创新互联IOS教程：使用Xcode创建独立Swift软件包

概览

Swift 软件包是可复用的 Swift、Objective-C、Objective-C++、C 或 C++ 代码组件。它们可以捆绑资源，将代码作为二进制文件来提供，或者依赖于其他软件包。Swift 软件包可用于捆绑可执行代码 (例如，将脚本捆绑为“可执行产品”)，或用于创建软件包来将可共享的代码作为“资源库产品”提供。用于提供资源库产品的软件包有助于促进代码模块化发展，方便与他人共享代码，而且也利于其他开发者在其 App 中添加功能。

成都创新互联业务包括：成品网站、企业产品展示型网站建设、高端网站设计、电子商务型网站建设、外贸网站建设(多语言)、商城开发、按需求定制网站、全网营销推广等。效率优先，品质保证，用心服务是我们的核心价值观，我们将继续以良好的信誉为基础，秉承稳固与发展、求实与创新的精神，为客户提供更全面、更优质的互联网服务！

通过 Xcode，你可以创建新的 Swift 软件包，添加代码、资源文件和二进制文件，构建 Swift 软件包，并且运行单元测试。

创建 Swift 软件包

要创建新的 Swift 软件包，请打开 Xcode，然后选择“File”(文件) >“New”(新建) >“Swift Package”(Swift 软件包)。选取名称并选择文件位置。选择“Create Git repository on my Mac”(在我的 Mac 上创建 Git 储存库)，以将你的软件包置于版本控制下。完成后，Swift 软件包会在 Xcode 中打开，就像是一个标准的 Xcode 项目。在创建 Swift 软件包时，Xcode 会生成所有必要的文件和文件夹：

• README.md 文件位于软件包的根目录下。它会提供 Swift 软件包功能的描述。

• Package.swift 文件 (即“软件包清单”) 描述 Swift 软件包的配置。你可以在访达中连按两次该文件来在 Xcode 中打开对应的软件包。软件包清单使用 Swift 和 PackageDescription 框架来定义软件包的名称、产品、目标，以及对其他软件包的依赖项等。

• 源代码文件位于名为 Sources 的文件夹中，并根据 Target (英文) 来设定作用域。一个 Swift 软件包可以包含多个目标，并且按照惯例，各目标的代码位于自己的子文件夹中。

• 单元测试目标位于名为 Tests 的文件夹中，并且遵循与标准目标相同的惯例，各测试目标的代码分别位于自己的子文件夹中。

配置你的 Swift 软件包

Swift 软件包不使用 .xcproject 或 .xcworkspace，但依赖于它们的文件夹结构，并且使用软件包清单来进行其他配置。以下代码摘录显示了一个简单的软件包清单。它声明了 MyLibrary 目标，并使用同一名称将它作为资源库产品来提供。

 // swift-tools-version:5.3 import PackageDescription   let package = Package(  name: "MyLibrary",  platforms: [  .macOS(.v10_14), .iOS(.v13), .tvOS(.v13)  ],  products: [  // Products define the executables and libraries a package produces, and make them visible to other packages.  .library(  name: "MyLibrary",  targets: ["MyLibrary", "SomeRemoteBinaryPackage", "SomeLocalBinaryPackage"])  ],  dependencies: [  // Dependencies declare other packages that this package depends on.  ],  targets: [  // Targets are the basic building blocks of a package. A target can define a module or a test suite.  // Targets can depend on other targets in this package, and on products in packages this package depends on.  .target(  name: "MyLibrary",  exclude: ["instructions.md"],  resources: [  .process("text.txt"),  .process("example.png"),  .copy("settings.plist")  ]  ),  .binaryTarget(  name: "SomeRemoteBinaryPackage",  url: "https://url/to/some/remote/binary/package.zip",  checksum: "The checksum of the XCFramework inside the ZIP archive."  ),  .binaryTarget(  name: "SomeLocalBinaryPackage",  path: "path/to/some.xcframework"  )  .testTarget(  name: "MyLibraryTests",  dependencies: ["MyLibrary"]),  ] )

软件包清单的开头必须是字符串 // swift-tools-version:，后跟版本号，例如 // swift-tools-version:5.3。

Swift 工具版本声明以下内容：

• PackageDescription 框架的版本

• 用于处理清单的 Swift 语言兼容版本

• 使用该软件包所需的最低 Swift 工具版本

每个版本的 Swift 都可能会推出 PackageDescription 框架更新，但以前的 API 版本仍可供声明较旧 Swift 工具版本的软件包使用。这样一来，你便可以利用新版本的 Swift、Swift 工具和 PackageDescription 框架，而无需更新你的软件包清单，也不会失去对现有软件包的访问。

要进一步了解 PackageDescription 框架，请参阅“Package (英文)”。

注释

在你编辑软件包清单时，Xcode 会提供代码补全功能。

添加你的代码

根据惯例，源代码文件位于软件包的 Sources 目录下的子文件中，文件夹名称与它们所属的目标相同。注意上方的软件包清单是如何声明 MyLibrary 目标的。其源代码文件位于 Sources/MyLibrary 中，用于测试的源代码文件则位于 Sources/MyLibraryTests 中。你可以利用其他子文件夹来组织它们的结构。默认情况下，Xcode 将所有有效的源代码文件包含在目标的文件夹中。如果想要以显式方式声明所含的源代码文件，请在初始化 Target (英文) 时使用 sources (英文) 参数来传递它们。也可以传递目录的路径。

