[文章]获取源码及Ubuntu编译环境准备

• 获取源码
• 安装和配置python
• 安装gn
• 安装ninja
• 安装LLVM
• 安装hb
  

须知：

• 针对Ubuntu编译环境我们提供了对应的Docker，该Docker封装了相关编译工具，选择使用Docker的开发者可跳过此章节。Docker使用可参考Docker方式获取编译环境。
• 通常系统默认安装samba、vim等常用软件，需要做适当适配以支持Linux服务器与Windows工作台之间的文件共享。
• 想要详细了解OpenHarmony编译构建模块功能的开发者可参考编译构建使用指南。
  

须知：

• 如果后续通过“HPM组件方式”或“HPM包管理器命令行工具方式”获取源码，不需要安装gn、ninja编译工具。
• （推荐）如果后续通过“镜像站点方式”或“代码仓库方式”获取源码，需要安装gn、ninja、LLVM编译工具。安装gn、ninja、LLVM编译工具时，请确保编译工具的环境变量路径唯一。
  

• 打开Linux编译服务器终端。
• 输入如下命令，查看python版本号，需使用python3.7以上版本。
  
  1. python3 --version

  复制代码
  
  如果低于python3.7版本，不建议直接升级，请按照如下步骤重新安装。以python3.8为例，按照以下步骤安装python。
  
  • 运行如下命令，查看Ubuntu版本：
    
  1. cat /etc/issue

  复制代码
  
  
  • 根据Ubuntu不同版本，安装python。
    
    • 如果Ubuntu 版本为18+，运行如下命令。
      
      1. sudo apt-get install python3.8

      复制代码
      
      
    • 如果Ubuntu版本为16。
      a. 安装依赖包
      
      1. sudo apt update && sudo apt install software-properties-common

      复制代码
      
      b. 添加deadsnakes PPA 源，然后按回车键确认安装。
      
      1. sudo add-apt-repository ppa:deadsnakes/ppa

      复制代码
      
      c. 安装python3.8
      
      1. sudo apt upgrade && sudo apt install python3.8

      复制代码
      
      
• 设置python和python3软链接为python3.8。
  
  1. sudo update-alternatives --install /usr/bin/python python /usr/bin/python3.8 1
     
  2. sudo update-alternatives --install /usr/bin/python3 python3 /usr/bin/python3.8 1

  复制代码
  
  
• 安装并升级Python包管理工具（pip3），任选如下一种方式。
  
  • 命令行方式：
    
    1. sudo apt-get install python3-setuptools python3-pip -y
       
    2. sudo pip3 install --upgrade pip

    复制代码
    
    
  • 安装包方式：
    
    1. curl https://bootstrap.pypa.io/get-pip.py -o get-pip.py
       
    2. python get-pip.py

    复制代码
    
    

• 打开Linux编译服务器终端。
• 下载gn工具。
• 在根目录下创建gn文件夹。
  
  1. mkdir ~/gn

  复制代码
  
  
• 解压gn安装包至~/gn路径下。
  
  1. tar -xvf gn-linux-x86-1717.tar.gz -C ~/gn

  复制代码
  
  
• 设置环境变量。
  
  1. vim ~/.bashrc

  复制代码
  
  将以下命令拷贝到.bashrc文件的最后一行，保存并退出。
  
  1. export PATH=~/gn:$PATH

  复制代码
  
  
• 生效环境变量。
  
  1. source ~/.bashrc

  复制代码
  
  

• 打开Linux编译服务器终端。
• 下载ninja工具。
• 解压ninja安装包至~/ninja路径下。
  
  1. tar -xvf ninja.1.9.0.tar -C ~/

  复制代码
  
  
• 设置环境变量。
  
  1. vim ~/.bashrc

  复制代码
  
  将以下命令拷贝到.bashrc文件的最后一行，保存并退出。
  
  1. export PATH=~/ninja:$PATH

  复制代码
  
  
• 生效环境变量。
  
  1. source ~/.bashrc

  复制代码
  
  

• 打开Linux编译服务器终端。
• 下载LLVM工具。

  说明：针对OpenHarmony_v1.x分支/标签，使用此链接下载LLVM工具。

• 解压LLVM安装包至~/llvm路径下。
  
  1. tar -zxvf llvm.tar.gz -C ~/

  复制代码
  
  

  说明：针对OpenHarmony_v1.x分支/标签，使用如下命令解压：
  

  1. tar -xvf llvm-linux-9.0.0-36191.tar -C ~/

  复制代码

  
  

• 设置环境变量。
  
  1. vim ~/.bashrc

  复制代码
  
  将以下命令拷贝到.bashrc文件的最后一行，保存并退出。
  
  1. export PATH=~/llvm/bin:$PATH

  复制代码
  
  
• 生效环境变量。
  
  1. source ~/.bashrc

  复制代码
  
  

• 运行如下命令安装hb
  
  1. python3 -m pip install --user ohos-build

  复制代码
  
  
• 设置环境变量
  
  1. vim ~/.bashrc

  复制代码
  
  将以下命令拷贝到.bashrc文件的最后一行，保存并退出。
  
  1. export PATH=~/.local/bin:$PATH

  复制代码
  
  执行如下命令更新环境变量。
  
  1. source ~/.bashrc

  复制代码
  
  
• 执行"hb -h"，有打印以下信息即表示安装成功：
  
  1. usage: hb
     
  2. 
     
  3. OHOS build system
     
  4. 
     
  5. positional arguments:
     
  6.   {build,set,env,clean}
     
  7.     build               Build source code
     
  8.     set                 OHOS build settings
     
  9.     env                 Show OHOS build env
     
  10.     clean               Clean output
      
  11. 
      
  12. optional arguments:
      
  13.   -h, --help            show this help message and exit

  复制代码
  
  

须知：如果安装hb的过程中遇到问题，请参见下文常见问题进行解决。

• apt安装全部依赖的工具
  
  1. 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

  复制代码