助力 Tuanjie OpenHarmony 开发：如何使用工具包 Hilog 和 SDK Kits Package？

随着团结引擎从 1.0.0 迭代至 1.3.0，越来越多的开发者开始使用团结引擎开发 OpenHarmony 应用。

在开发的过程中，我们也收到了大量反馈，尤其是在日志、堆栈和性能数据方面，这些信息对开发和调试过程至关重要。同时，我们注意到，越来越多的应用尝试接入登录、支付、推送和广告等 SDK，以便上架并丰富 OpenHarmony 生态。

结合广大开发者的反馈以及引擎 OpenHarmony 团队自身的开发经验，为了帮助移动端应用更快速地适配这一崭新的平台，提高开发效率与效果，我们在团结引擎中隆重推出两个全新工具包：OpenHarmony Hilog Package 和 OpenHarmony SDK Kits Package。

下文将详细介绍如何快速上手体验，欢迎广大开发者前来下载使用，共同推动 Tuanjie OpenHarmony 的发展！

OpenHarmony Hilog Package (v1.0.0)

支持 Tuanjie Editor OpenHarmony 平台连接真机实时查看 log、内存，还原堆栈等，v1.0.0 主要功能包括：

• Editor 支持直连 OpenHarmony 真机；

• 支持实时按需显示/筛选 log；

• 支持还原堆栈，帮助快速定位问题；

• 支持显示实时内存占用，支持计算自定义时间间隔内平均消耗；

• 支持抓取 ArkUI Dump 文件。

1、下载安装、连接真机

推荐使用 Tuanjiie 1.3.0 及以上版本 Editor。

在 Tuanjie Editor 中，通过顶部导航栏：Windows >> Package Manger，打开 Package Manager，点击左上角，切换为：Unity Registry，在搜索框中输入：“Hilog”，即可检索到 OpenHarmony Hilog Package，点击“Install”，Editor 会自动进行下载安装。

安装完成后，通过顶部导航栏：Windows >> Analysis >> OpenHarmony Hilog，即可打开该操作界面。

我们提供有线和无线两种连接方式，支持同时连接多台设备，可以使用数据线直接连接 OpenHarmony 设备和 Tuanjie Editor，当打开 OpenHarmony Hilog 窗口时，Tuanjie 会自动连接 OpenHarmony 设备，也可以手动输入 ip 地址进行无线连接。

 2、Hilog

连接到 OpenHarmony 真机后，hilog 窗口会自动刷新并实时显示设备上的 log 信息。窗口被划分为 3 个区域，顶部可以进行切换设备、筛选包体、筛选 log level、筛选 tag 等操作，来精准筛选所需 log 信息。同时支持自定义输入内容进行准确查找，支持模糊搜索和正则匹配。

页面中间会实时显示筛选出的 log 信息，同时点击右键，支持 log 保存、自定义 tag 等操作。

3、Stacktrace Utility

Stacktrace Utility 窗口帮助开发者一键还原堆栈，无需借助三方软件，在窗口内直接粘贴堆栈信息，点击按钮直接匹配符号表快速还原堆栈，一键还原崩溃现场，快速定位问题。支持自定义符号表文件路径、后缀等。

4、Memory

Memory 窗口支持实时跟踪为当前所选应用分配的内存。可以定期自动捕获所选应用的内存快照。也可以统计一段自定义时间的内存占用数据，包括峰值及均值。

5、ArkUI Dump

ArkUI Dump 窗口可以捕获 OpenHarmony 设备上前台应用程序的 ArkUI Dump 文件，以帮助了解应用程序的 ArkUI 组件和结构。成功连接真机后，点击“Get ArkUI Dump on Screen”，窗口将自动捕获当前设备前台页面的 ArkUI 结构，可一键保存。

OpenHarmony Hilog 详细文档可点击查看： https://docs.unity.cn/cn/tuanjiemanual/1.3/Manual/openharmony-hilog-introduction.html