要将源代码文件添加到 Swift 软件包中，可以利用你已熟知的工作流程。例如，你可以将源代码文件拖入项目导航器来将其添加到软件包中，也可以使用“File”(文件) >“Add Files to [packageName]”(添加文件至 [packageName]) 菜单来添加。目标可以包含 Swift、Objective-C/C++ 或 C/C++ 代码，但一个目标中不能混合 Swift 和 C 系列语言。例如，一个 Swift 软件包可以有两个目标，一个目标含有 Objective-C、Objective-C++ 和 C 代码，另一个则包含 Swift 代码。

添加对其他 Swift 软件包的依赖项

与 App 一样，Swift 软件包可以拥有“软件包依赖项”。要声明对远程软件包的依赖项，可以使用任何一种将远程软件包 URL 作为参数的函数。要将本地软件包添加为依赖项，可以使用任何一种将本地软件包路径作为参数的函数。以下代码片段显示了这两种选项：

 dependencies: [   // Dependencies declare other packages that this package depends on.  .package(url: "https://url/of/another/package.git", from: "1.0.0"),  .package(path: "path/to/a/local/package/", "1.0.0"..<"2.0.0")],

请参阅 Package.Dependency (英文)，以了解所有可用来声明软件包依赖项的方式。在添加依赖项时，你可以将其提供的产品用作 Target.Dependency (英文)，或使它成为软件包的 Product (英文) 的一部分。

将二进制文件作为 Swift 软件包进行分发

除了分发提供源代码文件的 Swift 软件包外，也可以选择分发二进制文件。例如，专有闭源资源库的创建者通常以二进制文件形式提供这些资源库。要了解更多信息，请参阅“将二进制框架作为 Swift 软件包进行分发 (英文)”。

添加软件包资源

在你的清单文件中声明 Swift 工具版本 5.3 或更高版本，以将素材文件作为软件包资源添加到 Swift 软件包中。例如，Swift 软件包可以包含使用素材目录、Storyboard 和 .strings 文件等的用户界面组件。要了解更多信息，请参阅“使用 Swift 软件包捆绑资源 (英文)”。

使你的 Swift 软件包能够跨平台兼容

尽管 Swift 软件包在本质上独立于平台，并包含 Linux 等目标平台，但是 Swift 软件包可能是针对特定平台的。你可以使用条件编译块来处理平台专有代码并实现跨平台兼容性。以下示例显示了如何使用条件编译块：

 #if os(Linux)   // Code specific to Linux   #elseif os(macOS)   // Code specific to macOS   #endif   #if canImport(UIKit)   // Code specific to platforms where UIKit is available   #endif

此外，你可能需要定义最低部署目标。注意以下软件包清单如何通过将最低部署目标作为值传递给 Package (英文) 构造器的 platforms 参数。但是，将最低部署目标传递给该构造器不会将软件包限制到列出的平台。

 // swift-tools-version:5.3 import PackageDescription   let package = Package(  name: "MyLibrary",  platforms: [  .macOS(.v10_14), .iOS(.v13), .tvOS(.v13)  ],  products: [  // Products define the executables and libraries a package produces, and make them visible to other packages.  .library(  name: "MyLibrary",  targets: ["MyLibrary", "SomeRemoteBinaryPackage", "SomeLocalBinaryPackage"])  ],  dependencies: [  // Dependencies declare other packages that this package depends on.  ],  targets: [  // Targets are the basic building blocks of a package. A target can define a module or a test suite.  // Targets can depend on other targets in this package, and on products in packages this package depends on.  .target(  name: "MyLibrary",  exclude: ["instructions.md"],  resources: [  .process("text.txt"),  .process("example.png"),  .copy("settings.plist")  ]  ),  .binaryTarget(  name: "SomeRemoteBinaryPackage",  url: "https://url/to/some/remote/binary/package.zip",  checksum: "The checksum of the XCFramework inside the ZIP archive."  ),  .binaryTarget(  name: "SomeLocalBinaryPackage",  path: "path/to/some.xcframework"  )  .testTarget(  name: "MyLibraryTests",  dependencies: ["MyLibrary"]),  ] )

提示

如果你计划发布 Swift 软件包，而且该软件包仅支持部分平台，请考虑在 README.md 文件中列出受支持的平台。此外，也请考虑添加对其他平台的支持，以便扩大受众范围。

构建目标并运行单元测试

Xcode 会在软件包清单中为每个产品创建一个方案。为软件包的构建和运行目的地选择一个方案，并像构建 App 目标一样进行构建。每个源代码目标通常至少有一个对应的测试目标。如果你的软件包中包含多个产品，Xcode 会使用名称 [packageName]-Package 来创建一个额外方案，以构建所有目标并运行所有单元测试。

分享文章：创新互联IOS教程：使用Xcode创建独立Swift软件包
文章转载：http://www.mswzjz.cn/qtweb/news14/501564.html

攀枝花网站建设、攀枝花网站运维推广公司-贝锐智能，是专注品牌与效果的网络营销公司；服务项目有等

广告

声明：本网站发布的内容（图片、视频和文字）以用户投稿、用户转载内容为主，如果涉及侵权请尽快告知，我们将会在第一时间删除。文章观点不代表本网站立场，如需处理请联系客服。电话：028-86922220；邮箱：631063699@qq.com。内容未经允许不得转载，或转载时需注明来源： 贝锐智能