RawGallery v0.4

RawGallery 是一个纯本地的 Android 相册项目，重点解决普通相册对较新 RAW 格式兼容不足、RAW 元数据看不全的问题。

它不是云相册，也不是联网图库，而是偏摄影工作流的本地相册：

• 支持普通图片、视频和多种 RAW 文件统一浏览
• 支持 RAW 配对素材、扩展元数据查看、Sony 私有信息解析
• 支持私密库、隐藏、回收站、合集管理、导出预览 JPEG 等实用功能
• 支持更直接的本地删除、回收站保留时间调整和图片浏览体验优化

当前定位

这个项目更适合以下场景：

• 手机上快速筛选 RAW / JPG / 视频 混合素材
• 查看 RAW 文件的拍摄参数和更多私有元数据
• 检查 RAW+JPEG 配对情况
• 查看 Sony ARW 的扩展信息，例如快门相关字段、释放模式、对焦模式等
• 在不依赖云服务的前提下，完成本地整理、导出、归档
• 对本地图片进行更高效的浏览、删除、恢复和长期整理

v0.4 更新内容

v0.4 主要优化了图片浏览、删除逻辑、回收站设置和主界面显示方式。

新增与调整内容包括：

• 新增图片浏览时按时间显示的滑动进度条，方便在大量图片中快速定位
• 在点开图片后的一级查看界面新增删除图片按钮
• 点击删除按钮时，图片会先放入回收站
• 长按删除按钮时，可以直接永久删除图片
• 新增回收站保留时间设置，可自行调整回收站中项目的自动清理时间
• 更改主界面图片显示形式，取消图片圆角，让缩略图显示更规整
• 优化合集界面的显示方式，增强信息层次和易读性
• 点击主界面的“Raw相册”标题可以直接返回顶部
• 新增 TIF / TIFF 图片支持

主要功能

• 支持普通图片浏览：JPG、PNG、WEBP、HEIF、TIF / TIFF 等系统可解码格式
• 支持视频浏览与管理
• 支持多种 RAW 文件索引与浏览：DNG / NEF / NRW / CR2 / CR3 / ARW / SR2 / SRF / RAF / ORF / RW2 / PEF / DCR / KDC
• 支持 RAW 与 JPG 配对识别，并可在查看器中跳转到配对文件
• 支持合集管理，合集优先于系统相册展示
• 支持智能分组：收藏、视频、RAW、RAW+JPEG、未配对 RAW、带定位、截图、下载、相机、最近添加、隐藏、私密库
• 支持搜索与高级筛选
• 支持按拍摄时间、修改时间、文件大小、ISO、快门、光圈、焦距、机身等排序
• 支持复制到选定文件夹、移动到选定文件夹
• 支持把 RAW 内嵌预览导出为 JPEG，或直接分享预览 JPEG
• 支持移入私密库，以及从私密库导出到系统文件夹
• 支持移入回收站，并可调整回收站项目的自动保留时间
• 支持直接永久删除图片
• 支持 sidecar XMP 同步

界面与浏览体验

v0.4 对主界面、合集界面和图片查看体验做了明显调整。

当前界面体验包括：

• 主界面缩略图取消圆角，图片显示更接近传统相册网格
• 合集界面经过重新优化，信息显示更清楚，阅读压力更低
• 点击主界面的“Raw相册”标题可以直接返回顶部
• 图片查看时支持根据时间显示的滑动进度条
• 通过滑动进度条，可以更快跳转到不同时间段的图片
• 点开图片后的一级查看界面就可以直接删除图片，不需要进入更多菜单

查看器功能

• 单图查看支持左右切换图片
• 支持双指缩放、拖动、双击缩放
• 上滑可直接拉出图片信息
• 支持根据时间显示的滑动进度条，方便快速浏览大量图片
• 支持幻灯片播放
• 支持分享、系统编辑、设为壁纸
• 支持收藏、重命名、加入合集、隐藏、移入私密库、移入回收站、永久删除
• 一级查看界面新增删除按钮
• 点击删除按钮会将图片移入回收站
• 长按删除按钮会直接永久删除图片

回收站与删除逻辑

