随着团结引擎从 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 按钮:如果没有服务器,可以输入推送消息的标题及正文,然后点击推送,模拟发送消息;
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
Unity 官方微信
第一时间了解Unity引擎动向,学习进阶开发技能
每一个“在看”,都是我们前进的动力
热门跟贴