harmony 鸿蒙环境搭建常见问题

2022-08-09
浏览 (905)

环境搭建常见问题

轻量和小型系统

安装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，如没有此隐藏目录，请重新解压获取的源码包，以获取完整的源码内容。
1. 使用repo init命令重新初始化源码库信息。
其中，branch表示分支名称，例如master、OpenHarmony-3.2-Beta3等。
```
 repo init -u https://gitee.com/openharmony/manifest -b branch --no-repo-verify
```
1. 下载更新源码文件。
```
 repo sync -c
 repo forall -c 'pwd;git lfs pull'
```
如果想保持工作路径清洁，可以执行如下命令。
注意： 此操作会重置本地工作区，删除未被git管理的文件或目录，请谨慎操作。
```
 repo forall -c 'git reset --hard;git clean -fdx'
```
1. 执行prebuilts脚本，安装编译器及二进制工具。
```
 bash build/prebuilts_download.sh
```