How to Integrate Bugly for Real‑Time Crash Monitoring on Harmony OS

1. Bugly Harmony Monitoring Capabilities

Harmony OS apps may encounter three main exceptions that cause crashes: Js Crash (from the ArkTS language, similar to Android Java Crash), Cpp Crash (native layer crash), and App Freeze (similar to Android ANR, leading to process termination). Bugly’s Harmony version uses the HiAppEvent system to monitor these exceptions, offering catch‑error and custom error reporting. After collection, the issues are reported to the Bugly platform, where developers can view stack traces, logs, and other state information. Stack traces support clustering, symbol file upload, and translation; logs and attachments can be downloaded.

Js Crash, Cpp Crash, and App Freeze all support reporting of stack traces, runtime data, logs, FaultLog information, custom fields, and custom attachments.

2. Integrating Bugly into Harmony OS

Bugly’s official documentation provides a two‑command process to quickly integrate the Harmony version.

ohpm config set registry https://ohpm.openharmony.cn/ohpm/

Install the Bugly Harmony package (latest version 0.2.3): ohpm install bugly@latest Initialize the SDK with code such as:

import { Bugly, BuglyBuilder } from "bugly";
initBugly(context: Context): void {
  let builder = new BuglyBuilder();
  builder.appId = 'xxxxxxx'; // required, APP ID
  builder.appKey = 'xxx-xxxx-xxxx-xxxx-xxxx'; // required, APP KEY
  builder.deviceId = "12345"; // required, unique device ID
  builder.platform = BuglyBuilder.PLATFORM_PRO; // required, professional platform
  builder.appVersion = '1.0.0'; // optional
  builder.buildNum = '0'; // optional
  builder.appChannel = 'website'; // optional
  builder.userId = "12345"; // optional
  builder.deviceModel = "huawei"; // optional
  builder.debugMode = true; // optional, enable debug logs
  builder.initDelay = 0; // optional, init delay in ms
  let initResult = Bugly.init(context, builder);
}

After initialization, the SDK begins monitoring online quality issues for Harmony OS applications.

3. Conclusion

Bugly’s Harmony version is freely available. Developers are encouraged to try it and contact the Bugly support assistant for any integration or usage questions. Ongoing updates will continue to improve compatibility and help resolve quality and performance problems on Harmony OS.