@gbyte/tauri-plugin-ios-photos

中文文档
0.3.0发布于 2025/12/31MITTypeScriptESM + CJS近 30 天下载 2130

访问iOS用户设备相片库.

中文使用文档
文档目录10 节
  1. 特征
  2. 所需资源
  3. iOS 权限
  4. 安装
  5. 用法(概念示例)
  6. 关于图像路径访问
  7. 状况
  8. 待办事宜/ 路线图
  9. 页:1
  10. 许可证

Tauri 插件 iOS 相片

访问和管理 Tauri 插件 iOS 相册和资产 使用本地相片框架.

这个插件允许Tauri应用程序请求照片权限,阅读相册,访问相片,并在iOS设备上进行基本的相册/相片管理.

只有iOS系统 此插件依赖于Apple Photos API,在其他平台上不可用.


特征

  • 请求和检查照片库的授权
  • 列出用户相册
  • 访问相册相片
  • 过滤相册
  • 检查相册权限
  • 创建并删除相册
  • 创建、访问和删除相片

所需资源

  • Tauri 2.x(或相容版本)
  • 带有 iOS SDK 的 Xcode
  • 配置适当的相片库权限 Info.plist

iOS 权限

此插件需要访问用户的照片库 .

请将以下密钥添加到您的 iOS系统 Info.plist数字 :

<key>NSPhotoLibraryUsageDescription</key>
<string>Allow access to your photo library</string>

<key>NSPhotoLibraryAddUsageDescription</key>
<string>Allow saving photos to your photo library</string>

安装

pnpm add @gbyte/tauri-plugin-ios-photos
# or
npm install @gbyte/tauri-plugin-ios-photos
# or
yarn add @gbyte/tauri-plugin-ios-photos

在您的 Tauri 工程中添加插件 Cargo.toml数字 :

[dependencies]
tauri-plugin-ios-photos = "0.3"

或使用 cargo add tauri-plugin-ios-photos。 。 。 .

配置您的插件权限 capabilities/default.json数字 :

{
  "permissions": [
    "ios-photos:default"
  ]
}

在您的 Tauri 应用程序中注册插件 :

fn main() {
    tauri::Builder::default()
        .plugin(tauri_plugin_ios_photos::init())
        .run(tauri::generate_context!())
        .expect("error while running tauri application");
}

用法(概念示例)

import {
  requestPhotosAuth,
  PhotosAuthorizationStatus,
  requestAlbums,
  PHAssetCollectionType,
  PHAssetCollectionSubtype
} from '@gbyte/tauri-plugin-ios-photos'

let photoAuth = ''
let albums = []

requestPhotosAuth()
  .then((status) => {
    switch (status) {
      case PhotosAuthorizationStatus.authorized:
        photoAuth = 'authorized'
        break
      case PhotosAuthorizationStatus.denied:
        photoAuth = 'denied'
        break
      case PhotosAuthorizationStatus.limited:
        photoAuth = 'limited'
        break
      case PhotosAuthorizationStatus.restricted:
        photoAuth = 'restricted'
        break
      case PhotosAuthorizationStatus.notDetermined:
        photoAuth = 'notDetermined'
        break
    }
  })
  .then(() => {
    requestAlbums({
      with: PHAssetCollectionType.smartAlbum,
      subtype: PHAssetCollectionSubtype.albumRegular
    }).then((value) => {
      albums = value
    })
  })


关于图像路径访问

此插件返回的图像路径是本地文件路径, 通常指向内部的 iOS 沙盒位置 .

在Tauri(特别是在iOS/WebView环境中)中,这些本地路径无法由前端直接访问(例如通过文件://或原始文件系统路径). 这是由于WebView的安全和沙盒的限制.

在使用前端的这些图像之前, 您必须通过 Tauri 自定义协议( URI 方案) 来曝光它们, 这样它们就可以作为普通的 URL 访问 .

建议的办法:

  1. 在 Tauri 中注册一个自定义的 URI 方案( 例如, time://)

  2. 当前端请求临时 :

  • Tauri 读取相应的本地文件

  • 以正确的 MIME 类型返回二进制数据

  1. 前端然后可以正常地使用URL(例如. (中文(简体) )

注释 :

  • 此插件不会自动将本地路径转换为可访问 URL

  • 执行自定义协议是应用程序的责任

  • 出于安全原因,建议限制无障碍路径范围


状况

可能的授权规定:

  • notDetermined
  • restricted
  • denied
  • authorized
  • limited

插件会让API接触到查询并对这些状态作出反应.


待办事宜/ 路线图

  • 请求访问授权
  • 检查授权类型
  • 列出用户设备相册
  • 从相册取相片
  • 过滤相册
  • 检查相册权限
  • 获取相片
  • 创建相册
  • 创建相片
  • 删除相册
  • 删除相片
  • 删除相片
  • 文件改进
  • 示例项目
  • 处理标准化出错

页:1

  • 所有相片操作都遵循iOS隐私规则.
  • 如果许可有限,一些行动可能会默默失败.
  • 相册和相片识别符由系统生成.

许可证

麻省理工学院

版本与发布记录

@gbyte/tauri-plugin-ios-photos 共发布 3 个版本,首次发布于 2025/12/24;过去 12 个月发布了 3 个版本。

版本发布日期距今
0.3.0latest2025/12/3110 个月前
0.2.02025/12/2910 个月前
0.1.02025/12/2410 个月前

关于 @gbyte/tauri-plugin-ios-photos 的常见问题

@gbyte/tauri-plugin-ios-photos 是什么?

访问iOS用户设备相片库.

如何安装 @gbyte/tauri-plugin-ios-photos?

在项目目录运行 npm install @gbyte/tauri-plugin-ios-photos,或使用 pnpm add / yarn add / bun add。

@gbyte/tauri-plugin-ios-photos 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@gbyte/tauri-plugin-ios-photos 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@gbyte/tauri-plugin-ios-photos 可以商用吗?

@gbyte/tauri-plugin-ios-photos 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@gbyte/tauri-plugin-ios-photos 的下载量有多少?

根据 npm 官方下载统计,@gbyte/tauri-plugin-ios-photos 在 2026/10/16 – 2026/11/14 这 30 天内被下载 2,130 次,日均约 71 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@gbyte/tauri-plugin-ios-photos 还在维护吗?

最新版本 0.3.0 发布于 2025/12/31(10 个月前);至今共发布 3 个版本,其中过去 12 个月发布了 3 个;首次发布于 2025/12/24。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。