Files
2nd/10_Wiki/Topic_Programming/Coding/Native_Crash_Reporting.md
T
Antigravity Agent 9148c358d0 docs(10_Wiki): 위키 전체 재구성 — Topic_* 폴더를 4개 카테고리로 통합 + 대규모 중복 제거
Topic_Agent/Topic_Blog/Topics/Topics_Biz/Topics_Meeting/Topics_Rag의 마크다운 지식 문서를
Topic_General/Topic_Programming/Topic_Graphic/Topic_Business 4개 카테고리로 재분류.

- 중복 제거: frontmatter의 status:duplicate/merged + duplicate_of/redirect_to 필드로
  자기 자신을 중복으로 선언한 리다이렉트 stub 1032개 제거, 완전 동일 내용 파일 472개 제거,
  동일 파일명·다른 내용 충돌 시 더 큰(완전한) 버전만 유지(162개 제거) — 총 1639개 중복 제거.
- 분류: 폴더 단위로 명확한 항목(AI_and_ML/Coding/Architecture 등 → Programming,
  Comfyui/Visual_Effects → Graphic, Topics_Biz/Topics_Meeting/사업 등 → Business,
  Poetic_Blog_Writing/창의성/Game_Design 등 → General)은 폴더 우선순위로,
  나머지 혼재 폴더(Topic_Agent/Topic_Blog/Topics 루트/Thinking & Reasoning/Other/UI_UX_Assets)는
  title/tags 키워드 스코어링으로 파일 단위 분류(불명확한 경우 General로 폴백).
  원본 폴더명은 "From_*" 서브폴더로 보존해 추적 가능성 유지.
- 최종 배치: Programming 2784 / General 1608 / Graphic 285 / Business 249 = 4926개 문서.
- 에이전트 운영 상태(.astra/.agent/.obsidian/sessions/memory/_company/docs/lessons/_shared/src)는
  지식 콘텐츠가 아니므로 재분류 대상에서 제외하고 원위치 유지.
- Topics/Topic_email(상위 보호 폴더 Topic_email과 파일명 100% 중복) 삭제 — 보호 폴더 자체는 미변경.
- 완전히 비게 된 Topic_Agent/Topic_Blog/Topics_Biz/Topics_Rag 폴더 제거.
2026-07-05 00:33:48 +09:00

3.8 KiB

id, title, category, status, source_trust_level, verification_status, created_at, updated_at, tags, tech_stack, applied_in, aliases
id title category status source_trust_level verification_status created_at updated_at tags tech_stack applied_in aliases
native-crash-reporting Native Crash Reporting — Crashlytics / Sentry Coding draft B conceptual 2026-05-09 2026-05-09
native
crash
sentry
crashlytics
vibe-coding
language applicable_to
Swift / Kotlin
iOS
Android
Crashlytics
Sentry
dSYM
ProGuard mapping
breadcrumbs

Native Crash Reporting

Prod crash 추적의 표준 = Firebase Crashlytics 또는 Sentry. dSYM(iOS)/mapping(Android) 업로드 필수. Symbol 없는 stack 은 쓸모없음. Breadcrumbs + user identifier + custom keys 가 디버깅 무기.

📖 핵심 개념

  • Symbolication: hex address → 함수명. dSYM/mapping 필요.
  • Non-fatal: handled exception 도 보고.
  • Breadcrumbs: 충돌 직전 N 이벤트.
  • ANR (Android): Crashlytics 자동 보고.

💻 코드 패턴

iOS — Crashlytics

# Podfile
pod 'FirebaseCrashlytics'
import FirebaseCrashlytics

// 사용자 식별
Crashlytics.crashlytics().setUserID(user.id)
Crashlytics.crashlytics().setCustomValue(plan, forKey: "subscription")

// 로그 (breadcrumb)
Crashlytics.crashlytics().log("Tapped checkout")

// non-fatal
Crashlytics.crashlytics().record(error: NSError(domain: "App", code: 42))

dSYM upload (Build Phase):

"${PODS_ROOT}/FirebaseCrashlytics/run"
# Input Files: $(BUILT_PRODUCTS_DIR)/$(INFOPLIST_PATH), ${DWARF_DSYM_FOLDER_PATH}/${DWARF_DSYM_FILE_NAME}

Android — Crashlytics

// build.gradle
plugins {
    id 'com.google.gms.google-services'
    id 'com.google.firebase.crashlytics'
}

dependencies {
    implementation("com.google.firebase:firebase-crashlytics-ktx")
    implementation("com.google.firebase:firebase-analytics-ktx")
}
val crashlytics = FirebaseCrashlytics.getInstance()
crashlytics.setUserId(user.id)
crashlytics.setCustomKey("subscription", "pro")
crashlytics.log("opened CartActivity")

// non-fatal
try { risky() } catch (e: Exception) { crashlytics.recordException(e) }

ProGuard mapping 자동 업로드 (gradle plugin 처리).

Sentry (cross-platform)

import Sentry

SentrySDK.start { o in
    o.dsn = "https://...@sentry.io/0"
    o.tracesSampleRate = 0.1
    o.debug = false
}

SentrySDK.setUser(User(userId: user.id))
SentrySDK.capture(error: error)
SentryAndroid.init(context) { o ->
    o.dsn = "https://...@sentry.io/0"
    o.tracesSampleRate = 0.1
}

Sentry.captureException(e)
Sentry.addBreadcrumb(Breadcrumb().apply { message = "checkout tapped" })

React Native — @sentry/react-native

import * as Sentry from '@sentry/react-native';

Sentry.init({ dsn: '...', tracesSampleRate: 0.1 });
Sentry.captureException(error);

Custom log line strategy

// 단순 log 보다 key=value 로
Crashlytics.crashlytics().log("nav route=cart user=\(user.id) cartCount=\(items.count)")

🤔 의사결정 기준

필요 추천
Firebase 이미 사용 Crashlytics (무료)
Self-hosted / 풍부한 분석 Sentry
Crash + Performance 통합 Sentry / Firebase Performance
ReactNative 한 SDK Sentry RN
Symbol 자동 업로드 Sentry CLI / Crashlytics gradle plugin

안티패턴

  • dSYM 업로드 누락: 의미 없는 stack.
  • Proguard mapping 안 올림: Android 도 동일.
  • PII 그대로 user log: GDPR / CCPA 위반.
  • breadcrumb 너무 많음: noise. 의미 있는 이벤트만.
  • fatalError(...) 무절제: prod 사용자에 보임.
  • catch 후 swallow: 보고도 안 함, 디버깅 불가. 최소 record.
  • debug build 도 SDK 활성: noise.

🤖 LLM 활용 힌트

  • userID + custom key + log + recordException 4종.
  • dSYM/mapping 자동 업로드 setup 우선.

🔗 관련 문서