讯享网

                <p id="34JCMPRT">随着团结引擎从 1.0.0 迭代至 1.3.0，越来越多的开发者开始使用团结引擎开发<strong>OpenHarmony</strong>应用。此前我们已经向广大开发者分享与（点击可跳转回顾）。</p><p id="34JCMPRU">在开发的过程中，我们也收到了大量反馈，尤其是在日志、堆栈和性能数据方面，这些信息对开发和调试过程至关重要。同时，我们注意到，越来越多的应用尝试<strong>接入登录、支付、推送和广告等 SDK</strong>，以便上架并丰富 OpenHarmony 生态。</p><p id="34JCMPRV">结合广大开发者的反馈以及引擎 OpenHarmony 团队自身的开发经验，为了帮助移动端应用更快速地适配这一崭新的平台，提高开发效率与效果，我们在团结引擎中隆重推出两个全新工具包：<strong>OpenHarmony Hilog Package</strong>和<strong>OpenHarmony SDK Kits Package</strong>。</p><p id="34JCMPS0">下文将详细介绍如何快速上手体验，欢迎广大开发者前来下载使用，共同推动<strong>Tuanjie OpenHarmony</strong>的发展！</p><p id="34JCMPS3"><strong>OpenHarmony Hilog Package  (v1.0.0)</strong></p><p id="34JCMPS6">支持 Tuanjie Editor OpenHarmony 平台连接真机实时查看 log、内存，还原堆栈等，v1.0.0 主要功能包括：</p><p><ul><li id="34JCMQ08"></p><p id="34JCMPS7">Editor 支持直连 OpenHarmony 真机；</p><p></li><li id="34JCMQ09"></p><p id="34JCMPS8">支持实时按需显示/筛选 log；</p><p></li><li id="34JCMQ0A"></p><p id="34JCMPS9">支持还原堆栈，帮助快速定位问题；</p><p></li><li id="34JCMQ0B"></p><p id="34JCMPSA">支持显示实时内存占用，支持计算自定义时间间隔内平均消耗；</p><p></li><li id="34JCMQ0C"></p><p id="34JCMPSB">支持抓取 ArkUI Dump 文件。</p><p></li></ul></p><p id="34JCMPSC"><strong>1、下载安装、连接真机</strong></p><p id="34JCMPSD">推荐使用<strong>Tuanjiie 1.3.0 及以上版本</strong>Editor。</p><p id="34JCMPSE">在 Tuanjie Editor 中，通过顶部导航栏：Windows &gt;&gt; Package Manger，打开 Package Manager，点击左上角，切换为：Unity Registry，在搜索框中输入：“<strong>Hilog</strong>”，即可检索到 OpenHarmony Hilog Package，点击“Install”，Editor 会自动进行下载安装。</p><p class="f_center"><img src="https://nimg.ws.126.net/?url=http%3A%2F%2Fdingyue.ws.126.net%2F2024%2F1028%2F71362065j00sm2eim0056d200u000gjg00u000gj.jpg&thumbnail=660x2147483647&quality=80&type=jpg"/><br/></p><p id="34JCMPSG">安装完成后，通过顶部导航栏：Windows &gt;&gt; Analysis &gt;&gt; OpenHarmony Hilog，即可打开该操作界面。</p><p id="34JCMPSH">我们提供有线和无线两种连接方式，支持同时连接多台设备，可以使用数据线直接连接 OpenHarmony 设备和 Tuanjie Editor，当打开 OpenHarmony Hilog 窗口时，Tuanjie 会<strong>自动连接</strong>OpenHarmony 设备，也可以手动输入 ip 地址进行无线连接。</p><p class="f_center"><img src="https://nimg.ws.126.net/?url=http%3A%2F%2Fdingyue.ws.126.net%2F2024%2F1028%2F1271dea8j00sm2ein000zd200u0009og00u0009o.jpg&thumbnail=660x2147483647&quality=80&type=jpg"/><br/></p><p id="34JCMPSJ"><strong>2、Hilog</strong></p><p id="34JCMPSK">连接到 OpenHarmony 真机后，hilog 窗口会<strong>自动刷新并实时显示设备上的 log 信息</strong>。窗口被划分为 3 个区域，顶部可以进行切换设备、筛选包体、筛选 log level、筛选 tag 等操作，来精准筛选所需 log 信息。同时支持自定义输入内容进行准确查找，支持模糊搜索和正则匹配。</p><p id="34JCMPSL">页面中间会实时显示筛选出的 log 信息，同时点击右键，支持 log 保存、自定义 tag 等操作。</p><p class="f_center"><img src="http://dingyue.ws.126.net/2024/1028/f1e3e6e5g00sm2eip057md200sq00hsg00sq00hs.gif"/><br/>‍<br/></p><p id="34JCMPSN"><strong>3、Stacktrace Utility‍</strong></p><p id="34JCMPSO">Stacktrace Utility 窗口帮助开发者<strong>一键还原堆栈</strong>，无需借助三方软件，在窗口内直接粘贴堆栈信息，点击按钮直接匹配符号表快速还原堆栈，一键还原崩溃现场，快速定位问题。支持自定义符号表文件路径、后缀等。</p><p class="f_center"><img src="http://dingyue.ws.126.net/2024/1028/4e1da1eag00sm2eir04x5d200sq00hsg00sq00hs.gif"/><br/></p><p id="34JCMPSQ"><strong>4、Memory</strong></p><p id="34JCMPSR">Memory 窗口支持<strong>实时跟踪</strong>为当前所选应用分配的内存。可以定期自动捕获所选应用的内存快照。也可以统计一段自定义时间的内存占用数据，包括峰值及均值。</p><p class="f_center"><img src="https://nimg.ws.126.net/?url=http%3A%2F%2Fdingyue.ws.126.net%2F2024%2F1028%2F7161a5aej00sm2eis002zd200u000jug00u000ju.jpg&thumbnail=660x2147483647&quality=80&type=jpg"/><br/></p><p id="34JCMPST"><strong>5、ArkUI Dump</strong></p><p id="34JCMPSU">ArkUI Dump 窗口可以捕获 OpenHarmony 设备上前台应用程序的 ArkUI Dump 文件，以帮助了解应用程序的 ArkUI 组件和结构。成功连接真机后，点击“Get ArkUI Dump on Screen”，窗口将<strong>自动捕获</strong>当前设备前台页面的 ArkUI 结构，可一键保存。</p><p class="f_center"><img src="http://dingyue.ws.126.net/2024/1028/aded2dc7g00sm2eiu03h5d200sq00hsg00sq00hs.gif"/><br/></p><p><blockquote id="34JCMQ0F">OpenHarmony Hilog 详细文档可点击查看： https://docs.unity.cn/cn/tuanjiemanual/1.3/Manual/openharmony-hilog-introduction.html</blockquote></p><p id="34JCMPT2"><strong>OpenHarmony SDK Kits Package (Beta v0.0.1)</strong></p><p id="34JCMPT5">帮助 OpenHarmony 开发者快速接入一系列常用场景 SDK，默认提供 Settings 配置面板，内置 Demo Scene，集成各场景下 SDK 接入的完整 API 调用流程，<strong>可直接导出/打包，在真机上运行，开箱即用，首个 Beta 版本已接入 Accout&amp;GameService、IAP、Push。Ads、Notification 等接入预计于近期版本发布</strong>，敬请期待！</p><p id="34JCMPT6">Beta v0.0.1 主要功能包括：</p><p id="34JCMPT7"><strong>• Settings 面板：</strong></p><p id="34JCMPT8">￮ 提供接入 SDK Kits 的公共配置项填写，和 Player Settings 保持同步变更；</p><p id="34JCMPT9">￮ 可勾选一键接入 SDK Kit，支持各 SDK Kit 定制化配置项填写，支持一键打开 Demo Scene，体验接入全流程。</p><p id="34JCMPTA"><strong><strong>•</strong></strong><strong>Demo Scenes：</strong></p><p id="34JCMPTB">￮ Account &amp; GameService Demo 覆盖初始化、登入/登出、绑定/解绑 Player，验证 Player 信息并上报、Game Performance 初始化及更新等；</p><p id="34JCMPTC">￮ IAP Demo 覆盖验证支付环境、查询各种类商品信息、完整购买流程、完整订阅流程；</p><p id="34JCMPTD">￮ Push Demo 支持获取 Token，支持模拟发送 Push message 并接收 Push message。</p><p id="34JCMPTE"><strong>1、下载安装</strong></p><p id="34JCMPTF">推荐使用<strong>Tuanjiie 1.3.0</strong>及以上版本 Editor。</p><p id="34JCMPTG">在 Tuanjie Editor 中，通过顶部导航栏：Windows &gt;&gt; Package Manger，打开 Package Manager，点击左上角“+”号，选择“Add package by name”，输入“<strong>cn.tuanjie.openharmony.sdkkit</strong>”，即可检索到 OpenHarmony SDK Kits Package，点击“Install”，Editor 会自动进行下载安装。</p><p class="f_center"><img src="https://nimg.ws.126.net/?url=http%3A%2F%2Fdingyue.ws.126.net%2F2024%2F1028%2Fbb86ddc7j00sm2eix0059d200u000h1g00u000h1.jpg&thumbnail=660x2147483647&quality=80&type=jpg"/><br/></p><p id="34JCMPTI">完成安装后，可以通过顶部的“OpenHarmonySDKKits”选项访问 Tuanjie Editor 中的 Setting 面板，在 Setting 面板中，可以直接填入接入所需的 client id、app id、bundle name 等信息，填入后，会<strong>自动同步并配置</strong>到项目及后续导出工程中需要这些参数的位置，无需多次修改。</p><p id="34JCMPTJ">Settings 面板中，可以直接勾选应用需要接入的具体 SDK，如 Account &amp; Game service 等。支持打开各 SDK 对应的内置 Demo 场景查看，<strong>Demo</strong><strong>场景中已经完成各</strong><strong>SDK</strong><strong>的接入及全流程必须的接口调用</strong>，支持直接导出 DevEco 工程及真机测试，可直接在 demo 场景上二次开发或参考对应脚本自行接入。</p><p class="f_center"><img src="https://nimg.ws.126.net/?url=http%3A%2F%2Fdingyue.ws.126.net%2F2024%2F1028%2Fbd9bdce2j00sm2eix001vd200u000emg00u000em.jpg&thumbnail=660x2147483647&quality=80&type=jpg"/><br/></p><p id="34JCMPTL"><strong>2、Account &amp; Game Service Kit</strong></p><p id="34JCMPTM">Account &amp; Game Service 中，已内置接入所需的全流程，每个按钮对应不同的接口及功能，包括：</p><p id="34JCMPTN"><strong>• Account &amp; Game Service 相关：</strong></p><p id="34JCMPTO">￮ 初始化游戏服务：点击后调用 init 接口，初始化游戏服务；</p><p id="34JCMPTP">￮ 登录：点击调用 unionLogin 接口进行联名登录，会弹出二级窗口询问登录方法，登录成功后返回获取的玩家 ID、needBinding、accountName 等信息；</p><p id="34JCMPTQ">￮ 注销：点击订阅并触发注销事件；</p><p id="34JCMPTR">￮ 绑定玩家：点击调用 bindPlayer 接口，将玩家 ID 与游戏官方账号绑定，并上报绑定结果；</p><p id="34JCMPTS">￮ 验证玩家：点击调用 verifyLocalPlayer 接口进行合规性验证，账号服务会验证当前设备的实名认证和游戏防沉迷控制状态，若验证失败会返回相应的错误码；</p><p id="34JCMPTT">￮ 保存玩家信息：合规性检查成功后，当玩家创建角色时，点击调用 savePlayerRole 上报玩家的角色信息。</p><p id="34JCMPTU"><strong>• Game Performance 相关：</strong></p><p id="34JCMPTV">￮ 初始化：点击调用 init 接口，初始化游戏场景感知；</p><p id="34JCMPU0">￮ 获取设备信息：点击调用 on 接口订阅设备状态变化事件，获取设备状态变化通知（如设备温控等级）；</p><p id="34JCMPU1">￮ 更新游戏信息：点击调用 updateGameInfo接口上报游戏信息。</p><p class="f_center"><img src="http://dingyue.ws.126.net/2024/1028/c43d9215g00sm2eiz01ojd200ri00hsg00ri00hs.gif"/><br/></p><p id="34JCMPU3"><strong>3、IAP Kit</strong></p><p id="34JCMPU4">接入应用内支付前，需要在<strong>AppGallery</strong>配置并上架商品信息，并将商品信息及对应的商品类型填入 OpenHarmony SDK Kits Settings 窗口内：</p><p class="f_center"><img src="https://nimg.ws.126.net/?url=http%3A%2F%2Fdingyue.ws.126.net%2F2024%2F1028%2F63767351j00sm2eiz0019d200u00095g00u00095.jpg&thumbnail=660x2147483647&quality=80&type=jpg"/><br/></p><p id="34JCMPU6">Demo 场景中已内置接入 IAP Kit 所需的全流程，每个按钮对应不同的接口及功能，包括：</p><p id="34JCMPU7"><strong><strong>•</strong>通用查询：</strong></p><p id="34JCMPU8">￮ 验证支付环境：点击向 IAP Kit 发送 queryEnvironmentStatus 请求，判断用户当前登录账号的服务所在地是否在 IAP Kit 支持结算的国家/地区；</p><p id="34JCMPU9">￮ 查询订阅商品：点击调用 queryProducts 获取 AppGallery Connect 上配置的商品信息，返回订阅的商品信息 Products 列表，包括商品价格、名称、描述等；</p><p id="34JCMPUA">￮ 查询可消耗商品：点击调用 queryProducts 获取 AppGallery Connect 上配置的商品信息，返回可消耗的商品信息 Products 列表，包括商品价格、名称、描述等；</p><p id="34JCMPUB">￮ 查询不可消耗商品：点击调用 queryProducts 获取 AppGallery Connect上 配置的商品信息，返回不可消耗的商品信息 Products 列表，包括商品价格、名称、描述等。</p><p id="34JCMPUC"><strong><strong>•</strong>订阅及购买全流程：</strong></p><p id="34JCMPUD">￮ 创建购买：点击显示一个窗口，其中包含可购买的消耗品和非消耗品。然后发送 createPurchase 请求以调出 IAP Kit 收银台；</p><p id="34JCMPUE">￮ 创建订阅：点击显示一个窗口，其中包含可订阅的订阅商品。然后发送 createPurchase 请求以调出 IAP Kit 收银台；</p><p id="34JCMPUF">￮ 检查购买信息：点击调用 queryPurchases 查看本次购买的结果；</p><p id="34JCMPUG">￮ 完成购买或订阅：点击发送 FinishPurchase 请求以确认发货，通知 IAP 服务器更新商品的发货状态，并完成购买流程。</p><p class="f_center"><img src="http://dingyue.ws.126.net/2024/1028/7e22f1a2g00sm2ej001w5d200ri00hsg00ri00hs.gif"/><br/></p><p id="34JCMPUI"><strong>4、Push Kit</strong></p><p id="34JCMPUJ">在常见的应用推送场景中，推送消息应该由服务器发送，由客户端接收。为了演示整个推送流程，我们在 Demo 中也内置了发送推送消息的功能。</p><p id="34JCMPUK">Demo场景中已内置接入 Push Kit 所需的全流程，每个按钮对应不同的接口及功能，包括：</p><p><ul><li id="34JCMQ0D"></p><p id="34JCMPUL">标题、正文、Push 按钮：如果没有服务器，可以输入推送消息的标题及正文，然后点击推送，模拟发送消息；</p><p></li><li id="34JCMQ0E"></p><p></li></ul></p><p class="f_center"><img src="http://dingyue.ws.126.net/2024/1028/f26196cbg00sm2ej4038ed200ri00hsg00ri00hs.gif"/><br/></p><p><blockquote id="34JCMQ0G">OpenHarmony SDK Kits 详细文档可点击查看： https://docs.unity.cn/cn/tuanjiemanual/1.3/Manual/openharmony-sdkkits-introduction.html</blockquote></p><p id="34JCMPUO">以上，Hilog Package 和SDK Kits Package 已在引擎内正式发布，欢迎广大开发者下载体验。我们期待收到更多反馈，让我们一起为 Tuanjie OpenHarmony 的成长贡献力量！</p><p id="34JCMPUR"><strong>下载与反馈渠道</strong></p><p id="34JCMPUU">OpenHarmony Package下载方式：</p><p id="34JCMPUV">• OpenHarmony Hilog Package  (v1.0.0)：Tuanjie Editor (1.3.0及以上) &gt;&gt; windows &gt;&gt; package manager &gt;&gt; 切换至Unity Registry &gt;&gt;<strong>搜索“Hilog”</strong></p><p id="34JCMPV0">• OpenHarmony SDK Kits Package  (Beta v0.0.1)：Tuanjie Editor (1.3.0及以上) &gt;&gt; windows &gt;&gt; package manager &gt;&gt; 点击左上角“+”号 &gt;&gt; 点击“Add package by name” &gt;&gt;<strong>输入“cn.tuanjie.openharmony.sdkkit”</strong></p><p id="34JCMPV1">反馈渠道：</p><p id="34JCMPV2">• Tuanjie editor 内直接反馈：Tuanjie Editor &gt;&gt; Help &gt;&gt; Report a Bug</p><p id="34JCMPV3">• 官方社区直接提问（推荐）：https://developer.unity.cn/plate/tuanjie-engine （添加 OpenHarmony 标签）</p><p id="34JCMPV4">团结引擎是 Unity 中国的引擎研发团队基于 Unity 2022 LTS 版本为中国开发者定制的实时 3D 引擎；基于 Unity 的核心能力，团结引擎团队倾听中国开发者的声音和需求，为团结引擎加入了一些中国开发者需要的定制化功能，并会在未来持续不断为中国开发者量身定制需要的功能。</p><p id="34JCMPV5">团结引擎 1.3.1 版本现已发布，欢迎点击阅读原文下载体验或至官网了解产品详情。</p><p id="34JCMPV6">[1]团结引擎官网：</p><p id="34JCMPV7">https://unity.cn/tuanjie/tuanjieyinqing</p><p id="34JCMPV8">[2]团结引擎问答专区：</p><p id="34JCMPV9">https://developer.unity.cn/plate/tuanjie-engine?tab=ask</p><p id="34JCMPVF"><strong>Unity 官方微信</strong></p><p id="34JCMPVG">第一时间了解Unity引擎动向，学习进阶开发技能</p><p id="34JCMPVO">每一个“在看”，都是我们前进的动力</p><p class="f_center"><img src="http://dingyue.ws.126.net/2024/1028/1366e238g00sm2ejg0005d000b400b4g.gif"/><br/></p>