大图查看器库BigImageViewPager的安装与配置指南-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00048/article/details/146722187

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

BigImageViewPager 🔥🔥🔥 BigImage ImageView ViewPager 支持超长图、超大图的图片浏览器，优化内存，支持手势放大、下拉关闭、查看原图、加载百分比、保存图片等功能。项目地址: https://gitcode.com/gh_mirrors/bi/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()));
    }
}