Saltar al contenido principal

Administrador de estadísticas de uso plugin de Capacitor

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

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 el Administrador de Estadísticas de Uso en Capacitor

Probar en dispositivo

Descargue la aplicación Capgo, luego escane el código QR code.

Administrador de Estadísticas de Uso plugin preview QR code

Usando @capgo/capacitor-android-usagestatsmanager

Plugin Capacitor para acceder a Android UsageStatsManager API.

Instalar

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

¿Qué Exposición de este Plugin?

  • queryAndAggregateUsageStats - Consulta y agrupa estadísticas de uso para el rango de tiempo dado.
  • isUsageStatsPermissionGranted - Verifica si se ha concedido la permiso de estadísticas de uso.
  • openUsageStatsSettings - Abre la pantalla de ajustes de estadísticas de uso. Esta abrirá la pantalla de ajustes de estadísticas de uso, que permite al usuario conceder la permiso de estadísticas de uso. Esta siempre abrirá la pantalla de ajustes, incluso si ya se ha concedido la permiso.
  • queryAllPackages - Consulta todos los paquetes instalados en el dispositivo. Requiere la permiso de QUERY_ALL_PACKAGES.

Uso de ejemplo

queryAndAggregateUsageStats

Consulta y agrupa estadísticas de uso para el rango de tiempo dado.

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 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 ajustes de estadísticas de uso. Esto abrirá la pantalla de ajustes de estadísticas de uso, que permite al usuario conceder el permiso de estadísticas de uso. Esto siempre abrirá la pantalla de ajustes, incluso si el permiso ya se ha concedido.

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

await CapacitorUsageStatsManager.openUsageStatsSettings();

queryAllPackages

Consulta todos los paquetes instalados en el dispositivo. Requiere la permiso de 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

Si estás utilizando @capgo/capacitor-android-usagestatsmanager

Si estás utilizando Usando @capgo/capacitor-android-usagestatsmanager para planificar la consola y las operaciones de API, conecte con @capgo/capacitor-android-usagestatsmanager para obtener detalles de implementación en @capgo/capacitor-android-usagestatsmanager, Getting Started para obtener detalles de implementación en Inicio, Resumen de API para obtener detalles de implementación en Resumen de API, Introducción para obtener detalles de implementación en Introducción, y Claves de API para obtener detalles de implementación en Claves de API.

FAQ

Administrador de Estadísticas de Uso plugin FAQ

Cómo instalo el plugin de gestor de estadísticas de uso en una aplicación 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 capturen el code nativo. Importa desde "@capgo/capacitor-android-usagestatsmanager" en tu code de la aplicación.

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

Sí. El administrador de estadísticas de uso 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 Capgo siguen la versión principal de Capacitor: utilice la versión principal del plugin que coincida con la versión principal de Capacitor (por ejemplo, plugin v8 con Capacitor 8). La tabla de compatibilidad en el README del GitHub lista las versiones mantenidas.

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

Sí. El código fuente de code está disponible en GitHub en https://github.com/Cap-go/capacitor-android-usagestatsmanager/ y el paquete es gratuito para instalar desde npm. Se aceptan informes de errores y solicitudes de extracción.

¿Puedo actualizar code que utiliza el administrador de estadísticas de uso sin una revisión de la tienda?

La instalación o actualización del plugin cambia el code nativo, por lo que necesita una nueva construcción de la tienda. Después de eso, los cambios en JavaScript, HTML y CSS que llaman al plugin pueden enviar directamente con Capgo actualizaciones en vivo.

Ship Usage Stats Manager changes without waiting for app review

Una vez que el plugin esté en tu tienda de construcción, Capgo actualizaciones en vivo envían los cambios de JavaScript, HTML y CSS a los usuarios en minutos.

Comienza con Capgo