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

Usando @capgo/capacitor-android-usagestatsmanager

Plugin Capacitor para acceder a API de Android UsageStatsManager

Instalar

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

Lo que expone este plugin

  • queryAndAggregateUsageStats - Consulta y agrega estadísticas de uso en el rango de tiempo indicado.
  • isUsageStatsPermissionGranted - Comprueba si el permiso de estadísticas de uso está concedido.
  • openUsageStatsSettings Abre la pantalla de ajustes de estadísticas de uso. Esto abrirá la configuración de estadísticas de uso para que el usuario pueda conceder el permiso. Siempre abrirá la pantalla de ajustes, aunque 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 en 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 el permiso de estadísticas de uso está concedido.

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

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

openUsageStatsSettings

Abre la pantalla de ajustes de estadísticas de uso. Esto abrirá la configuración de estadísticas de uso para que el usuario pueda conceder el permiso. Siempre abrirá la pantalla de ajustes, aunque 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

Continuar desde Usando @capgo/capacitor-android-usagestatsmanager

Si estás usando Usando @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") y luego "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 es compatible con @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 en https://github.com/Cap-go/capacitor-android-usagestatsmanager/ y el paquete es gratuito para instalar desde npm. Se agradecen los reportes de bugs y pull requests.

¿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