隨著團結(jié)引擎從 1.0.0 迭代至 1.3.0，越來越多的開發(fā)者開始使用團結(jié)引擎開發(fā)OpenHarmony應用。此前我們已經(jīng)向廣大開發(fā)者分享與（點擊可跳轉(zhuǎn)回顧）。

在開發(fā)的過程中，我們也收到了大量反饋，尤其是在日志、堆棧和性能數(shù)據(jù)方面，這些信息對開發(fā)和調(diào)試過程至關重要。同時，我們注意到，越來越多的應用嘗試接入登錄、支付、推送和廣告等 SDK，以便上架并豐富 OpenHarmony 生態(tài)。

結(jié)合廣大開發(fā)者的反饋以及引擎 OpenHarmony 團隊自身的開發(fā)經(jīng)驗，為了幫助移動端應用更快速地適配這一嶄新的平臺，提高開發(fā)效率與效果，我們在團結(jié)引擎中隆重推出兩個全新工具包：OpenHarmony Hilog Package和OpenHarmony SDK Kits Package。

下文將詳細介紹如何快速上手體驗，歡迎廣大開發(fā)者前來下載使用，共同推動Tuanjie OpenHarmony的發(fā)展！

OpenHarmony Hilog Package (v1.0.0)

支持 Tuanjie Editor OpenHarmony 平臺連接真機實時查看 log、內(nèi)存，還原堆棧等，v1.0.0 主要功能包括：

• Editor 支持直連 OpenHarmony 真機；

• 支持實時按需顯示/篩選 log；

• 支持還原堆棧，幫助快速定位問題；

• 支持顯示實時內(nèi)存占用，支持計算自定義時間間隔內(nèi)平均消耗；

• 支持抓取 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，即可打開該操作界面。

我們提供有線和無線兩種連接方式，支持同時連接多臺設備，可以使用數(shù)據(jù)線直接連接 OpenHarmony 設備和 Tuanjie Editor，當打開 OpenHarmony Hilog 窗口時，Tuanjie 會自動連接OpenHarmony 設備，也可以手動輸入 ip 地址進行無線連接。

2、Hilog

連接到 OpenHarmony 真機后，hilog 窗口會自動刷新并實時顯示設備上的 log 信息。窗口被劃分為 3 個區(qū)域，頂部可以進行切換設備、篩選包體、篩選 log level、篩選 tag 等操作，來精準篩選所需 log 信息。同時支持自定義輸入內(nèi)容進行準確查找，支持模糊搜索和正則匹配。

頁面中間會實時顯示篩選出的 log 信息，同時點擊右鍵，支持 log 保存、自定義 tag 等操作。

?

3、Stacktrace Utility?

Stacktrace Utility 窗口幫助開發(fā)者一鍵還原堆棧，無需借助三方軟件，在窗口內(nèi)直接粘貼堆棧信息，點擊按鈕直接匹配符號表快速還原堆棧，一鍵還原崩潰現(xiàn)場，快速定位問題。支持自定義符號表文件路徑、后綴等。

4、Memory

Memory 窗口支持實時跟蹤為當前所選應用分配的內(nèi)存。可以定期自動捕獲所選應用的內(nèi)存快照。也可以統(tǒng)計一段自定義時間的內(nèi)存占用數(shù)據(jù)，包括峰值及均值。

5、ArkUI Dump

ArkUI Dump 窗口可以捕獲 OpenHarmony 設備上前臺應用程序的 ArkUI Dump 文件，以幫助了解應用程序的 ArkUI 組件和結(jié)構(gòu)。成功連接真機后，點擊“Get ArkUI Dump on Screen”，窗口將自動捕獲當前設備前臺頁面的 ArkUI 結(jié)構(gòu)，可一鍵保存。

OpenHarmony Hilog 詳細文檔可點擊查看： https://docs.unity.cn/cn/tuanjiemanual/1.3/Manual/openharmony-hilog-introduction.html

OpenHarmony SDK Kits Package (Beta v0.0.1)

幫助 OpenHarmony 開發(fā)者快速接入一系列常用場景 SDK，默認提供 Settings 配置面板，內(nèi)置 Demo Scene，集成各場景下 SDK 接入的完整 API 調(diào)用流程，可直接導出/打包，在真機上運行，開箱即用，首個 Beta 版本已接入 Accout&GameService、IAP、Push。Ads、Notification 等接入預計于近期版本發(fā)布，敬請期待！

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 覆蓋驗證支付環(huán)境、查詢各種類商品信息、完整購買流程、完整訂閱流程；

? Push Demo 支持獲取 Token，支持模擬發(fā)送 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 等信息，填入后，會自動同步并配置到項目及后續(xù)導出工程中需要這些參數(shù)的位置，無需多次修改。

Settings 面板中，可以直接勾選應用需要接入的具體 SDK，如 Account & Game service 等。支持打開各 SDK 對應的內(nèi)置 Demo 場景查看，Demo場景中已經(jīng)完成各SDK的接入及全流程必須的接口調(diào)用，支持直接導出 DevEco 工程及真機測試，可直接在 demo 場景上二次開發(fā)或參考對應腳本自行接入。

2、Account & Game Service Kit

Account & Game Service 中，已內(nèi)置接入所需的全流程，每個按鈕對應不同的接口及功能，包括：

? Account & Game Service 相關：

? 初始化游戲服務：點擊后調(diào)用 init 接口，初始化游戲服務；

