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

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

DevEco Studio(5.0.2)开发环境一览：

一、下载DevEco Studio（5.0.2 Release）工具

• 方式一：联网下载，适合身边有一台能上网的电脑
• 方式二：直接使用附件中的固定版本安装包

方式一（联网下载）：

1. 需要一台可访问网络的电脑

2. 访问下载地址（需登录华为账号）：

DevEco Studio下载

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像素及以上

开始安装

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

   image.png

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

   
   
   image.png

3 单击Finish完成安装

image.png

image.png

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

image.png

sdk路径：

image.png

OpenHarmony全量SDK下载地址

三、配置环境变量

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

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)]

3 签名配置：

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

  
  
  image.png

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

  
  
  image.png

• 3.点击OK

• 4 点击运行工程

  
  
  image.png