OpenHarmony SDK Kits Package (Beta v0.0.1)

帮助 OpenHarmony 开发者快速接入一系列常用场景 SDK，默认提供 Settings 配置面板，内置 Demo Scene，集成各场景下 SDK 接入的完整 API 调用流程，可直接导出/打包，在真机上运行，开箱即用，首个 Beta 版本已接入 Accout&GameService、IAP、Push。Ads、Notification 等接入预计于近期版本发布，敬请期待！

Beta v0.0.1 主要功能包括：

• Settings 面板：

￮ 提供接入 SDK Kits 的公共配置项填写，和 Player Settings 保持同步变更；

￮ 可勾选一键接入 SDK Kit，支持各 SDK Kit 定制化配置项填写，支持一键打开 Demo Scene，体验接入全流程。

• Demo Scenes：

￮ Account & GameService Demo 覆盖初始化、登入/登出、绑定/解绑 Player，验证 Player 信息并上报、Game Performance 初始化及更新等；

￮ IAP Demo 覆盖验证支付环境、查询各种类商品信息、完整购买流程、完整订阅流程；

￮ Push Demo 支持获取 Token，支持模拟发送 Push message 并接收 Push message。

1、下载安装

推荐使用 Tuanjiie 1.3.0 及以上版本 Editor。

在 Tuanjie Editor 中，通过顶部导航栏：Windows >> Package Manger，打开 Package Manager，点击左上角“+”号，选择“Add package by name”，输入“cn.tuanjie.openharmony.sdkkit”，即可检索到 OpenHarmony SDK Kits Package，点击“Install”，Editor 会自动进行下载安装。

完成安装后，可以通过顶部的“OpenHarmonySDKKits”选项访问 Tuanjie Editor 中的 Setting 面板，在 Setting 面板中，可以直接填入接入所需的 client id、app id、bundle name 等信息，填入后，会自动同步并配置到项目及后续导出工程中需要这些参数的位置，无需多次修改。

Settings 面板中，可以直接勾选应用需要接入的具体 SDK，如 Account & Game service 等。支持打开各 SDK 对应的内置 Demo 场景查看，Demo 场景中已经完成各 SDK 的接入及全流程必须的接口调用，支持直接导出 DevEco 工程及真机测试，可直接在 demo 场景上二次开发或参考对应脚本自行接入。

2、Account & Game Service Kit

Account & Game Service 中，已内置接入所需的全流程，每个按钮对应不同的接口及功能，包括：

• Account & Game Service 相关：

￮ 初始化游戏服务：点击后调用 init 接口，初始化游戏服务；

￮ 登录：点击调用 unionLogin 接口进行联名登录，会弹出二级窗口询问登录方法，登录成功后返回获取的玩家 ID、needBinding、accountName 等信息；

￮ 注销：点击订阅并触发注销事件；

￮ 绑定玩家：点击调用 bindPlayer 接口，将玩家 ID 与游戏官方账号绑定，并上报绑定结果；

￮ 验证玩家：点击调用 verifyLocalPlayer 接口进行合规性验证，账号服务会验证当前设备的实名认证和游戏防沉迷控制状态，若验证失败会返回相应的错误码；

￮ 保存玩家信息：合规性检查成功后，当玩家创建角色时，点击调用 savePlayerRole 上报玩家的角色信息。

• Game Performance 相关：

￮ 初始化：点击调用 init 接口，初始化游戏场景感知；

￮ 获取设备信息：点击调用 on 接口订阅设备状态变化事件，获取设备状态变化通知（如设备温控等级）；

￮ 更新游戏信息：点击调用 updateGameInfo接口上报游戏信息。

3、IAP Kit

接入应用内支付前，需要在 AppGallery 配置并上架商品信息，并将商品信息及对应的商品类型填入 OpenHarmony SDK Kits Settings 窗口内：

