如何用最少的代码启动图片画廊ImageGallery Intent传图实战指南【免费下载链接】ImageGalleryA gallery used to host an array of images项目地址: https://gitcode.com/gh_mirrors/im/ImageGallery想在 Android 应用里展示一组图片不用自己写 RecyclerView 网格也不用造全屏轮播的轮子。ImageGallery是一个轻量级 Android 图片画廊库——你只需几行 Intent 传图代码就能启动一个缩略图网格 全屏放大浏览的完整画廊页面。本文手把手带你用最少代码完成集成。️ ImageGallery 能做什么在动手之前先了解这个画廊库提供的能力网格缩略图列表竖屏 3 列、横屏 4 列自适应布局全屏浏览点击缩略图进入全屏页支持左右滑动切换、顶部显示页码如 9/30双指缩放全屏图片支持 pinch-to-zoom 手势放大细节Palette 动态背景色根据图片主色调自动为全屏页设置背景色上面就是传入一组 Unsplash 图片后自动生成的画廊网格页顶部工具栏标题也来自你传入的标题参数。 快速集成获取 ImageGallery 库先克隆仓库到本地查看示例工程git clone https://gitcode.com/gh_mirrors/im/ImageGallery仓库分为两部分library/是画廊核心库sample/是可直接运行的示例工程。在build.gradle中添加依赖compile com.github.lawloretienne:imagegallery:0.1.0如果你本地没有网络环境也可以直接把library/模块作为本地模块引入项目。 核心实战7 行 Intent 代码启动画廊这是全文最关键的步骤。在任意 Activity 中用下面的代码就能启动画廊Intent intent new Intent(MainActivity.this, ImageGalleryActivity.class); Bundle bundle new Bundle(); bundle.putStringArrayList(ImageGalleryActivity.KEY_IMAGES, new ArrayList(Arrays.asList(imageUrlList))); bundle.putString(ImageGalleryActivity.KEY_TITLE, Unsplash Images); intent.putExtras(bundle); startActivity(intent);只有 2 个传图参数含义一目了然常量类型作用KEY_IMAGESArrayListString图片 URL 列表决定网格内容KEY_TITLEString顶部工具栏显示的标题这两个常量定义在 ImageGalleryActivity.java 中画廊页启动后会自动从 Intent 的 Bundle 里取出它们并渲染网格。 注意图片加载需要你提供实现。完整可运行的写法见示例工程 MainActivity.java它用 Picasso 加载图片并实现了ImageThumbnailLoader缩略图和FullScreenImageLoader全屏图两个接口。 全屏传图与页码自动完成零额外代码点击缩略图后库会自动把整组图片 点击位置传给全屏页源码在 FullScreenImageGalleryActivity.javaKEY_IMAGES完整图片列表KEY_POSITION当前点击图片的下标所以你不需要为全屏页写任何 Intent 代码滑动切换、页码显示、背景色提取全部开箱即用。右侧上下两块红色区域正是 Palette 提取的图片主色调背景全屏滑动时会自动切换。⚙️ 别忘了在 AndroidManifest 中声明 Activity如果你要直接使用ImageGalleryActivity必须在你自己的AndroidManifest.xml中声明它库的清单里只预声明了全屏页可参考 AndroidManifest.xmlactivity android:namecom.etiennelawlor.imagegallery.library.activities.ImageGalleryActivity android:configChangesorientation|keyboardHidden|screenSize android:label android:themestyle/ImageGalleryTheme /configChanges一行很关键——它保证旋转屏幕时页面不重建网格能自适应切换 3 列/4 列。 进阶用 Fragment 嵌入自己的页面不想跳转独立页面可以把画廊作为一个 Fragment 嵌进自己的 Activity。ImageGalleryFragment提供newInstance(Bundle)工厂方法传图方式和 Activity 完全一致Bundle bundle new Bundle(); bundle.putStringArrayList(ImageGalleryFragment.KEY_IMAGES, imageUrlList); bundle.putString(ImageGalleryFragment.KEY_TITLE, My Gallery); ImageGalleryFragment fragment ImageGalleryFragment.newInstance(bundle);注意 Fragment 版本同样需要你注册缩略图加载器ImageGalleryFragment.setImageThumbnailLoader(this);完整演示见示例工程的 HostImageGalleryActivity.java。 关键文件索引文件说明MainActivity.java完整传图 图片加载示例ImageGalleryActivity.java网格画廊页定义 KEY_IMAGES / KEY_TITLEFullScreenImageGalleryActivity.java全屏浏览页定义 KEY_POSITIONImageGalleryFragment.javaFragment 嵌入方式arrays.xml示例图片 URL 数组✅ 小结回顾一下最少代码路径声明 Activity → 传 KEY_IMAGES 和 KEY_TITLE → startActivity三步即可得到一个带全屏缩放和调色板背景色的图片画廊。整个流程你只需写不到 10 行业务代码剩下的网格、轮播、缩放交给 ImageGallery 处理即可。【免费下载链接】ImageGalleryA gallery used to host an array of images项目地址: https://gitcode.com/gh_mirrors/im/ImageGallery创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考