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

相关推荐
RReality4 小时前
【Unity Shader URP】Matcap 材质捕捉实战教程
java·ui·unity·游戏引擎·图形渲染·材质
魔士于安4 小时前
unity urp材质球大全
游戏·unity·游戏引擎·材质·贴图·模型
南無忘码至尊7 小时前
Unity学习90天 - 第 6 天 -学习物理 Material + 重力与阻力并实现弹跳球和冰面滑动效果
学习·unity·游戏引擎
mxwin9 小时前
Unity 单通道立体渲染(Single Pass Instanced)对 Shader 顶点布局的特殊要求
unity·游戏引擎·shader
魔士于安12 小时前
unity 低多边形 无人小村 木质建筑 晾衣架 盆子手推车,桌子椅子,罐子,水井
游戏·unity·游戏引擎·贴图·模型
RReality12 小时前
【Unity Shader URP】简易卡通着色(Simple Toon)实战教程
ui·unity·游戏引擎·图形渲染·材质
魔士于安12 小时前
unity 骷髅人 连招 武器 刀光 扭曲空气
游戏·unity·游戏引擎·贴图·模型
瑞瑞小安15 小时前
Unity功能篇:文本框随文字内容动态调整
ui·unity
南無忘码至尊15 小时前
Unity学习90天-第7天-学习委托与事件(简化版)
学习·unity·游戏引擎
君莫愁。15 小时前
【Unity】解决UGUI的Button无法点击/点击无反应的排查方案
unity·c#·游戏引擎·解决方案·ugui·按钮·button