跳过主要内容

使用统计管理 Capacitor 插件

访问 Android 使用统计数据,跟踪应用程序使用时间和屏幕时间分析

安装

bun add @capgo/capacitor-android-usagestatsmanager bunx cap sync
npm、pnpm 或 yarn
  • npm install @capgo/capacitor-android-usagestatsmanager
  • pnpm add @capgo/capacitor-android-usagestatsmanager
  • yarn add @capgo/capacitor-android-usagestatsmanager

指南

如何在Capacitor中使用使用统计管理器

在设备上测试

下载Capgo应用程序,然后扫描code的二维码。

使用统计数据管理器插件预览二维码 code

使用 @capgo/capacitor-android-usagestatsmanager

Capacitor 插件用于访问 Android UsageStatsManager API。

安装

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

此插件暴露的内容

  • queryAndAggregateUsageStats - 为给定时间范围查询和聚合使用统计数据。
  • isUsageStatsPermissionGranted - 检查是否已授予使用统计数据权限。
  • openUsageStatsSettings - 打开使用统计数据设置屏幕。该屏幕将打开,允许用户授予使用统计数据权限。即使权限已被授予,该屏幕也将始终打开。
  • queryAllPackages - 设备上查询所有已安装的包。需要 QUERY_ALL_PACKAGES 权限。

示例用法

queryAndAggregateUsageStats

查询和聚合给定时间范围内的使用统计数据。

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

检查使用统计权限是否已授权。

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

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

openUsageStatsSettings

打开使用统计设置屏幕。该屏幕将打开,允许用户授予使用统计权限。即使权限已授权,也会始终打开设置屏幕。

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

await CapacitorUsageStatsManager.openUsageStatsSettings();

queryAllPackages

- 设备上查询所有已安装的包。需要 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}`);
});

完整参考

继续使用 @capgo/capacitor-android-usagestatsmanager

如果您正在使用 使用@capgo/capacitor-android-usagestatsmanager 规划仪表板和API操作,连接它 @capgo/capacitor-安卓使用统计管理器 了解@capgo/capacitor-android-usagestatsmanager的实现细节 开始使用 了解开始使用的实现细节 API概述 了解API概述的实现细节 介绍 了解介绍的实现细节 API关键 了解API关键的实现细节

常见问题

使用统计管理器插件FAQ

如何在Capacitor应用中安装使用统计管理器插件?

运行"bun add @capgo/capacitor-android-usagestatsmanager" (或 "npm install @capgo/capacitor-android-usagestatsmanager" ),然后运行 "bunx cap sync" 以使 iOS 和 Android 项目捕获到本地 code。从 "@capgo/capacitor-android-usagestatsmanager" 中导入它到您的应用 code 中。

是否@capgo/capacitor-android-usagestatsmanager与React、Vue和Angular兼容?

是。使用统计管理器是一个Capacitor包,因此它与任何运行在Capacitor内的Web框架兼容,包括Ionic、React、Vue、Angular、Svelte和纯JavaScript。

哪个Capacitor版本@capgo/capacitor-android-usagestatsmanager支持?

Capgo插件遵循Capacitor的主要版本:使用与Capacitor主要版本匹配的插件主要版本(例如,插件v8与Capacitor 8)。在GitHub README中列出的兼容性表格中可以找到维护的版本。

是否@capgo/capacitor-android-usagestatsmanager免费且开源?

是。code的源代码在GitHub上公开,https://github.com/Cap-go/capacitor-android-usagestatsmanager/,并且该包可以从npm免费安装。欢迎bug报告和拉取请求。

是否可以在App Store审查无需更新code使用的使用统计管理器?

安装或升级插件会更改本机code,因此需要新建一个商店。之后,调用插件的JavaScript、HTML和CSS更改可以立即与Capgo实时更新一起发布。

不必等待应用程序审查就可以将使用情况统计管理器的更改交付

一旦插件在您的商店构建中,Capgo即刻推送您的JavaScript、HTML和CSS更改到用户中。

从Capgo开始