跳转至正文

App Tracking Transparency Capacitor 插件

请求并检查 iOS App Tracking Transparency 权限以获取 IDFA 访问权限

安装

bun add @capgo/capacitor-app-tracking-transparency bunx cap sync
npm、pnpm 或 yarn
  • npm install @capgo/capacitor-app-tracking-transparency
  • pnpm add @capgo/capacitor-app-tracking-transparency
  • yarn add @capgo/capacitor-app-tracking-transparency

指南

如何在 Capacitor 中使用 App Tracking Transparency

使用 @capgo/capacitor-app-tracking-transparency

Capacitor App Tracking Transparency 插件

安装

bun add @capgo/capacitor-app-tracking-transparency
bunx cap sync

bunx cap sync 将插件的原生 code 复制到你的原生项目中。每次升级插件后都要重新运行。

导入

import { AppTrackingTransparency } from '@capgo/capacitor-app-tracking-transparency';

API 概览

方法 描述
getStatus 在不弹出提示的情况下,获取当前的追踪授权状态。
requestPermission 请求用户授权以访问应用相关数据进行追踪。此时会显示 iOS 原生的追踪权限弹窗。

示例

getStatus()

在不弹出提示的情况下,获取当前的追踪授权状态。

import { AppTrackingTransparency } from '@capgo/capacitor-app-tracking-transparency';

const { status } = await AppTrackingTransparency.getStatus();
if (status === 'authorized') {
  console.log('Tracking is authorized');
}

requestPermission()

请求用户授权以访问应用相关数据进行追踪。此时会显示 iOS 原生的追踪权限弹窗。

import { AppTrackingTransparency } from '@capgo/capacitor-app-tracking-transparency';

const { status } = await AppTrackingTransparency.requestPermission();
switch (status) {
  case 'authorized':
    console.log('User authorized tracking');
    break;
  case 'denied':
    console.log('User denied tracking');
    break;
  case 'restricted':
    console.log('Tracking is restricted');
    break;
  case 'notDetermined':
    console.log('Status not determined');
    break;
}

完整参考文档

继续使用 @capgo/capacitor-app-tracking-transparency

如果你正在使用 使用 @capgo/capacitor-app-tracking-transparency 要规划原生插件工作,请将其与 @capgo/capacitor-app-tracking-transparency 有关 @capgo/capacitor-app-tracking-transparency 中的实现细节, 快速入门 有关“入门指南”中的实现细节, Capgo 插件目录 查看 Capgo 插件目录中的产品工作流, Capgo 提供的 Capacitor 插件 有关 Capgo 的 Capacitor 插件实现细节,以及 添加或更新插件 有关添加或更新插件的实现细节。

常见问题

App Tracking Transparency 插件常见问题

如何在 Capacitor 应用中安装 App Tracking Transparency 插件?

运行 "bun add @capgo/capacitor-app-tracking-transparency"(或 "npm install @capgo/capacitor-app-tracking-transparency"),然后运行 "bunx cap sync",使 iOS 和 Android 项目同步 native code。最后在你的应用 code 中从 "@capgo/capacitor-app-tracking-transparency" 导入即可。

@capgo/capacitor-app-tracking-transparency 是否支持 React、Vue 和 Angular?

支持。App Tracking Transparency 是一个 Capacitor 包,因此它支持任何在 Capacitor 中运行的 Web 框架,包括 Ionic、React、Vue、Angular、Svelte 以及原生 JavaScript。

@capgo/capacitor-app-tracking-transparency 支持哪个版本的 Capacitor?

Capgo 插件遵循 Capacitor 的主版本号:请使用与 Capacitor 主版本号一致的插件主版本(例如插件 v8 对应 Capacitor 8)。GitHub README 中的兼容性表列出了仍在维护的版本。

@capgo/capacitor-app-tracking-transparency 是免费开源的吗?

是的。code 源码已在 GitHub 公开,地址为 https://github.com/Cap-go/capacitor-app-tracking-transparency/,且你可以通过 npm 免费安装该包。欢迎提交 Bug 报告和 Pull Request。

我可以在不经过 App Store 审核的情况下,更新使用了 App Tracking Transparency 的 code 吗?

安装或升级插件会改动原生 code,因此需要重新做一次商店构建。之后,调用该插件的 JavaScript、HTML 和 CSS 改动就能通过 Capgo live updates 立即发布。

无需等待 App Store 审核,即可快速发布 App Tracking Transparency 相关变更

只要插件已包含在你的商店版本中,Capgo live updates 就能在几分钟内把 JavaScript、HTML 和 CSS 的改动推送给用户。

开始使用 Capgo