시작하기
설치
Set up this Capacitor plugin in the project.
Use the package manager already used by the project.
Install these package(s): `@capgo/capacitor-firebase-performance`
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-performance/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.
설치
설치Capgo의 AI 보조 설치를 사용하여 플러그인을 설치할 수 있습니다. 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-performance` plugin in my project.만약 Manual Setup을 선호한다면, 플러그인을 설치하기 위해 다음 명령어를 실행하고 아래의 플랫폼별 지침을 따르세요:
bun add @capgo/capacitor-firebase-performancebunx cap syncimport { FirebasePerformance } from '@capgo/capacitor-firebase-performance';API 개요
Section titled “API 개요”startTrace
Section titled “startTrace”트레이스 시작
import { FirebasePerformance } from '@capgo/capacitor-firebase-performance';
await FirebasePerformance.startTrace({} as StartTraceOptions);stopTrace
Section titled “stopTrace”트레이스 중지
import { FirebasePerformance } from '@capgo/capacitor-firebase-performance';
await FirebasePerformance.stopTrace({} as StopTraceOptions);incrementMetric
Section titled “incrementMetric”선택한 트레이스에서 지정된 이름의 메트릭을 원자적으로 증가시킵니다. incrementBy 값입니다.
import { FirebasePerformance } from '@capgo/capacitor-firebase-performance';
await FirebasePerformance.incrementMetric({} as IncrementMetricOptions);setEnabled
setEnabled성능 모니터링을 활성화하거나 비활성화합니다. 앱이 다음으로 시작될 때 적용됩니다.
import { FirebasePerformance } from '@capgo/capacitor-firebase-performance';
await FirebasePerformance.setEnabled({} as SetEnabledOptions);isEnabled
isEnabled성능 모니터링이 활성화되어 있는지 비활성화되어 있는지 결정합니다.
import { FirebasePerformance } from '@capgo/capacitor-firebase-performance';
await FirebasePerformance.isEnabled();putAttribute
putAttribute트레이스에 사용자 지정 속성을 지정된 값으로 설정합니다.
import { FirebasePerformance } from '@capgo/capacitor-firebase-performance';
await FirebasePerformance.putAttribute({} as PutAttributeOptions);getAttribute
getAttributetrace의 사용자 정의 속성을 반환합니다.
import { FirebasePerformance } from '@capgo/capacitor-firebase-performance';
await FirebasePerformance.getAttribute({} as GetAttributeOptions);getAttributes
getAttributestrace의 모든 사용자 정의 속성과 그 값을 가져옵니다.
import { FirebasePerformance } from '@capgo/capacitor-firebase-performance';
await FirebasePerformance.getAttributes({} as GetAttributesOptions);removeAttribute
removeAttributetrace에서 사용자 정의 속성을 삭제합니다.
import { FirebasePerformance } from '@capgo/capacitor-firebase-performance';
await FirebasePerformance.removeAttribute({} as RemoveAttributeOptions);putMetric
putMetric사용자 정의 메트릭의 값을 설정합니다.
import { FirebasePerformance } from '@capgo/capacitor-firebase-performance';
await FirebasePerformance.putMetric({} as PutMetricOptions);getMetric
getMetric이름에 해당하는 사용자 정의 지표의 값을 가져옵니다.
import { FirebasePerformance } from '@capgo/capacitor-firebase-performance';
await FirebasePerformance.getMetric({} as GetMetricOptions);record
기록이름과 옵션을 사용하여 트레이스 기록합니다.
웹에서만 사용할 수 있습니다.
import { FirebasePerformance } from '@capgo/capacitor-firebase-performance';
await FirebasePerformance.record({} as RecordOptions);타입 참조
타입 참조StartTraceOptions
트레이스 시작 옵션export interface StartTraceOptions { /** * Custom trace name. * * Names for custom code traces must meet the following requirements: * no leading or trailing whitespace, no leading underscore (_) character, * and max length is 100 characters. * * @since 0.1.0 */ traceName: string;}StopTraceOptions
트레이스 중지 옵션export interface StopTraceOptions { /** * Name of the trace that was set with `startTrace`. * * @since 0.1.0 */ traceName: string;}IncrementMetricOptions
IncrementMetricOptions 섹션export interface IncrementMetricOptions { /** * Name of the trace that was set with `startTrace`. * * @since 0.1.0 */ traceName: string; /** * Name of the metric to be incremented. * * @since 0.1.0 */ metricName: string; /** * Amount by which the metric has to be incremented. * * @default 1 * @since 0.1.0 */ incrementBy?: number;}SetEnabledOptions
SetEnabledOptions 섹션export interface SetEnabledOptions { /** * Should performance monitoring be enabled. * * @since 0.1.0 */ enabled: boolean;}IsEnabledResult
IsEnabledResult 섹션export interface IsEnabledResult { /** * `true` if performance monitoring is enabled, otherwise `false`. * * @since 0.1.0 */ enabled: boolean;}PutAttributeOptions
PutAttributeOptions 섹션export interface PutAttributeOptions { /** * Name of the trace to set its attribute. * * @since 6.3.0 */ traceName: string; /** * Name of the attribute to set its value. * * @since 6.3.0 * @example "experiment" */ attribute: string; /** * The value to set to the attribute. * * @since 6.3.0 * @example "A" */ value: string;}GetAttributeOptions
GetAttributeOptions 섹션export interface GetAttributeOptions { /** * Name of the trace to set its attribute. * * @since 6.3.0 */ traceName: string; /** * Name of the attribute to retrieve its value. * * @since 6.3.0 */ attribute: string;}GetAttributeResult
GetAttributeResult 섹션export interface GetAttributeResult { /** * The value of the custom attribute. * * @since 6.3.0 */ value: string | null;}GetAttributesOptions
Section titled “GetAttributesOptions”export interface GetAttributesOptions { /** * Name of the trace to get its attributes. * * @since 6.3.0 */ traceName: string;}GetAttributesResult
Section titled “GetAttributesResult”export interface GetAttributesResult { /** * A map of all custom attributes of a trace with their values. * * @since 6.3.0 */ attributes: { [key: string]: string };}RemoveAttributeOptions
Section titled “RemoveAttributeOptions”export type RemoveAttributeOptions = GetAttributeOptions;PutMetricOptions
Section titled “PutMetricOptions”export interface PutMetricOptions { /** * Name of the trace to set its metric. * * @since 6.3.0 */ traceName: string; /** * The metric name. * * @since 6.3.0 */ metricName: string; /** * The value to set for the metric. * The given value is floored down to the nearest integer. * * @since 6.3.0 */ num: number;}실질적인 출처
Section titled “실질적인 출처”이 페이지는 플러그인의 src/definitions.ts공개 API이 업스트림에서 변경될 때 다시 싱크를 실행하세요.
다음 단계로 진행하기
다음 단계로 진행하기이러한 기능을 사용 중이라면 Getting Started 계획 대시보드 및 API 연산을 위해 사용하는 경우 API Overview API Overview API Overview 소개 __CAPGO_KEEP_0__ Keys API Keys for the implementation detail in API Keys, 기기 장치에서 구현 세부 정보를 위해 채널 채널에서 구현 세부 정보를 위해