Mobile & desktop

For agents: paste the DSN from list_keys into the snippet for the platform; create the project with the matching platform id (create_project(org="acme", slug="web", name="Web", platform="android")). Platforms on this page: android, ios, react-native, flutter, electron.

Mobile SDKs capture crashes that happen before your code runs (ContentProvider init on Android, crash-on-disk-then-send on iOS) and report release health sessions by default, which is what powers crash-free rates in Releases. Sessions are free — they do not count against the event meter.

Replace https://<public_key>@ingest.bugwatch.io/<project_number> with the DSN from list_keys or the project's settings page.

Android

• Platform id: android · Language: Kotlin · Runs in: mobile
• Install: implementation 'io.sentry:sentry-android:8.+'
• Files: AndroidManifest.xml

<application>
  <meta-data android:name="io.sentry.dsn" android:value="https://<public_key>@ingest.bugwatch.io/<project_number>" />
  <meta-data android:name="io.sentry.traces.sample-rate" android:value="1.0" />
  <meta-data android:name="io.sentry.session-tracking.enable" android:value="true" />
</application>

Lifecycle notes:

• Init happens via a ContentProvider before Application.onCreate — crashes during startup are captured.
• ANRs, native (NDK) crashes and release health sessions are on by default; ProGuard/R8 mappings upload with the Gradle plugin so traces deobfuscate.

iOS / Swift

• Platform id: ios · Language: Swift · Runs in: mobile
• Install: SPM: https://github.com/getsentry/sentry-cocoa
• Files: App.swift

import Sentry

@main struct MyApp: App {
    init() {
        SentrySDK.start { o in
            o.dsn = "https://<public_key>@ingest.bugwatch.io/<project_number>"
            o.tracesSampleRate = 1.0
            o.enableAppHangTracking = true
        }
    }
}

Lifecycle notes:

• Start in the App initializer (or AppDelegate didFinishLaunching) before any UI; crashes are written to disk and sent on next launch.
• Upload dSYMs with sentry-cli (or the Xcode build phase) so native frames symbolicate; release health sessions track foreground/background automatically.

React Native

• Platform id: react-native · Language: TypeScript · Runs in: mobile
• Install: npx @sentry/wizard@latest -i reactNative

import * as Sentry from "@sentry/react-native";
Sentry.init({ dsn: "https://<public_key>@ingest.bugwatch.io/<project_number>", tracesSampleRate: 1.0 });
export default Sentry.wrap(App);

Lifecycle notes:

• Sentry.wrap(App) adds the error boundary and touch breadcrumbs; native crashes on both platforms report through the bundled native SDKs.
• Upload JS source maps AND native symbols (dSYM / ProGuard) per release — the Metro plugin handles source maps.

Flutter

• Platform id: flutter · Language: Dart · Runs in: mobile
• Install: flutter pub add sentry_flutter

await SentryFlutter.init(
  (o) { o.dsn = "https://<public_key>@ingest.bugwatch.io/<project_number>"; o.tracesSampleRate = 1.0; },
  appRunner: () => runApp(const MyApp()),
);

Lifecycle notes:

• appRunner wraps runApp in a zone so async errors and Flutter framework errors are captured.
• Obfuscated builds need flutter build --split-debug-info symbols uploaded with sentry-cli.

Electron

• Platform id: electron · Language: TypeScript · Runs in: desktop
• Install: npm install @sentry/electron

// main process
import * as Sentry from "@sentry/electron/main";
Sentry.init({ dsn: "https://<public_key>@ingest.bugwatch.io/<project_number>" });

// each renderer
import * as Sentry from "@sentry/electron/renderer";
Sentry.init({ dsn: "https://<public_key>@ingest.bugwatch.io/<project_number>" });

Lifecycle notes:

• Main and renderer processes init separately; renderer events are forwarded through IPC so both share the release/context.
• Native crashes come through the crashpad minidump integration.

Symbolication for this family

Native frames need symbols uploaded per release: dSYMs on iOS (sentry-cli --url https://api.bugwatch.io debug-files upload or the Xcode build phase), ProGuard/R8 mappings on Android (Gradle plugin), --split-debug-info output for obfuscated Flutter builds, plus JS source maps for React Native and Electron renderers. Point every uploader at https://api.bugwatch.io with a release:write token.