开始

复制一个包含安装步骤和此插件的完整 Markdown 指南的配置提示。

        Set up this Capacitor plugin in the project.

Use the package manager already used by the project.
Install these package(s): `@capgo/capacitor-app-tracking-transparency`
Run the required Capacitor sync/update step after installation.
Read this markdown guide for the full setup steps: https://raw.githubusercontent.com/Cap-go/website/refs/heads/main/apps/docs/src/content/docs/docs/plugins/app-tracking-transparency/getting-started.mdx
Use that guide for platform-specific steps, native file edits, permissions, config changes, imports, and usage setup.
If that guide references other docs pages, read them too.

安装

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

导入

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

API 概述

`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;
}

类型参考

`AppTrackingStatusResponse`

响应对象包含跟踪授权状态。

export interface AppTrackingStatusResponse {
  /**
   * The current tracking authorization status.
   *
   * @since 1.0.0
   */
  status: AppTrackingStatus;
}

`AppTrackingStatus`

跟踪授权状态的可能值。

export type AppTrackingStatus = 'authorized' | 'denied' | 'notDetermined' | 'restricted';

真实来源

当公共__CAPGO_KEEP_0__在上游发生变化时，请重新运行同步。 src/definitions.ts. Re-run the sync when the public API changes upstream.