Demo 场景中已内置接入 IAP Kit 所需的全流程，每个按钮对应不同的接口及功能，包括：

• 通用查询：

￮ 验证支付环境：点击向 IAP Kit 发送 queryEnvironmentStatus 请求，判断用户当前登录账号的服务所在地是否在 IAP Kit 支持结算的国家/地区；

￮ 查询订阅商品：点击调用 queryProducts 获取 AppGallery Connect 上配置的商品信息，返回订阅的商品信息 Products 列表，包括商品价格、名称、描述等；

￮ 查询可消耗商品：点击调用 queryProducts 获取 AppGallery Connect 上配置的商品信息，返回可消耗的商品信息 Products 列表，包括商品价格、名称、描述等；

￮ 查询不可消耗商品：点击调用 queryProducts 获取 AppGallery Connect上 配置的商品信息，返回不可消耗的商品信息 Products 列表，包括商品价格、名称、描述等。

• 订阅及购买全流程：

￮ 创建购买：点击显示一个窗口，其中包含可购买的消耗品和非消耗品。然后发送 createPurchase 请求以调出 IAP Kit 收银台；

￮ 创建订阅：点击显示一个窗口，其中包含可订阅的订阅商品。然后发送 createPurchase 请求以调出 IAP Kit 收银台；

￮ 检查购买信息：点击调用 queryPurchases 查看本次购买的结果；

￮ 完成购买或订阅：点击发送 FinishPurchase 请求以确认发货，通知 IAP 服务器更新商品的发货状态，并完成购买流程。

4、Push Kit

在常见的应用推送场景中，推送消息应该由服务器发送，由客户端接收。为了演示整个推送流程，我们在 Demo 中也内置了发送推送消息的功能。

Demo场景中已内置接入 Push Kit 所需的全流程，每个按钮对应不同的接口及功能，包括：

• 标题、正文、Push 按钮：如果没有服务器，可以输入推送消息的标题及正文，然后点击推送，模拟发送消息；

• 获取 token：点击获取推送 token。

• 

OpenHarmony SDK Kits 详细文档可点击查看：https://docs.unity.cn/cn/tuanjiemanual/1.3/Manual/openharmony-sdkkits-introduction.html

以上，Hilog Package 和SDK Kits Package 已在引擎内正式发布，欢迎广大开发者下载体验。我们期待收到更多反馈，让我们一起为 Tuanjie OpenHarmony 的成长贡献力量！

下载与反馈渠道

OpenHarmony Package下载方式：

• OpenHarmony Hilog Package (v1.0.0)：Tuanjie Editor (1.3.0及以上) >> windows >> package manager >> 切换至Unity Registry >> 搜索“Hilog”

• OpenHarmony SDK Kits Package (Beta v0.0.1)：Tuanjie Editor (1.3.0及以上) >> windows >> package manager >> 点击左上角“+”号 >> 点击“Add package by name” >> 输入“cn.tuanjie.openharmony.sdkkit”

反馈渠道：

• Tuanjie editor 内直接反馈：Tuanjie Editor >> Help >> Report a Bug

• 官方社区直接提问（推荐）：https://developer.unity.cn/plate/tuanjie-engine （添加 OpenHarmony 标签）

团结引擎是 Unity 中国的引擎研发团队基于 Unity 2022 LTS 版本为中国开发者定制的实时 3D 引擎；基于 Unity 的核心能力，团结引擎团队倾听中国开发者的声音和需求，为团结引擎加入了一些中国开发者需要的定制化功能，并会在未来持续不断为中国开发者量身定制需要的功能。

团结引擎 1.3.1 版本现已发布，欢迎点击阅读原文下载体验或至官网了解产品详情。

[1]团结引擎官网：

https://unity.cn/tuanjie/tuanjieyinqing

[2]团结引擎问答专区：

https://developer.unity.cn/plate/tuanjie-engine?tab=ask