接入 mPaaS 能力

引入依赖

1. 在项目的 .ohpmrc 中添加如下仓库。

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

2. 参考接入文档中 oh-package.json5 中添加 "@mpaas/framework":"0.0.2" 安装框架依赖。

3. 参考接入文档中 oh-package.json5 中添加 "@mpaas/cpp-shared":"1.0.0"安装 libc++_shared.so依赖，如果您引入了第三方其他依赖包含了此二进制文件，请不要重复安装。

下载配置

在 mPaaS AppCenter 控制台上，下载 HarmonyOS NEXT 相关的配置文件，改名为 mpaas.config 并放入 entry 工程的 rawfile 中。

初始化与使用

参看 鸿蒙官方文档 AbilityStage 组件容器 手动新建一个 ArkTs 文件 EntryAbilityStage。

在 AbilityStage 的 onCreate 回调初始化框架。

import AbilityStage from '@ohos.app.ability.AbilityStage';
import { MPFramework } from '@mpaas/framework';

export default class EntryAbilityStage extends AbilityStage {
  async onCreate() {
    const app = this.context;
    MPFramework.create(app);
    const instance: MPFramework = MPFramework.instance;
    const ctx: Context = instance.context
    // 进行其他组件的初始化
  }
}

切记要在 module.json5 中注册该 AbilityStage。

{
  "module": {
    "name": "entry",
    "type": "entry",
    "description": "$string:module_desc",
    "mainElement": "EntryAbility",
    "srcEntry": "./ets/EntryAbilityStage.ets",
  }
}

相关 API

• 获取 udid：MPFramework.instance.udid

  重要

  该接口为异步接口，调用时添加 await。

• 设置/获取 userId：MPFramework.instance.userId

• 设置/获取 appSecret：MPFramework.instance.appSecret