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

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

#### 安装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/6e/v3/2Zjz6iS_Ty62LuWLqZY1JA/zh-cn_image_0000002624994487.png?HW-CC-KV=V1&HW-CC-Date=20260612T073826Z&HW-CC-Expire=86400&HW-CC-Sign=E0AA8E8A044CB28FD56AD26B79A1DC3AE7005E4123092AD38697BD5E1A71A050)

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

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/be/v3/J0JTWWH9SueWnX7Q64FKUw/note_3.0-zh-cn.png?HW-CC-KV=V1&HW-CC-Date=20260612T073826Z&HW-CC-Expire=86400&HW-CC-Sign=96BD4E826095D96B8739712FD35697097C46426374BC0A014EFD1E84BBB059E3)

有网环境和无网环境下使用的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/0/v3/0eyhwCcpRjqC249WAD_5Gg/zh-cn_image_0000002625074627.png?HW-CC-KV=V1&HW-CC-Date=20260612T073826Z&HW-CC-Expire=86400&HW-CC-Sign=E845721010EC473DBD8B135C3E6E87826C8CCBD64CA588AB9F93AFF4D68CBFA5)
    
    将oh\_modules文件夹和oh-package-lock.json5文件拷贝到无网络电脑的工程根目录下。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/b5/v3/CnINjgq5SwqiHJzYuvL1pQ/caution_3.0-zh-cn.png?HW-CC-KV=V1&HW-CC-Date=20260612T073826Z&HW-CC-Expire=86400&HW-CC-Sign=CC9069C93D1F961A5AB1CEAE4BB1FC1D9AA9EAACDC59A51D814CD22CE5E8EF5D)
    
    使用方法二时，需要确保可访问网络的电脑与无网络电脑中ohpm版本是一致的，以避免因oh-package-lock.json5文件版本不匹配而导致oh-package-lock.json5文件失效的问题。
    

#### 部署模拟器

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