# @capgo/capacitor-app-tracking-transparency 中文文档
规范地址：https://npmcn.com/package/%40capgo/capacitor-app-tracking-transparency/
版本：8\.1\.21
npm 元数据更新时间：2026-10-15T06:18:43.151Z
中文译文更新时间：2026-11-09T04:18:52.557Z
软件包许可：MPL-2\.0
本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。
原始 npm 页面：https://www.npmjs.com/package/%40capgo/capacitor-app-tracking-transparency
原文对照：https://npmcn.com/package/%40capgo/capacitor-app-tracking-transparency/?lang=original
项目主页：https://capgo.app/docs/plugins/app-tracking-transparency/
源码仓库：https://github.com/Cap-go/capacitor-app-tracking-transparency
## 关键信息（来自 npm 元数据）
- 包体积（解压后）：35.3 kB，23 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：0 个
- peer 依赖：@capacitor/core \>=8\.0\.0
- 首次发布：2026-02-01T00:16:38.369Z
- 最新版本发布：2026-10-15T06:18:42.788Z
- 近 30 天下载量：33544（2026-10-09 至 2026-11-07，npm 官方下载统计）
- 已发布版本数：22（近 12 个月 22 个）
## 中文简介
IOS App跟踪透明框架的电容插件. 请求用户授权访问应用相关数据进行跟踪.
## 安装
```sh
npm install @capgo/capacitor-app-tracking-transparency
```
也可以使用：`pnpm add @capgo/capacitor-app-tracking-transparency`、`yarn add @capgo/capacitor-app-tracking-transparency`、`bun add @capgo/capacitor-app-tracking-transparency`
## README
# 电容器-应用-跟踪-透明度
显示 Apple 的 App 跟踪透明提示,并从您的 Capacitor app 读取用户的选择 。 在您访问 IDFA 在 iOS 上的广告或归属前, 需要 .
[](https://capgo.app/?ref=plugin_att)
**队长**:在几分钟内将修正推给您的 Capacitor 用户,在没有Mac的情况下构建已签名的iOS和Android apps,并在一击中回滚.
## [\*免费开始\*](https://capgo.app/register/?ref=plugin_att)
14天无限自由审判. 不需要信用卡
> 🤖 **建筑与AI编码代理?** 安装 [Capgo 技能](https://capgo.app/skills/?ref=plugin_att) 所以克劳德代码,代码,光标,副驾驶,或双子座CLI知道如何安装和使用 `@capgo/capacitor-app-tracking-transparency` 在您的电容应用程序中: `npx skills add Cap-go/capgo-skills`。然后问你的经纪人: _添加@capgo/capor-app-tracking-透明到我的Capacitor app并把它接上"_ [代理设置指南](https://capgo.app/agents/?ref=plugin_att) • 妇女 [主机磁共振](https://capgo.app/docs/ai/mcp/?ref=plugin_att)
## 主要特点
- **请求许可**数字 : `requestPermission()` 显示 iOS 跟踪及时返回结果.
- **读取状态**数字 : `getStatus()` 返回当前授权而不提示.
- **本地框架**: 使用苹果的 `AppTrackingTransparency` 框架.
- **简单状态**:授权、拒绝、限制或未确定.
- **平台**: iOS,Android和Web. 互联网档案馆的存檔,存档日期2013-12-02. 提示是 iOS 。 在Android和网上, `requestPermission()` 财务报告和审定财务报表 `getStatus()` 返回时 `authorized` 没有提示.
## 为什么是App追踪公司?
很简单, **免费**,以及 **轻型** iOS App 跟踪透明度插件 :
- **iOS 14+ 合规** - 处理苹果的应用跟踪透明度要求
- **权限状态** - 在不提示的情况下检查当前授权状态
- **请求许可** - 显示本地 iOS 权限对话框
- **跨平台** - 回归 `authorized` 用于透明使用
- **现代软件包管理** - 支持Swift软件包管理器(SPM)和CocoaPods(SPM-为Capacitor 8准备)
- **零依赖关系** - 最小的脚印,没有出血
适合使用FIDA的应用程序,广告SDK,分析跟踪,或任何跟踪用户跨应用程序和网站的功能.
## 文档
这里有最完整的医生: [https://capgo.app/docs/plugins/app-tracting-透明/ 互联网档案馆的存檔,存档日期2014-12-21](https://capgo.app/docs/plugins/app-tracking-transparency/)
## 兼容性
| 插件版本 | 电容兼容性 | 维护 |
| --- | --- | --- |
| 联合国 | 联合国 | ✅ |
| 页:1 | 页:1 | 应要求 |
| 页:1 | 页:1 | ❌ |
| 页:1 | 页:1 | ❌ |
> **说明:** 此插件的主要版本沿用了Capacitor的主要版本. 使用匹配您的 Capacitor 安装的版本( 如 Capacitor 8 的插件 v8) 。 只有最新的主要版本得到积极维护.
## 安装
您可以使用我们的 AI 辅助设置安装插件 。 使用以下命令将 Capgo 技能添加到您的 AI 工具 :
```bash
npx skills add https://github.com/cap-go/capacitor-skills --skill capacitor-plugins
```
然后使用下列提示:
```text
Use the `capacitor-plugins` skill from `cap-go/capacitor-skills` to install the `@capgo/capacitor-app-tracking-transparency` plugin in my project.
```
如果您更喜欢手动设置,请通过运行以下命令来安装插件,并遵循下面的平台特定指令:
```bash
npm install @capgo/capacitor-app-tracking-transparency
npx cap sync
```
## iOS系统
添加数据 `NSUserTrackingUsageDescription` 键 `Info.plist` 文件 :
```xml
NSUserTrackingUsageDescription
This identifier will be used to deliver personalized ads to you.
```
字符串应该解释为什么您需要跟踪权限 。 此信件在请求权限时会显示给用户 .
### 权限信件本地化
要提供跟踪权限消息的本地化版本, 请创建 `InfoPlist.strings` 每种语言的文件 :
1. 创建一个 `InfoPlist.strings` xcode 项目中的文件
2. 添加数据 `NSUserTrackingUsageDescription` 有本地化值的密钥 :
```
"NSUserTrackingUsageDescription" = "This identifier will be used to deliver personalized ads to you.";
```
## 机器人
App跟踪透明是一个只使用iOS的框架. 此插件返回 `authorized` 状态在Android上允许透明地跨平台使用而不附带条件代码.
## 网页
回返 `authorized` 用于发展目的和透明跨平台使用.
## API 密码
- [`getStatus()`](https://npmcn.com/package/%40capgo/capacitor-app-tracking-transparency/#readme-getstatus)
- [`requestPermission()`](https://npmcn.com/package/%40capgo/capacitor-app-tracking-transparency/#readme-requestpermission)
- [`getPluginVersion()`](https://npmcn.com/package/%40capgo/capacitor-app-tracking-transparency/#readme-getpluginversion)
- [接口](https://npmcn.com/package/%40capgo/capacitor-app-tracking-transparency/#readme-interfaces)
- [类型异名](https://npmcn.com/package/%40capgo/capacitor-app-tracking-transparency/#readme-type-aliases)
电容App跟踪透明插件.
用于请求和检查应用程序跟踪用户授权的插件 在iOS设备。 使用苹果的App跟踪透明框架.
### 获取状态( C)
```typescript
getStatus() => Promise
```
获取当前跟踪授权状态而不提示用户 .
**回返情况:** `Promise<[AppTrackingStatusResponse](https://npmcn.com/package/%40capgo/capacitor-app-tracking-transparency/#readme-apptrackingstatusresponse)>`
**自:** 1.0.0 (单位:千美元)
* * *
### 请求( )
```typescript
requestPermission() => Promise
```
请用户授权访问与应用相关的数据进行跟踪. 显示本地 iOS 跟踪权限对话框 .
说明: 此方法只显示一次对话框 。 随后的电话 将返回存储的授权状态而不显示对话框 .
**回返情况:** `Promise<[AppTrackingStatusResponse](https://npmcn.com/package/%40capgo/capacitor-app-tracking-transparency/#readme-apptrackingstatusresponse)>`
**自:** 1.0.0 (单位:千美元)
* * *
### 获取 PluginVersion ()
```typescript
getPluginVersion() => Promise<{ version: string; }>
```
获取本地 Capacitor 插件版本 .
**回返情况:** `Promise<{ version: string; }>`
**自:** 1.0.0 (单位:千美元)
* * *
### 接口
#### 跟踪状态响应
包含跟踪授权状态的反应对象.
| Prop | 类型 | 说明 | 自兹 |
| --- | --- | --- | --- |
| **`status`** | `[AppTrackingStatus](https://npmcn.com/package/%40capgo/capacitor-app-tracking-transparency/#readme-apptrackingstatus)` | 目前追踪授权状态. | 1.0.0 (单位:千美元) |
### 类型异名
#### 跟踪状态
追踪授权状态的可能值.
- `authorized`: 用户已授权访问用于跟踪的应用程序相关数据
- `denied`: 用户拒绝访问用于跟踪的应用程序相关数据
- `notDetermined`: 用户尚未收到授权请求
- `restricted`: 授权受到限制(例如父控制, MDM)
`'authorized' | 'denied' | 'notDetermined' | 'restricted'`
## 常见问题
### @capgo/capacitor-app-tracking-transparency 是什么？
IOS App跟踪透明框架的电容插件\. 请求用户授权访问应用相关数据进行跟踪\.
### 如何安装 @capgo/capacitor-app-tracking-transparency？
在项目目录运行 npm install @capgo/capacitor-app-tracking-transparency，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：@capacitor/core（\>=8\.0\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。
### @capgo/capacitor-app-tracking-transparency 支持 TypeScript 吗？
支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。
### @capgo/capacitor-app-tracking-transparency 支持 ESM 还是 CommonJS？
同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。
### @capgo/capacitor-app-tracking-transparency 可以商用吗？
@capgo/capacitor-app-tracking-transparency 使用 MPL-2\.0 许可。弱 Copyleft：可以商用，也可以和闭源代码一起使用；但如果分发时修改了 MPL 授权的文件，这些文件的修改需以 MPL 开源。以上为概括，不构成法律意见，请以许可原文为准。
### @capgo/capacitor-app-tracking-transparency 的下载量有多少？
根据 npm 官方下载统计，@capgo/capacitor-app-tracking-transparency 在 2026/10/09 – 2026/11/07 这 30 天内被下载 33,544 次，日均约 1,118 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。
### @capgo/capacitor-app-tracking-transparency 还在维护吗？
最新版本 8\.1\.21 发布于 2026/10/15（25 天前）；至今共发布 22 个版本，其中过去 12 个月发布了 22 个；首次发布于 2026/02/01。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。