更新记录

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+ 媒体权限

隐私、权限声明

1. 本插件需要申请的系统权限列表:

Android 需相册读取权限(Android 13+ 为 READ_MEDIA_IMAGES,以下为 READ_EXTERNAL_STORAGE);最低支持 Android 5.0 (API 21)

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

插件不采集、不上传任何图片数据,所有读取与处理均在本机完成

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

无

暂无用户评论。