【入门到实战】OpenHarmony设备开发：环境搭建常见问题

本文链接：https://blog.csdn.net/Androidbye/article/details/147537168

现象描述

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

pip版本过低。
解决办法

执行如下命令升级pip。
```
python3 -m pip install -U pip
```

现象描述

执行“python3 -m pip install --user ohos-build”提示"cannot import ‘sysconfig’ from ‘distutils’"。
可能原因

缺少distutils模块。

解决办法

执行如下命令安装。

sudo apt-get install python3.8-distutils

现象描述

执行“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

现象描述

执行“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. See 'config.log' for more details

现象描述

安装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。

现象描述

安装python3过程中出现以下错误：
```
ModuleNotFoundError：No module named ‘_ctypes’
```
可能原因

环境中未安装“libffi”和“libffi-devel”。
解决办法

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

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

现象描述

安装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”

解决办法

执行如下命令重新安装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
shell
```
3. 下载更新源码文件。
```
repo sync -c
repo forall -c 'pwd;git lfs pull'
shell
```
  如果想保持工作路径清洁，可以执行如下命令。
  
  注意： 此操作会重置本地工作区，删除未被git管理的文件或目录，请谨慎操作。
```
repo forall -c 'git reset --hard;git clean -fdx'
```
4. 执行prebuilts脚本，安装编译器及二进制工具。
```
bash build/prebuilts_download.sh
```