Android真机从相册选择图片功能失效问题求助

尝试从相册选择图片并显示在ImageView中，但选择功能无法正常工作——无法打开图片选择页面。不过该功能在电脑模拟器中运行正常。

相关代码片段 #

import 'dart:io';
import 'package:image_picker/image_picker.dart';

class CreatePage extends StatefulWidget {
  final FirebaseUser user;

  CreatePage(this.user);

  @override
  _CreatePageState createState() => _CreatePageState();
}

class _CreatePageState extends State<CreatePage> {
  final textEditingController = TextEditingController();

  @override
  void initState() {
    super.initState();
    _getImage();
  }

  @override
  void dispose() {
    textEditingController.dispose();
    super.dispose();
  }

  File _image;

  Future _getImage() async {
    var image = await ImagePicker.pickImage(
      source: ImageSource.gallery,
      maxWidth: 1000,
      maxHeight: 1000,
    );

    setState(() {
      _image = image;
    });
  }
}

解决方案 #

• 配置平台权限
  真机访问相册需要明确的权限配置，模拟器通常默认授予权限，真机则需要手动配置：

  • Android：在android/app/src/main/AndroidManifest.xml中添加权限

    <!-- 适配Android 12及以下 -->
    <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
    <!-- 适配Android 13及以上 -->
    <uses-permission android:name="android.permission.READ_MEDIA_IMAGES" />
    

  • iOS：在ios/Runner/Info.plist中添加权限描述

    <key>NSPhotoLibraryUsageDescription</key>
    <string>需要访问您的相册以选择图片</string>
    

• 升级image_picker依赖
  旧版本的image_picker可能存在真机兼容性问题，将依赖升级到最新稳定版：
  在pubspec.yaml中更新：

  dependencies:
    image_picker: ^1.0.4 # 替换为最新版本号
  

  运行flutter pub get完成依赖更新。

• 添加权限请求逻辑
  代码中缺少主动请求权限的步骤，真机需要用户授权后才能访问相册，可借助permission_handler包实现：

  1. 添加依赖：

     dependencies:
       permission_handler: ^10.2.0 # 替换为最新版本号
     

  2. 修改_getImage方法：

     Future _getImage() async {
       PermissionStatus status = await Permission.photos.request();
       if (status.isGranted) {
         final image = await ImagePicker().pickImage(
           source: ImageSource.gallery,
           maxWidth: 1000,
           maxHeight: 1000,
         );
         setState(() {
           _image = image != null ? File(image.path) : null;
         });
       } else {
         ScaffoldMessenger.of(context).showSnackBar(
           const SnackBar(content: Text('需要相册权限才能选择图片')),
         );
       }
     }
     

• 检查系统权限设置
  如果配置后仍无法打开相册，前往真机的系统设置，找到该应用，确认已开启相册访问权限。

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