更新记录

1.0.1（2026-10-27）

无

平台兼容性

uni-app(4.71)

其他

使用说明 导入

    // #ifdef APP-PLUS
    import {
        saveImageToAlbum
    } from '@/uni_modules/ygfj-savealbum'
    // #endif

使用：

 saveImageToAlbum(absPath, '自定义相册名称', (ret) => {
                    uni.hideLoading();
                    if (ret.success) {
                      uni.showToast({ title: '已保存到相册', icon: 'none' });
                    } else {
                      console.log('保存到自定义相册失败', ret.errMsg);
                      // 插件失败兜底：直接保存到系统相册
                      uni.saveImageToPhotosAlbum({
                        filePath: res.tempFilePath,
                        success: () => uni.showToast({ title: '已保存到相册', icon: 'none' }),
                        fail: () => uni.showToast({ title: '保存失败，请重试', icon: 'none' })
                      });
                    }
                  });
                },
                fail: () => {
                  uni.hideLoading();
                  uni.showToast({ title: '保存失败，请重试', icon: 'none' });
                }

    <uses-permission android:name="android.permission.READ_MEDIA_IMAGES" />

Android 13 及以上版本建议使用 READ_MEDIA_IMAGES。如果项目仍需要兼容较低版本，可根据实际编译目标补充对应存储权限。 iOS 配置 iOS 需要在 Info.plist 中配置相册权限描述，例如： XML

    <key>NSPhotoLibraryAddUsageDescription</key>

    <string>需要保存图片和视频到相册</string>

如果插件需要读取相册已有内容，也可以配置： XML

    <key>NSPhotoLibraryUsageDescription</key>

    <string>需要访问相册以保存图片</string>

。