Usage Stats Manager Capacitor plugin

Using @capgo/capacitor-android-usagestatsmanager

Capacitor plugin for accessing Android UsageStatsManager API.

Install

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

What This Plugin Exposes

• queryAndAggregateUsageStats - Queries and aggregates usage stats for the given time range.
• isUsageStatsPermissionGranted - Checks if the usage stats permission is granted.
• openUsageStatsSettings - Open the usage stats settings screen. This will open the usage stats settings screen, which allows the user to grant the usage stats permission. This will always open the settings screen, even if the permission is already granted.
• queryAllPackages - Queries all installed packages on the device. Requires the QUERY_ALL_PACKAGES permission.

Example Usage

queryAndAggregateUsageStats

Queries and aggregates usage stats for the given time range.

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

Checks if the usage stats permission is granted.

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

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

openUsageStatsSettings

Open the usage stats settings screen. This will open the usage stats settings screen, which allows the user to grant the usage stats permission. This will always open the settings screen, even if the permission is already granted.

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

await CapacitorUsageStatsManager.openUsageStatsSettings();

queryAllPackages

Queries all installed packages on the device. Requires the QUERY_ALL_PACKAGES permission.

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

const { packages } = await CapacitorUsageStatsManager.queryAllPackages();
packages.forEach(pkg => {
  console.log(`${pkg.appName} (${pkg.packageName}): v${pkg.versionName}`);
});

Full Reference

• GitHub: https://github.com/Cap-go/capacitor-android-usagestatsmanager/
• Docs: /docs/plugins/android-usagestatsmanager/

Keep going from Using @capgo/capacitor-android-usagestatsmanager

If you are using Using @capgo/capacitor-android-usagestatsmanager to plan dashboard and API operations, connect it with @capgo/capacitor-android-usagestatsmanager for the implementation detail in @capgo/capacitor-android-usagestatsmanager, Getting Started for the implementation detail in Getting Started, API Overview for the implementation detail in API Overview, Introduction for the implementation detail in Introduction, and API Keys for the implementation detail in API Keys.