Saltare al contenuto principale

Manager dei dati di utilizzo plugin Capacitor

Accedi alle statistiche di utilizzo Android per tracciare il tempo di utilizzo dell'app e le analisi di tempo di schermo

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

How to use Usage Stats Manager in Capacitor

Testa sul dispositivo

Scarica l'app Capgo, poi scansione il codice QR code.

Usage Stats Manager plugin preview QR code

Utilizzo di @capgo/capacitor-android-usagestatsmanager

Plugin Capacitor per l'accesso al gestore dei dati di utilizzo Android API

Installa

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

Cosa questo plugin espone

  • queryAndAggregateUsageStats - Esegue query e aggrega i dati di utilizzo per l'intervallo di tempo specificato.
  • isUsageStatsPermissionGranted - Verifica se è autorizzato l'accesso ai dati di utilizzo.
  • openUsageStatsSettings - Apri la schermata di impostazioni dei dati di utilizzo. Questo aprirà la schermata di impostazioni dei dati di utilizzo, che consente all'utente di autorizzare l'accesso ai dati di utilizzo. Questo aprirà sempre la schermata di impostazioni, anche se l'autorizzazione è già stata concessa.
  • queryAllPackages - Esegue tutte le query sui pacchetti installati sul dispositivo. Richiede la permessione QUERY_ALL_PACKAGES.

Esempio di utilizzo

queryAndAggregateUsageStats

Esegue query e aggrega statistiche di utilizzo per il range 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 è stato concesso il permesso per le statistiche di utilizzo.

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

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

openUsageStatsSettings

Apre la schermata di impostazioni delle statistiche di utilizzo. Questo aprirà la schermata di impostazioni delle statistiche di utilizzo, che consente all'utente di concedere la permessione per le statistiche di utilizzo. Questo aprirà sempre la schermata di impostazioni, anche se la permessione è già stata concessa.

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

await CapacitorUsageStatsManager.openUsageStatsSettings();

queryAllPackages

Esegue tutte le query sui pacchetti installati sul dispositivo. Richiede la permessione 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 dall'uso di @capgo/capacitor-android-usagestatsmanager

Se stai utilizzando Utilizzando @capgo/capacitor-android-usagestatsmanager per pianificare il dashboard e le operazioni API, connettilo con @capgo/capacitor-android-usagestatsmanager per i dettagli di implementazione in @capgo/capacitor-android-usagestatsmanager, Avvio rapido per i dettagli di implementazione in Avvio rapido, Panoramica di API per i dettagli di implementazione in Panoramica di API, Introduzione per i dettagli di implementazione in Introduzione, e Chiavi di API per i dettagli di implementazione in Chiavi di API.

FAQ

Domande frequenti sul plugin Usage Stats Manager

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

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

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

Sì. Il gestore delle statistiche di utilizzo è un pacchetto Capacitor, quindi funziona con qualsiasi framework web che esegue all'interno di Capacitor, compresi Ionic, React, Vue, Angular, Svelte e JavaScript puro.

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

Il pacchetti Capgo seguono la versione maggiore di Capacitor: utilizza la versione maggiore del plugin che corrisponde alla tua versione maggiore di Capacitor (ad esempio plugin v8 con Capacitor 8). La tabella di compatibilità nel README di GitHub elenca le versioni mantenute.

È gratuito e open source @capgo/capacitor-android-usagestatsmanager?

Sì. Il codice sorgente di code è pubblico su GitHub all'indirizzo https://github.com/Cap-go/capacitor-android-usagestatsmanager/ e il pacchetto è gratuito per l'installazione da npm. Sono accetti i rapporti di bug e le richieste di pull.

Posso aggiornare code che utilizza il gestore delle statistiche di utilizzo senza una revisione dell'App Store?

L'installazione o l'aggiornamento del plugin modifica il code nativo, quindi richiede una nuova costruzione dello store. Dopo di che, le modifiche JavaScript, HTML e CSS che chiamano il plugin possono essere spediti immediatamente con gli aggiornamenti live di Capgo.

Ship Usage Stats Manager changes without waiting for app review

Una volta che il plugin è presente nella tua build di store, Capgo le aggiornamenti in tempo reale inviano le tue modifiche JavaScript, HTML e CSS agli utenti in pochi minuti.

Inizia con Capgo