Erste Schritte

Copy a setup prompt with the install steps and the full markdown guide for this plugin.

        Set up this Capacitor plugin in the project.

Use the package manager already used by the project.
Install these package(s): `@capgo/capacitor-android-usagestatsmanager`
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/de/docs/plugins/android-usagestatsmanager/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.

Installation

npm install @capgo/capacitor-android-usagestatsmanager
npx cap sync

yarn add @capgo/capacitor-android-usagestatsmanager
npx cap sync

pnpm add @capgo/capacitor-android-usagestatsmanager
npx cap sync

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

Plattform-Konfiguration

Android

Fügen Sie die erforderlichen Berechtigungen zu Ihrer android/app/src/main/AndroidManifest.xml hinzu:

<uses-permission android:name="android.permission.PACKAGE_USAGE_STATS" />
<uses-permission android:name="android.permission.QUERY_ALL_PACKAGES" />

Verwendungsbeispiel

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

// Prüfen, ob die Berechtigung erteilt wurde
const permissionResult = await AndroidUsageStatsManager.isUsageStatsPermissionGranted();
if (!permissionResult.granted) {
  // Einstellungen öffnen, um die Berechtigung zu erteilen
  await AndroidUsageStatsManager.openUsageStatsSettings();
  return;
}

// Nutzungsstatistiken für die letzten 7 Tage abfragen
const statsOptions = {
  intervalType: 0, // INTERVAL_DAILY
  startTime: Date.now() - (7 * 24 * 60 * 60 * 1000), // vor 7 Tagen
  endTime: Date.now()
};

const usageStats = await AndroidUsageStatsManager.queryAndAggregateUsageStats(statsOptions);
console.log('Nutzungsstatistiken:', usageStats);

// Alle installierten Pakete abrufen
const packages = await AndroidUsageStatsManager.queryAllPackages();
console.log('Installierte Pakete:', packages);

API-Referenz

isUsageStatsPermissionGranted()

isUsageStatsPermissionGranted() => Promise<{ granted: boolean }>

Prüft, ob die PACKAGE_USAGE_STATS-Berechtigung erteilt wurde.

Rückgabewert: Promise<{ granted: boolean }>

openUsageStatsSettings()

openUsageStatsSettings() => Promise<void>

Öffnet die Systemeinstellungsseite zum Erteilen der Berechtigung für Nutzungsstatistiken.

queryAndAggregateUsageStats(options)

queryAndAggregateUsageStats(options: UsageStatsOptions) => Promise<UsageStatsResult>

Ruft detaillierte Nutzungsstatistiken für installierte Apps ab.

Parameter	Typ
`options`	`UsageStatsOptions`

Rückgabewert: Promise<UsageStatsResult>

queryAllPackages()

queryAllPackages() => Promise<PackagesResult>

Ruft Informationen über alle auf dem Gerät installierten Pakete ab.

Rückgabewert: Promise<PackagesResult>

Schnittstellen

UsageStatsOptions

Eigenschaft	Typ	Beschreibung
`intervalType`	`number`	Intervalltyp (0=TÄGLICH, 1=WÖCHENTLICH, 2=MONATLICH, etc.)
`startTime`	`number`	Startzeit in Millisekunden
`endTime`	`number`	Endzeit in Millisekunden

UsageStatsResult

Enthält Nutzungsstatistikdaten für jede App:

App-Nutzungszeit und -Häufigkeit
Erste und letzte Verwendung
Gesamtzeit im Vordergrund
Anzahl der Starts

PackagesResult

Enthält Informationen über installierte Pakete:

Paketname und Version
Installationszeit
App-Bezeichnungen und Icons
System- vs. Benutzer-Apps

Berechtigungsverwaltung

Das Plugin erfordert spezielle Berechtigungen, die nicht über normale Laufzeit-Berechtigungsanforderungen erteilt werden können:

PACKAGE_USAGE_STATS: Ermöglicht den Zugriff auf Nutzungsstatistiken
QUERY_ALL_PACKAGES: Erforderlich für Paketinformationen (Android 11+)

Benutzer müssen diese Berechtigungen manuell über die Systemeinstellungen erteilen. Verwenden Sie openUsageStatsSettings(), um Benutzer zur entsprechenden Einstellungsseite zu leiten.

Bewährte Methoden

Prüfen Sie immer den Berechtigungsstatus, bevor Sie Nutzungsstatistiken abfragen
Gehen Sie mit Berechtigungsablehnungen benutzerfreundlich um
Berücksichtigen Sie die Privatsphäre der Benutzer beim Sammeln von Nutzungsdaten
Implementieren Sie ordnungsgemäße Datenverarbeitungs- und Speicherpraktiken
Befolgen Sie die Google Play-Richtlinien für die Erfassung von Nutzungsdaten

Anwendungsfälle

Digital Wellbeing Apps: Bildschirmzeit und App-Nutzung überwachen
Kindersicherung: Gerätenutzung von Kindern verfolgen
Produktivitäts-Apps: Arbeitsmuster und Fokuszeiten analysieren
Analytics: Benutzerverhalten und App-Engagement verstehen