Swift Package Manager 库制作

Swift Package Manager 是苹果官方推出的库管理工具。类似 cocoapods。

准备事项：

一个需要封装的库
存放库的远程仓库，如 github、gitee、gitLab等

创建Package

创建 Package 有2种方式，命令行和 Xcode。

一、命令行

首先创建包名

mkdir SPMTest
cd SPMTest

创建 package 项目

swift package init

此时我们已经创建好了一个包项目，只需要双击 Package.swift 文件即可启动 Xcode，进行编码和测试。

我们也可以使用swift package generate-xcodeproj来生成 xcode 项目，但是一般不需要。

Tips: 对于已经存在的库，我们可以指定源码路径，不一定要使用默认的构建源码路径

二、Xcode

通过 Xcode 开发工具，我们也可以新建一个 Package 项目。

输入库名即可。

Package 文件编辑

Package.swift相当于 Cocoapods 库的 xxx.podspes文件，是对库的配置。

示例：

import PackageDescriptionlet package = Package(name: "SPMTest",products: [// Products define the executables and libraries a package produces, and make them visible to other packages..library(name: "SPMTest",targets: ["SPMTest"]),],dependencies: [// Dependencies declare other packages that this package depends on.// .package(url: /* package url */, from: "1.0.0"),],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: "SPMTest",dependencies: []),.testTarget(name: "SPMTestTests",dependencies: ["SPMTest"]),]
)

默认添加 name、products、targets，还可以添加其他参数，但是需要按照顺序。

参数解释

name：库包的名称；

defaultLocalization：资源的默认本地化；

platforms：支持的最低系统平台的列表；

pkgConfig：用于C模块的名称。如果存在，Xcode将搜索.pc文件以获取系统目标所需的其他标志；

providers：系统目标的程序包提供者；

products：此软件包可让客户使用的产品列表；

dependencies：软件包依赖项列表（可空，或需要其它外部依赖）；

targets：属于此软件包的目标列表（源码目录、测试目录）；

swiftLanguageVersions：此软件包兼容的Swift版本列表；

cLanguageStandard：用于此程序包中所有C目标的C语言标准；

cxxLanguageStandard：用于此程序包中所有C ++目标的C ++语言标准；

测试

一、单元测试

自行封装的库，建议写好单元测试，以便后期维护和保证库的稳定性。

二、使用测试

在库还没有推到远程仓库，或者没有发布时，本地该如何测试？

将库文件夹手动拉入项目，手动添加库

Tips: Xcode 可在不删除远程库的条件下，添加本地库调试（本地库会覆盖远程库），调试完成删除即可

使用

我们可以在 Xcode 的菜单栏 File -> Swift Pakcages -> Add Package Dependncy进入添加页面。

也可以直接选择项目，进入PROJECT 选择 Swift Packages

复制库地址或者搜索库选择之后，选择版本号，等待下载就可以了。

Tips: 没有发布 release 的库只能通过 branch 或者 commit 下载代码

项目使用的 SPM 库文件路径在[appName].xcodeproj/project.workspace/xcshareddata/swiftpm/Package.resolved

更新第三方库

我们使用 Cocoapods 的时候可以随时通过 pod install 或者 pod update将库更新到最新，如果使用 Swift Package Manager 怎么更新了。

虽然Xcode会更新你的包依赖并自动解析包版本，但你可以从File > Swift Packages菜单中触发这两个动作。

如下图，选择更新库。

参考

Swift Package Manager介绍 – raywenderlich

如何让自己的库支持 Swift Package Manager

how to use swift package manager – Mobile Thinking: 英文介绍，包含如何创建和使用。

iOS 包依赖管理工具（五）：Swift Pakcage Manager自定义篇 – 简书-青叶小小

WWDC2020 - Swift Package Manager – kemchenj