AWS SDK for iOS 的 Swift Package Manager 支持

本仓库通过提供清单文件 (Package.swift) 来实现对 AWS Mobile SDK for iOS 的 Swift Package Manager 支持，该文件链接到 SDK 的二进制框架。

设置

要开始使用 AWS SDK for iOS，请查看 iOS 开发者指南。您可以设置 SDK 并开始构建新项目，或者将 SDK 集成到现有项目中。

要使用 AWS SDK for iOS，您需要在开发机器上安装以下内容：

通过 Swift Package Manager 添加 AWS SDK iOS

  1. 在 Xcode 11.0 或更高版本中打开您的项目

  2. 转到 File > Swift Packages > Add Package Dependency...

  3. 在 Enter package repository URL 字段中，输入 "https://github.com/aws-amplify/aws-sdk-ios-spm"

  4. 选择最新版本，然后单击 Next。

    注意： AWS Mobile SDK for iOS 不遵循语义版本控制。

  5. 选择您的项目所需的包，然后单击 Finish

本地开发

如果您使用 SPM 进行开发并修改 AWS SDK iOS 代码库中的源代码，您需要使用本地构建的 XCF 文件副本。运行 local.sh 将生成所有 XCF 文件并将它们复制到此仓库中的一个目录，以便可以更新 Package.swift 以引用它们。XCF 文件就位后，将 localPathEnabled 的值更改为 true，包将引用本地路径。然后，Swift 包可以在本地使用，并应用在 aws-sdk-ios 仓库的克隆副本中所做的任何更改。

要求

为了进行本地开发，必须使用 XCF 文件填充 XCF 目录。这些文件可以从 aws-sdk-ios 仓库生成，预计会与此仓库一起克隆。用于创建用于部署的 XCF 文件的 Python 脚本将用于准备这些文件，然后将其复制到此仓库目录中名为 XCF 的文件夹中。然后可以更改 Package.swift 以使用本地路径。

  1. 将 aws-sdk-ios 克隆到与此仓库相同的目录
  2. 运行 local.sh 以准备 XCF 文件（这可能需要一段时间）
  3. 更新 Package.swift 以将 buildMode 设置为 localWithDictionary 或 localWithFilesystem

localWithDictionary 模式将使用 Package.swift 中的包列表，而 localWithFilesystem 将读取文件系统以查找哪些包已构建并在 XCF 文件夹中找到。当构建包的子集时，此选项很有用，这需要更少的时间。