跳到主要内容

集成 SDK

游戏侧需要按照本文步骤以正确集成 OmniSDK HarmonyOS。

开始集成​

添加 SDK 依赖​

  • 在 ohpm 配置文件 .ohpmrc 文件中添加以下配置：
    • 在 registry 中添加世游 OHPM 私有仓库地址 https://ohpm.kingamer.cn/repos/ohpm
    • 添加 AccessToken 配置 //ohpm.kingamer.cn/repos/ohpm/:_read_auth=<readOnlyToken>
提示
  • .ohpmrc 文件内其他配置保持默认即可，无需修改，尤其要确保 strict_ssl 选项保持为 true。
  • 访问世游 OHPM 私有仓库的 AccessToken 由世游团队在游戏接入前通过邮件提供。
  • 修改模块级 entry/oh-package.json5 文件，在 dependencies 字段下追加所需 OmniSDK 的模块依赖及版本信息，格式如下：
{
  "dependencies": {
    // 已有三方库依赖
    "@omnisdk/omnisdk": "0.1.0", // OmniSDK 对外 API 及业务
    "@omnisdk/huawei": "0.1.0"   // 华为游戏联运
  }
}
  • 在 DevEco Studio Terminal 中，执行 ohpm install 命令安装配置的依赖。
提示

若需自行在命令行中执行 ohpm install 命令，需要提前安装 ohpm 并配置环境变量，请参考 鸿蒙官方指南。

配置文件​

project_config.json 配置文件放在工程目录 AppScope/resources/rawfile/shiyou 目录下。

提示

project_config.json 配置文件由世游团队在游戏接入前通过邮件提供。

游戏图标和名称​

参考 鸿蒙官方指南 配置正确的游戏图标和游戏名称。

游戏包名​

参考 鸿蒙官方指南 配置正确的游戏包名。

compatibleSdkVersion​

修改工程级 build-profile.json5 文件，将 app -> products -> compatibleSdkVersion 字段设置为 5.0.4(16)。

华为账号登录配置​

在工程目录 entry/src/main/module.json5 文件 module -> metadata 字段中新增 client_id 和 app_id 配置。

提示

配置所需的 client_id 与 app_id 参数由世游团队在游戏接入前通过邮件提供。

"module": {
  "name": "entry",
  "type": "xxx",
  "description": "xxxx",
  "mainElement": "xxxx",
  "deviceTypes": [],
  "pages": "xxxx",
  "abilities": [],
  "metadata": [ // 配置如下信息
    {
      "name": "client_id",
      "value": "xxxxxx" // Client ID 由世游团队通过邮件提供给游戏方
    },
    {
      "name": "app_id",
      "value": "xxxxxx" // APP ID 由世游团队通过邮件提供给游戏方
    }
  ]
}

签名密钥​

签名密钥由世游团队在游戏接入前通过邮件提供。包括：

  • debug 与 release 类型的 keystore 密钥（.p12）、别名及密码
  • debug 与 release 类型的数字证书文件（.cer）
  • debug 、internal_testing 及 release 类型的 Profile 文件（.p7b）
提示

若游戏方需要使用世游的调试证书进行调试，请提前将使用的调试设备 UDID 及对应机型信息提供给世游团队，我们将把这些设备添加到调试用的 Profile 文件中。

构建​

  • 使用 DevEco Studio -> Build -> BuildHap(s)/App(s) 进行构建（若已配置好签名密钥信息，则构建出的程序包也会被签名）
  • 使用 hvigorw 构建工具对工程进行构建（构建出的程序包是没有签名的，需要对未签名的程序包使用签名工具 hap_sign_tool.jar 签名）

签名​

使用调用签名工具 hap_sign_tool.jar 对未签名产物（HAP/APP）进行签名，可参考 鸿蒙官方指南。

最后于 更新