mac上搭建鸿蒙开发环境（2024）

朱雀 2024-05-08 06:55 99阅读 0赞

## 开发环境 ##

设备 MacBook Pro

芯片 Apple M1

系统 11.4

内存 16 GB

## 一、**下载公开版本的DevEco Studio** ##

华为官方目前对外提供的版本是DevEco Studio 3.1，可在官网下载https://developer.huawei.com/consumer/cn/deveco-studio/

因为目前还在学习阶段，先装一个开放版本的DevEco Studio 3.1试试。

选择对应电脑系统的压缩包。

![1217fcca48824357b32333ff342fca08.png][]

解压后是一个dmg文件，拖拽将DevEco Studio 拷贝到应用程序

![e93597ff269b4535b49f05fd26e522e5.png][]

### 1.应用配置 ###

打开应用后，选择agree

![cf8a3ed45fde48959b44008374809205.png][]

然后这里应该弹出一些setup弹窗，但是我走到这一步的时候没有弹出，后面打开DevEcoStudio的时候才弹。

按理说此处需要进行以下设置：

*  nodejs：Node.js版本要求为v14.19.1及以上，且低于v17.0.0，对应的npm版本要求为6.14.16及以上
 *  ohpm：全称是：Open Harmony Package Manager 作为包管理和发布的标准，Haromony自研工具
 *  sdk路径 PS：HarmonyOS SDK路径中不能包含中文字符
 *  为HDC端口号设置环境变量
 *  安装中间提示要先安装ohpm，下载ohpm并添加环境变量

如果跟我一样在这一步没有弹出弹窗的话，也不用着急，后面再进行配置也一样。

### 2.打开DevEcoStudio ###

点击create project，弹窗提示应用开发环境存在问题，运行诊断测试

![7879cfd559a441a284586ebdaf9cd7ab.png][]

诊断后发现我的nodejs,ohpm,sdk路径等没有设置，也就是缺失了上面提到的那步。

![776d895a349f498ab4d87249d9178a7f.png][]

点击Set it up now，弹出设置弹窗。

![f35e18d2c3ed4503b44e98b3d2833e34.png][]

这里看一下nodejs的版本要求，我电脑上的nodejs不符合要求，也为了避免版本问题，所以这里选择install，然后点击next

![946f60e0b50f4da0a07d487ea67858d2.png][]

ohpm也选择install，然后点击next

![57a50a64296e40ecb30417082dc5da20.png][]

然后是sdk设置

![1873511b4851427c9e6bef5a6b274c94.png][]

选择accept，然后点击next。

最后环境诊断是全绿色的状态就可以了。

![071294691ee44ba4b9bce11824591594.png][]

### 3.工程配置 ###

点击crreate project进入选择模版，选择第一个template，手机悬浮在上方的时候会显示可选择的设备，选择第一个。

![0094588b496e4b228fbd6af2f3ef4410.png][]

进入工程配置界面

![237e22132e734b419c69cdbd32726540.png][]

### 4.安装设备 ###

点击no devices 点开device manager

![8204be6b78884e31a86cd2ebc172b7eb.png][]

然后安装模拟器，点击右下方的 `+ New Emulator`，弹出选择硬件的窗口，点击 Next

![a62b572c7dd749ecaf377cd71a55528c.png][]

![613c6ecbd80b4ef59e463d0d1a23b5f0.png][]

进入选择 系统镜像的窗口，点击 Name 旁边的 下载按钮，进入下载 下载完成后，点击右下角的 Finish

![9cc5eb55c0c34efb8a8af3067c9fbd74.png][]

安装完成，进入以下界面

点击finish

![217c0b4ee18641b7b3ca699bc6ca41af.png][]

点击绿色按钮启动设备

![d0e9eb46e796480a89576542130ff36c.png][]

遇到一个问题，点击之后没有反应

![5dcf8d204ab24ce0ab1e0d46d4661986.png][]

launch New\_Device\_from\_Huawei\_Phone timeout, Please manually confirm

查了一下这种情况

根据qemu.log、qemu-err.log、Emulator.log日志分析，是mac系统的版本太低导致。

系统版本不兼容，需要12.2以上

### 5.运行工程 ###

