Flutter问题：image_picker在TestFlight正常但App Store版本异常

问题背景 #

开发了一款基于Flutter的移动端应用，使用image_picker包访问相机与相册，Info.plist配置如下：

<key>NSCameraUsageDescription</key>
<string>This lets you take pictures for product listing.</string>
<key>NSMicrophoneUsageDescription</key>
<string>This lets you take pictures for product listing.</string>
<key>NSSpeechRecognitionUsageDescription</key>
<string>This app requires speech recognition access to enable voice search functionality for a more convenient user experience.</string>
<key>NSPhotoLibraryUsageDescription</key>
<string>This lets you select photos from your gallery and attach them to your listing.</string>

遇到的问题：TestFlight安装时权限显示正常，但App Store版本中，部分用户的照片设置项完全不显示，部分用户则看到提示：photo private access this app can show your photo library but can only access the items you select。

问题原因分析 #

1. iOS权限机制差异：iOS 14+引入的**精选照片权限（Limited Photo Library Access）**在App Store正式版中的触发逻辑比TestFlight更严格，旧版image_picker可能未适配该权限的完整流程。
2. Info.plist配置缺失：可能遗漏了必要的权限键（如NSPhotoLibraryAddUsageDescription），或权限描述的准确性不符合苹果审核要求。
3. 包版本问题：使用的image_picker版本过旧，未兼容iOS最新权限框架。

解决方案 #

1. 更新image_picker到最新稳定版 #

旧版本的image_picker对iOS 14+的精选照片权限支持不完善，更新到最新版可修复大部分权限显示问题：

• 修改pubspec.yaml中的依赖：

  dependencies:
    image_picker: ^latest_version # 替换为当前最新版本号
  

• 执行flutter pub get更新依赖，重新编译应用。

2. 完善Info.plist权限配置 #

确保权限键完整且描述清晰准确：

• 如果应用需要保存照片到相册，必须添加NSPhotoLibraryAddUsageDescription键；即使只读取相册，补充该键也能避免权限异常：

  <key>NSPhotoLibraryUsageDescription</key>
  <string>This lets you select photos from your gallery and attach them to your listing.</string>
  <key>NSPhotoLibraryAddUsageDescription</key>
  <string>This lets you save taken photos to your gallery for future product listing management.</string>
  

• 权限描述需直接说明用途，避免模糊表述，确保与App Store Connect隐私政策中的描述一致。

3. 主动处理精选照片权限逻辑 #

在代码中检查权限状态，当用户选择了精选照片权限时，可引导其前往设置修改：

• 配合permission_handler包实现权限检查（需先添加该包依赖）：

  import 'package:permission_handler/permission_handler.dart';
  import 'package:image_picker/image_picker.dart';
  
  Future<void> pickImage() async {
    // 先检查相册权限状态
    final photoStatus = await Permission.photos.status;
    if (photoStatus.isLimited) {
      // 引导用户前往设置修改权限
      await openAppSettings();
      return;
    }
  
    // 正常调用image_picker
    final pickedFile = await ImagePicker().pickImage(source: ImageSource.gallery);
    // 后续处理逻辑...
  }
  

4. 重新提交App Store注意事项 #

• 确保提交的二进制包是基于最新配置重新编译的，避免缓存的旧配置导致问题。
• 在App Store Connect的「隐私」板块，准确填写相册权限的使用场景，与Info.plist中的描述保持一致，避免审核时的权限校验不通过。

为什么TestFlight正常而App Store版本异常？ #

TestFlight构建的权限校验逻辑相对宽松，苹果对正式版App Store的权限合规性检查更严格，任何配置细节的疏漏都可能导致权限显示异常。

内容的提问来源于stack exchange，提问作者Med Oussema Zaier