关于uniapp ios ATT 弹窗问题

欢迎到专业群（ uni-app 官方技术交流群 1 ） 咨询，群中有相关专业的管理员和群友。

好的，作为 uni-app 开发工程师，我来为你详细解答关于 iOS 平台 ATT 弹窗自动弹出的问题，并提供解决方案。

你的问题核心在于：即使没有主动调用任何获取 IDFA 的代码，勾选了 IDFA 模块并云打包后，App 一打开就会自动弹出 ATT 隐私跟踪授权弹窗。

这通常不是微信支付、分享或腾讯地图等第三方 SDK 直接导致的，而是 uni-app 云打包的默认机制。

原因分析

根据官方文档，当你勾选 IDFA（广告标识）后，应用为了获取 IDFA，默认会在应用启动时自动调用相关 API，从而触发 iOS 系统的 跟踪App活动 授权提示框（ATT 弹窗）。这在合规性检测中（例如奇安信等机构）通常会被判定为不合规，因为弹窗应该在用户同意你的 App 隐私政策之后再出现。

解决方案：手动控制 ATT 弹窗时机

uni-app 官方提供了 privacyRegisterMode 配置项来解决这个问题。你可以通过以下步骤，将自动弹出改为在用户同意隐私政策后手动触发。

1. 修改 manifest.json 配置

在 manifest.json 文件中，找到并添加 privacyRegisterMode 配置为 manual。这会禁止应用在启动时自动获取 IDFA，从而避免 ATT 弹窗自动弹出。

{  
  // ... 其他配置  
  "app-plus": {  
    "distribute": {  
      "ios": {  
        "privacyRegisterMode": "manual"  
      }  
    }  
  },  
  // ... 其他配置  
}

本助手使用国产模型，生成代码可能不准确。专业的代码生成需要全球顶尖的AI Coding模型。推荐使用uni-agent

2. 在用户同意隐私政策后调用 API

在你的自定义隐私政策弹窗中，当用户点击“同意”按钮后，你需要调用 plus.runtime.agreePrivacy() 方法。这个方法会触发获取 IDFA 的操作，此时才会弹出系统级的 ATT 授权框。

步骤示例：

• 在 App.vue 的 onLaunch 生命周期中，检查用户是否已同意过隐私政策（可以通过本地存储判断）。
• 如果未同意，则显示你的自定义隐私政策弹窗。
• 在弹窗的“同意”按钮点击事件中，执行以下代码：

// 用户点击“同意”后  
// 1. 先调用 agreePrivacy，触发 ATT 弹窗  
plus.runtime.agreePrivacy();  

// 2. 然后你可以在这里监听 ATT 弹窗的结果并获取 IDFA，或者进行其他初始化操作

本助手使用国产模型，生成代码可能不准确。专业的代码生成需要全球顶尖的AI Coding模型。推荐使用uni-agent

如何监听授权并获取 IDFA

调用 plus.runtime.agreePrivacy() 会弹出 ATT 弹窗，但此方法没有提供直接的回调来获取用户选择结果。你可以通过定时查询或使用原生插件的方式来获取 IDFA 值。

方案一：使用原生插件（推荐）
从插件市场可以找到专门用于获取 IDFA 并监听 ATT 弹窗按钮事件的插件，例如 iOS IDFA获取 插件。它提供了回调，能明确告诉你用户是点击了“允许”还是“要求App不跟踪”，并直接返回 IDFA 字符串。

方案二：使用 plus.device.getInfo 定期检查
plus.runtime.agreePrivacy() 调用后，你可以使用 setTimeout 延迟一小段时间，然后调用 plus.device.getInfo 来获取 IDFA。如果用户授权了，就能获取到值。

plus.runtime.agreePrivacy();  
setTimeout(() => {  
    plus.device.getInfo({  
        success: function(e) {  
            console.log('IDFA: ' + e.idfa);  
        },  
        fail: function(e) {  
            console.log('获取IDFA失败: ' + JSON.stringify(e));  
        }  
    });  
}, 500);

本助手使用国产模型，生成代码可能不准确。专业的代码生成需要全球顶尖的AI Coding模型。推荐使用uni-agent

重要注意事项

1. 版本要求：此配置需要 HBuilderX 4.81 及以上版本 才支持。
2. 打包生效：配置 privacyRegisterMode 后，需要提交云端打包才能真正生效。
3. 合规顺序：在调用 plus.runtime.agreePrivacy() 之前，绝对不能调用任何使用 IDFA 的代码（如 uni-ad 广告 API）或获取 IDFA 的接口。
4. 崩溃统计：如果配置了 manual 但从未调用 plus.runtime.agreePrivacy()，会导致应用的崩溃统计功能失效。

总结一下，你的问题是由于 uni-app 默认启动时获取 IDFA 的机制导致的，并非某个特定 SDK 的问题。通过配置 privacyRegisterMode 为 manual，并结合 plus.runtime.agreePrivacy() 方法，你可以完全掌控 ATT 弹窗的弹出时机，满足合规要求。

希望这个解答能帮助你解决问题。