Flutter项目pod安装报错解决方法及iOS端DeepAR使用指南

• 先确认项目ios目录下的Podfile顶部已指定iOS最低版本为13.0，添加代码：platform :ios, '13.0'，rwa_deep_ar依赖的DeepAR库最低适配iOS12，最新版本要求最低iOS13，版本低于要求会直接报依赖兼容错误。
• 如果是M系列芯片的Mac设备出现架构相关报错，先执行命令安装ffi：sudo arch -x86_64 gem install ffi，再执行后续pod操作。
• 清空本地缓存重新拉取依赖，cd到项目ios目录后依次执行以下命令：

  rm -rf ~/Library/Caches/CocoaPods
  rm -rf Pods
  rm Podfile.lock
  pod deintegrate
  pod setup
  pod install --repo-update
  

• 如果依旧报找不到DeepAR库的错误，在Podfile最顶部添加公共源配置：source 'https://github.com/CocoaPods/Specs.git'，避免本地配置的私有源优先级过高导致无法拉取公共库。如果出现DeepAR版本冲突，可在Podfile的target块中手动指定兼容版本：pod 'DeepAR', '~> 3.4.0'，版本号要和你使用的rwa_deep_ar版本适配。

• 先注册DeepAR账号申请iOS平台专属授权密钥，未填写密钥运行时会出现水印或者黑屏问题。
• 在项目pubspec.yaml中添加rwa_deep_ar依赖，替换为官方最新发布的版本号：

  dependencies:
    flutter:
      sdk: flutter
    rwa_deep_ar: ^最新版本号
  

• 配置iOS端系统权限，打开ios/Runner/Info.plist文件，添加以下权限声明：

  NSCameraUsageDescription：使用相机实现AR特效功能
  NSMicrophoneUsageDescription：录制带音频的AR视频时需要
  NSPhotoLibraryAddUsageDescription：保存拍摄的AR素材到相册时需要

• 打开Xcode的Runner项目配置，在Build Settings中搜索Bitcode，设置为NO，DeepAR库不支持Bitcode开启，否则打包会报错。
• 业务代码调用示例：

  import 'package:rwa_deep_ar/rwa_deep_ar.dart';
  
  // 初始化控制器
  final RwaDeepArController deepArController = RwaDeepArController(
    iosLicenseKey: "你申请的iOS端授权密钥",
    resolution: Resolution.high,
  );
  
  // 页面视图中嵌入AR预览组件
  @override
  Widget build(BuildContext context) {
    return Scaffold(
      body: DeepArView(
        controller: deepArController,
        onViewCreated: (controller) {
          // 视图加载完成后可加载默认特效
          controller.switchEffect("特效文件路径/远程特效地址");
        },
      ),
    );
  }
  
  // 页面销毁时释放资源
  @override
  void dispose() {
    deepArController.dispose();
    super.dispose();
  }
  

• 特效文件可以使用DeepAR官方提供的免费素材，也可以自己通过DeepAR编辑器制作，支持本地路径和远程URL加载。

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