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 Nutzungsstatistiken für den angegebenen Zeitraum ab und aggregiert diese.
  • isUsageStatsPermissionGranted - Prüft, ob die Berechtigung für Nutzungsstatistiken erteilt wurde.
  • openUsageStatsSettings Öffnet die Einstellungen für Nutzungsstatistiken. Damit gelangt der Nutzer direkt zu den Einstellungen, um die Berechtigung zu erteilen. Die Einstellungen werden immer geöffnet, auch wenn die Berechtigung bereits vorliegt.
  • queryAllPackages - Fragt alle auf dem Gerät installierten Pakete ab. 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 die Einstellungen für Nutzungsstatistiken. Damit gelangt der Nutzer direkt zu den Einstellungen, um die Berechtigung zu erteilen. Die Einstellungen werden immer geöffnet, auch wenn die Berechtigung bereits vorliegt.

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

await CapacitorUsageStatsManager.openUsageStatsSettings();

queryAllPackages

Fragt alle auf dem Gerät installierten Pakete ab. 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 der Nutzung von @capgo/capacitor-android-usagestatsmanager

Wenn du es nutzt Nutzung 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

FAQ zum Usage Stats Manager Plugin

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 die nativen code übernehmen. Importiere es in deiner App code aus "@capgo/capacitor-android-usagestatsmanager".

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

Ja. Der 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 wird von @capgo/capacitor-android-usagestatsmanager unterstützt?

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 code Code ist öffentlich auf GitHub unter https://github.com/Cap-go/capacitor-android-usagestatsmanager/ einsehbar und das Package kann kostenlos via npm installiert werden. Bug-Reports und Pull Requests sind willkommen.

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

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