VandelayDropbox 0.6.0

VandelayDropbox 0.6.0

×

测试已测试✓
语言语言 SwiftSwift
许可证 MIT
发布最后发布2018 年 9 月
SPM支持 SPM✗

由 Daniel Saidi 维护。

 
依赖
SwiftyDropbox>= 0
Vandelay>= 0
 

VandelayDropbox 0.6.0

Vandelay logo

Vandelay

CI Status Version License Platform

关于

Vandelay 是一个针对 iOS 的导入/导出器（注意双关语）。它使用 Swift 4 编写，并自带将字符串和数据导出到/从各种数据源导入的功能。它支持 Codable 类型以及基本的字符串和数据。

安装

CocoaPods

要使用 CocoaPods 安装 Vandelay，请将以下内容添加到您的 Podfile，然后运行 pod install

pod "Vandelay"

您可以通过在 Podfile 中添加更多行来添加对 Dropbox 和 QR 码的额外支持

pod "VandelayDropbox"
pod "VandelayQr"

Carthage

要使用 Carthage 安装 Vandelay，只需将以下内容添加到您的 Cartfile 中，然后运行 carthage update --platform iOS

pod "Vandelay"

这将下载并构建所有 Vandelay 框架。Vandelay 框架包含核心功能，是所有其他可选框架所必需的。VandelayDropbox 添加额外的 Dropbox 支持。VandelayQr 添加对扫描二维码的支持。如果需要，请添加它们。

导出数据

Vandelay 允许您通过使用其内置的任何导出器，导出字符串、数据和 Encodable 类型。您还可以通过自定义导出器来扩展它。

Vandelay 随附以下内置导出器

  • EmailExporter - 以电子邮件附件形式导出 strings 和 data
  • FileExporter - 将 strings 和 data 导出到本地文件
  • MessageExporter - 以消息附件形式导出 strings 和 data
  • PasteboardExporter - 将 strings 导出到剪贴板

如果您添加了 VandelayDropbox，您将获得以下导出器的访问权限

  • DropboxExporter - 将 strings 和 data 导出到 Dropbox

尽可能使用字符串导出器。当只有 Data 或类型无法序列化时，请使用数据导出器。

导入数据

Vandelay 允许您通过使用其内置的任何导入器，导入字符串、数据和 Decodable 类型。您也可以通过自定义导入器来扩展它。

Vandelay 随附以下内置导入器

  • FileExporter - 从本地文件导入 strings 和 data
  • PasteboardExporter - 从剪贴板导入 strings
  • UrlExporter - 从自定义网址导入 strings 和 data

如果您添加了 VandelayDropbox，您将获得以下导入器的访问权限

  • DropboxImporter - 从 Dropbox 导入 strings 和 data

如果您添加了 VandelayQr，您将获得以下导入器的访问权限

  • QrCodeImporter [STRING|DATA] - 通过扫描二维码导入

导入时与导出时相同：数据更强大，但字符串更通用。

Dropbox 支持

Vandelay 支持额外的 Dropbox 功能。这意味着一个应用程序可以使用 Vandelay 将数据同步到用户的个人 Dropbox 应用文件夹。

要在您的应用程序中使用这些功能，您必须创建一个 Dropbox 开发者账户以及一个适用于您的应用程序的 Dropbox 应用程序。本指南说明了如何操作。

查看示例应用程序如何为使用 Dropbox 准备。基本上，当您的应用程序启动时，必须在 Dropbox 中设置集成，并处理 Dropbox 将用户重定向回应用程序时触发的任何回调 URL。此外，您的应用程序还需要在 Info.plist 中添加一些密钥。

在示例应用程序中，只需要将 Dropbox 应用程序 ID 添加到本地的 Accounts.plist 文件，然后选择应用程序的目标，选择“信息”选项卡，在“URL 类型”下插入相同的应用程序 ID。

QR 码支持

Vandelay 支持额外的 QR 码功能。这意味着应用程序可以使用 Vandelay 通过让用户扫描 QR 码来导入数据。

要使用此功能，请确保在 Info.plist 中指定了 NSCameraUsageDescription 文本。否则，应用程序将崩溃。此外，请确保应用程序可以访问扫描的 URL。示例通过允许导入任何 URL 来实现这一点。在实际应用程序中，允许任意 URL 不是很好的主意 :)

示例项目

Vandelay 伴随一个示例项目，允许您导出和导入待办事项列表（字符串）和照片（数据）。

在您能够运行示例应用程序之前，必须安装 Carthage 并运行 carthage update --platform iOS。这将设置所有依赖项并准备应用程序。然后您可以打开项目并运行应用程序。

对于 QR 码，您可以使用内置的 QrCodeGenerator 生成一个可扫描的 QR 码，以查看您已经导出的任何 URL 的数据。然后您将能够扫描该代码以将数据导入到应用程序中。

版本

版本 < 1.0.0 之间的较小版本会有破坏性更改，因此 Vandelay 0.3.0 可能与 Vandelay 0.2.0 等不兼容。

作者

Daniel Saidi, [email protected]

许可

Vandelay 在MIT许可下可用。有关更多信息，请参阅LICENSE文件。