LargeImageMonitor 使用教程

1、项目介绍

LargeImageMonitor 是一个使用 ASM 进行字节码插桩的大图监控框架。它可以帮助开发者在应用中监控图片的加载情况，防止因加载过大的图片而导致 OOM（Out of Memory）或 APK 体积过大的问题。该框架支持多种图片加载库，如 Glide、Fresco、Picasso 和 Universal Image Loader，并且可以对图片的文件大小和内存占用设置阈值，当图片超过设定阈值时会进行报警。

2、项目快速启动

2.1 添加依赖

首先，在项目的根目录 build.gradle 文件中添加如下代码：

buildscript {
    repositories {
        jcenter()
    }
    dependencies {
        classpath 'org.zzy.largeimage:large-image-monitor-plugin:1.0.0'
    }
}

接着，在要使用的模块的 build.gradle 文件中添加如下代码：

// 添加使用插件
apply plugin: 'largeimage-monitor'

// 添加依赖库
implementation 'org.zzy.lib.largeimage:large-image-monitor:1.0.0'

2.2 初始化框架

在 Application 类中初始化 LargeImageMonitor 框架：

// 初始化大图监控
LargeImage.getInstance()
    .install(this) // 一定要调用该方法进行初始化
    .setFileSizeThreshold(400.0) // 设置文件大小阈值，单位为KB（可选）
    .setMemorySizeThreshold(100) // 设置内存占用大小阈值，单位为KB（可选）
    .setLargeImageOpen(true) // 是否开启大图监控，默认为开启（可选）
    .addOkHttpInterceptor(new CustomGlobalInterceptor()) // 添加OKhttp自定义全局应用监听器（可选）
    .addOkHttpNetworkInterceptor(new CustomGlobalNetworkInterceptor()) // 添加Okhttp自定义全局网络监听器（可选）
    .setDns(new CustomHttpDns()); // 设置自定义的全局DNS，可以自己实现HttpDns（可选）

2.3 打开浮窗权限

确保在应用中打开了浮窗权限，以便能够显示超过阈值的图片的弹窗或列表。

3、应用案例和最佳实践

3.1 应用案例

假设你正在开发一个图片社交应用，用户会上传和浏览大量的图片。为了防止因加载过大的图片而导致应用崩溃或内存不足，你可以使用 LargeImageMonitor 来监控图片的加载情况。当检测到某张图片的文件大小或内存占用超过预设的阈值时，框架会自动报警，提醒开发者进行优化。

3.2 最佳实践

• 设置合理的阈值：根据应用的实际情况，设置合理的文件大小和内存占用阈值，避免误报或漏报。
• 结合其他优化手段：除了使用 LargeImageMonitor 进行监控外，还可以结合图片压缩、缓存策略等手段，进一步优化图片加载性能。
• 定期检查和优化：定期检查应用中加载的图片，优化那些超过阈值的图片，确保应用的稳定性和性能。

4、典型生态项目

LargeImageMonitor 可以与以下典型的生态项目结合使用，进一步提升应用的性能和稳定性：

• Glide：一个强大的图片加载库，支持图片的异步加载和缓存。
• Fresco：由 Facebook 开源的图片加载库，特别适合处理大图和复杂图片。
• Picasso：一个轻量级的图片加载库，适合快速加载和显示图片。
• Universal Image Loader：一个灵活且功能强大的图片加载库，支持多种图片加载策略。

通过结合这些生态项目，LargeImageMonitor 可以帮助开发者更全面地监控和管理应用中的图片资源，确保应用的高效运行。