RawGallery 支持更灵活的删除管理。

当前删除逻辑包括：

• 普通删除会先将图片移入回收站
• 回收站中的项目会在设定时间后自动清理
• 用户可以在设置中调整回收站的保留时间
• 查看图片时，点击删除按钮会移入回收站
• 查看图片时，长按删除按钮会直接永久删除
• 永久删除后，文件不会再进入回收站，需要谨慎操作

RAW 信息能力

RawGallery 不做完整 RAW 显影，但会尽量把 RAW 文件中可直接读取的信息挖出来。

当前信息页包括：

• 文件基础信息：名称、路径、时间、大小、分辨率、MIME 等
• 拍摄摘要信息：机身、镜头、ISO、光圈、快门、焦距、曝光补偿、白平衡、测光、闪光灯、GPS、色彩空间、位深等
• RAW 预览来源与内嵌预览尺寸
• Sidecar / 配对文件信息
• 扩展 RAW 标签区：按底层目录展示可读的 MakerNote / 私有标签

Sony ARW 增强

当前版本对 Sony ARW 做了额外增强，重点参考了 ExifTool 的 Sony 私有规则：

• 可显示 Sony 快门相关字段
• 对部分机型可直接识别并显示机械快门次数
• 可显示快门相关候选字段，便于人工核对
• 可显示部分 Sony 摄影向信息，并做中文化展示，例如：
  • 释放模式
  • 连拍序号 / 连拍文件号
  • 对焦模式
  • AF 对焦点
  • 镜头卡口
  • 镜头画幅
  • APS-C 裁切状态
  • 机身防抖
  • Sony 机型代号

说明：

• 机械快门次数不是通用标准 EXIF 字段，而是基于机型相关的 Sony 私有元数据规则识别
• 不同 Sony 机型使用的字段位置并不固定
• 当前已优先接入对实际拍摄使用价值最高的一批 Sony 私有规则

已知边界

• 本项目不是完整 RAW 显影器，不会对 14bit/12bit RAW 原始数据做专业调色级显影
• 很多 RAW 预览依赖文件内嵌 JPEG，或依赖 Android 侧兼容解码能力
• TIF / TIFF 图片支持也会受到 Android 系统解码能力和具体文件编码方式影响
• 一些厂商私有元数据存在机型差异、固件差异，不能保证所有机型完全一致
• 机械快门次数等字段属于“按机型规则解释”的结果，不是所有品牌都能用统一字段读取
• 长按删除属于永久删除操作，使用前需要确认文件已经不再需要

设置项

当前可配置项包括：

• 主题模式
• 网格列数
• 排序方式与默认顺序
• 删除前确认
• 回收站保留时间
• 搜索中显示隐藏项
• 网格元数据角标
• 查看器直方图显示
• 查看器焦点检查显示
• sidecar XMP 同步
• 私密库自动锁定时间

构建

环境要求：

• Android Studio
• JDK 17
• Android SDK

命令行构建：

.\gradlew.bat assembleDebug

生成的 APK 默认位于：
Plain text
app/build/outputs/apk/debug/app-debug.apk
发行包
当前仓库的 Releases 页面提供现成 APK：
v0.4
资产文件：RawGallery-v0.4-debug.apk
说明：
当前发行页放的是自用 debug 构建，不是应用商店签名版
更适合本地安装、自测和继续迭代
项目配置
applicationId: com.zcc.rawgallery
minSdk: 26
targetSdk: 35
versionName: 0.4
致谢
本项目的 RAW 元数据解析与信息展示思路，参考了开源社区长期积累的方法与经验。
感谢 ExifTool⁠ 对各厂商 EXIF / MakerNote 的持续整理与维护。本项目在 Sony 私有快门规则、扩展 RAW 标签和摄影向信息展示方面重点参考了它的方法。
感谢 s_afv⁠ 等 Sony RAW 社区项目提供的实践启发，帮助我们更务实地看待 ARW 内部私有信息的可读性与展示方式。
同时感谢所有维护 RAW 元数据生态的开源作者与测试者。没有这些公开资料和长期维护，很多机型差异根本无从验证。