HarmonyOS Next-DevEco Studio(5.0.2)无网络环境配置（详细教程）

开发者如果电脑处于完全无网环境，可以参考下面文档进行相关配置

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. 访问下载地址（需登录华为账号）：

DevEco Studio下载

3. 根据当前系统版本，下载对应软件


方式二（本地安装包）：

使用附件压缩包中下载好的DevEco Studio (5.0.2)

二、安装DevEco Studio

DevEco Studio支持Windows和macOS系统。

Windows环境

运行环境要求

为保证DevEco Studio正常运行，建议电脑配置满足如下要求：

• 操作系统：Windows10 64位、Windows11 64位
• 内存：16GB及以上
• 硬盘：100GB及以上
• 分辨率：1280*800像素及以上

开始安装

1. 双击下载的“deveco-studio-xxxx.exe”，进入DevEco Studio安装向导。
   在如下界面选择安装路径，默认安装于C:\Program Files路径下，也可以单击浏览（B）...指定其他安装路径，然后单击Next。

  !

2. 在如下安装选项界面勾选DevEco Studio后，单击Next，直至安装完成：
   
   3 单击Finish完成安装
   


解压安装后的DevEco Studio文件夹工具路径：

sdk路径：

OpenHarmony全量SDK下载地址

三、配置环境变量

方式一（使用附件中的插件）

1.配置ohpm环境变量

解压附件中ohpm-5.0.11压缩包

• Windows环境变量设置方法：
  在此电脑 > 属性 > 高级系统设置 > 高级 > 环境变量中，在系统或者用户的PATH变量中，添加ohpm安装位置下bin文件夹的路径。
  

• 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压缩包
  

  • 2.2 Windows环境变量设置方法：
    在系统或者用户的PATH变量中，添加Node.js安装位置的路径。
    

  • 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 压缩包
  

• 2.将解压后的node_modules文件夹和package.json文件拷贝到无网络电脑的C:\Users\用户名目录.hvigor\wrapper\tools下（若当前无该目录，请手动创建）。
  

• 3.在无网络电脑上执行如下命令，设置npm离线模式

npm config set offline true

方式二（需要联网生成）

• 1.请在可访问网络的电脑上创建一个空文件夹，在文件夹中创建一个package.json文件，在文件中填写如下内容：

{
  "dependencies": {
    "pnpm": "8.13.1"
  }
}

• 2.打开命令行工具，在文件夹下执行 npm install 命令，会生成node_modules文件夹。
  

• 3.将node_modules文件夹和package.json文件拷贝到无网络电脑的C:\Users\用户名目录\.hvigor\wrapper\tools下（若当前无该目录，请手动创建）。
  

• 4.在无网络电脑上执行如下命令，设置npm离线模式：

npm config set offline true

四、无网络环境配置

• 方式一：本地har包形式，适合完全没有网络的环境。
• 方式二：适合身边有一台能联网的电脑，灵活性更高。

方式一（本地har包形式）

1. 使用DevEco Studio创建一个新的OpenHarmony空工程


2.在工程根目录创建har(名字可以自己定义)文件夹


3.解压缩附件中的har压缩包


4.将需要的har包复制到创建的har文件夹下

新工程必须的har包：
- hypium-1.0.21.har

5.在工程根目录oh-package.json5中引用依赖的har包


6.在工程根目录创建oh-package-lock.json5文件

• 内容：可以为空
• 目的：oh-package-lock.json5用于锁定所有依赖的版本，以及缓存依赖的元数据信息。

方式二（远程依赖方式）

前提：需要先在一台可访问网络的电脑上准备好以下文件，将这些文件拷贝到无网络电脑中。

1.安装hypium

• 工程模板的工程级oh-package.json5文件中默认配置了hypium依赖，因此需要安装hypium，如果配置了其他依赖，也可参考以下步骤安装。
  

• 在可访问网络的电脑上创建一个空文件夹（如命名为third_library），在文件夹中创建一个oh-package.json5文件，配置hypium依赖，配置如下：

  {
    "dependencies": {
      "@ohos/hypium": "1.0.21"
    }
  }
  

• 先配置环境变量，再打开命令行工具，执行 ohpm install 命令，会生成oh_modules文件夹和oh-package-lock.json5文件。
  


• 将oh_modules文件夹和oh-package-lock.json5文件拷贝到无网络电脑的工程根目录下。
  


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文件。
  


• 3.将oh_modules文件夹和oh-package-lock.json5文件拷贝到无网络电脑的工程根目录下。
  注意


五、运行工程

1 找到对应设备或者模拟器

• 注意：在开发板上运行项目需要将runtimeos字段修改为：OpenHarmony
  

2 SDK路径设置

• 解压缩附件sdk压缩包
• 附件压缩包中包含了harmonyOS sdk和openHarmony sdk 10
• 依次点击 File-Setting-Open Harmony SDK
• 设置sdk对应路径
  • openHarmonySDK
    

3 签名配置：

• 1.打开项目左上角File-Project Structure
  

• 2.选中Signing Configs,进行签名配置
  

• 3.点击OK

• 4 点击运行工程