鸿蒙开发环境下载与配置（三）

前言

⭐️本文介绍了 Dev studio 配置和测试项目中常见问题如1.Ohpm install fail 而配置日志显示Error：excute install task failed，component ohpm.zip.以及 2.Priview filed 而运行窗口提示Unable to start the priviewer. Open PriviewerLog to check for details，并提供了高效的解决方案。

项目场景1：

基于前文的指引，我们一步步来到了最后的安装配置环节

---

问题描述

然而在 Dev studio 的安装配置过程中，可能会出现鸿蒙第三方组件 ohpm 配置失败的情形。配置界面显示基础配置失败，ohpm安装失败，我们也无法点击 Finish 完成配置。要注意的是，在配置过程中，如果选择安装由华为提供的 ohpm 组件，它要求安装文件夹是空的，我们是无法直接将文件下载解压到对应文件夹完成配置的。

如果依照可行选项回退去重新安装，会发现依然失败

---

解决方案：

这个时候我们回到窗口页面，选择Settings进入到设置界面，点击Build,Execution,Depolyment，可以看到该项目下有好几个选项，我们只需要点击鸿蒙第三方组件ohpm针对性设置即可

接下来我们可以看到如下内容

由于没有成功安装 ohpm，这里 ohpm home 路径是空的，我们可以依照 ohpm user config 中提供的路径去找到相关文件，用记事本打开查看问题原因，一般是镜像问题。要处理该问题，我们按部就班先点击 Optimize config 进行优化配置，勾选 ohpm registry 并将华为镜像地址https://repo.harmonyos.com/ohpm/填入其中，点击 OK 进入下一步

点击 Edit，将路径再次选择为此前新建好的文件夹中，点击 OK 完成该操作

再次进入 ohpm 的安装环节，重新选择 install 并更新路径为此前新建好的文件夹 Ohpm

点击 NEXT 进入安装配置环节，等待一会直接 Finish 完成配置

最终效果为

---

项目场景2：

解决配置问题后，我们往往会先测试一个项目，新建项目的步骤可以参考上一篇文章link，里面提供了详细的配置和新建项目教程。对于还未完成鸿蒙开发环境安装的同学可以参考文章https://blog.csdn.net/lp00_00/article/details/137887241

问题描述

当我们完成项目新建，在执行 Priviewer 时这个时候我们可能会发现预览失败，且窗口显示 Build task failed. Open the Run window to view details.

---

解决方案

我们可以按照提示去打开运行窗口检查详细报告

这个时候不用着急，我们选择 Settings 进入设置界面

点击 Build,Execution,Depolyment，在构建工具 Build Tools 下面选择 Hvigor

这里我们选择 Uncheck（取消勾选）构建守护进程模式

可以发现再次运行模拟器的时候预览界面正常显示

同样我们也可以切换为平板模式预览

分析与补充

🔖 经测试，上述方案只对当前构建有效，也就是说离开重启之后，我们可能仍然会遇到 Priview failed 的问题并且这个时候单对 Hvigor 的构建守护进程模式选项进行设置已然无效。这迫使我们去探寻 Dev studio 预览运行的逻辑以及寻找其他可行方案。

• 对应的日志提示为[webpack-cli] SyntaxError: Unexpected end of JSON input ...根据信息指示是预览页有缓存，此时我们清理（Clean）项目或者重构（Rebuild）项目均无法解决该问题，这时候我们需要删除 entry 文件夹下的 .preview 文件，重新预览即可。

• 对应的日志提示为Cannot preview this file. Previews are available for files in .ets, .js, .css, .hml, or .visual format, .json files of service widgets, layout.xml, AbilitySlice.java, and Ability.java.有分析认为报错的原因是：没有选中相应的.ets文件。在鸿蒙4.0中，只有 .ets 布局文件才能打开 Previewer，查看相应的UI界面。这里的提供的解决方法是双击选中 .ets 文件，如 index.ets 文件，再点击Previewer，可以成功加载。

---

总结

⭐️当然，还有一些比较少见的问题也可能会发生，必要的话会一并整理进来。😜😜😜

补充一个重要发现：

⭐️关键测试⭐️

在实测过程中，我们发现上述方法无法一劳永逸！！！正常的安装配置包括预览均应该是十分顺利的，不会出现任何差错，参考我相关文章鸿蒙开发环境下载与配置（二）。因为该文章是我用一台配置改动较少的电脑安装测试所得到的结果，全程非常完美没有任何报错！

经过两台电脑对比排查，我有理由推测各位在配置和预览过程中的报错应该跟电脑本地安装的软件有关：你应该在某种特定需求下安装了一些比较“著名”的编译类（或其他）软件 （没错，我这里点名的就是 CTex），这款软件会深刻改写覆盖系统或者用户的环境变量，继而引发 Dev studio 配置与预览的各种问题，处理方法也很简单，直接卸载掉那款软件就好。

当问题被解决后，我们甚至可以再回去执行 Settings-->build-->Build,Execution,Depolyment-->Build Tools-->Hvigor 将被取消勾选的 Enable the Daemon for tasks 勾选上了。在后续使用过程中也不会再发生前面提到的各种预览报错问题。