Files

T

Antigravity Agent 93ec7e9056 [G1-Sync] Manual knowledge update

2026-05-09 21:08:02 +09:00

3.9 KiB

Raw Blame History

id, title, category, status, source_trust_level, verification_status, created_at, updated_at, tags, tech_stack, applied_in, aliases

title

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 우선.

3.9 KiB Raw Blame History