系统要求:Ubuntu16.04及以上64位系统版本。
编译环境搭建分为如下几步:
- 获取源码
- 安装和配置python
- 安装gn
- 安装ninja
- 安装LLVM
- 安装hb
须知:
- 针对Ubuntu编译环境我们提供了对应的Docker,该Docker封装了相关编译工具,选择使用Docker的开发者可跳过此章节。Docker使用可参考Docker方式获取编译环境。
- 通常系统默认安装samba、vim等常用软件,需要做适当适配以支持Linux服务器与Windows工作台之间的文件共享。
- 想要详细了解OpenHarmony编译构建模块功能的开发者可参考编译构建使用指南。
获取软件Linux服务器通用环境配置需要的工具及其获取途径如下表所示:
表 1 Linux服务器开发工具及获取途径
须知:
- 如果后续通过“HPM组件方式”或“HPM包管理器命令行工具方式”获取源码,不需要安装gn、ninja编译工具。
- (推荐)如果后续通过“镜像站点方式”或“代码仓库方式”获取源码,需要安装gn、ninja、LLVM编译工具。安装gn、ninja、LLVM编译工具时,请确保编译工具的环境变量路径唯一。
获取源码开发者需要在Linux服务器上下载并解压一套源代码,请参见源码获取。 安装和配置Python- 打开Linux编译服务器终端。
- 输入如下命令,查看python版本号,需使用python3.7以上版本。
如果低于python3.7版本,不建议直接升级,请按照如下步骤重新安装。以python3.8为例,按照以下步骤安装python。
- 根据Ubuntu不同版本,安装python。
- 如果Ubuntu 版本为18+,运行如下命令。
- sudo apt-get install python3.8
- 如果Ubuntu版本为16。
a. 安装依赖包
- sudo apt update && sudo apt install software-properties-common
b. 添加deadsnakes PPA 源,然后按回车键确认安装。
- sudo add-apt-repository ppa:deadsnakes/ppa
c. 安装python3.8
- sudo apt upgrade && sudo apt 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
- 安装并升级Python包管理工具(pip3),任选如下一种方式。
- 命令行方式:
- sudo apt-get install python3-setuptools python3-pip -y
- sudo pip3 install --upgrade pip
- 安装包方式:
- curl https://bootstrap.pypa.io/get-pip.py -o get-pip.py
- python get-pip.py
安装gn- 打开Linux编译服务器终端。
- 在根目录下创建gn文件夹。
- 解压gn安装包至~/gn路径下。
- tar -xvf gn-linux-x86-1717.tar.gz -C ~/gn
- 设置环境变量。
将以下命令拷贝到.bashrc文件的最后一行,保存并退出。
- 生效环境变量。
安装ninja- 打开Linux编译服务器终端。
- 下载ninja工具。
- 解压ninja安装包至~/ninja路径下。
- tar -xvf ninja.1.9.0.tar -C ~/
- 设置环境变量。
将以下命令拷贝到.bashrc文件的最后一行,保存并退出。
- export PATH=~/ninja:$PATH
- 生效环境变量。
安装LLVM- 打开Linux编译服务器终端。
说明:针对OpenHarmony_v1.x分支/标签,使用此链接下载LLVM工具。
- 解压LLVM安装包至~/llvm路径下。
- tar -zxvf llvm.tar.gz -C ~/
说明:针对OpenHarmony_v1.x分支/标签,使用如下命令解压:
- tar -xvf llvm-linux-9.0.0-36191.tar -C ~/
- 设置环境变量。
将以下命令拷贝到.bashrc文件的最后一行,保存并退出。
- export PATH=~/llvm/bin:$PATH
- 生效环境变量。
安装hb前提条件请先安装Python 3.7.4及以上版本,请见安装和配置Python。
安装方法- 运行如下命令安装hb
- python3 -m pip install --user ohos-build
- 设置环境变量
将以下命令拷贝到.bashrc文件的最后一行,保存并退出。
- export PATH=~/.local/bin:$PATH
执行如下命令更新环境变量。
- 执行"hb -h",有打印以下信息即表示安装成功:
- usage: hb
- OHOS build system
- positional arguments:
- {build,set,env,clean}
- build Build source code
- set OHOS build settings
- env Show OHOS build env
- clean Clean output
- optional arguments:
- -h, --help show this help message and exit
卸载方法- python3 -m pip uninstall ohos-build
须知:如果安装hb的过程中遇到问题,请参见下文常见问题进行解决。
安装其他工具安装方法- apt安装全部依赖的工具
- sudo apt-get install build-essential gcc g++ make zlib* libffi-dev e2fsprogs pkg-config flex bison perl bc openssl libssl-dev libelf-dev libc6-dev-amd6