学习鸿蒙，你一定要熟知的这几个重要知识点？_stage与fa那个主流(1)

Mac 在不同的系统中使用不同的 shell, 使用下面命令查看自己使用的是哪一个 shell。

echo $SHELL 
1

• 如果输出结果为 /bin/bash，你的配置文件是 .bash_profile，打开文件命令 vi .bash_profile
• 如果输出结果为 /bin/zsh，你的配置文件是 .zshrc, 打开文件命令 vi .zshrc

打开配置文件，将下面的内容添加到文件末尾。记得将「用户名目录」修改为你电脑的用户名。

export HARMONY_HOME=/Users/用户名目录/Library/Huawei
export HARMONY_SDK_HOME=$HARMONY_HOME/sdk
export PATH=$HARMONY_SDK_HOME/hmscore/3.1.0/toolchains:$PATH
1
2
3

保存文件，执行下面命令立即生效。

• 如果配置文件是 .bash_profile，执行 source ~/.bash_profile
• 如果配置文件是 .zshrc，执行 source ~/.zshrc

最后验证 hdc 是否配置成功。

hdc -v
1

hdc 和 adb 一样也有一堆命令，后期我会总结好分享给大家。

在命令行中配置 ohpm

OHPM CLI 作为鸿蒙生态三方库的包管理工具，支持 OpenHarmony 共享包的发布、安装和依赖管理。这个工具在开发中经常会用到，比如在模块中依赖三方库，我们可以使用 ohpm 下载安装第三方库。所以配置好 ohpm 环境变量，方便我们在开发中使用。

打开配置文件

• 如果配置文件是 .bash_profile，执行 vi ~/.bash_profile
• 如果配置文件是 .zshrc，执行 vi ~/.zshrc

将下面的内容，添加到配置文件末尾。记得将「用户名目录」修改为你电脑的用户名。

export HARMONY_HOME=/Users/用户名目录/Library/Huawei/
export PATH=$HARMONY_HOME/ohpm/bin:$PATH
1
2

保存文件，执行下面命令立即生效。

• 如果配置文件是 .bash_profile，执行 source ~/.bash_profile
• 如果配置文件是 .zshrc，执行 source ~/.zshrc

最后验证 ohpm 是否配置成功。

ohpm -v
1

但是在下载安装 ohpm 工具包和使用 ohpm 时可能会出现不同的错误，这里列了几个常见的错误。

ohpm install failed

Error: execute install task failed, component ohpm.zip.
Error: execute 'ohpm install' failed.
1
2

这是由于 NPM 以前版本中的一个 bug 导致，运行下面的命令即可解决。

sudo chown -R 501:20 "/Users/替换为你mac的用户名/.npm"
1

ohpm registry is empty

创建 Harmony 项目之后 build 时可能出现 ohpm registry is empty 的错误。

ohpm ERROR: The registry is empty - edit .ohpmrc file or use "ohpm config set registry your_registry" command to set registry.
ohpm ERROR: Install failed  
1
2

想解决这个问题，我们需要在 DevEco Studio 中配置 ohpm 仓库的地址，按照下面的路径打开 Ohpm 窗口。

DevEco Studio -> Perferences -> Build, Execution, Deployment -> Ohpm

点击 Optimize Config 会弹出了一个界面。

在 ohpm registry 中输入 ohpm 仓库的地址并勾选。

https://repo.harmonyos.com/ohpm/
1

保存成功之后，重新 build 项目即可成功。

---

真机和模拟器无法运行

首先检查你的 DevEco Studio 版本是否是  3.1 Release，这个版本可能存在一些问题。

真机无法连接

我用 usb 连接真机，在 DevEco Studio 设备管理器中无法显示，用命令查看已经连接上了，我猜测是这个版本的问题，于是我尝试降级到 DevEco Studio 3.1 Beta2 正常了。

本地模拟器无法运行

从 DevEco Studio 3.1 开始支持两个模拟器，API 版本分别为 6、9，无论哪个模拟器都无法运行。

于是我查看了 鸿蒙的开发文档 DevEco Studio >=3.1 本地模拟器仅支持以下系统中运行。

• Windows 系统：内存推荐为 16GB 及以上。
• macOS 系统：内存推荐为 8GB 及以上。如果是 ARM 版本的 macOS，macOS 版本需在 12.2 及以上，否则将无法运行本地模拟器。

但是我的 macOS 的版本是 12.5.1 不仅本地模拟器无法运行，而且真机连接了也无法显示。

我猜测这个问题应该也是 DevEco Studio 版本的原因，于是我尝试降级到 DevEco Studio 3.1 Beta2，成功运行 DevEco Studio 支持的模拟器。

但是这里需要注意的是如果你的 macOS >=10.14 and macOS < 12.2  只能运行 API 版本是 6 的模拟器。

如果有遇到和我一样问题的小伙伴，可以采用临时方案，尝试降级 DevEco Studio 版，等待官方解决吧。

如何解决安装错误

好不容易解决了开发工具的问题，满心欢喜想运行鸿蒙应用体验一下，结果安装应用时报错了，让我喝杯茶压压惊。

这是因为运行的设备（模拟器和真机）和 SDK 版本的不匹配，因此会报 INSTALL_PARSE_FAILED_USESDK_ERROR 错误。

想解决这个问题，需要将 compileSdkVersion 和 compatibleSdkVersion 以及 SDK 版本需要与运行设备的 apiVersion 对应起来。

