Zum Hauptinhalt springen

Usage-Stats-Manager Capacitor Plugin

Greifen Sie auf Android-Nutzungsstatistiken zu, um die App-Nutzungsdauer und Screen-Time-Analysen zu tracken

Installieren

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

Anleitung

Usage Stats Manager in Capacitor nutzen

Verwendung von @capgo/capacitor-android-usagestatsmanager

Capacitor Plugin für den Zugriff auf den Android UsageStatsManager API.

Installieren

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

Was dieses Plugin bereitstellt

  • queryAndAggregateUsageStats - Fragt die Nutzungsstatistiken für den angegebenen Zeitraum ab und aggregiert sie.
  • isUsageStatsPermissionGranted - Prüft, ob die Berechtigung für Nutzungsstatistiken erteilt ist.
  • openUsageStatsSettings - Öffnet die Einstellungen für Nutzungsstatistiken. Dies führt den Nutzer direkt zu den Einstellungen, um die Berechtigung zu erteilen. Die Einstellungen werden immer geöffnet, auch wenn die Berechtigung bereits vorliegt.
  • queryAllPackages - Abfrage aller auf dem Gerät installierten Pakete. Erfordert die QUERY_ALL_PACKAGES-Berechtigung.

Anwendungsbeispiel

queryAndAggregateUsageStats

Fragt Nutzungsstatistiken für den angegebenen Zeitraum ab und aggregiert diese.

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

Prüft, ob die Berechtigung für Nutzungsstatistiken erteilt wurde.

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

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

openUsageStatsSettings

Öffnet den Bildschirm für die Nutzungsstatistik-Einstellungen. Dies öffnet den Bildschirm für die Nutzungsstatistik-Einstellungen, über den der Benutzer die Berechtigung für Nutzungsstatistiken erteilen kann. Der Bildschirm wird immer geöffnet, auch wenn die Berechtigung bereits erteilt wurde.

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

await CapacitorUsageStatsManager.openUsageStatsSettings();

queryAllPackages

Abfrage aller auf dem Gerät installierten Pakete. Erfordert die QUERY_ALL_PACKAGES-Berechtigung.

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

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

Vollständige Referenz

Weiter mit „@capgo/capacitor-android-usagestatsmanager verwenden“

Wenn du es nutzt Verwendung von @capgo/capacitor-android-usagestatsmanager um Dashboard- und API-Operationen zu planen, verbinde es mit @capgo/capacitor-android-usagestatsmanager für die Implementierungsdetails in @capgo/capacitor-android-usagestatsmanager, Erste Schritte für die Implementierungsdetails in Erste Schritte, API Übersicht für Details zur Implementierung im API Overview, Einführung für die Implementierungsdetails in der Einleitung und API Schlüssel für die Implementierungsdetails in den API Keys.

FAQ

Usage Stats Manager Plugin FAQ

Wie installiere ich das Usage Stats Manager Plugin in einer Capacitor-App?

Führe "bun add @capgo/capacitor-android-usagestatsmanager" (oder "npm install @capgo/capacitor-android-usagestatsmanager") aus und danach "bunx cap sync", damit die iOS- und Android-Projekte das native code übernehmen. Importiere es aus "@capgo/capacitor-android-usagestatsmanager" im code deiner App.

Funktioniert @capgo/capacitor-android-usagestatsmanager mit React, Vue und Angular?

Ja. Usage Stats Manager ist ein Capacitor-Package und funktioniert daher mit jedem Web-Framework, das in Capacitor läuft, einschließlich Ionic, React, Vue, Angular, Svelte und reinem JavaScript.

Welche Capacitor-Version unterstützt @capgo/capacitor-android-usagestatsmanager?

Capgo Plugins folgen der Major-Version von Capacitor: Nutze die Plugin-Major-Version, die zu deiner Capacitor Major-Version passt (z. B. Plugin v8 bei Capacitor 8). Die Kompatibilitätstabelle im GitHub README listet die gepflegten Versionen auf.

Ist @capgo/capacitor-android-usagestatsmanager kostenlos und Open Source?

Ja. Der Quellcode von code ist öffentlich auf GitHub unter https://github.com/Cap-go/capacitor-android-usagestatsmanager/ einsehbar, und das Package lässt sich kostenlos über npm installieren. Bug-Reports und Pull Requests sind willkommen.

Kann ich code mit dem Usage Stats Manager ohne App Store Review aktualisieren?

Die Installation oder ein Upgrade des Plugins ändert den nativen code, weshalb ein neuer Store-Build nötig ist. Danach können JavaScript-, HTML- und CSS-Änderungen, die das Plugin aufrufen, sofort per Capgo Live Updates ausgeliefert werden.

Änderungen am Usage Stats Manager ausrollen, ohne auf den App-Review zu warten

Sobald das Plugin in deinem Store-Build ist, bringt Capgo mit Live-Updates deine JavaScript-, HTML- und CSS-Änderungen in Minuten zu den Nutzern.

Starte mit Capgo