YImagePicker 使用教程

YImagePicker 使用教程

YImagePicker小红书多图剪裁+微信图片选择器+大图预览+图片剪裁(支持圆形剪裁和镂空剪裁)，已适配androidQ,借鉴并升级matisse加载内核!超强定制性可轻松实现知乎/马蜂窝/微博等特殊样式!支持跨进程回调!内部结构轻量级，无任何第三方开源库！支持support依赖！项目地址:https://gitcode.com/gh_mirrors/yi/YImagePicker

1. 项目目录结构及介绍

YImagePicker 的源代码结构如下：

- YImagePicker
  - gradle            // 存放Gradle相关配置
  - gradle.properties
  - idea              // IDEA IDE相关配置
  - app                // 示例应用模块
    - src
      ...
  - YPX_ImagePicker_androidx   // AndroidX兼容模块
  - YPX_ImagePicker_support   // Support库兼容模块
  - LICENSE             // 许可证文件
  - README.md           // 主要的项目说明文件
  - README_2_x.md       // 对旧版本的说明
  - documentation_3.x.md // 文档
  - picker              // 图片选择器的核心代码
  - special_scene.md    // 特殊场景的说明
  ...

• YPX_ImagePicker_androidx 和 YPX_ImagePicker_support 分别包含了基于AndroidX库和支持库的不同版本。
• picker 文件夹包含主要的图片选择逻辑和相关的组件。
• README.md 文件提供了项目的基本信息和使用指南。
• app 文件夹是示例应用的源代码，用于展示如何集成和使用YImagePicker。

2. 项目的启动文件介绍

YImagePicker 是一个库项目，不包含传统的主入口类（MainActivity）。但是，它有一个示例应用 (app)，可以用来测试和演示库的功能。在示例应用里，你可以找到 MainActivity.java 或对应的 Kotlin 类，它们展示了如何初始化和调用图片选择器。

例如，调用图片选择器的代码可能类似这样：

YImagePicker.showImagePicker(this, new ImagePickerConfig.Builder()
        .setCropEnabled(true)
        .build());

这段代码会在当前Activity中显示图片选择界面，并启用图片剪裁功能。

3. 项目的配置文件介绍

3.1 build.gradle 文件

在项目的根目录和 YPX_ImagePicker_{androidx/support} 文件夹下都有 build.gradle 文件。根目录下的 build.gradle 文件管理整个项目和子模块的构建设置，而子模块中的 build.gradle 文件则针对各自模块的构建进行配置。

例如，根目录的 build.gradle 可能包含如下内容：

// ... 其他设置
include ':YPX_ImagePicker_androidx'
include ':YPX_ImagePicker_support'

这表明了项目包含了两个子模块。

子模块的 build.gradle 文件则会声明依赖，如：

dependencies {
    implementation 'com.android.support:appcompat-v7:XX.X.X' // 或对应AndroidX依赖
}

3.2 配置项

在 AndroidManifest.xml 文件中，你需要添加必要的权限来允许读取和写入外部存储：

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

对于Android Q及以上版本，还需要声明存储访问权限：

<application>
    ...
    <provider
        android:name="androidx.core.content.FileProvider"
        android:authorities="${applicationId}.fileprovider"
        android:exported="false"
        android:grantUriPermissions="true">
        <meta-data
            android:name="android.support.FILE_PROVIDER_PATHS"
            android:resource="@xml/file_paths" />
    </provider>
</application>

并在 res/xml 文件夹下创建 file_paths.xml 文件，定义共享文件的路径。

以上就是YImagePicker项目的基础配置和使用方法。记得按照项目文档的指示，正确地集成这个库到你的应用中，并适当调整配置以适应你的项目需求。如果你在集成过程中遇到问题，可以查阅GitHub仓库中的README和其他资源，或者提交问题寻求帮助。

YImagePicker小红书多图剪裁+微信图片选择器+大图预览+图片剪裁(支持圆形剪裁和镂空剪裁)，已适配androidQ,借鉴并升级matisse加载内核!超强定制性可轻松实现知乎/马蜂窝/微博等特殊样式!支持跨进程回调!内部结构轻量级，无任何第三方开源库！支持support依赖！项目地址:https://gitcode.com/gh_mirrors/yi/YImagePicker