시작하기
이 플러그인의 설치 단계와 전체 마크다운 가이드를 포함한 설정 지시서를 복사하세요.
Set up this Capacitor plugin in the project.
Use the package manager already used by the project.
Install these package(s): `@capgo/capacitor-firebase-crashlytics`
Run the required Capacitor sync/update step after installation.
Read this markdown guide for the full setup steps: https://raw.githubusercontent.com/Cap-go/website/refs/heads/main/apps/docs/src/content/docs/docs/plugins/firebase-crashlytics/getting-started.mdx
Use that guide for platform-specific steps, native file edits, permissions, config changes, imports, and usage setup.
If that guide references other docs pages, read them too.
설치
설치AI-Assisted Setup을 사용하여 플러그인을 설치할 수 있습니다. AI 도구에 Capgo 기능을 추가하려면 다음 명령어를 사용하세요:
npx skills add https://github.com/Cap-go/capgo-skills --skill capacitor-plugins그런 다음 다음 프롬프트를 사용하세요:
Use the `capacitor-plugins` skill from `Cap-go/capgo-skills` to install the `@capgo/capacitor-firebase-crashlytics` plugin in my project.만약에 수동 설정을 원한다면, 다음 명령어를 실행하고 아래의 플랫폼별 지침을 따르면 플러그인을 설치할 수 있습니다.
bun add @capgo/capacitor-firebase-crashlyticsbunx cap syncImport
__CAPGO_KEEP_0__ 개요import { FirebaseCrashlytics } from '@capgo/capacitor-firebase-crashlytics';API 개요
API 개요강제로 시스템을 다운시키기 때문에 테스트를 위해 사용합니다.
설치
import { FirebaseCrashlytics } from '@capgo/capacitor-firebase-crashlytics';
await FirebaseCrashlytics.crash({ message: 'Hello from Capacitor' });setCustomKey
setCustomKey사용자 정의 키와 값이 이후의 치명적 및 비치명적 보고서와 연관됩니다.
안드로이드 및 iOS에서만 사용 가능합니다.
import { FirebaseCrashlytics } from '@capgo/capacitor-firebase-crashlytics';
await FirebaseCrashlytics.setCustomKey({ key: 'key-123', value: 'value', type: 'string',});setUserId
setUserId사용자 ID(식별자)를 이후의 치명적 및 비치명적 보고서와 연관시킵니다.
안드로이드 및 iOS에서만 사용 가능합니다.
import { FirebaseCrashlytics } from '@capgo/capacitor-firebase-crashlytics';
await FirebaseCrashlytics.setUserId({ userId: 'user-id-123' });log
setUserId로그 메시지를 추가하여 치명적 데이터와 함께 이벤트의 원인에 대한 더 많은 정보를 제공합니다.
안드로이드 및 iOS에서만 사용 가능합니다.
import { FirebaseCrashlytics } from '@capgo/capacitor-firebase-crashlytics';
await FirebaseCrashlytics.log({ message: 'Hello from Capacitor' });setEnabled
setEnabled자동 데이터 수집을 자동으로 활성화/비활성화합니다. 다음 앱 실행 시에만 적용됩니다.
Android 및 iOS에서만 사용 가능합니다.
import { FirebaseCrashlytics } from '@capgo/capacitor-firebase-crashlytics';
await FirebaseCrashlytics.setEnabled({ enabled: true });isEnabled
isEnabled자동 데이터 수집이 활성화되어 있는지 여부를 반환합니다.
iOS에서만 사용 가능합니다.
import { FirebaseCrashlytics } from '@capgo/capacitor-firebase-crashlytics';
const result = await FirebaseCrashlytics.isEnabled();console.log(result);didCrashOnPreviousExecution
didCrashOnPreviousExecution앱이 이전 실행 시에 충돌한지 여부를 반환합니다.
Android 및 iOS에서만 사용 가능합니다.
import { FirebaseCrashlytics } from '@capgo/capacitor-firebase-crashlytics';
const result = await FirebaseCrashlytics.didCrashOnPreviousExecution();console.log(result);sendUnsentReports
sendUnsentReports다음 시작 시 미전송 보고서를 Crashlytics로 업로드합니다.
자동 데이터 수집이 활성화된 경우 Crashlytics는 시작 시 보고서를 자동으로 업로드합니다.
Android 및 iOS에서만 사용 가능합니다.
import { FirebaseCrashlytics } from '@capgo/capacitor-firebase-crashlytics';
await FirebaseCrashlytics.sendUnsentReports();deleteUnsentReports
deleteUnsentReports장치에 있는 미전송 보고서를 삭제합니다.
Android 및 iOS에서만 사용 가능합니다.
import { FirebaseCrashlytics } from '@capgo/capacitor-firebase-crashlytics';
await FirebaseCrashlytics.deleteUnsentReports();recordException
recordException비상태 보고서를 Crashlytics로 전송합니다.
Android 및 iOS에서만 사용 가능합니다.
import { FirebaseCrashlytics } from '@capgo/capacitor-firebase-crashlytics';
await FirebaseCrashlytics.recordException({ message: 'Hello from Capacitor' });타입 참조
타입 참조 섹션CrashOptions
크래시 옵션 섹션export interface CrashOptions { /** * @since 0.1.0 */ message: string;}SetCustomKeyOptions
사용자 ID 설정 옵션 섹션export type SetCustomKeyOptions = CustomKeyAndValue;SetUserIdOptions
로그 옵션 섹션export interface SetUserIdOptions { /** * @since 0.1.0 */ userId: string;}LogOptions
타입 참조export interface LogOptions { /** * @since 0.1.0 */ message: string;}SetEnabledOptions
설정 옵션 활성화export interface SetEnabledOptions { /** * @since 0.1.0 */ enabled: boolean;}IsEnabledResult
설정 옵션 활성화export interface IsEnabledResult { /** * @since 0.1.0 */ enabled: boolean;}DidCrashOnPreviousExecutionResult
활성화 결과export interface DidCrashOnPreviousExecutionResult { /** * @since 0.1.0 */ crashed: boolean;}RecordExceptionOptions
이전 실행 시 충돌 결과export interface RecordExceptionOptions { /** * The message to record as a non-fatal exception. * * @since 0.1.0 */ message: string; /** * Error code within a specific error domain. * * **Attention:** This option is ignored on iOS if `stacktrace` is provided. * * Only available for iOS. * * @since 0.1.0 */ code?: number; /** * A string containing the error domain. * * **Attention:** This option is ignored on iOS if `stacktrace` is provided. * * Only available for iOS. * * @since 0.1.0 */ domain?: string; /** * An array of keys and the values to associate with the non fatal exception, * in addition to the app level custom keys. * * **Attention:** This option is ignored on iOS if `stacktrace` is provided. * * @since 7.1.0 */ keysAndValues?: CustomKeyAndValue[]; /** * A stacktrace generated by stacktrace.js. * * @since 1.1.0 */ stacktrace?: StackFrame[];}GetPluginVersionResult
예외 기록 옵션export interface GetPluginVersionResult { /** * The semantic version of this plugin. * * @since 8.0.2 */ version: string;}CustomKeyAndValue
플러그인 버전 결과export interface CustomKeyAndValue { /** * @since 7.1.0 */ key: string; /** * @since 7.1.0 */ value: string | number | boolean; /** * @since 7.1.0 */ type: 'string' | 'long' | 'double' | 'boolean' | 'int' | 'float';}StackFrame
StackFrameStacktrace를 생성하는 stacktrace.js의 부분입니다.
export interface StackFrame { lineNumber?: number; fileName?: string; functionName?: string;}실제 데이터의 근원
Source Of Truth이 페이지는 플러그인의 src/definitions.tspublic API이 업스트림에서 변경될 때 다시 싱크를 실행하세요.
Getting Started에서 계속
Keep going from Getting StartedGetting Started 계획 대시보드 및 __CAPGO_KEEP_0__ 운영을 위해 to plan dashboard and API operations, connect it with API 개요 API 구현 세부 사항에 대한 설명 소개 소개 구현 세부 사항에 대한 설명 API 키 API 키 구현 세부 사항에 대한 설명 장치 장치 Bundles 패키지