[Huawei Developers] Mayism:
The Crash service of AppGallery Connect provides a simple, coding-free solution for app crashes. It is found that Cocos Creator also supports the Crash service provided by AppGallery Connect. Let’s see how it works.If you want to quickly experience this service, see the demo on GitHub.

1. Creating an App and Enabling the Crash Service

1.1 Setting a Cocos App ID

Cocos app ID is the unique identifier of a game app. Before using services, you need to set a Cocos app ID for your game project.

If you do not have a Cocos-based game, click Dashboard to create one in the Cocos Account Center, as shown in the following figure.

In the Cocos Account Center, click Create a game, complete your game information, and obtain the generated app ID.

View attachment 5203371

Return to Cocos Creator, click Set Cocos AppID, and choose the game to associate it.

1.2 Enabling HUAWEI Analytics and Crash in Cocos Creator

In the Service panel, enable HUAWEI Analytics and Crash.

View attachment 5195241

You can also view the enabled services (highlighted) in the Cocos Account Center, as shown in the following figure.

View attachment 5203373

1.3 Enabling HUAWEI Analytics and Crash in AppGallery Connect

You also need to enable the services in AppGallery Connect. The steps are as follows:

a) Sign in to AppGallery Connect, create a project, and add an app to it. For details about how to create an app in AppGallery Connect, check the official documentation.

b) In AppGallery Connect, click My projects, select a project, go to Quality > Crash, and click Enable now to enable both HUAWEI Analytics and Crash.

View attachment 5195245

c) Go to Project settings and download the latest agconnect-services.json file.

d) Save the downloaded agconnect-services.json file to the settings directory in your Cocos project.

View attachment 5195247

The file is also displayed in Cocos Creator, as shown in the following figure.

2. Building and Installing an App

2.1 Releasing your app in AppGallery Connect

a) In Cocos Creator, go to Project > Build…, choose HUAWEI AppGallery Connect, and set a package name. The package name must be the same as that configured in AppGallery Connect. Otherwise, a compilation error will be reported.

View attachment 5195249

b) Click Build, and then Compile. You can find the corresponding APK file in the \build\jsb-link\publish\android directory of the project. You can run the adb command after a USB cable has been connected to install the package on your phone for testing.

View attachment 5195251

c) You can also upload the APK file to AppGallery Connect by clicking Upload next to Compile. Select a sign-in type, fill in the relevant information, and click Confirm.

View attachment 5195253

2.2 Releasing your app to an Android platform

a) In the Build… panel, choose Android for Platform, connect a phone to your computer, and click Play to install the APK file to your phone.

b) You can also open the project in the \build\jsb-link\frameworks\runtime-src\proj.android-studio directory in Android Studio.

View attachment 5195255

3. Testing the Crash Service

Usually, app crashes are not common. You can manually trigger a crash and test the Crash service by calling the AGConnectCrash.testIt method of the Crash SDK and then checking whether the crash data is reported in AppGallery Connect.

In this example, a test button CrashTest is created. You can click the button to trigger a crash. The API is defined as follows:

testIt(): void

Sample code:

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

4. Viewing a Crash Report

4.1 Viewing crash statistics

a) Package and run your app. Tap CrashTest to trigger a crash. Exit the app and launch it again.

b) In AppGallery Connect, click My projects.

c) Find your project from the project list and click your app on the project card.

d) Go to Quality > Crash. On the Crash page, click the Statistics tab and select Last hour to view crash statistics of your app.

4.2 Viewing crash stack details

Click the crash name to go to the crash details page. Click the Stack tab. The possible causes of the crash are displayed, helping you analyze the crash.

4.3 Obtaining a readable crash report

a) When ProGuard or DexGuard overrides class names, fields, and methods in code with unreadable code during building, you can obtain a de-obfuscation crash report from the obfuscation mapping file.

b) Find the obfuscation mapping file in the following directory in Android Studio and download the file.

c) On the Mapping file tab page in AppGallery Connect, click Upload.

d) It is found that the data is restored.

View attachment 5195257

Summary

1. It is simple to integrate the Crash SDK into a Cocos-based app. You just need to create an app and enable HUAWEI Analytics and Crash.

2. If it is your first time integrating the SDK, you can use a demo app for testing.

3. In addition to Crash, some other Huawei services have started to support Cocos-based apps.

For more details, please check:

1. Cocos official documentation:

https://docs.cocos.com/creator/manual/en/cocos-service/agc-crash.html

2. HUAWEI AppGallery Connect Crash documentation:

https://developer.huawei.com/consum...Gallery-connect-Guides/agc-crash-introduction

3. HUAWEI AppGallery Connect Crash codelab:

https://github.com/AppGalleryConnect/agc-crash-codelab-java

4. Cocos Creator Integrates with AppGallery Connect APM — Releasing a Cocos-based App:

https://forums.developer.huawei.com/forumPortal/en/topic/0202382127496450426?fid=0101187876626530001

if you have any question, please refer to stackoverflow.