大图查看器库BigImageViewPager的安装与配置指南

1. 项目基础介绍

BigImageViewPager 是一个开源的 Android 图片/视频浏览器库，它支持超大图、超长图、动图以及视频的显示。该库具备手势支持功能，可以查看原图、下载图片，并显示加载进度的百分比。它通过区块复用加载技术，优化内存使用，有效避免内存溢出（OOM）问题。

主要编程语言：Java 和 Kotlin

2. 关键技术和框架

• ViewPager: 用于实现图片的滑动查看。
• subsampling-scale-image-view: 内核技术，用于支持超大图片的缩放查看。
• Glide: 图片加载框架，用于高效加载网络图片。
• OkHttp: 网络请求库，用于下载图片。
• ExoPlayer: 视频播放框架，用于播放视频。

3. 安装和配置

准备工作

在开始之前，请确保你的开发环境满足以下要求：

• Android Studio
• JDK 1.8 或更高版本
• Android SDK 平台工具
• Gradle 4.6 或更高版本

安装步骤

步骤 1：添加仓库地址

打开你项目的 build.gradle 文件，在 allprojects 下的 repositories 中添加以下代码：

allprojects {
    repositories {
        ...
        maven { url 'https://jitpack.io' }
    }
}

步骤 2：添加项目依赖

在你应用模块的 build.gradle 文件中，添加以下依赖：

dependencies {
    // 本框架
    implementation 'com.github.SherlockGougou:BigImageViewPager:androidx-8.2.2'
    // glide
    implementation 'com.github.bumptech.glide:glide:4.16.0'
    annotationProcessor 'com.github.bumptech.glide:compiler:4.16.0' // 如果使用 Kotlin，请使用 kapt
    implementation 'com.github.bumptech.glide:okhttp3-integration:4.16.0'
    implementation "com.github.zjupure:webpdecoder:2.3.4.14.2"
    // ExoPlayer
    implementation "androidx.media3:media3-exoplayer:1.4.1"
    implementation "androidx.media3:media3-exoplayer-dash:1.4.1"
    implementation "androidx.media3:media3-ui:1.4.1"
}

步骤 3：配置 AppGlideModule

创建一个名为 MyAppGlideModule 的类，继承 AppGlideModule 并在 registerComponents 方法中添加以下代码：

@GlideModule
public class MyAppGlideModule extends AppGlideModule {
    @Override
    public void registerComponents(@NonNull Context context, @NonNull Glide glide, @NonNull Registry registry) {
        super.registerComponents(context, glide, registry);
        registry.replace(GlideUrl.class, InputStream.class, new OkHttpUrlLoader.Factory(ProgressManager.getOkHttpClient()));
    }
}

步骤 4：重建项目

完成以上步骤后，点击 Android Studio 的 "Build" -> "Rebuild Project" 选项，等待项目重建完成。

至此，BigImageViewPager 库的安装和配置工作就完成了。你可以按照项目的示例代码开始集成和使用 BigImageViewPager 库了。如果在安装或使用过程中遇到任何问题，可以参考项目的文档或通过 QQ 群进行交流。