Allez directement au contenu principal

Gestionnaire de statistiques d'utilisation plugin Capacitor

Access Android usage statistics to track app usage time and screen time analytics

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

How to use Manager des Statistiques d'Utilisation dans Capacitor

Utilisation de @capgo/capacitor-android-usagestatsmanager

plugin d'accès à UsageStatsManager Android Capacitor pour API.

Installation

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

Ce que ce Plugin Expose

  • queryAndAggregateUsageStats Analyse et agrège les statistiques d'utilisation pour la plage de temps 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 ouvrira l'écran de paramètres des statistiques d'utilisation, qui permet au utilisateur d'accorder la permission des statistiques d'utilisation. Cela ouvrira toujours l'écran de paramètres, même si la permission est déjà accordée.
  • queryAllPackages - Interroge toutes les applications installées sur le dispositif. Exige la permission QUERY_ALL_PACKAGES.

- Utilisation

queryAndAggregateUsageStats

Analyse et agrège les statistiques d'utilisation pour la plage de temps 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

Ouvrez l'écran de paramétrage des statistiques d'utilisation. Cela ouvrira l'écran de paramétrage des statistiques d'utilisation, qui permettra à l'utilisateur de concéder la permission d'accès aux statistiques d'utilisation. Cela ouvrira toujours l'écran de paramétrage, même si la permission est déjà accordée.

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

await CapacitorUsageStatsManager.openUsageStatsSettings();

queryAllPackages

Interroge toutes les applications installées sur le dispositif. Exige 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

Continuez à partir de l'utilisation de @capgo/capacitor-android-usagestatsmanager

Si vous utilisez Utilisation de @capgo/capacitor-android-usagestatsmanager pour planifier le tableau de bord et les opérations de API, connectez-l’avec @capgo/capacitor-android-usagestatsmanager pour les détails d'implémentation dans @capgo/capacitor-android-usagestatsmanager Getting Started pour les détails d'implémentation dans Démarrage API Vue d'ensemble pour les détails d'implémentation dans API Vue d'ensemble Introduction pour les détails d'implémentation dans Introduction, et API Clés pour les détails d'implémentation dans API Clés.

FAQ

FAQ du gestionnaire de statistiques d'utilisation du plugin

How do I install the Usage Stats Manager plugin in a Capacitor app?

Exécutez « bun add @capgo/capacitor-android-usagestatsmanager » (ou « npm install @capgo/capacitor-android-usagestatsmanager »), puis exécutez « bunx cap sync » afin que les projets iOS et Android prennent en compte le projet natif code. Importez-l’à partir de « @capgo/capacitor-android-usagestatsmanager » dans votre application code.

Does @capgo/capacitor-android-usagestatsmanager work with React, Vue and Angular?

Oui. Le gestionnaire de statistiques d'utilisation est un paquet Capacitor, il fonctionne donc avec tout framework web qui s'exécute à l'intérieur de Capacitor, y compris Ionic, React, Vue, Angular, Svelte et JavaScript pur.

Quelle version de Capacitor est prise en charge 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, plugin v8 avec Capacitor 8). La table de compatibilité dans le fichier README du GitHub liste les versions maintenues.

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

Oui. Le code source code est public sur GitHub à https://github.com/Cap-go/capacitor-android-usagestatsmanager/ et le package est gratuit pour l'installation depuis npm. Les rapports de bugs et les demandes de mise à jour sont les bienvenus.

Can I update code that uses Usage Stats Manager without an App Store review?

L'installation ou la mise à niveau du plugin modifie le code natif code, il faut donc une nouvelle mise à jour de l'application. Une fois cela fait, les modifications JavaScript, HTML et CSS qui appellent le plugin peuvent être déployées instantanément avec les mises à jour Capgo.

Ship Usage Stats Manager changes without waiting for app review

Once the plugin is in your store build, Capgo live updates push your JavaScript, HTML and CSS changes to users in minutes.

Commencez avec Capgo