Flutter集成app_tracking_transparency插件Xcode构建报错及框架缺失求助

问题背景 #

环境信息：

• Flutter 3.22.0
• Dart 3.4.0
• pod 1.15.2
• app_tracking_transparency: ^2.0.5

Xcode构建时报错：

/StudioProjects/**/ios/Runner/GeneratedPluginRegistrant.m:12:9: Module 'app_tracking_transparency' not found

已执行过以下操作但无效：

• cd ios
• rm -rf Podfile.lock Pods
• pod install --repo-update
• cd ..
• flutter clean
• flutter pub get

核心问题：重新安装后，ios/.symlinks/plugins/app_tracking_transparency/ios目录中仍缺少app_tracking_transparency.framework。

解决方案 #

1. 修复插件本地缓存 #

Flutter插件缓存损坏可能导致缺少framework，删除对应插件的缓存后重新拉取：

# 删除插件缓存
rm -rf ~/.pub-cache/hosted/pub.dev/app_tracking_transparency-2.0.5
# 重新拉取依赖
flutter pub get

2. 手动重建Symlink链接 #

如果缓存目录存在framework，但ios/.symlinks/plugins中的链接异常，手动删除并重新创建：

cd ios/.symlinks/plugins
rm -rf app_tracking_transparency
# 替换为你实际的插件缓存路径
ln -s ~/.pub-cache/hosted/pub.dev/app_tracking_transparency-2.0.5 app_tracking_transparency

3. 调整Podfile配置 #

在iOS目录的Podfile中添加插件路径的显式声明，强制CocoaPods正确识别插件：

pod 'app_tracking_transparency', :path => '.symlinks/plugins/app_tracking_transparency/ios'

添加后重新执行：

cd ios
pod install --repo-update

4. 检查Xcode项目设置 #

• 打开Xcode，进入Runner项目的Build Settings，搜索Framework Search Paths，添加以下路径（确保路径真实存在）：

  $(HOME)/.pub-cache/hosted/pub.dev/app_tracking_transparency-2.0.5/ios
  

• 清理Xcode构建缓存：点击菜单Product > Clean Build Folder，再重新构建项目。

5. 调整插件版本 #

当前插件版本可能与Flutter 3.22.0存在兼容性问题，尝试切换版本：

• 修改pubspec.yaml中的插件版本：

  app_tracking_transparency: 2.0.4 # 降级到稳定旧版本，或尝试最新稳定版
  

• 执行flutter pub get后重新执行iOS端的pod安装流程。

内容的提问来源于stack exchange，提问作者back