본문으로 건너뛰기

사용 통계 관리 Capacitor 플러그인

안드로이드 사용 통계를 통해 앱 사용 시간과 화면 시간 분석을 추적

설치

bun add @capgo/capacitor-android-usagestatsmanager bunx cap sync
npm, pnpm 또는 yarn
  • npm install @capgo/capacitor-android-usagestatsmanager
  • pnpm add @capgo/capacitor-android-usagestatsmanager
  • yarn add @capgo/capacitor-android-usagestatsmanager

설명서

Usage Stats Manager를 사용하는 방법은 Capacitor

기기에서 테스트

Capgo 앱을 다운로드하고 QR코드 code를 스캔하세요.

사용 통계 관리 플러그인 미리보기 QR code

@capgo/capacitor-android-usagestatsmanager을 사용

Capacitor 플러그인은 Android 사용자 통계 관리 API에 접근할 수 있습니다.

설치

bun add @capgo/capacitor-android-usagestatsmanager
bunx cap sync

이 플러그인은 다음을 제공합니다.

  • queryAndAggregateUsageStats - 지정된 시간 범위 내의 사용량 통계를 조회하고 집계합니다.
  • isUsageStatsPermissionGranted - 사용량 통계 권한이 부여되었는지 확인합니다.
  • openUsageStatsSettings - 사용량 통계 설정 화면을 열어줍니다. 사용자에게 사용량 통계 권한을 부여하도록 허용하는 화면을 열어줍니다. 권한이 이미 부여되어 있더라도 항상 설정 화면을 열어줍니다.
  • queryAllPackages - 장치에 설치된 모든 패키지를 조회합니다. QUERY_ALL_PACKAGES 권한이 필요합니다.

예시 사용법

queryAndAggregateUsageStats

- 지정된 시간 범위 내의 사용량 통계를 조회하고 집계합니다.

import { CapacitorUsageStatsManager } from '@capgo/capacitor-android-usagestatsmanager';

const oneDayAgo = Date.now() - 24 * 60 * 60 * 1000;
const now = Date.now();
const stats = await CapacitorUsageStatsManager.queryAndAggregateUsageStats({
  beginTime: oneDayAgo,
  endTime: now
});

for (const [packageName, usageData] of Object.entries(stats)) {
  console.log(`${packageName}: ${usageData.totalTimeInForeground}ms`);
}

isUsageStatsPermissionGranted

- 사용량 통계 권한이 부여되었는지 확인합니다.

import { CapacitorUsageStatsManager } from '@capgo/capacitor-android-usagestatsmanager';

const { granted } = await CapacitorUsageStatsManager.isUsageStatsPermissionGranted();
if (!granted) {
  await CapacitorUsageStatsManager.openUsageStatsSettings();
}

openUsageStatsSettings

- 사용량 통계 설정 화면을 열어줍니다. 사용자에게 사용량 통계 권한을 부여하도록 허용하는 화면을 열어줍니다. 권한이 이미 부여되어 있더라도 항상 설정 화면을 열어줍니다.

import { CapacitorUsageStatsManager } from '@capgo/capacitor-android-usagestatsmanager';

await CapacitorUsageStatsManager.openUsageStatsSettings();

queryAllPackages

- 장치에 설치된 모든 패키지를 조회합니다. QUERY_ALL_PACKAGES 권한이 필요합니다.

import { CapacitorUsageStatsManager } from '@capgo/capacitor-android-usagestatsmanager';

const { packages } = await CapacitorUsageStatsManager.queryAllPackages();
packages.forEach(pkg => {
  console.log(`${pkg.appName} (${pkg.packageName}): v${pkg.versionName}`);
});

전체 참조

Using @capgo/capacitor-android-usagestatsmanager

이 기능을 사용 중이라면 @capgo/capacitor-안드로이드 사용 통계 관리자 @API/__CAPGO_KEEP_1__-android-usagestatsmanager @capgo/capacitor-안드로이드 사용 통계 관리자 @capgo/capacitor-안드로이드 사용 통계 관리자 구현 세부 사항 @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-android-usagestatsmanager 를 사용하여 @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-android-usagestatsmanager API 개요 API 개요 소개 소개에서 구현 세부 정보를 위해 API 키 API 키에서 구현 세부 정보를 위해

FAQ

사용 통계 관리자 플러그인 FAQ

Usage Stats Manager 플러그인을 Capacitor 앱에 설치하는 방법은?

Run "bun add @capgo/capacitor-android-usagestatsmanager" (or "npm install @capgo/capacitor-android-usagestatsmanager"), then run "bunx cap sync" so the iOS and Android projects pick up the native code. Import it from "@capgo/capacitor-android-usagestatsmanager" in your app code.

@capgo/capacitor-안드로이드 사용 통계 관리자는 React, Vue 및 Angular와 함께 작동합니까?

React, Vue 및 Angular과 함께 @Capacitor/Capacitor-android-usagestatsmanager가 작동하는지?

Which Capacitor version does @capgo/capacitor-android-usagestatsmanager support?

Capgo plugins follow Capacitor's major version: use the plugin major version that matches your Capacitor major version (for example plugin v8 with Capacitor 8). The compatibility table in the GitHub README lists the maintained versions.

@capgo/capacitor-android-usagestatsmanager은 무료이며 오픈 소스인가요?

Yes. The source code is public on GitHub at https://github.com/Cap-go/capacitor-android-usagestatsmanager/ and the package is free to install from npm. Bug reports and pull requests are welcome.

앱 스토어 리뷰 없이 Usage Stats Manager를 사용하는 code를 업데이트 할 수 있나요?

플러그인을 설치하거나 업그레이드하면 네이티브 code이 변경되므로 새로운 스토어 빌드를 필요로 합니다. 그 후에 JavaScript, HTML 및 CSS 변경 사항이 플러그인을 호출하는 경우 Capgo 라이브 업데이트와 함께 즉시 배포할 수 있습니다.

__CAPGO_KEEP_0__ 앱 스토어 빌드에 플러그인을 추가하면, Ship Usage Stats Manager 변경 사항이 앱 리뷰 대기 없이 적용됩니다.

Capgo를 시작하세요.

Capgo