1# 环境搭建常见问题<a name="ZH-CN_TOPIC_0000001215650793"></a> 2 3 4## 轻量和小型系统<a name="section1742119306399"></a> 5 6### 安装hb<a name="section36351051193919"></a> 7 8#### 出现乱码、段错误 9 10- **现象描述** 11 12 执行“python3 -m pip install --user ohos-build”出现乱码、段错误（segmentation fault）。 13 14 15- **可能原因** 16 17 pip版本过低。 18 19- **解决办法** 20 21 执行如下命令升级pip。 22 23 ``` 24 python3 -m pip install -U pip 25 ``` 26 27 28#### 提示"cannot import 'sysconfig' from 'distutils'"<a name="section48221013144011"></a> 29 30- **现象描述** 31 32 执行“python3 -m pip install --user ohos-build”提示"cannot import 'sysconfig' from 'distutils'"。 33 34 35- **可能原因** 36 37 缺少distutils模块。 38 39- **解决办法** 40 41 执行如下命令安装。 42 43 ``` 44 sudo apt-get install python3.8-distutils 45 ``` 46 47 48#### 提示"module 'platform' has no attribute 'linux\_distribution'"<a name="section10307193044111"></a> 49 50- **现象描述** 51 52 执行“python3 -m pip install --user ohos-build”提示"module 'platform' has no attribute 'linux\_distribution'"。 53 54 55- **可能原因** 56 57 python3 pip安装兼容性问题。 58 59- **解决办法** 60 61 执行如下命令重新安装pip。 62 63 ``` 64 sudo apt remove python3-pip 65 curl https://bootstrap.pypa.io/get-pip.py -o get-pip.py 66 python get-pip.py 67 ``` 68 69 70#### 提示"Could not find a version that satisfies the requirement ohos-build"<a name="section8692735427"></a> 71 72- **现象描述** 73 74 执行“python3 -m pip install --user ohos-build”提示"Could not find a version that satisfies the requirement ohos-build" 75 76 77- **可能原因** 78 79 可能是网络环境较差导致的安装失败。 80 81- **解决办法** 82 1. 请检查网络连接是否正常。如果网络有问题，请修复网络问题后重新安装。 83 2. 若网络正常，请尝试指定临时pypi源的方式安装： 84 85 ``` 86 python3 -m pip install -i https://pypi.tuna.tsinghua.edu.cn/simple ohos-build 87 ``` 88 89### 安装python3 90 91#### 提示“configure: error: no acceptable C compiler found in $PATH”<a name="section870082884217"></a> 92 93- **现象描述** 94 95 安装python3过程中出现以下错误： 96 97 ``` 98 configure: error: no acceptable C compiler found in $PATH. See 'config.log' for more details 99 ``` 100 101- **可能原因** 102 103 环境中未安装“gcc”。 104 105- **解决办法** 106 107 1、通过命令“apt-get install gcc”在线安装。 108 109 2、完成后，重新安装python3。 110 111 112#### 提示“-bash: make: command not found”<a name="section198707170455"></a> 113 114- **现象描述** 115 116 安装python3过程中出现以下错误： 117 118 ``` 119 -bash: make: command not found 120 ``` 121 122- **可能原因** 123 124 环境中未安装“make”。 125 126- **解决办法** 127 128 1、通过命令“apt-get install make”在线安装。 129 130 2、完成后，重新安装python3。 131 132 133#### 提示“zlib not available”<a name="section85401445204518"></a> 134 135- **现象描述** 136 137 安装python3过程中出现以下错误： 138 139 ``` 140 zipimport.ZipImportError: can't decompress data; zlib not available 141 ``` 142 143- **可能原因** 144 145 环境中未安装“zlib”。 146 147- **解决办法** 148 149 方法1：通过命令“apt-get install zlib”在线安装。 150 151 方法2：如果软件源中没有该软件，请从“www.zlib.net”下载版本代码，并离线安装。 152 153  154 155 完成下载后，通过以下命令安装： 156 157 ``` 158 # tar xvf zlib-1.2.11.tar.gz 159 # cd zlib-1.2.11 160 # ./configure 161 # make && make install 162 ``` 163 164 完成后，重新安装python3。 165 166 167#### 提示“No module named '\_ctypes'”<a name="section12202694460"></a> 168 169- **现象描述** 170 171 安装python3过程中出现以下错误： 172 173 ``` 174 ModuleNotFoundError：No module named ‘_ctypes’ 175 ``` 176 177 178- **可能原因** 179 180 环境中未安装“libffi”和“libffi-devel”。 181 182 183- **解决办法** 184 185 1、通过命令“apt-get install libffi\* -y”，在线安装。 186 187 2、完成后，重新安装python3。 188 189 190### 安装kconfiglib过程中遇到lsb\_release错误<a name="section5803174135115"></a> 191 192- **现象描述** 193 194 安装kconfiglib过程中遇到如下错误打印： 195 196 ``` 197 subprocess.CalledProcessError: Command '('lsb_release', '-a')' returned non-zero exit status 1. 198 ``` 199 200- **可能原因** 201 202 lsb\_release模块基于的python版本与现有python版本不一致 203 204- **解决办法** 205 206 执行"find / -name lsb\_release"，找到lsb\_release位置并删除，如："sudo rm -rf /usr/bin/lsb\_release" 207 208 209### Linux编译服务器终端输入不识别的命令时提示“ImportError: No module named apt\_pkg”<a name="section510820516515"></a> 210 211- **现象描述** 212 213 Linux编译服务器终端输入不识别的命令时，提示"ImportError: No module named apt\_pkg" 214 215 216- **可能原因** 217 218 python3 apt安装兼容性问题。 219 220- **解决办法** 221 222 执行如下命令重新安装python3-apt。 223 224 ``` 225 sudo apt-get remove python3-apt 226 sudo apt-get install python3-apt 227 ``` 228 229### 如何将下载好的源码升级为其他分支源码 230- **场景描述** 231 232 当您的环境中已有下载好的OpenHarmony源码，需要将其升级为其他分支（例如Master）源码时，可按照如下步骤进行操作。 233 234- **操作方法** 235 236 1. 进入现有OpenHarmony根目录。 237 238 请注意该目录下包含一个隐藏目录.repo，如没有此隐藏目录，请重新解压获取的源码包，以获取完整的源码内容。 239 240 2. 使用repo init命令重新初始化源码库信息。 241 242 其中，branch表示分支名称，例如master、OpenHarmony-3.2-Beta3等。 243 ```shell 244 repo init -u https://gitee.com/openharmony/manifest -b branch --no-repo-verify 245 ``` 246 247 3. 下载更新源码文件。 248 249 ```shell 250 repo sync -c 251 repo forall -c 'pwd;git lfs pull' 252 ``` 253 如果想保持工作路径清洁，可以执行如下命令。 254 255 > **注意：** 256 >此操作会重置本地工作区，删除未被git管理的文件或目录，请谨慎操作。 257 ```shell 258 repo forall -c 'git reset --hard;git clean -fdx' 259 ``` 260 261 4. 执行prebuilts脚本，安装编译器及二进制工具。 262 263 ```shell 264 bash build/prebuilts_download.sh 265 ``` 266 267
