01 环境搭建

首先需要一台安装了Ubuntu的电脑或者虚拟机，推荐使用20.04版本。用户名不能包含中文。

我们已经准备了docker环境，只需要按照以下方法便可创建一个完善的编译环境来编译open Harmony 5.0.

docker镜像创建方法如下所示：

2 使用我们构造好的 docker image

本文档将介绍两种方式，
方式 1 为使用我们构造好的 docker image；方式 2 为自己构建一个 docker image。

优点：省心，不需要联网。
缺点：可能会有文件权限问题。

备注

docker image 路径：
ShimetaPi开源鸿蒙资料>M4-R1>05-开发资料>01-OpenHarmory 开发资料>openharmony5_env.tar

将文件下载下来拷贝到任意目录下面，然后执行以下命令加载docker镜像

docker load -i openharmony5_env.tar
docker images  # 查看镜像是否加载成功

在第14行，修改apt命令的源为华为云，以缓解原镜像源下载缓慢的问题。
在第23行，其主要是安装编译所需要的一些依赖包，后期可在此处进行修改添加自己想要的包;
在第39行，使用传入的 groupid 创建组，建议不修改。
在第40行，使用传入的 userid 创建用户，建议不修改。
在第41行，修改用户密码为123456，可在此处将用户的默认密码自行修改为自身常用的密码；
通过以上配置，当我们进入容器后，容器的默认用户，其grouid、userid、用户密码就是由上述代码所决定的。
在第48行，将root的密码显式设置为123456，此处可将root密码修改为自身常用的密码。

3.2 创建build-container

3.2.1 作用

该脚本用于：根据2.1中的dockerfile创建出所需的镜像（image）。

3.2.2 创建方法

（1）cd ~/proj
（2）vim build-container
（3）将以下文本粘贴进来后输入“:q”保存。

#!/bin/bash

USER_ID=1000
GROUP_ID=1000
USERNAME=shimeta


docker build --build-arg userid=$USER_ID  --build-arg groupid=$GROUP_ID  --build-arg username=$USERNAME --tag sc3568ha2:latest .

提示

第3、4、5行将自定义用户的组ID、用户ID、用户名称传递给dockerfile，在2.1所创建的dockerfile中，会根据传入的这三个参数创建一个新用户。
第8行末尾的 " . " 用于指定上一步我们创建的dockerfile所处的位置，由于我们将dockerfile、build-container、entrycontainer这三个文件都放在同一路径下，因此此处就使用 " . " ，表示dockerfile处于当前目录下。
第8行的"sc3568ha2:latest"用于指定创建出的docker镜像的名称及其版本号，可自行修改，格式为"镜像名称:版本号"。

（4）chmod +x ./build-container

3.3 创建镜像

# 先将当前用户加入docker组
sudo usermod -aG docker $USER
# 应用变更
newgrp docker
# 运行以下命令测试是否无需 sudo 即可使用 Docker：
docker images
bash ./build-container

3.3.1 问题1

创建镜像失败，并有以下相关字样，考虑是网络问题导致的docker拉取镜像失败。 Error response from daemon: Get "https://registry-1.docker.io/v2/": context deadline exceeded (Client.Timeout exceeded while awaiting headers)

可通过配置镜像源解决，参考解决方案：

# 编辑daemon.json
vim /etc/docker/daemon.json

# 将下述第5至36行的文本粘贴到daemon.json
{
  "registry-mirrors" : ["https://docker.registry.cyou",
"https://docker-cf.registry.cyou",
"https://dockercf.jsdelivr.fyi",
"https://docker.jsdelivr.fyi",
"https://dockertest.jsdelivr.fyi",
"https://mirror.aliyuncs.com",
"https://dockerproxy.com",
"https://mirror.baidubce.com",
"https://docker.m.daocloud.io",
"https://docker.nju.edu.cn",
"https://docker.mirrors.sjtug.sjtu.edu.cn",
"https://docker.mirrors.ustc.edu.cn",
"https://mirror.iscas.ac.cn",
"https://docker.rainbond.cc",
"https://do.nark.eu.org",
"https://dc.j8.work",
"https://dockerproxy.com",
"https://gst6rzl9.mirror.aliyuncs.com",
"https://registry.docker-cn.com",
"http://hub-mirror.c.163.com",
"http://mirrors.ustc.edu.cn/",
"https://mirrors.tuna.tsinghua.edu.cn/",
"http://mirrors.sohu.com/"
],
 "insecure-registries" : [
    "registry.docker-cn.com",
    "docker.mirrors.ustc.edu.cn"
    ],
"debug": true,
"experimental": false
}


# 重新加载daemon.json文件，使修改生效
sudo systemctl daemon-reload
# 重新启动docker服务
sudo systemctl restart docker
# 查看是否配置成功
docker info

4 进入容器

4.1 entrycontainer

4.1.1 作用

该脚本用于：根据1中的镜像或者2中生成的镜像创建一个容器并进入该容器。

4.1.2 创建方法

（1）cd ~/proj
（2）vim entrycontainer
（3）将以下文本粘贴进来后输入“:q”保存。

#!/bin/bash

set -e

HOME_DIR="/home/shimeta/proj"
BUILD_DIR="/home/xxx/proj"


docker run --privileged  --volume ${BUILD_DIR}:${HOME_DIR}:rw --volume /tmp:/tmp \
  --workdir=${HOME_DIR} \
  --env TERM=xterm-256color --env SHELL=/bin/bash \
  --rm --init --tty --interactive \
  --hostname docker_OP \
  sc3568ha2:latest

提示

使用docker的一个便利之处在于可以将主机文件夹映射到容器中，我们进入到容器中后，仿佛是在使用一台新的电脑的同时，还可以访问主机的指定文件夹。借助这一功能，后续，在进入容器前，我们先把项目文件放置在BUILD_DIR所指定的路径下，然后进入容器后，我们进入HOME_DIR路径下，便可以在容器路径HOME_DIR看到我们的项目文件。
第9行的"--volume ${BUILD_DIR}:${HOME_DIR}:rw"是实现这一映射功能的语句，其将主机文件夹BUILD_DIR映射到容器的路径HOME_DIR下面，当我们进入容器中后，可以在路径HOME_DIR下面访问主机文件夹BUILD_DIR下面的所有文件。
第6行的路径通常也是"/home/xxx/proj"，与容器内路径一致，以避免混淆。其中，xxx是你使用的用户的名称，需要手动修改一下。

4.2 执行以下命令

cd ~/proj
chmod +x ./entrycontainer
bash ./entrycontainer

5 进入容器后操作

进入容器后，还需要执行以下命令：

# 1、配置默认命令行解释器为bash
ls -l /bin/sh                   #如果显示为“/bin/sh -> bash”则为正常，否则请以以下方式修改：
sudo dpkg-reconfigure dash      #然后选择no
# 2、配置git邮箱，防止编译代码时报错
git config --global user.name "你的用户名"
git config --global user.email "你的邮箱@example.com"