离线环境配置指导
========

如果开发者所使用的电脑处于完全无网络的离线环境中，需要先在一台可访问网络的电脑上准备好以下文件，将这些文件拷贝到无网络电脑中。

#### 安装hypium

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

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

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

[配置环境变量并打开命令行工具](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-commandline-get#section17776863449)，执行ohpm install命令，会生成oh\_modules文件夹和oh-package-lock.json5文件。

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/a7/v3/YgzKo9upT1qzSWexxVRBiA/zh-cn_image_0000002624994487.png?HW-CC-KV=V1&HW-CC-Date=20260709T132834Z&HW-CC-Expire=86400&HW-CC-Sign=7385956CEA238FEAE18A4610B30325C9CCB945C1D7930DAE637260896E108D93)

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

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/cc/v3/CkC8ranoQ8aaXrZ4vE7-RQ/note_3.0-zh-cn.png?HW-CC-KV=V1&HW-CC-Date=20260709T132834Z&HW-CC-Expire=86400&HW-CC-Sign=90B1AE2EEBC8D8EB8C5687BD64F1D77ED9622E088C77AE1D7BF4F36ABBC36A86)

有网环境和无网环境下使用的ohpm版本需保持一致，否则可能导致oh-package-lock.json5文件不生效。

#### 安装三方库

通过如下两种方式使用三方库：

*   方式一：使用[ohpm-repo](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-ohpm-repo)搭建私仓，将需要依赖的三方包发布至私仓中，并将[.ohpmrc文件](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-ohpmrc#zh-cn_topic_0000001792216397_文件)中的registry配置项的值替换为该私仓地址，以此从私仓中获取依赖。
*   方式二：在可访问网络的电脑上创建一个空文件夹（如命名为third\_library），在文件夹中创建一个oh-package.json5文件，设置三方包依赖，配置示例如下：
    
    {
      "dependencies": {
        "@ohos/hypium": "1.0.17",
        "@ohos/lottie": "^2.0.0" 
      }
    }
    
    打开命令行工具，执行ohpm install命令，会生成oh\_modules文件夹和oh-package-lock.json5文件。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/59/v3/TNYAA47zTxaeop0kuquklw/zh-cn_image_0000002625074627.png?HW-CC-KV=V1&HW-CC-Date=20260709T132834Z&HW-CC-Expire=86400&HW-CC-Sign=F3600327BF998F1432CD43C12F2B0EB9A9FC32B5A88E638DFBEB8907941A8C21)
    
    将oh\_modules文件夹和oh-package-lock.json5文件拷贝到无网络电脑的工程根目录下。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/de/v3/zhJudwuvRjWp8YKKnS1Zfw/caution_3.0-zh-cn.png?HW-CC-KV=V1&HW-CC-Date=20260709T132834Z&HW-CC-Expire=86400&HW-CC-Sign=D79B9EB41AC93F5CFC77061939ACF03824F4F15940B14ECDF6D98D85C389A1F7)
    
    使用方法二时，需要确保可访问网络的电脑与无网络电脑中ohpm版本是一致的，以避免因oh-package-lock.json5文件版本不匹配而导致oh-package-lock.json5文件失效的问题。
    

#### 部署模拟器

请参考[离线部署模拟器](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-emulator-no-network)。