关于
Vandelay 是一个基于 Swift 的 iOS 导入/导出工具。它支持 Codable
、字符串和数据,并内置对从多个数据源导入和导出字符串和数据的支持。
安装
Swift Package Manager
将 Vandelay 添加到项目的最简单方法是使用 Swift Package Manager
.package(url: "[email protected]:danielsaidi/Vandelay.git" ...)
CocoaPods
pod "Vandelay"
Carthage
github "danielsaidi/Vandelay"
手动安装
在不使用依赖管理器的情况下将 Vandelay
添加到您的应用程序中,请克隆此存储库,将 Vandelay.xcodeproj
添加到您的项目中,并将 Vandelay.framework
作为嵌入的应用程序二进制和目标依赖项添加。
导出数据
Vandelay 使用 导出器
允许您导出字符串、数据和 Encodable
。
Vandelay 内置以下导出器
EmailExporter
- 将字符串
和数据
作为电子邮件附件导出FileExporter
- 将字符串
和数据
导出到本地文件MessageExporter
- 将字符串
和数据
作为消息附件导出PasteboardExporter
- 将字符串
导出到剪贴板
您还可以通过自定义导出器扩展 Vandelay。
如果您想要平台无关、可读的导出,请使用 字符串
导出器。当您只有 Data
或类型无法序列化时,请使用 数据
导出器。
导入数据
Vandelay 使用 导入器
允许您导入字符串、数据和 Decodable
类型。
Vandelay 内置以下导入器
FileImporter
- 从本地文件导入字符串
和数据
PasteboardImporter
- 从剪贴板导入字符串
UrlImporter
- 从自定义 URL 导入字符串
和数据
您也可以通过自定义导入器扩展 Vandelay。
在导入时,与导出一样:数据更强大,但字符串更通用。
导入外部文件
您可以使用现有的导入器通过共享外部文件到Vandelay导入数据,例如通过点击电子邮件附件或将文件共享到应用中。
要导入文件,您的应用必须正确配置以处理文件类型。您需要注册文档类型
和导出类型UTIs
并在AppDelegate
(iOS 12及以下版本)或SceneDelegate
(iOS 13及以上版本)中实现正确功能。一旦触发这些功能,您可以使用UrlImporter
导入点击的文件。
查看示例应用了解如何实现这一功能。
QR码支持
您可以使用库中的QrCodeGenerator
实现来生成QR码。您可以用UrlImporter
导入扫描的QR码中的数据。
示例应用
此存储库包含一个示例应用,允许您导出/导入待办事项(字符串)和照片(数据)。要运行示例应用,打开并运行Vandelay.xcodeproj
项目。
示例应用注册了一个自定义文件类型.vdl
,它使用该文件类型导出和导入数据。请查看Info.plist
、AppDelegate
和SceneDelegate
以了解其处理导入的方式。
联系我
如果您有任何问题或想以任何方式做出贡献,随时联系我。
- 电子邮箱:[email protected]
- Twitter:@danielsaidi
- 网站:danielsaidi.com
许可证
Vandelay 根据MIT许可证提供。有关更多信息,请参阅LICENSE文件。