当前位置：首页 > news >正文

鸿蒙OpenHarmony

news 2025/9/18 1:02:45

开源鸿蒙系统编译指南

Ubuntu编译环境配置
- 第一步：Shell 改 Bash
- 第二步：安装Git和安装pip3工具
- 第三步：远程仓配置
- 第四步：拉取代码
- 第五步：安装编译环境
- 第六步：本地编译源码
Windows开发环境配置
- 第一步：在Ubuntu编译环境上安装SSH服务
- 第二步：在Windows开发环境上安装Remote SSH客户端
- 第三步：开发环境远程连接编译环境

使用Ubuntu的编译环境对OpenHarmony鸿蒙源码进行编译，在Windows环境中将编译出来的固件烧录到开发板上。

在这里插入图片描述

Ubuntu编译环境配置

Ubuntu环境实际使用环境：
Ubuntu 22.04.4 LTS
内存：64G
另外，用的CPU E5-2697 v2@2.70GHz*24，编译完成不到1个小时吧

第一步：Shell 改 Bash

1、在Ubuntu的终端窗口中执行sudo dpkg-reconfigure dash，出现如下页面：
在这里插入图片描述
2、在页面中使用方向按键选择"否"或No，回车确认会自动退出。

第二步：安装Git和安装pip3工具

Git是版本控制工具，pip3是python的包管理工具
1、安装Git

sudo apt install git git-lfs python3-pip curl

2、安装pip3

mkdir ~/.pip
pip3 config set global.index-url https://mirrors.huaweicloud.com/repository/pypi/simple
pip3 config set global.trusted-host mirrors.huaweicloud.com
pip3 config set global.timeout 120

第三步：远程仓配置

鸿蒙的源码放在码云服务器上，需要先申请码云gitee的自有账号，这里只介绍部分过程。
1、SSH 公钥设置
根据官网指导文档生成SSH公钥，再设置账户SSH公钥。
这里需要注意的是测试SSH环境时，再Linux终端中，首次执行 ssh -T git@gitee.com 时，出现如下结果，直接输入yes跳过。
在这里插入图片描述
再次执行 ssh -T git@gitee.com，才会出现和gitee官网相同的结果，这一点官方可能是选择性忽略，或许没有自测到此场景。
2、配置git的用户信息

git config --global user.name "yourname"
git config --global user.email "your-email-address"
git config --global credential.helper store

3、下载安装码云的repo工具，安装在 ~/bin 或其他路径下：

mkdir ~/bin
curl https://gitee.com/oschina/repo/raw/fork_flow/repo-py3 -o ~/bin/repo 
chmod a+x ~/bin/repo
pip3 install -i https://repo.huaweicloud.com/repository/pypi/simple requests

4、配置repo环境变量
在终端中执行 vim ~/.bashrc 命令编辑环境变量，在环境变量文件的最后一行添加repo的安装路径：

export PATH=~/bin:$PATH  # 这里的repo在~/bin下安装，也可以安装在其他路径下

执行 source ~/.bashrc 使该环境变量生效。

第四步：拉取代码

1、在新建的空文件夹中，准备拉取源码。这里下载到了 /xxx/openharmony4.0

mkdir /xxx/openharmony4.0

2、拉取源码

cd /xxx/openharmony4.0          # 1.进入到新建的文件下
repo init -u git@gitee.com:openharmony/manifest.git -b master --no-repo-verify    # 2.初始化仓库
repo sync -c     # 3.开始同步代码

获取鸿蒙代码结束后，如下文件列表：
在这里插入图片描述

第五步：安装编译环境

1、通过以下步骤安装编译OpenHarmony需要的库和工具。

