Advance Image Picker 开源项目教程

张萌纳

于 2024-09-08 08:39:42 发布

阅读量960

点赞数 26

本文链接：https://blog.csdn.net/gitblog_00705/article/details/142014262

版权

#Advance Image Picker 开源项目教程

advance_image_pickerFlutter plugin for selecting multiple images from the Android and iOS image library, taking new pictures with the camera, and edit them before using such as rotating, cropping, adding sticker/filters.项目地址:https://gitcode.com/gh_mirrors/ad/advance_image_picker

1. 目录结构及介绍

Advance Image Picker 是一个用于Flutter的高级图片选择器插件，支持从设备相册选取多张图片、使用相机拍照并进行编辑，如旋转、裁剪、添加贴纸/滤镜等。以下是其主要的目录结构概述：

configs: 包含图像选择器的配置相关文件。
- image_picker_configs.dart: 定义全局配置项。
models: 模型类存放处，例如图像对象的定义。
- image_object.dart: 表示单个图像的实体类。
utils: 工具方法集合，涉及日志、时间处理等。
- log_utils.dart: 日志记录工具。
- time_utils.dart: 时间操作帮助函数。
widgets: 用户界面组件。
- 分为多个子目录，如common, editors, pickers, viewer，分别负责基础控件、编辑功能、选择器视图和查看器的实现。
其他重要文件如advance_image_picker.dart是核心逻辑的入口点，image_picker.dart在picker模块中可能是用于与原生交互的桥接。

2. 项目的启动文件介绍

项目的核心启动或主要逻辑通常分散在几个关键文件中，但最重要的启动点不在传统意义上的“单一启动文件”，而是在你的Flutter应用中引入和初始化该插件的地方。具体来说：

初始化: 一般在应用的主要入口文件（如main.dart），通过在依赖管理和具体的页面调用中导入并配置advance_image_picker来“启动”这个插件。

import 'package:flutter/material.dart';
import 'package:advance_image_picker/advance_image_picker.dart';

void main() {
  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    // 初始化配置（如果需要全局配置的话）
    var configs = ImagePickerConfigs();
    // 设置配置项...

    return MaterialApp(
      home: Scaffold(appBar: AppBar(title: Text('Advance Image Picker Demo'))),
      // 根据需求，在适当的位置使用advance_image_picker
    );
  }
}

3. 项目的配置文件介绍

(A) 应用级别的配置

对于 Flutter 项目本身，并没有特定于advance_image_picker的应用级配置文件。但是，为了适配权限需求，你需要在平台特定的配置文件中进行设置：

iOS: 更新ios/Runner/Info.plist以请求必要的权限：

<key>NSCameraUsageDescription</key>
<string>应用需要访问相机。</string>
<key>NSPhotoLibraryUsageDescription</key>
<string>应用需要访问您的相册。</string>

Android: 修改android/app/src/main/AndroidManifest.xml，确保有存储和相机权限：

<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"/>
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>
<uses-permission android:name="android.permission.CAMERA"/>

<!-- 若针对Android 10及以上版本使用旧式存储访问，可加入此条 -->
<!-- 注意：随着API 30+的变化，应考虑使用Scoped Storage -->
<!-- <application ... android:requestLegacyExternalStorage="true"> -->