助力 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

相关推荐
两水先木示6 小时前
【Unity3D】实现可视化链式结构数据(节点数据)
unity·可视化编辑器工具·unity编辑器自定义窗口
王源骏7 小时前
unity接入coze智能体
unity·游戏引擎
每日出拳老爷子9 小时前
【Unity】【VR开发】实现VR屏幕共享应用的几个重要插件和参考资料分享
unity·游戏引擎·vr
向宇it12 小时前
【从零开始入门unity游戏开发之——C#篇10】循环结构——while、do-while、for、foreach的使用
java·开发语言·vscode·unity·c#·游戏引擎
浅陌sss12 小时前
Unity UI SafeArea适配
ui·unity·游戏引擎
Xiao_Chen____12 小时前
Unity 组件学习记录:Aspect Ratio Fitter
学习·unity·游戏引擎
冒泡P13 小时前
Unity中的委托和事件(UnityAction、UnityEvent)
unity·游戏引擎
林枫依依13 小时前
Unity超优质动态天气插件(含一年四季各种天气变化,可用于单机局域网VR)
unity·游戏引擎·vr·动态天气插件·一年四季
benben04416 小时前
Unity3D仿星露谷物语开发5之角色单例模式
unity·单例模式·游戏引擎