环境搭建常见问题

轻量和小型系统

安装hb

出现乱码、段错误

  • 现象描述

    执行“python3 -m pip install --user ohos-build”出现乱码、段错误（segmentation fault）。

  • 可能原因

    pip版本过低。

  • 解决办法

    执行如下命令升级pip。

    python3 -m pip install -U pip

提示"cannot import 'sysconfig' from 'distutils'"

  • 现象描述

    执行“python3 -m pip install --user ohos-build”提示"cannot import 'sysconfig' from 'distutils'"。

  • 可能原因

    缺少distutils模块。

  • 解决办法

    执行如下命令安装。

    sudo apt-get install python3.8-distutils

提示"module 'platform' has no attribute 'linux_distribution'"

  • 现象描述

    执行“python3 -m pip install --user ohos-build”提示"module 'platform' has no attribute 'linux_distribution'"。

  • 可能原因

    python3 pip安装兼容性问题。

  • 解决办法

    执行如下命令重新安装pip。

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

提示"Could not find a version that satisfies the requirement ohos-build"

  • 现象描述

    执行“python3 -m pip install --user ohos-build”提示"Could not find a version that satisfies the requirement ohos-build"

  • 可能原因

    可能是网络环境较差导致的安装失败。

  • 解决办法

    1. 请检查网络连接是否正常。如果网络有问题，请修复网络问题后重新安装。

    2. 若网络正常，请尝试指定临时pypi源的方式安装：

      python3 -m pip install -i https://pypi.tuna.tsinghua.edu.cn/simple ohos-build

安装python3

提示“configure: error: no acceptable C compiler found in $PATH”

  • 现象描述

    安装python3过程中出现以下错误：

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

  • 可能原因

    环境中未安装“gcc”。

  • 解决办法

    1、通过命令“apt-get install gcc”在线安装。

    2、完成后，重新安装python3。

提示“-bash: make: command not found”

  • 现象描述

    安装python3过程中出现以下错误：

    -bash: make: command not found

  • 可能原因

    环境中未安装“make”。

  • 解决办法

    1、通过命令“apt-get install make”在线安装。

    2、完成后，重新安装python3。

提示“zlib not available”

  • 现象描述

    安装python3过程中出现以下错误：

    zipimport.ZipImportError: can't decompress data; zlib not available

  • 可能原因

    环境中未安装“zlib”。

  • 解决办法

    方法1：通过命令“apt-get install zlib”在线安装。

    方法2：如果软件源中没有该软件，请从“www.zlib.net”下载版本代码，并离线安装。

    完成下载后，通过以下命令安装：

    # tar xvf zlib-1.2.11.tar.gz
# cd zlib-1.2.11
# ./configure
# make && make install

    完成后，重新安装python3。

提示“No module named '_ctypes'”

  • 现象描述

    安装python3过程中出现以下错误：

    ModuleNotFoundError：No module named ‘_ctypes’

  • 可能原因

    环境中未安装“libffi”和“libffi-devel”。

  • 解决办法

    1、通过命令“apt-get install libffi* -y”，在线安装。

    2、完成后，重新安装python3。

安装kconfiglib过程中遇到lsb_release错误

  • 现象描述

    安装kconfiglib过程中遇到如下错误打印：

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

  • 可能原因

    lsb_release模块基于的python版本与现有python版本不一致

  • 解决办法

    执行"find / -name lsb_release"，找到lsb_release位置并删除，如："sudo rm -rf /usr/bin/lsb_release"

Linux编译服务器终端输入不识别的命令时提示“ImportError: No module named apt_pkg”

  • 现象描述

    Linux编译服务器终端输入不识别的命令时，提示"ImportError: No module named apt_pkg"

  • 可能原因

    python3 apt安装兼容性问题。

  • 解决办法

    执行如下命令重新安装python3-apt。

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

如何将下载好的源码升级为其他分支源码

  • 场景描述

    当您的环境中已有下载好的OpenHarmony源码，需要将其升级为其他分支（例如Master）源码时，可按照如下步骤进行操作。

  • 操作方法

    1. 进入现有OpenHarmony根目录。

      请注意该目录下包含一个隐藏目录.repo，如没有此隐藏目录，请重新解压获取的源码包，以获取完整的源码内容。

    2. 使用repo init命令重新初始化源码库信息。

      其中，branch表示分支名称，例如master、OpenHarmony-3.2-Beta3等。

      repo init -u https://gitee.com/openharmony/manifest -b branch --no-repo-verify

    3. 下载更新源码文件。

      repo sync -c
repo forall -c 'pwd;git lfs pull'

      如果想保持工作路径清洁，可以执行如下命令。

      icon-note.gif 注意： 此操作会重置本地工作区，删除未被git管理的文件或目录，请谨慎操作。

      repo forall -c 'git reset --hard;git clean -fdx'

    4. 执行prebuilts脚本，安装编译器及二进制工具。

      bash build/prebuilts_download.sh