Aller au contenu principal

Gestionnaire de statistiques d'utilisation Plugin Capacitor

Accédez aux statistiques d'usage Android pour suivre le temps d'utilisation des apps et analyser le temps d'écran

Installer

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

Guide

Comment utiliser Usage Stats Manager dans Capacitor

Utiliser @capgo/capacitor-android-usagestatsmanager

Plugin Capacitor pour accéder aux API de l'UsageStatsManager d'Android

Installer

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

Ce que ce plugin expose

  • queryAndAggregateUsageStats - Interroge et agrège les statistiques d'utilisation sur la période donnée.
  • isUsageStatsPermissionGranted - Vérifie si la permission des statistiques d'utilisation est accordée.
  • openUsageStatsSettings - Ouvrir l'écran de paramètres des statistiques d'utilisation. Cela ouvre l'écran de paramètres, qui permet à l'utilisateur d'accorder la permission des statistiques d'utilisation. L'écran de paramètres s'ouvre toujours, même si la permission est déjà accordée.
  • queryAllPackages - Interroge tous les packages installés sur l'appareil. Nécessite la permission QUERY_ALL_PACKAGES.

Exemple d'utilisation

queryAndAggregateUsageStats

Interroge et agrège les statistiques d'utilisation sur la période donnée.

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

Vérifie si la permission des statistiques d'utilisation est accordée.

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

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

openUsageStatsSettings

Ouvrir l'écran de paramètres des statistiques d'utilisation. Cela ouvre l'écran de paramètres, qui permet à l'utilisateur d'accorder la permission des statistiques d'utilisation. L'écran de paramètres s'ouvre toujours, même si la permission est déjà accordée.

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

await CapacitorUsageStatsManager.openUsageStatsSettings();

queryAllPackages

Interroge tous les packages installés sur l'appareil. Nécessite la permission 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}`);
});

Référence complète

Continuer avec l'utilisation de @capgo/capacitor-android-usagestatsmanager

Si vous utilisez Utiliser @capgo/capacitor-android-usagestatsmanager pour planifier les opérations du dashboard et de API, connectez-l’avec @capgo/capacitor-android-usagestatsmanager pour les détails d'implémentation dans @capgo/capacitor-android-usagestatsmanager, Prise en main pour les détails d'implémentation dans Getting Started Aperçu de API pour les détails d'implémentation dans « Vue d'ensemble de API », Introduction pour les détails d'implémentation dans l'Introduction, et Clés API pour les détails d'implémentation dans les clés API.

FAQ

FAQ du plugin Usage Stats Manager

Comment installer le plugin Usage Stats Manager dans une application Capacitor ?

Exécutez "bun add @capgo/capacitor-android-usagestatsmanager" (ou "npm install @capgo/capacitor-android-usagestatsmanager"), puis lancez "bunx cap sync" pour que les projets iOS et Android prennent en compte le code natif. Importez-le depuis "@capgo/capacitor-android-usagestatsmanager" dans votre code.

Est-ce que @capgo/capacitor-android-usagestatsmanager fonctionne avec React, Vue et Angular ?

Oui. Usage Stats Manager est un package Capacitor, il fonctionne donc avec n'importe quel framework web tournant dans Capacitor, y compris Ionic, React, Vue, Angular, Svelte et le JavaScript pur.

Quelle version de Capacitor est supportée par @capgo/capacitor-android-usagestatsmanager ?

Les plugins Capgo suivent la version majeure de Capacitor : utilisez la version majeure du plugin qui correspond à la version majeure de votre Capacitor (par exemple le plugin v8 avec Capacitor 8). Le tableau de compatibilité du README de GitHub recense les versions maintenues.

Est-ce que @capgo/capacitor-android-usagestatsmanager est gratuit et open source ?

Oui. Le code source code est public sur GitHub à l'adresse https://github.com/Cap-go/capacitor-android-usagestatsmanager/ et le package est gratuit à installer via npm. Les rapports de bugs et les pull requests sont les bienvenus.

Puis-je mettre à jour code utilisant Usage Stats Manager sans passer par une revue de l'App Store ?

L'installation ou la mise à jour du plugin modifie le code natif, ce qui impose un nouveau build pour les stores. Ensuite, les changements JavaScript, HTML et CSS qui appellent le plugin peuvent être livrés instantanément via les live updates de Capgo.

Déployez les changements de Usage Stats Manager sans attendre la validation de l'app

Une fois le plugin intégré à votre build de store, Capgo live updates déploie vos changements JavaScript, HTML et CSS aux utilisateurs en quelques minutes.

Commencez avec Capgo