Setting Up Ubuntu Development Environment

• Obtaining Source Code and Tools
• Obtaining Source Code
• Installing Necessary Libraries and Tools
• Installing Python3
• Installing LLVM (Required only for OpenHarmony_v1.x)
• Installing hb
  • Prerequisites
  • Installation Procedure
  • Uninstalling hb

Operating system: 64-bit version of Ubuntu 16.04 or later.

Perform the following steps to set up the development environment:

1. Obtain source code.
2. Install necessary libraries and tools.
3. Install Python3.
4. Install LLVM (required only for OpenHarmony_v1.x).
5. Install hb.

NOTICE:

• Docker is provided for the Ubuntu build environment, which encapsulates related build tools. If you use Docker to prepare the build environment, you do not need to perform the following steps in this section. For details, see Using Docker to Prepare the Build Environment.
• By default, basic software, such as Samba and Vim, is installed in the system. Adaptation on the software is required to support file sharing between the Linux server and the Windows workstation.
• For details about the compilation and building subsystem of OpenHarmony, see Compilation and Building Overview.

Obtaining Source Code and Tools

The following table describes the tools and source code required for setting up the general environment for a Linux server and how to obtain these tools and the source code.

Table 1 Source code and development tools and their obtaining methods

NOTICE:

• If you acquire the source code using an HPM component or HPM CLI tool, you do not need to install compilation tools like gn and ninja.
• (Recommended) If you obtain the source code via the mirror site or code repository, install compilation tools such as gn, ninja, and LLVM. When installing these tools, ensure that their environment variable paths are unique.

Obtaining Source Code

You need to acquire source code, download it on a Linux server, and decompress it.

Installing Necessary Libraries and Tools

Run the following command to install the libraries and tools required for compilation:

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-amd64 binutils binutils-dev libdwarf-dev u-boot-tools mtd-utils gcc-arm-linux-gnueabi

Installing Python3

1. Start a Linux server.

2. Run the following command to check the Python version:

   python3 --version
   

   If Python version is earlier than 3.7, reinstall Python. Do as follows to install Python, for example, Python 3.8.

   1. Check the Ubuntu version.

   cat /etc/issue
   

   1. Install Python based on the Ubuntu version.

      • If the Ubuntu version is 18 or later, run the following command:

        sudo apt-get install python3.8
        

      • If the Ubuntu version is 16, perform the following steps:

        a. Install dependency packages.

        sudo apt update && sudo apt install software-properties-common
        

        b. Add the source of deadsnakes PPA and press Enter.

        sudo add-apt-repository ppa:deadsnakes/ppa
        

        c. Install Python 3.8.

        sudo apt upgrade && sudo apt install python3.8
        

3. Set the soft link of python and python3 to 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
   

4. Install and upgrade the Python package management tool (pip3) using either of the following methods:

   • Command line:

     sudo apt-get install python3-setuptools python3-pip -y
     sudo pip3 install --upgrade pip
     

   • Installation package:

     curl https://bootstrap.pypa.io/get-pip.py -o get-pip.py
     python get-pip.py
     

Installing LLVM (Required only for OpenHarmony_v1.x)

NOTICE: When downloading source code under the OpenHarmony_v1.x branches or tags, perform the operation procedure described in this section to install LLVM 9.0.0. When downloading source code under the Master and OpenHarmony_v2.x branches or tags, skip this section. The hb automatically downloads the latest version of LLVM.

1. Start a Linux server.

2. Download LLVM.

3. Decompress the LLVM installation package to ~/llvm.

   tar -zxvf llvm.tar.gz -C ~/
   

4. Set an environment variable.

   vim ~/.bashrc
   

   Copy the following command to the last line of the .bashrc file, save the file, and exit.

   export PATH=~/llvm/bin:$PATH
   

5. Validate the environment variable.

   source ~/.bashrc
   

Installing hb

Prerequisites

Python 3.7.4 or later has been installed. For details, see Installing Python3.

Installation Procedure

1. Install hb.

   python3 -m pip install --user ohos-build
   

2. Set an environment variable.

   vim ~/.bashrc
   

   Copy the following command to the last line of the .bashrc file, save the file, and exit.

   export PATH=~/.local/bin:$PATH
   

   Update the environment variable.

   source ~/.bashrc
   

3. Run the hb -h command. If the following information is displayed, the installation is successful:

   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
   

Uninstalling hb

python3 -m pip uninstall ohos-build

NOTICE: If you encounter any problem during the installation, resort to the FAQs.