mobile-crash-sdk
Use when an "enable observability" card asks for crash reporting on a mobile (iOS, Android, React Native, Flutter) or desktop app - adding Sentry or Firebase Crashlytics with release and environment tags, symbol upload, and session tracking so crash-free users can be read
- License 许可
- Apache-2.0
- 最近更新
- 2026-11-15
- Stars
- ★ 122
- Forks
- 18
01 前言 Front Matter
- name
- mobile-crash-sdk
- source
- getsentry/sentry-cocoa, sentry-java, sentry-react-native, Firebase Crashlytics docs (MIT/Apache-2.0), adapted
- category
- observability
- description
- Use when an "enable observability" card asks for crash reporting on a mobile (iOS, Android, React Native, Flutter) or desktop app - adding Sentry or Firebase Crashlytics with release and environment tags, symbol upload, and session tracking so crash-free users can be read
03 SKILL.md 正文
Mobile crash reporting
The mobile golden signal is crash-free users per release. It needs three things from the app: a crash SDK, the release (version + build) and environment on every event, and session tracking — without sessions a tool knows how many crashes there were but not out of how many users.
Sentry
- iOS (
sentry-cocoa, Swift Package Manager):SentrySDK.start { o in o.dsn = …; o.releaseName = "\(bundleId)@\(version)+\(build)"; o.environment = "production"; o.enableAutoSessionTracking = true }at app launch. Upload dSYMs in the release build (sentry-cli debug-files uploador the Fastlanesentry_debug_files_uploadaction) or crashes arrive unsymbolicated. - Android (
io.sentry:sentry-android+ theio.sentry.android.gradleplugin): DSN, release and environment in the manifest<meta-data>orSentryAndroid.init; the Gradle plugin uploads the R8/ProGuard mapping per build. - React Native:
@sentry/react-native(its wizard wires both native projects and source maps). Flutter:sentry_flutterwithSentryFlutter.init, and--split-debug-infosymbols uploaded. - The DSN is not a secret, but the
sentry-cliauth token used for uploads is: a CI secret, never in the repository.
Firebase Crashlytics
- iOS:
FirebaseCrashlyticsvia SPM,FirebaseApp.configure(), and theupload-symbolsrun script phase for dSYMs. - Android:
com.google.firebase:firebase-crashlyticsand thecom.google.firebase.crashlyticsGradle plugin (mapping upload on release builds). - Crashlytics takes the version from the app itself; set the environment as a custom key (
Crashlytics.crashlytics().setCustomValue("staging", forKey: "environment")) and keep debug builds out (setCrashlyticsCollectionEnabled(false)there). - Crash-free users is reported by the Firebase console; Google Play's Android vitals (and App Store Connect's metrics) give the store-side view a store data source reads.
Desktop (Electron)
@sentry/electron in both the main and renderer processes, release from app.getVersion(), native crash minidumps enabled.
In the task
- One SDK, initialised before anything else at launch; no personal data in breadcrumbs (strip request bodies, emails, tokens).
- Acceptance criteria: "Given a build of this release crashes on a test device, then the crash appears in <Sentry|Crashlytics> symbolicated, tagged with this version and environment"; "Given the app is opened, then a session is recorded for this release."
- A store build has to ship before any of this is visible: say so, and tell the person which data source (Sentry, Google Play vitals, App Store metrics) to add so
mobile.crash_free_userscan be bound.
04 同仓库更多 Skills
visual-craft
暂无简介
ux-copy
Use when you write any words a user reads in a mockup or a hand-off - content language and voice, buttons, labels, errors, empty states, confirmations, numbers and dates, and the longest-string check
screen-mockup-html
Use when you draw screens as the design task's HTML mockup - ONE canvas document holding every screen and every variant side by side, the sanitizer-safe recipe, phone and wide frames, the states grid, static control states, and the loopback self-check with screenshots at 375, 768 and 1440 attached to the task
performance-awareness
How the performance score moves for your role. Use when the score context shows a declining trend, or before handing off work you have not self-checked against every criterion.
design-variants
Use when a screen design needs variants - how many, variants as side-by-side rows on the one canvas, what makes two variants genuinely different, recommending one, how the human's choice is read, and narrowing to the chosen one in revision
design-system-authoring
Use when you derive, change or extend a design system - where tokens live per stack, the DTCG token tree, role-based names for both themes, base vs layer vs drift, the DESIGN.md section order, the inventory format, the contrast check and the lint every proposal returns