開發者如果電腦處于完全無網環境，可以參考下面文檔進行相關配置

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 點擊運行工程