更新记录
1.1.0(2026-11-19)
首次发布:完成 Android / HarmonyOS 双端实现与真机验证。
平台兼容性
uni-app x(4.25)
| Chrome |
Safari |
Android |
iOS |
鸿蒙 |
微信小程序 |
| × |
× |
√ |
× |
√ |
× |
其他
| 多语言 |
暗黑模式 |
宽屏模式 |
蒸汽模式 |
| × |
× |
× |
√ |
uni-gallery-pro 相册增强插件
开箱即用的相册增强能力,纯系统 API 实现,无三方 SDK 依赖。
平台支持
| 平台 |
支持 |
最低版本 |
说明 |
| Android |
✅ |
5.0 (API 21) |
已适配 Android 10+ 分区存储、Android 13+ 媒体权限 |
| HarmonyOS |
✅ |
API 9+ |
基于 photoAccessHelper,部分高级能力降级 |
| iOS |
⏸ |
— |
后期规划 |
快速开始
import { getAlbums, getPhotos } from '@/uni_modules/uni-gallery-pro'
// 获取相册列表
getAlbums({
success: (res) => console.log(res.albums)
})
// 分页加载图片(albumId 传 '' 表示全部)
getPhotos({ albumId: '', offset: 0, limit: 30, success: (res) => {
console.log(res.photos, res.hasMore)
}})
API
| 方法 |
说明 |
getAlbums(options) |
获取相册分组列表(名称、数量、封面) |
getPhotos(options) |
分页加载图片,返回 photos/hasMore/total |
getThumbnail(options) |
生成正方形缩略图:中心裁剪 + 磁盘缓存,返回本地文件路径 |
saveImage(options) |
保存本地图片到相册 |
deleteImage(options) |
删除相册图片 |
diagnose(options) |
环境诊断(权限、系统版本、是否支持) |
权限声明
- Android 13+(API 33+):
READ_MEDIA_IMAGES
- Android 12 及以下:
READ_EXTERNAL_STORAGE
- 最低支持 Android 5.0(API 21);低于此版本
diagnose() 返回 supported=false
更新记录
1.0.0(2026-11-19)
- 首发:相册列表、分页加载、缩略图、保存、删除、诊断
- 适配 Android 10+ 分区存储与 Android 13+ 媒体权限