跳过主要内容

App 跟踪透明度 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插件目录中的产品工作流程 Capacitor Capgo 的插件 Capacitor Plugins by Capgo 添加或更新插件 为添加或更新插件的实现细节。

常见问题

App Tracking Transparency 插件 FAQ

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

Run "bun add @capgo/capacitor-app-tracking-transparency" (or "npm install @capgo/capacitor-app-tracking-transparency"), then run "bunx cap sync" so the iOS and Android projects pick up the native code. Import it from "@capgo/capacitor-app-tracking-transparency" in your app code.

@capgo/capacitor-app-tracking-transparency 与 React、Vue 和 Angular 是否兼容?

是的。App Tracking Transparency 是一个 Capacitor 包,因此它与任何运行在 Capacitor 内的 Web 框架兼容,包括 Ionic、React、Vue、Angular、Svelte 和普通 JavaScript。

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

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

@capgo/capacitor-app-tracking-transparency 是否免费和开源?

Yes. The source code is public on GitHub at https://github.com/Cap-go/capacitor-app-tracking-transparency/ and the package is free to install from npm. Bug reports and pull requests are welcome.

是否可以在不经过 App Store 审核的情况下更新使用 App Tracking Transparency 的 code?

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

无需等待应用程序审查即可将 App Tracking Transparency 变更推送到应用商店

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

开始使用 Capgo