5分钟上手ImageGalleryAndroid图片画廊库快速集成完整教程【免费下载链接】ImageGalleryA gallery used to host an array of images项目地址: https://gitcode.com/gh_mirrors/im/ImageGalleryImageGallery 是一个轻量级的Android 图片画廊库专为以数组形式托管一组图片而设计。它提供缩略图网格浏览、全屏滑动查看、双指缩放等完整能力还支持用 Palette 根据当前图片自动提取主色作为背景。无论你是想给 App 加一个商品图集还是做一个简洁的图片浏览页都能在 5 分钟内把 ImageGallery 集成进项目。ImageGallery 图片画廊库能做什么先看看它上手后的实际效果——点击图片即进入全屏画廊支持左右滑动切换与双指缩放它的核心特性一览特性说明️ 缩略图网格竖屏 3 列 / 横屏 4 列自动适配点击任意缩略图进入全屏 双指缩放全屏页面内置 TouchImageView支持手势缩放查看细节 Palette 背景色支持 VIBRANT、LIGHT_VIBRANT、DARK_VIBRANT、MUTED 等 6 种色彩提取模式 两种集成方式独立 Activity 或嵌入你自己页面的 Fragment 解耦的图片加载库本身不绑定图片加载框架Picasso / Glide 均可对接快速集成给项目添加 ImageGallery 依赖第一步把仓库克隆到本地git clone https://gitcode.com/gh_mirrors/im/ImageGallery仓库包含两个模块核心库library和示例工程sample见 settings.gradle。在 App 模块的 Gradle 中添加依赖compile com.github.lawloretienne:imagegallery:0.1.0或者用 Maven 坐标dependency groupIdcom.github.lawloretienne/groupId artifactIdimagegallery/artifactId version0.1.0/version /dependency 如果使用本地模块也可以直接在 settings.gradle 中include :library后以project(:library)依赖。3步完成图片画廊集成第1步注册图片加载器ImageGallery 把加载图片这件事交给你只需实现两个接口缩略图加载ImageGalleryAdapter.ImageThumbnailLoader和全屏图片加载FullScreenImageGalleryAdapter.FullScreenImageLoader。以 Picasso 为例ImageGalleryActivity.setImageThumbnailLoader(this); FullScreenImageGalleryActivity.setFullScreenImageLoader(this);完整示例可参考 MainActivity.java它演示了用 Picasso 加载缩略图与全屏图的完整写法。第2步在 Manifest 中声明画廊页面使用 ImageGalleryActivity 时需要在 AndroidManifest.xml 中注册它并指定主题activity android:namecom.etiennelawlor.imagegallery.library.activities.ImageGalleryActivity android:configChangesorientation|keyboardHidden|screenSize android:label android:themestyle/Theme.ImageGallery /全屏页面FullScreenImageGalleryActivity已在 library/src/main/AndroidManifest.xml 中声明无需重复添加。第3步传入图片列表启动画廊只需一个 Intent Bundle传入ArrayListString图片地址和标题Intent intent new Intent(MainActivity.this, ImageGalleryActivity.class); Bundle bundle new Bundle(); bundle.putStringArrayList(ImageGalleryActivity.KEY_IMAGES, new ArrayList(Arrays.asList(images))); bundle.putString(ImageGalleryActivity.KEY_TITLE, Unsplash Images); intent.putExtras(bundle); startActivity(intent);运行后你将得到第一张截图中的三列缩略图网格点击图片则自动跳转全屏画廊顶部标题显示当前/总数的页码左右滑动流畅切换进阶技巧Palette 动态背景色 Fragment 嵌入动态背景色在全屏图片加载成功后用 Android Support 库的 Palette 从位图提取主色再设置到背景容器上即可。颜色类型枚举定义在 PaletteColorType.java包含VIBRANT、LIGHT_VIBRANT、DARK_VIBRANT、MUTED、LIGHT_MUTED、DARK_MUTED六种每种颜色都有完善的回退fallback策略。嵌入自己的页面不想用独立 Activity可以改用 ImageGalleryFragment.javapublic static ImageGalleryFragment newInstance(Bundle extras)它内部使用 RecyclerView GridLayoutManager 构建网格点击缩略图同样会跳转到全屏页见 HostImageGalleryActivity.java。项目结构速览模块路径作用library/核心库Activity、Adapter、Fragment 与 UI 组件sample/示例工程演示完整接入流程library/src/main/java/com/etiennelawlor/imagegallery/library/activities/画廊页与全屏页入口library/src/main/java/com/etiennelawlor/imagegallery/library/adapters/缩略图与全屏页适配器library/src/main/java/com/etiennelawlor/imagegallery/library/ui/TouchImageView.java双指缩放图片视图library/src/main/res/values/themes.xml内置主题可按需自定义配色CHANGELOG.md版本演进记录常见问题Q图片不显示A检查是否已调用setImageThumbnailLoader/setFullScreenImageLoader注册加载器——这是最常见的遗漏。Q横屏和竖屏显示列数不同A这是特性而非 Bug。ImageGalleryAdapter.java 会根据 DisplayUtility.java 判断方向竖屏 3 列横屏 4 列。Q如何自定义配色A修改 themes.xml 中的colorPrimary、colorAccent等属性或参考 material_design_colors.xml 中的 Material 调色板。 到这里你已经掌握了 ImageGallery 图片画廊库的完整集成流程加依赖 → 注册加载器 → 启动画廊剩下的就是把它用到你的下一个 App 里去【免费下载链接】ImageGalleryA gallery used to host an array of images项目地址: https://gitcode.com/gh_mirrors/im/ImageGallery创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考