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 a Android UsageStatsManager API.

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 - Apre la schermata delle impostazioni per le statistiche di utilizzo. Questa azione apre la schermata delle impostazioni, che consente all'utente di concedere il permesso per le statistiche di utilizzo. Verrà sempre aperta la schermata delle impostazioni, anche se il permesso è già stato concesso.
  • 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 usage stats è stato concesso.

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

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

openUsageStatsSettings

Apre la schermata delle impostazioni per le statistiche di utilizzo. Questa azione apre la schermata delle impostazioni, che consente all'utente di concedere il permesso per le statistiche di utilizzo. Verrà sempre aperta la schermata delle impostazioni, anche se il permesso è già stato concesso.

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 Utilizzo di @capgo/capacitor-android-usagestatsmanager

Se stai usando Utilizzo di @capgo/capacitor-android-usagestatsmanager per pianificare le operazioni della dashboard e di API, collegalo a @capgo/capacitor-android-usagestatsmanager per i dettagli dell'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 del plugin Usage Stats Manager

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

Esegui "bun add @capgo/capacitor-android-usagestatsmanager" (oppure "npm install @capgo/capacitor-android-usagestatsmanager"), poi esegui "bunx cap sync" così che i progetti iOS e Android includano 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 framework web che gira all'interno di Capacitor, inclusi Ionic, React, Vue, Angular, Svelte e JavaScript puro.

Quale versione di Capacitor supporta @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 è gratuito e open source?

Sì. Il code sorgente è pubblico su GitHub all'indirizzo https://github.com/Cap-go/capacitor-android-usagestatsmanager/ e il pacchetto è gratuito da installare da npm. Bug report e pull request sono benvenuti.

Posso aggiornare code che usa Usage Stats Manager senza 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.

Pubblica le modifiche di Usage Stats Manager senza aspettare 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