背景

随着OpenHarmony3.1的发布，越来越多的开发者将目光聚焦到OpenHarmony系统开发上。对于首次接触OpenHarmony的开发者来说，如何进行源码编译是一个大难题，本文将详细介绍源码拉取到编译成功的过程，希望对开发小伙伴有所帮助。

开发环境准备

我们将使用官方推荐的Ubuntu20作为编译环境，开发板使用Hi3516DV300，由于整个编译工具链过于庞大，手动搭建编译环境非常复杂，并且容易出错，这里将使用docker搭建编译环境，可以事半功倍

安装Docker

1.首先删除可能已有的docker
$ sudo apt-get remove docker docker-engine docker.io containerd runc

2.更新apt，安装基础工具
$ sudo apt-get update
$ sudo apt-get install ca-certificates curl gnupg lsb-release

3.添加docker官方GPG key
$ curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg

4.添加稳定版docker源到apt
$ echo
“deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu
$(lsb_release -cs) stable” | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

5.安装docker
$ sudo apt-get update
$ sudo apt-get install docker-ce docker-ce-cli containerd.io

6.测试docker
$ sudo docker run hello-world

7.拉取docker编译环境
$ sudo docker pull swr.cn-south-1.myhuaweicloud.com/openharmony-docker/openharmony-docker:1.0.0

验证docker是否安装成功

拉取源码

源码拉取流程如下：

操作命令如下：
1.更新apt
$ sudo apt update

2.安装git
$ sudo apt install git-all

3.注册gitee账号，配置git ssh-key
$ git config --global user.name “yourname”
$ git config --global user.email “your-email-address”
$ git config --global credential.helper store

4.安装python3.8，需要注意，ubuntu有可能自带有python2.7，可能引发冲突，ubuntu20
$ sudo apt-get install python3.8

设置python和python3软链接为python3.8
$ sudo update-alternatives --install /usr/bin/python python /usr/bin/python3.8 1
$ sudo update-alternatives --install /usr/bin/python3 python3 /usr/bin/python3.8 1
5.安装码云repo工具
$ curl -s https://gitee.com/oschina/repo/raw/fork_flow/repo-py3 > /usr/local/bin/repo
#如果没有权限，可下载至其他目录，并将其配置到环境变量中
$ chmod a+x /usr/local/bin/repo
$ pip3 install -i https://repo.huaweicloud.com/repository/pypi/simple requests

6.拉取代码
创建代码文件夹
$ mkdir /home/openharmony3.0
$ cd /home/openharmony3.0
拉取代码
$ repo init -u https://gitee.com/openharmony/manifest.git -b refs/tags/OpenHarmony-v3.0.1-LTS --no-repo-verify
$ repo sync -c
$ repo forall -c ‘git lfs pull’

开发环境

Visual Studio Code进行远程开发方式，需要安装Remote Development插件，步骤如下：

① 下载Visual Studio Code并安装，官网链接：https://code.visualstudio.com/

② 安装Remote Development插件

③ 点击左下角绿色图标

④ 选择连接主机

⑤ 选择增加远程主机

⑥ 输入ssh 用户名@IP

⑦ 输入账号密码

⑧ 选择远程主机代码目录

⑨ 成功后会展示代码目录

源码编译

注意：
不要重复执行sudo docker run -it …，
这样会导致重复创新多个容器，第一次编译执行完后，容器会停止，那么就需要启动容器
$ sudo docker start ohosc
// 这里ohosc是上一步 --name ohosc 给容器起的别名

进入容器内部执行编译
$ sudo docker exec -it ohosc /bin/bash

./build.sh --product-name Hi3516DV300 --ccache

编译过程输出日志如下：

编译成功提示：