Environment Setup

Mini and Small Systems

Symptom

After the python3 -m pip install --user ohos-build command is executed, garbled characters and segmentation faults occur.
Possible Causes

The pip version does not meet requirements.
Solution

Run the following command to upgrade pip:
```
python3 -m pip install -U pip
```

Symptom

During the execution of python3 -m pip install --user ohos-build, the following information is displayed:
cannot import 'sysconfig' from 'distutils'
Possible Causes

The distutils module is unavailable.
Solution

Run the following command to install distutils:
```
sudo apt-get install python3.8-distutils
```

Symptom

During the execution of python3 -m pip install --user ohos-build, the following information is displayed:
module 'platform' has no attribute 'linux_distribution'
Possible Causes

There is a compatibility issue of python3-pip.

Solution

Reinstall pip.

sudo apt remove python3-pip
curl https://bootstrap.pypa.io/get-pip.py -o get-pip.py
python get-pip.py

Symptom

During the execution of python3 -m pip install --user ohos-build, the following information is displayed:
Could not find a version that satisfies the requirement ohos-build
Possible Causes

The installation fails due to poor network connectivity.
Solution
1. Check that your computer has a good network connection. If the network connection is unstable, rectify the network fault and reinstall hb.
2. If the network is functional, run the following commands to install hb by specifying a temporary PyPI source:
```
python3 -m pip install -i https://pypi.tuna.tsinghua.edu.cn/simple ohos-build
```

Symptom

The following informaton is displayed during the Python 3 installation process:

configure: error: no acceptable C compiler found in $PATH. See 'config.log' for more details

Possible Causes

GCC is not installed.
Solution
1. Run the apt-get install gcc command to install GCC online.
2. Install Python 3.

Symptom

The following information is displayed during the Python 3 installation process:
```
-bash: make: command not found
```
Possible Causes

make is not installed.
Solution
1. Run the apt-get install make command to install make online.
2. Install Python 3.

Symptom

The following information is displayed during the Python 3 installation process:
```
zipimport.ZipImportError: can't decompress data; zlib not available
```
Possible Causes

zlib is not installed.
Solution
1. Install zlib online or offline.
  
  Online installation:
  
  Run the apt-get install zlib command to install zlib online.
  
  Offline installation:
  1. Download zlib from http://www.zlib.net/.
  2. Run the following command to install zlib:
```
 # tar xvf zlib-1.2.11.tar.gz
   # cd zlib-1.2.11
   # ./configure
   # make && make install
```
2. Install Python 3.

Symptom

The following information is displayed during the Python 3 installation process:
```
ModuleNotFoundError: No module named '_ctypes'
```
Possible Causes

libffi and libffi-devel are not installed.
Solution
1. Run the apt-get install libffi* -y command to install libffi and libffi-devel online.
2. Install Python 3.

Symptom

The following information is displayed during the kconfiglib installation process:

subprocess.CalledProcessError: Command '('lsb_release', '-a')' returned non-zero exit status 1.

Possible Causes

The Python version in use does not match the Python version on which the lsb_release module depends.
Solution

Run find / -name lsb_release to locate lsb_release, and delete it, for example, run sudo rm -rf /usr/bin/lsb_release.

Symptom

When an unidentifiable command is executed on the Linux server, the following information is displayed:
ImportError: No module named apt_pkg
Possible Causes

There is a compatibility issue of python3-apt.

Solution

Reinstall python3-apt.

sudo apt-get remove  python3-apt
sudo apt-get install python3-apt

Scenario

Update the OpenHarmony source code downloaded to the branch (for example, Master) source code.
Solution
1. Go to the OpenHarmony root directory.
  
  Check that the root directory has a .repo folder, which is usually hidden. If the .repo folder does not exist, decompress the obtained source code package again to obtain complete source code.
2. Run the repo init command to initialize the source code repository information.
  
  In the command, branch indicates the branch name, for example, master or OpenHarmony-3.2-Beta3.
```
repo init -u https://gitee.com/openharmony/manifest -b branch --no-repo-verify
```
3. Download and update the source code file.
```
repo sync -c
repo forall -c 'pwd;git lfs pull'
```
  To keep the working directory clean, run the following command:
  
  CAUTION
  This command will reset the local workspace and delete files or directories that are not managed by gitee. Exercise caution when performing this operation.
```
repo forall -c 'git reset --hard;git clean -fdx'
```
4. Run the prebuilts script to install the compiler and binary tool.
```
bash build/prebuilts_download.sh
```