基于已有工程使用 ohpmrc 接入

本文介绍如何基于 ohpmrc 快速接入 mPaaS。

前置条件

• 已安装 HarmonyOS NEXT 最新版开发环境，支持 API 12 以上版本。

• 已有鸿蒙 3.0.0.22 以上版本真机或模拟器，模拟器使用场景请参考 鸿蒙模拟器。

• 已在控制台创建应用，并下载了 HarmonyOS NEXT 版本 .config 配置文件。更多信息，参见 在控制台创建应用并获取 HarmonyOS NEXT config 配置文件（beta）。

接入步骤

1. 将 .config 配置文件重命名为 mpaas.config 并拷贝到 App 主工程的 entry 的 resource 目录下的 rawfile 中。

   

2. 配置 ohpmrc 文件，在项目 entry/module 根目录（oh-package.json5 同级）和项目的根目录均新建 .ohpmrc 文件。

   

   配置文件内容为：

   @mpaas:registry=https://mpaas-ohpm.oss-cn-hangzhou.aliyuncs.com/meta

3. 在 oh-package.json5 中配置所需依赖。

   {
     "license": "",
     "devDependencies": {},
     "author": "",
     "name": "entry",
     "description": "Please describe the basic information.",
     "main": "",
     "version": "1.0.0",
     "dependencies": {
       "@mpaas/udid": "0.0.1"
     }
   }
   

4. 配置 oh-package.json5 文件。

5. 添加 mPaaS 组件依赖，例如："@mpaas/udid": "0.0.1"，其中 mpaas/udid 为组件名称，更多组件名称可参考下方的组件列表。

   组件配置	版本号	说明
   @mpaas/framework	0.0.2	移动框架：提供初始化、基础信息、userId 统一配置等。
   @mpaas/upgrade	0.0.2	升级发布：提供便捷的主动检测升级的服务，可用于日常灰度发布、线上新版本更新提示。更多组件使用详情请参考 发布管理接入 HarmonyOS NEXT（beta）。
   @mpaas/configservice	0.0.2	开关配置：根据 key 从服务端拉取对应的 value，可动态控制客户端逻辑。更多组件使用详情请参考 实时发布开关配置接入 HarmonyOS NEXT（beta）。
   @mpaas/rpc	0.0.2	移动网关：提供 RPC 调用等功能。更多组件使用详情请参考 移动网关接入 HarmonyOS NEXT（beta）。
   @mpaas/sync-service	0.0.2	数据同步：长连接服务。更多组件使用详情请参考 数据同步接入 HarmonyOS NEXT（beta）。
   @mpaas/masadapter	0.0.2	移动分析：行为日志、自动化日志、Crash 日志、性能日志分析。更多组件使用详情请参考 移动分析接入 HarmonyOS NEXT（beta）。
   @mpaas/trace-log	0.0.2	诊断日志：支持写入本地日志，通过控制台可拉取。更多组件使用详情请参考 HarmonyOS NEXT 客户端诊断（beta）。
   @mpaas/push	0.0.2	消息推送，更多组件使用详情请参考 消息推送接入 HarmonyOS NEXT（beta）。
   @mpaas/hriver	0.0.5-2406210000.11	H5 容器与离线包：H5 容器，支持前端与 native 交互。更多组件使用详情请参考 H5容器和离线包接入 HarmonyOS NEXT（beta）。
   @mpaas/udid	0.0.2	设备标识：简单快捷地获取设备 ID，以利于应用程序安全有效的找到特定设备。更多组件使用详情请参考 设备标识接入 HarmonyOS NEXT（beta）。
   @mpaas/datacenter	0.0.2	统一存储：提供安全、快速、可加密、支持多种数据类型的 KV 存储。更多组件使用详情请参考 统一存储接入 HarmonyOS NEXT（beta）。
   @mpaas/scanapp	0.0.4	扫一扫：快速识别二维码、条形码。更多组件使用详情请参考 扫一扫接入 HarmonyOS NEXT（beta）。