设备选择刚才的模拟器，点击右侧运行按钮在模拟器上运行工程。

DevEco Studio 3.1是API9

在鸿蒙适配开发工作中，如果需要使用API11（API9支持的能力有限），API11版本目前还未公开，只有认证开发者能够下载使用，下面也介绍下载最新api版本套件的方法。

## 二、**下载最新API版本的套件** ##

认证华为开发者，下载开发套件

在官网用邮箱注册一个华为开发者账号；

https://developer.harmonyos.com/deveco-developer-suite/enabling/kit?currentPage=1&pageSize=100

然后再次点开这个链接，进入开发者认证，选择个人开发者，进行实名认证，认证需要2-3个工作日，实测快的话就三四个小时；

认证通过后，再次点开此链接，申请鸿蒙开发套件，也需要2-3工作日审批；

申请通过后，再次点开此链接，就会展示出各版本的开发套件，选择适合自己电脑版本的DevEcoStudio（仅需要下载 IDE，实际里面包含了 SDK 等工具）

![4a4b68314066401ca9a92b3021bfff2b.png][]

解压刚才下载的文件后，点击dmg文件进行安装；

然后解压sdk，不要自行用zip工具解压，在DevEco Studio欢迎页面中，点击左下角的齿轮按钮，弹出框中选择Unzip，source path选择刚才文件中sdk文件夹中的sdk的zip包。

配置sdk路径

点击左上角 DevEco Studio 中，弹出框中选择 “Preferences”

将 HarmonyOS Location 配置为上一个步骤解压的目标位置

[1217fcca48824357b32333ff342fca08.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/05/08/af4c4a0630c146d6bcacceff9258eb24.png
[e93597ff269b4535b49f05fd26e522e5.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/05/08/6d47da4dcf3c4eb68f69f6726cfeb050.png
[cf8a3ed45fde48959b44008374809205.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/05/08/4540f96527954e63a9d782875943f52a.png
[7879cfd559a441a284586ebdaf9cd7ab.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/05/08/0bdd85e528084c35a0996b9c434f7cb2.png
[776d895a349f498ab4d87249d9178a7f.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/05/08/df70e85cba41428ba3d9a1c5e7612072.png
[f35e18d2c3ed4503b44e98b3d2833e34.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/05/08/fdab269331bb4a82b1ea1ab008b4207f.png
[946f60e0b50f4da0a07d487ea67858d2.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/05/08/226bbbf0d15d4456a7b60d680d267167.png
[57a50a64296e40ecb30417082dc5da20.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/05/08/3cbd930fd23243758639e5730a9c8adf.png
[1873511b4851427c9e6bef5a6b274c94.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/05/08/ac0e80ea8a234d49bb7bb099b01855e1.png
[071294691ee44ba4b9bce11824591594.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/05/08/ca32736cbd7e43769f08e609192a943a.png
[0094588b496e4b228fbd6af2f3ef4410.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/05/08/5fd15c22f8c9404092d7e4d0d761cf67.png
[237e22132e734b419c69cdbd32726540.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/05/08/3981360bd54d4a70ae835723f8243745.png
[8204be6b78884e31a86cd2ebc172b7eb.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/05/08/878face72b5e4862b408dffb4f46d208.png
[a62b572c7dd749ecaf377cd71a55528c.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/05/08/88f8f8f1cc2845118b412f72abaa9650.png
[613c6ecbd80b4ef59e463d0d1a23b5f0.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/05/08/60e7583793634f3488daced63d145d64.png
[9cc5eb55c0c34efb8a8af3067c9fbd74.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/05/08/31087cc7e92e451a93a98add6c0d7583.png
[217c0b4ee18641b7b3ca699bc6ca41af.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/05/08/2380596ce08d4aabaec51b5f52c6caaa.png
[d0e9eb46e796480a89576542130ff36c.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/05/08/3003ac45d09b4dc08b435d8f87526193.png
[5dcf8d204ab24ce0ab1e0d46d4661986.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/05/08/54e92b180d2b4066babbf28ecc296e91.png
[4a4b68314066401ca9a92b3021bfff2b.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/05/08/46a98fe0ffc54a29ba3abfcba3a847dc.png