Salta al contenuto principale

Gestore statistiche di utilizzo Plugin Capacitor

Accedi ai dati di utilizzo di Android per monitorare l'uso dell'app e analizzare lo screen time

Installa

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

Guida

Come usare Usage Stats Manager in Capacitor

Utilizzo di @capgo/capacitor-android-usagestatsmanager

Plugin Capacitor per accedere alle API di Android UsageStatsManager

Installa

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

Cosa espone questo plugin

  • queryAndAggregateUsageStats - Interroga e aggrega le statistiche di utilizzo per l'intervallo di tempo specificato.
  • isUsageStatsPermissionGranted - Verifica se il permesso per le statistiche di utilizzo è stato concesso.
  • openUsageStatsSettings Apri la schermata delle impostazioni per le statistiche di utilizzo. Questo aprirà la schermata delle impostazioni, permettendo all'utente di concedere il permesso. La schermata verrà aperta sempre, anche se il permesso è già attivo.
  • queryAllPackages Interroga tutti i pacchetti installati sul dispositivo. Richiede il permesso QUERY_ALL_PACKAGES.

Esempio d'uso

queryAndAggregateUsageStats

Interroga e aggrega le statistiche di utilizzo per l'intervallo di tempo specificato.

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

Verifica se il permesso per le statistiche di utilizzo è stato concesso.

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

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

openUsageStatsSettings

Apri la schermata delle impostazioni per le statistiche di utilizzo. Questo aprirà la schermata delle impostazioni, permettendo all'utente di concedere il permesso. La schermata verrà aperta sempre, anche se il permesso è già attivo.

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

await CapacitorUsageStatsManager.openUsageStatsSettings();

queryAllPackages

Interroga tutti i pacchetti installati sul dispositivo. Richiede il permesso 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}`);
});

Riferimento completo

Continua da Usare @capgo/capacitor-android-usagestatsmanager

Se stai usando Usare @capgo/capacitor-android-usagestatsmanager per pianificare le operazioni della dashboard e di API, collegalo a @capgo/capacitor-android-usagestatsmanager per i dettagli di implementazione in @capgo/capacitor-android-usagestatsmanager, Per iniziare per i dettagli di implementazione nella guida introduttiva, Panoramica API per i dettagli di implementazione in Panoramica di API, Introduzione per i dettagli implementativi nell'Introduzione, e Chiavi API per i dettagli implementativi in API Keys.

FAQ

FAQ sul plugin Usage Stats Manager

Come installo il plugin Usage Stats Manager in un'app Capacitor?

Esegui "bun add @capgo/capacitor-android-usagestatsmanager" (o "npm install @capgo/capacitor-android-usagestatsmanager"), poi lancia "bunx cap sync" in modo che i progetti iOS e Android integrino il code nativo. Importalo da "@capgo/capacitor-android-usagestatsmanager" nel code della tua app.

@capgo/capacitor-android-usagestatsmanager funziona con React, Vue e Angular?

Sì. Usage Stats Manager è un pacchetto Capacitor, quindi funziona con qualsiasi web framework in esecuzione all'interno di Capacitor, inclusi Ionic, React, Vue, Angular, Svelte e JavaScript puro.

Quale versione di Capacitor è supportata da @capgo/capacitor-android-usagestatsmanager?

I plugin Capgo seguono la major version di Capacitor: usa la major version del plugin che corrisponde alla tua major version di Capacitor (ad esempio plugin v8 con Capacitor 8). La tabella di compatibilità nel README di GitHub elenca le versioni mantenute.

@capgo/capacitor-android-usagestatsmanager è free e open source?

Sì. Il codice sorgente code è pubblico su GitHub all'indirizzo https://github.com/Cap-go/capacitor-android-usagestatsmanager/ e il pacchetto è gratuito su npm. Segnalazioni di bug e pull request sono benvenute.

Posso aggiornare code che utilizza Usage Stats Manager senza passare per la revisione dell'App Store?

Installare o aggiornare il plugin modifica il code nativo, quindi serve una nuova build per lo store. Dopo, le modifiche a JavaScript, HTML e CSS che chiamano il plugin possono essere rilasciate subito con le live updates di Capgo.

Distribuisci aggiornamenti per Usage Stats Manager senza attendere la revisione dell'app

Una volta incluso il plugin nel tuo store build, Capgo invia le modifiche a JavaScript, HTML e CSS tramite live updates in pochi minuti.

Inizia con Capgo