# @gbyte/tauri-plugin-ios-photos 中文文档

规范地址：https://npmcn.com/package/%40gbyte/tauri-plugin-ios-photos/

版本：0\.3\.0
npm 元数据更新时间：2025-12-31T02:58:23.065Z
中文译文更新时间：2026-11-16T00:45:34.554Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40gbyte/tauri-plugin-ios-photos
原文对照：https://npmcn.com/package/%40gbyte/tauri-plugin-ios-photos/?lang=original
项目主页：https://github.com/Gbyte-Group/tauri-plugin-ios-photos#readme
源码仓库：https://github.com/Gbyte-Group/tauri-plugin-ios-photos

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：24.2 kB，6 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：1 个
- 首次发布：2025-12-24T08:07:43.244Z
- 最新版本发布：2025-12-31T02:58:22.863Z
- 近 30 天下载量：2130（2026-10-16 至 2026-11-14，npm 官方下载统计）
- 已发布版本数：3（近 12 个月 3 个）

## 中文简介

访问iOS用户设备相片库.

## 安装

```sh
npm install @gbyte/tauri-plugin-ios-photos
```

也可以使用：`pnpm add @gbyte/tauri-plugin-ios-photos`、`yarn add @gbyte/tauri-plugin-ios-photos`、`bun add @gbyte/tauri-plugin-ios-photos`

## README

# Tauri 插件 iOS 相片

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

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

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

* * *

## 特征

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

* * *

## 所需资源

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

* * *

## iOS 权限

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

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

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

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

* * *

## 安装

```bash
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`数字 :

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

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

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

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

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

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

* * *

## 用法(概念示例)

```ts
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 类型返回二进制数据
    

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

> 注释 :
> 
> -   此插件不会自动将本地路径转换为可访问 URL
>     
> -   执行自定义协议是应用程序的责任
>     
> -   出于安全原因,建议限制无障碍路径范围
>     

* * *

## 状况

可能的授权规定:

-   `notDetermined`
-   `restricted`
-   `denied`
-   `authorized`
-   `limited`

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

* * *

## 待办事宜/ 路线图

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

* * *

## 页:1

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

* * *

## 许可证

麻省理工学院

## 常见问题

### @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 和提交记录判断。

