Saltar al contenido principal

Gestor de estadísticas de uso plugin Capacitor

Accede a las estadísticas de uso de Android para medir el tiempo de uso de la app y el tiempo de pantalla

Instalar

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

Guía

Cómo usar Usage Stats Manager en Capacitor

Uso de @capgo/capacitor-android-usagestatsmanager

Plugin de Capacitor para acceder a Android UsageStatsManager API.

Instalar

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

Lo que expone este plugin

  • queryAndAggregateUsageStats - Consulta y agrega estadísticas de uso para el rango de tiempo indicado.
  • isUsageStatsPermissionGranted - Comprueba si se ha concedido el permiso de estadísticas de uso.
  • openUsageStatsSettings - Abre la pantalla de configuración de estadísticas de uso. Esto abrirá la pantalla de configuración de estadísticas de uso, que permite al usuario conceder el permiso de estadísticas de uso. Esto abrirá siempre la pantalla de configuración, incluso si el permiso ya está concedido.
  • queryAllPackages - Consulta todos los paquetes instalados en el dispositivo. Requiere el permiso QUERY_ALL_PACKAGES.

Ejemplo de uso

queryAndAggregateUsageStats

Consulta y agrega estadísticas de uso para el rango de tiempo indicado.

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

Comprueba si se ha concedido el permiso de estadísticas de uso.

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

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

openUsageStatsSettings

Abre la pantalla de configuración de estadísticas de uso. Esto abrirá la pantalla de configuración de estadísticas de uso, que permite al usuario conceder el permiso de estadísticas de uso. Esto abrirá siempre la pantalla de configuración, incluso si el permiso ya está concedido.

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

await CapacitorUsageStatsManager.openUsageStatsSettings();

queryAllPackages

Consulta todos los paquetes instalados en el dispositivo. Requiere el permiso 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}`);
});

Referencia completa

Continúa desde Uso de @capgo/capacitor-android-usagestatsmanager

Si estás usando Uso de @capgo/capacitor-android-usagestatsmanager para planificar las operaciones del dashboard y de API, conéctalo con @capgo/capacitor-android-usagestatsmanager para los detalles de implementación en @capgo/capacitor-android-usagestatsmanager, Primeros pasos para los detalles de implementación en Primeros pasos, Resumen de API para los detalles de implementación en API Overview, Introducción para los detalles de implementación en Introducción, y Claves de API para los detalles de implementación en API Keys.

FAQ

FAQ del plugin Usage Stats Manager

¿Cómo instalo el plugin Usage Stats Manager en una app Capacitor?

Ejecuta "bun add @capgo/capacitor-android-usagestatsmanager" (o "npm install @capgo/capacitor-android-usagestatsmanager"), luego ejecuta "bunx cap sync" para que los proyectos de iOS y Android reconozcan el code nativo. Impórtalo desde "@capgo/capacitor-android-usagestatsmanager" en el code de tu app.

¿Es compatible @capgo/capacitor-android-usagestatsmanager con React, Vue y Angular?

Sí. Usage Stats Manager es un paquete Capacitor, por lo que funciona con cualquier framework web que se ejecute dentro de Capacitor, incluyendo Ionic, React, Vue, Angular, Svelte y JavaScript puro.

¿Qué versión de Capacitor soporta @capgo/capacitor-android-usagestatsmanager?

Los plugins de Capgo siguen la versión mayor de Capacitor: usa la versión mayor del plugin que coincida con la versión mayor de tu Capacitor (por ejemplo, el plugin v8 con Capacitor 8). La tabla de compatibilidad del README de GitHub lista las versiones mantenidas.

¿Es @capgo/capacitor-android-usagestatsmanager gratuito y de código abierto?

Sí. El código fuente de code es público en GitHub: https://github.com/Cap-go/capacitor-android-usagestatsmanager/ y el paquete se instala gratis desde npm. Los reportes de bugs y pull requests son bienvenidos.

¿Puedo actualizar code que usa Usage Stats Manager sin pasar por la revisión de la App Store?

Instalar o actualizar el plugin cambia el code nativo, así que requiere un nuevo build para la tienda. Después, los cambios de JavaScript, HTML y CSS que llamen al plugin se pueden publicar al instante con las live updates de Capgo.

Publica cambios en Usage Stats Manager sin esperar la revisión de la app

Una vez que el plugin esté en tu store build, Capgo live updates envía tus cambios de JavaScript, HTML y CSS a los usuarios en minutos.

Empieza con Capgo