Documents by Readdle

Documents by Readdle 是 Readdle 面向 iPhone 和 iPad 的文件管理、媒体播放与文档中心应用。Protocol Launcher 允许你生成 Documents URL scheme 链接，用于打开应用内文件。

使用方式

有两种使用此库的方式：

• 按需导入（On-Demand）：从子路径导入支持 tree-shaking，保持较小的打包体积。
• 完整导入（Full Import）：从根包导入更方便，但会包含所有应用模块。

生产构建建议选择按需导入；快速脚本或演示可以使用完整导入。

选择安装方式

按需加载

推荐使用。生产环境优化。

全量导入

使用便捷。适合快速脚本。

打开文件

使用官方文档中的 rdocs:///folder/subfolder/file.pdf 形式，打开存储在 My Files 区域中的文件。

On-Demand

import { openFile } from 'protocol-launcher/documents-readdle'

const url = openFile({
  path: 'folder/subfolder/file.pdf',
})

在 Documents 中打开文件

打开同步文件

使用官方文档中的 rdocs:///SyncedFolders/ 静态路径，打开保存在 Synced folders 中的文件。

On-Demand

import { openSyncedFile } from 'protocol-launcher/documents-readdle'

const url = openSyncedFile({
  path: 'folder1/folder2/test.pdf',
})

在 Documents 中打开同步文件

Readdle 提示，其他应用语言可能需要使用 URL 中 Synced folders 部分的翻译版本。需要时通过 syncedFoldersPath 传入该路径段：

On-Demand

const localizedUrl = openSyncedFile({
  syncedFoldersPath: '同期フォルダ',
  path: 'folder1/folder2/test.pdf',
})

打开本地化同步文件

生成的 URL

openFile({ path: 'folder/subfolder/file.pdf' })
// => 'rdocs:///folder/subfolder/file.pdf'

openSyncedFile({ path: 'folder1/folder2/test.pdf' })
// => 'rdocs:///SyncedFolders/folder1/folder2/test.pdf'

openSyncedFile({
  syncedFoldersPath: '同期フォルダ',
  path: 'folder1/folder2/test.pdf',
})
// => 'rdocs:///同期フォルダ/folder1/folder2/test.pdf'

官方文档

• Documents URL scheme from Safari