HarmonyOS Next-DevEco Studio(5.0
开发者如果电脑处于完全无网环境，可以参考下面文档进行相关配置
DevEco Studio(5.0.2)开发环境一览：
| 工具 | 版本 |
|---|---|
| DevEco Studio | 5.0.2 |
| openHarmonySDK | 14 |
| ohpm | 5.0.11 |
| node.js | 18.20.1 |
| hypium | 1.0.21 |
一、下载DevEco Studio（5.0.2 Release）工具
- 方式一：联网下载，适合身边有一台能上网的电脑
- 方式二：直接使用附件中的固定版本安装包
方式一（联网下载）：
1. 需要一台可访问网络的电脑
2. 访问下载地址（需登录华为账号）：
3. 根据当前系统版本，下载对应软件
image.png
方式二（本地安装包）：
使用附件压缩包中下载好的DevEco Studio (5.0.2)
image.png
二、安装DevEco Studio
DevEco Studio支持Windows和macOS系统。
Windows环境
运行环境要求
为保证DevEco Studio正常运行，建议电脑配置满足如下要求：
- 操作系统：Windows10 64位、Windows11 64位
- 内存：16GB及以上
- 硬盘：100GB及以上
- 分辨率：1280*800像素及以上
开始安装
-
双击下载的“deveco-studio-xxxx.exe”，进入DevEco Studio安装向导。
在如下界面选择安装路径，默认安装于C:\Program Files路径下，也可以单击浏览（B）...指定其他安装路径，然后单击Next。
image.png
-
在如下安装选项界面勾选DevEco Studio后，单击Next，直至安装完成：
image.png
3 单击Finish完成安装
image.png
image.png
解压安装后的DevEco Studio文件夹工具路径：
image.png
sdk路径：
image.png
三、配置环境变量
方式一（使用附件中的插件）
1.配置ohpm环境变量
解压附件中ohpm-5.0.11压缩包
image.png
-
Windows环境变量设置方法：
在此电脑 > 属性 > 高级系统设置 > 高级 > 环境变量中，在系统或者用户的PATH变量中，添加ohpm安装位置下bin文件夹的路径。
image.png
- macOS环境变量设置方法：
打开终端工具，执行以下命令。
export OHPM_HOME=/home/xx/Downloads/ohpm #本处路径请替换为ohpm的安装路径。默认路径为:/home/xx/Downloads/DevEco Studio解压目录\tools\ohpm
export PATH=$OHPM_HOME/bin:$PATH
配置完以后命令行执行 ohpm -v，查看配置是否成功
2.配置Node.js（npm）环境变量
-
2.1解压附件中node18.20.2.zip压缩包
image.png
- 2.2 Windows环境变量设置方法：
在系统或者用户的PATH变量中，添加Node.js安装位置的路径。
image.png
- 2.3 macOS环境变量设置方法：
打开终端工具，执行以下命令。
export NODE_HOME=/home/xx/Downloads/node-vxx.xx.x-linux-x64 #本处路径请替换为Node.js的安装路径（默认路径为$DevEco Studio安装目录\tools\node下）
export PATH=$NODE_HOME/bin:$PATH
- 2.4 配置完以后命令行执行 npm -v，查看配置是否成功
3.配置安装pnpm插件
方式一（使用附件中的插件）
-
1.解压附件中 pnpm.zip 压缩包
image.png
-
2.将解压后的node_modules文件夹和package.json文件拷贝到无网络电脑的C:\Users\用户名目录.hvigor\wrapper\tools下（若当前无该目录，请手动创建）。
image.png
- 3.在无网络电脑上执行如下命令，设置npm离线模式
npm config set offline true
方式二（需要联网生成）
- 1.请在可访问网络的电脑上创建一个空文件夹，在文件夹中创建一个package.json文件，在文件中填写如下内容：
{
"dependencies": {
"pnpm": "8.13.1"
}
}
-
2.打开命令行工具，在文件夹下执行 npm install 命令，会生成node_modules文件夹。
image.png
-
3.将node_modules文件夹和package.json文件拷贝到无网络电脑的
C:\Users\用户名目录\.hvigor\wrapper\tools下（若当前无该目录，请手动创建）。
image.png
- 4.在无网络电脑上执行如下命令，设置npm离线模式：
npm config set offline true
四、无网络环境配置
- 方式一：本地har包形式，适合完全没有网络的环境。
- 方式二：适合身边有一台能联网的电脑，灵活性更高。
方式一（本地har包形式）
1. 使用DevEco Studio创建一个新的OpenHarmony空工程
image.png
2.在工程根目录创建har(名字可以自己定义)文件夹
image.png
3.解压缩附件中的har压缩包
image.png
4.将需要的har包复制到创建的har文件夹下
新工程必须的har包：
- hypium-1.0.21.har
image.png
5.在工程根目录oh-package.json5中引用依赖的har包
image.png
6.在工程根目录创建oh-package-lock.json5文件
- 内容：可以为空
-
目的：oh-package-lock.json5用于锁定所有依赖的版本，以及缓存依赖的元数据信息。
image.png
方式二（远程依赖方式）
前提：需要先在一台可访问网络的电脑上准备好以下文件，将这些文件拷贝到无网络电脑中。
1.安装hypium
-
工程模板的工程级oh-package.json5文件中默认配置了hypium依赖，因此需要安装hypium，如果配置了其他依赖，也可参考以下步骤安装。
image.png
- 在可访问网络的电脑上创建一个空文件夹（如命名为third_library），在文件夹中创建一个oh-package.json5文件，配置hypium依赖，配置如下：
{ "dependencies": { "@ohos/hypium": "1.0.21" } } - 先配置环境变量，再打开命令行工具，执行 ohpm install 命令，会生成oh_modules文件夹和oh-package-lock.json5文件。
[图片上传失败...(image-9afbfb-1746004020343)]
image.png
image.png
-
将oh_modules文件夹和oh-package-lock.json5文件拷贝到无网络电脑的工程根目录下。
image.png
image.png
2.安装三方库
- 1.在可访问网络的电脑上创建一个空文件夹（如命名为third_library），在文件夹中创建一个oh-package.json5文件，设置三方包依赖，配置示例如下：
{
"dependencies": {
"@ohos/hypium": "1.0.21",
"@ohos/lottie": "^2.0.0"
}
}
-
2.打开命令行工具，执行 ohpm install 命令，会生成oh_modules文件夹和oh-package-lock.json5文件。
image.png
image.png
-
3.将oh_modules文件夹和oh-package-lock.json5文件拷贝到无网络电脑的工程根目录下。
注意
image.png
五、运行工程
1 找到对应设备或者模拟器
- 注意：在开发板上运行项目需要将runtimeos字段修改为：OpenHarmony
[图片上传失败...(image-8f0487-1746004020343)]
2 SDK路径设置
- 解压缩附件sdk压缩包
- 附件压缩包中包含了harmonyOS sdk和openHarmony sdk 10
- 依次点击 File-Setting-Open Harmony SDK
- 设置sdk对应路径
- openHarmonySDK
[图片上传失败...(image-f85719-1746004020343)]
- openHarmonySDK
3 签名配置：
-
1.打开项目左上角File-Project Structure
image.png
-
2.选中Signing Configs,进行签名配置
image.png
- 3.点击OK
-
4 点击运行工程
image.png