sudo apt-get update && sudo apt-get install binutils binutils-dev git git-lfs gnupg flex bison gperf build-essential zip curl zlib1g-dev gcc-multilib g++-multilib libc6-dev-i386 libc6-dev-amd64 lib32ncurses5-dev x11proto-core-dev libx11-dev lib32z1-dev ccache libgl1-mesa-dev libxml2-utils xsltproc unzip m4 bc gnutls-bin python3.8 python3-pip ruby genext2fs device-tree-compiler make libffi-dev e2fsprogs pkg-config perl openssl libssl-dev libelf-dev libdwarf-dev u-boot-tools mtd-utils cpio doxygen liblz4-tool openjdk-8-jre gcc g++ texinfo dosfstools mtools default-jre default-jdk libncurses5 apt-utils wget scons python3.8-distutils tar rsync git-core libxml2-dev lib32z-dev grsync xxd libglib2.0-dev libpixman-1-dev kmod jfsutils reiserfsprogs xfsprogs squashfs-tools pcmciautils quota ppp libtinfo-dev libtinfo5 libncurses5-dev libncursesw5 libstdc++6 gcc-arm-none-eabi vim ssh locales libxinerama-dev libxcursor-dev libxrandr-dev libxi-dev

说明：
（1）若使用Ubuntu20及以上版本，由于gcc-multilib和gcc-arm-linux-gnueabi互斥，请勿安装gcc-arm-linux-gnueabi，直接执行上述命令即可。
（2）若使用Ubuntu18.04，需要继续执行 sudo apt-get install gcc-arm-linux-gnueabi

Python要求安装Python 3.8及以上版本，此处以Python 3.8为例。
Java要求java8及以上版本，此处以java8为例。

2、设置默认python版本
查看Python 3.8的安装路径 which python3.8，这里的路径是 /usr/bin/python3.8

# 设置默认Python解释器
sudo update-alternatives --install /usr/bin/python python {默认Python路径} 1
sudo update-alternatives --install /usr/bin/python3 python3 {默认Python路径} 1
# 例如：
# 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

第六步：本地编译源码

1、在源码根目录下执行prebuilts脚本
bash build/prebuilts_download.sh
在这里插入图片描述
2、开始编译源码
指定编译类型为rk3568，编译结果文件及编译日志文件获取路径：out/rk3568
sudo ./build.sh --product-name rk3568 --ccache
不指定类型，直接编译源码，编译结果文件在 out/sdk/ohos-sdk文件夹里
sudo ./build.sh --product-name ohos-sdk

Windows开发环境配置

一般情况下，大多数人都会在Windows环境下开发调试烧录，这就需要Windows和Ubuntu交互和传输文件，这就需要配置远程访问环境。

第一步：在Ubuntu编译环境上安装SSH服务

一般情况下，只要用其他远程(MobaXterm)工具能通过SSH服务登录，就可以忽略不执行此步骤。
在Ubuntu系统中，打开终端工具，执行如下命令安装SSH服务并启动。

sudo apt-get install openssh-server   # 安装openssh-server
sudo systemctl start ssh      # 启动SSH服务

第二步：在Windows开发环境上安装Remote SSH客户端

打开Windows系统下的Visual Studio Code工具，点击插件管理模块，在插件市场的搜索并安装“remote-ssh”插件。
在这里插入图片描述

第三步：开发环境远程连接编译环境

1、打开Remote Explorer。
2、新建远程连接。
3、输入“ssh user@host-or-ip”或者"user@domain@host-or-ip"后回车确认。其中host-or-ip为要连接的远程计算机的IP地址或者host名称，user为登录远程计算机的帐号。注意：这里的user和host-or-ip均是编译环境已经配置过的账号。
在这里插入图片描述
4、在弹出的输入框中，选择SSH configuration文件，选择默认的第一选项即可。

5、根据自己的习惯选择两种链接方式之一

6、在弹出的输入框中，根据远程环境的类型，选择Linux/Windows/MacOs，然后输入登录远程计算机的user的密码，确认回车开始连接远程计算机。
在这里插入图片描述
这是成功连接的正常状态。

7、如图找到远程环境中的源码后，点击"OK" ，可以打开远程源码进行编辑调试。