但是我们不能简单修改配置文件中 compileSdkVersion 和 c ompatibleSdkVersion 的版本号，因为使用不同的 HarmonyOS Sdk 版本，创建的 HarmonyOS 工程的目录结构和开发语言都不相同。

• API Version 4~7 构建体系是由 Gradle 构建工具和构建插件组成，不要基于这个版本去开发，不然后期从 Gradle 迁移到 Hvigor 是件非常痛苦的事
• API Version 8~9 构建体系是由 Hvigor 构建工具和构建插件组成

开发语言也不一样：

• API Version >= 9 仅仅支持 ArkTS
• API Version == 8 支持 ArkTS 和 JS
• API Version == 7 支持 ArkTS 、 JS 和 Java
• API Version < 7 支持 JS 和 Java

所以我们不能简单的修改  compileSdkVersion 和 compatibleSdkVersion 的版本，对于我们初学者，如果出现这个问题，建议重新创建一个新的工程。

新建项目时 Compile Sdk 应该选择与你运行的设备（模拟器和真机） apiVersion 相对应的版本号。

---

如何查看运行的设备（模拟器和真机） apiVersion 的版本

这里我们需要用到 hdc 工具，hdc 的配置在前面已经介绍过了，hdc 的用法等价于 adb，hdc 如何使用，后期我会总结好分享给大家。

hdc shell
getprop hw_sc.build.os.apiversion
1
2

输出结果即是设备（模拟器和真机） apiVersion 的版本。

运行项目常见错误

当我以为一切都正常的时候，运行项目，有出现了一个新的错误，真令人崩溃，跑起一个项目怎么这么难。

对应的错误信息。

{
  instancePath: 'app.compileSdkVersion',
  keyword: 'exclusiveMinimum',
  params: { comparison: '>', limit: 7 },
  message: 'must be > 7',
  location: '/Users/用户名目录/Documents/codebase/harmonyOs/Application/build-profile.json5:4:27'
}
1
2
3
4
5
6
7

这是因为创建的是 Hvigor 工程，而 Hvigor 工程支持最低的 apiVersion 版本是 7，而我修改了 apiVersion 的版本 < 7, 因此运行的时候会出现上面的错误。因此我们应该选择 Compile Sdk 和你运行设备（模拟器和真机） apiVersion 相对应的版本号。

在鸿蒙模拟器，运行 Android 应用

Android 同学都体验过 Android Studio 自带的模拟器是多么的难用，网上也有很多 Android 模拟器，但是安装的门槛高，而且安装好了运行会出现很多问题，体验也不是那么的好。

DevEco Studio 提供的模拟器，相比于其它的模拟器，非常的好用，Android 同学可以在下载体验一下，在鸿蒙的模拟器上安装 Android 应用，对于简单的应用体验还是可以的。而且 DevEco Studio 的模拟器安装非常的简单。

如何安装鸿蒙的模拟器

按照图示方式打开 Device Manager。

点击 New Emulator 按钮，按照图示，操作即可。

如何安装 Android 应用到鸿蒙的模拟器

我们可以使用 adb 命令安装，也可以点击  Android Studio 上运行按钮

，直接将 Android 应用安装到鸿蒙模拟器。

但是我们需要修改 Android 项目支持的 CPU/API 版本。因为 Harmony 的模拟器 CPU/API 是 x86，所以需要在 build.gradle 文件中添加 x86 的支持。

自我介绍一下，小编13年上海交大毕业，曾经在小公司待过，也去过华为、OPPO等大厂，18年进入阿里一直到现在。

深知大多数HarmonyOS鸿蒙开发工程师，想要提升技能，往往是自己摸索成长或者是报班学习，但对于培训机构动则几千的学费，着实压力不小。自己不成体系的自学效果低效又漫长，而且极易碰到天花板技术停滞不前！

因此收集整理了一份《2024年HarmonyOS鸿蒙开发全套学习资料》，初衷也很简单，就是希望能够帮助到想自学提升又不知道该从何学起的朋友，同时减轻大家的负担。

既有适合小白学习的零基础资料，也有适合3年以上经验的小伙伴深入学习提升的进阶课程，基本涵盖了95%以上HarmonyOS鸿蒙开发知识点，真正体系化！

由于文件比较大，这里只是将部分目录大纲截图出来，每个节点里面都包含大厂面经、学习笔记、源码讲义、实战项目、讲解视频，并且会持续更新

如果你觉得这些内容对你有帮助，可以添加VX：vip204888 （备注鸿蒙获取）

一个人可以走的很快，但一群人才能走的更远。不论你是正从事IT行业的老鸟或是对IT行业感兴趣的新人，都欢迎扫码加入我们的的圈子（技术交流、学习资源、职场吐槽、大厂内推、面试辅导），让我们一起学习成长！

料，也有适合3年以上经验的小伙伴深入学习提升的进阶课程，基本涵盖了95%以上HarmonyOS鸿蒙开发知识点，真正体系化！**

由于文件比较大，这里只是将部分目录大纲截图出来，每个节点里面都包含大厂面经、学习笔记、源码讲义、实战项目、讲解视频，并且会持续更新

如果你觉得这些内容对你有帮助，可以添加VX：vip204888 （备注鸿蒙获取）
[外链图片转存中…(img-pr38Yz6K-1712895532034)]

一个人可以走的很快，但一群人才能走的更远。不论你是正从事IT行业的老鸟或是对IT行业感兴趣的新人，都欢迎扫码加入我们的的圈子（技术交流、学习资源、职场吐槽、大厂内推、面试辅导），让我们一起学习成长！