? 登錄：點擊調(diào)用 unionLogin 接口進行聯(lián)名登錄，會彈出二級窗口詢問登錄方法，登錄成功后返回獲取的玩家 ID、needBinding、accountName 等信息；

? 注銷：點擊訂閱并觸發(fā)注銷事件；

? 綁定玩家：點擊調(diào)用 bindPlayer 接口，將玩家 ID 與游戲官方賬號綁定，并上報綁定結(jié)果；

? 驗證玩家：點擊調(diào)用 verifyLocalPlayer 接口進行合規(guī)性驗證，賬號服務會驗證當前設備的實名認證和游戲防沉迷控制狀態(tài)，若驗證失敗會返回相應的錯誤碼；

? 保存玩家信息：合規(guī)性檢查成功后，當玩家創(chuàng)建角色時，點擊調(diào)用 savePlayerRole 上報玩家的角色信息。

? Game Performance 相關：

? 初始化：點擊調(diào)用 init 接口，初始化游戲場景感知；

? 獲取設備信息：點擊調(diào)用 on 接口訂閱設備狀態(tài)變化事件，獲取設備狀態(tài)變化通知（如設備溫控等級）；

? 更新游戲信息：點擊調(diào)用 updateGameInfo接口上報游戲信息。

3、IAP Kit

接入應用內(nèi)支付前，需要在AppGallery配置并上架商品信息，并將商品信息及對應的商品類型填入 OpenHarmony SDK Kits Settings 窗口內(nèi)：

Demo 場景中已內(nèi)置接入 IAP Kit 所需的全流程，每個按鈕對應不同的接口及功能，包括：

?通用查詢：

? 驗證支付環(huán)境：點擊向 IAP Kit 發(fā)送 queryEnvironmentStatus 請求，判斷用戶當前登錄賬號的服務所在地是否在 IAP Kit 支持結(jié)算的國家/地區(qū)；

? 查詢訂閱商品：點擊調(diào)用 queryProducts 獲取 AppGallery Connect 上配置的商品信息，返回訂閱的商品信息 Products 列表，包括商品價格、名稱、描述等；

? 查詢可消耗商品：點擊調(diào)用 queryProducts 獲取 AppGallery Connect 上配置的商品信息，返回可消耗的商品信息 Products 列表，包括商品價格、名稱、描述等；

? 查詢不可消耗商品：點擊調(diào)用 queryProducts 獲取 AppGallery Connect上 配置的商品信息，返回不可消耗的商品信息 Products 列表，包括商品價格、名稱、描述等。

?訂閱及購買全流程：

? 創(chuàng)建購買：點擊顯示一個窗口，其中包含可購買的消耗品和非消耗品。然后發(fā)送 createPurchase 請求以調(diào)出 IAP Kit 收銀臺；

? 創(chuàng)建訂閱：點擊顯示一個窗口，其中包含可訂閱的訂閱商品。然后發(fā)送 createPurchase 請求以調(diào)出 IAP Kit 收銀臺；

? 檢查購買信息：點擊調(diào)用 queryPurchases 查看本次購買的結(jié)果；

? 完成購買或訂閱：點擊發(fā)送 FinishPurchase 請求以確認發(fā)貨，通知 IAP 服務器更新商品的發(fā)貨狀態(tài)，并完成購買流程。

4、Push Kit

在常見的應用推送場景中，推送消息應該由服務器發(fā)送，由客戶端接收。為了演示整個推送流程，我們在 Demo 中也內(nèi)置了發(fā)送推送消息的功能。

Demo場景中已內(nèi)置接入 Push Kit 所需的全流程，每個按鈕對應不同的接口及功能，包括：

• 標題、正文、Push 按鈕：如果沒有服務器，可以輸入推送消息的標題及正文，然后點擊推送，模擬發(fā)送消息；

OpenHarmony SDK Kits 詳細文檔可點擊查看： https://docs.unity.cn/cn/tuanjiemanual/1.3/Manual/openharmony-sdkkits-introduction.html

以上，Hilog Package 和SDK Kits Package 已在引擎內(nèi)正式發(fā)布，歡迎廣大開發(fā)者下載體驗。我們期待收到更多反饋，讓我們一起為 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 內(nèi)直接反饋：Tuanjie Editor >> Help >> Report a Bug

? 官方社區(qū)直接提問（推薦）：https://developer.unity.cn/plate/tuanjie-engine （添加 OpenHarmony 標簽）

團結(jié)引擎是 Unity 中國的引擎研發(fā)團隊基于 Unity 2022 LTS 版本為中國開發(fā)者定制的實時 3D 引擎；基于 Unity 的核心能力，團結(jié)引擎團隊傾聽中國開發(fā)者的聲音和需求，為團結(jié)引擎加入了一些中國開發(fā)者需要的定制化功能，并會在未來持續(xù)不斷為中國開發(fā)者量身定制需要的功能。

團結(jié)引擎 1.3.1 版本現(xiàn)已發(fā)布，歡迎點擊閱讀原文下載體驗或至官網(wǎng)了解產(chǎn)品詳情。

[1]團結(jié)引擎官網(wǎng)：

https://unity.cn/tuanjie/tuanjieyinqing

[2]團結(jié)引擎問答專區(qū)：

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

Unity 官方微信

第一時間了解Unity引擎動向，學習進階開發(fā)技能

每一個“在看”，都是我們前進的動力