Cocos平臺 | 零代碼快速集成AGC崩潰服務

咱們公司以前使用Android平臺開發應用時集成過華爲提供的崩潰服務，只須要引入SDK就能夠，零代碼集成還免費，應用崩潰信息實時採集上報，及時幫助修復Bug，真是太好用了。最近公司使用Cocos在開發另外一款遊戲，就想着若是也能用Cocos來集成，那就太好了。網上搜索了一下，嘿!還真有相關文檔，根據文檔和本身摸索，徹底從一個小白的角度總結下如何集成，但願有須要的開發者能拿來即用。

一、 Cocos平臺建立應用並開啓服務

1.1 建立Cocos AppID
Cocos AppID是遊戲(應用)的惟一標識。在使用服務以前，必須先爲遊戲工程設定Cocos AppID，而後才能開始使用各類服務。

若是沒有Cocos AppID，須要先前往 Cocos 帳戶中心建立一個。

以下：

進入 Cocos 帳戶中心後，點擊建立遊戲，填寫相關信息後完成遊戲的建立並獲取Cocos AppID。

此時再次進入Cocos Creator控制檯，點擊「設定Cocos AppID」，能夠看到剛剛建立的遊戲已經同步過來了，選擇遊戲後完成關聯。

1.1 Cocos Creator控制檯開啓華爲分析和崩潰服務
關聯遊戲後，能夠在Cocos Creator控制檯開啓華爲分析和崩潰服務。

Cocos Creator控制檯開始相關服務後，在 Cocos帳戶中心刷新頁面發現相關服務也同步開通(顏色高亮)：

1.1 AGC頁面開啓華爲分析和崩潰服務
在 Cocos Creator控制檯開啓華爲分析和崩潰後，還須要在AGC頁面開啓相應的服務，操做步驟以下：

a) 登陸AGC，完成項目和應用的建立，此處再也不講述如何在AGC建立應用，能夠直接參考華爲的官方文檔->(戳我建立應用)

b) 建立完項目和應用後就須要開發相關服務了。進入個人項目-> 質量->崩潰，點擊「啓動分析服務」後同步開啓華爲分析和崩潰服務：

c) 服務開通之後，回到項目設置界面，下載最新的json文件。

d) 將剛下載好json文件，放到Cocos工程目錄的settings目錄下。

同時也能夠在工程架構中看到：

二、 構建並安裝應用

2.1 發佈到HUAWEI AppGallery Connect平臺

a) 在Cocos菜單面板，點擊 項目-> 構建發佈 –> 選擇 HUAWEI AppGallery Connect，配置對應的包名。此處的包名須要和在華爲AGC建立的應用包名保持一致，不然會報編譯錯誤。

b) 依次點擊「構建」、「編譯」，編譯完成後能夠直接打開發布路徑查看生產的APK包，發佈路徑通常在 \build\jsb-link\publish\android下。獲取APK包後您可使用USB數據線經過adb命令將軟件包安裝到您的手機上進行調測。

c) 您還能夠直接上傳APK包到AGC頁面，選擇「上傳」，首次上傳須要登陸AGC帳號。填寫應用的APPID，選擇APK包的路徑，點擊「確認上傳」便可。

2.1 發佈到Android平臺

a) 您還能夠將發佈平臺選擇Android，而後直接鏈接手機和電腦，點擊「運行」直接將APK安裝到手機：

b) 若是須要在Android Studio中打開項目，能夠在Android Studio中打開Cocos工程，路徑通常爲： .\build\jsb-link\frameworks\runtime-src\proj.android-studio

三、 測試崩潰實現

一般應用程序崩潰出現的機率較小，您能夠在測試應用時調用Crash SDK的自帶的測試方法testIt手動製造一個崩潰，而後在AGC上查看崩潰上報狀況，以測試崩潰服務是否正常運行。

本工程中經過設置一個按鍵「CrashTest」，點擊後調用Crash SDK的測試方法能夠製造一次崩潰。接口定義以下：

testIt(): void

示例：

huawei.agc.crash.CrashService.testIt();

四、 查看崩潰報告

4.1 查看崩潰報告統計信息
a) 安裝好應用後，點擊「CrashTest」按鈕製造一次崩潰，應用退出後再次打開應用。

b) 登陸AppGallery Connect網站，點擊「個人項目」。

c) 在項目列表中找到您的項目，在項目下的應用列表中選擇您的應用。

d) 點擊「質量 > 崩潰」，進入崩潰服務頁面，點擊"統計"頁籤，時間段選擇"過去一小時"，查看您應用的崩潰統計信息，以下：

4.2 查看崩潰堆棧詳情

點擊崩潰問題，能夠進入問題詳情頁面，在"堆棧"信息中，您能夠大體瞭解發生崩潰問題的緣由，以幫助您對崩潰問題進行分析。

4.3 獲取可閱讀的崩潰報告

a) 當ProGuard或DexGuard在編譯時將代碼中的類名、字段和方法等替換爲不可閱讀的代碼，您能夠經過混淆Mapping文件獲取通過反混淆處理的崩潰報告。

b) 找到本次工程的mapping文件，獲取混淆的mapping文件：

c) 點擊上傳，將對應的mapping文件上傳到AGC：

d) 上傳混淆的mapping文件後，再次查看原先的崩潰堆棧，發現已經還原：

總結

一、 用Cocos集成華爲崩潰SDK很簡單，只需建立應用，開啓華爲分析和崩潰服務

二、 建議首次接入的開發者能夠先下載demo本身跑一跑

三、 不止華爲崩潰服務，不少其餘的華爲服務也陸續開發支持Cocos了，感興趣的朋友能夠本身接入

欲瞭解更多詳情，請參見：

一、 Cocos官方集成文檔：https://docs.cocos.com/creator/manual/zh/cocos-service/agc-crash.html

二、 華爲AGC 崩潰服務文檔：https://developer.huawei.com/consumer/cn/doc/development/AppGallery-connect-Guides/agc-crash-introduction

三、 華爲AGC-崩潰服務codelab：https://developer.huawei.com/consumer/cn/codelab/CrashService/index.html#0

四、 Cocos應用發佈：https://developer.huawei.com/consumer/cn/forum/topicview?fid=0101271690375130218&tid=0203359161844040878&pid=0303359161844040067

---

原文連接：https://developer.huawei.com/consumer/cn/forum/topic/0201409049537500307?fid=0101271690375130218

原做者：Jessyyyyy