Swift Package Manager（SPM），通常简称为SwiftPM或SPM，是苹果官方提供的用于管理Swift代码分发的工具。它与Swift构建系统集成，自动处理依赖项的下载、编译和链接过程，支持Swift、Objective-C、C和C++等语言。SPM包含在Swift 3.0及更高版本中，适用于macOS和Linux平台，与CocoaPods和Carthage功能类似，但更简洁且侵入性更小。
SPM版本
Xcode自带SPM，可以在终端通过swift package --version命令查看版本信息。
SPM管理添加三方库
SPM从Xcode 8.0开始集成，并在Xcode 11中通过libSwiftPM支持iOS、watchOS和tvOS平台。这意味着iOS 11及更高版本才能使用SPM管理这些平台的依赖。要判断一个库是否支持SPM，可以检查是否存在Package.swift文件。
添加依赖有两种主要方式：通过Xcode菜单的"File -> Swift Packages -> Add Package Dependency"，或直接在项目设置的"Swift Packages"部分添加。两种方式都会打开"Choose Package Repository"对话框，输入三方库的GitHub或其他Git仓库链接后，可以选择集成方式，包括版本范围（如Up to Next Major、Up to Next Minor）、分支或特定提交。
集成完成后，可以在项目设置中管理依赖，例如重置缓存、解析版本或更新到最新版本。使用时，只需在代码中导入相应的模块即可。
SPM如何管理依赖
当通过SPM添加依赖（如RxSwift）时，代码不会直接出现在项目中，而是被下载到Xcode的DerivedData缓存目录中。配置信息则存储在项目文件的project.pbxproj中。SPM与CocoaPods可以同时使用，互不影响。
生成Swift Package
创建Swift Package有两种方式：命令行和Xcode。在命令行中，使用swift package init可以初始化一个包，并指定类型，如executable（可执行文件）、library（静态库）或system-module（系统库）。常用的命令包括：
swift build：编译包。swift run：编译并运行可执行文件。swift test：运行单元测试。
在Xcode中，可以通过"File -> New -> Swift Package"创建包，并编辑Package.swift文件来配置依赖和设置。包可以本地拖入项目使用，也可以发布到远程仓库供他人依赖。
SPM支持Objective-C和C/C++
SPM也支持Objective-C、C和C++代码。创建包时，可以删除默认的Swift文件，添加相应的头文件和实现文件。配置Package.swift时，需要正确设置publicHeadersPath来指定头文件路径，或使用软链接。使用时，在桥接文件中导入头文件即可调用。
包中依赖其他库
在Package.swift的dependencies数组中添加其他包的Git URL和版本要求，SPM会自动处理依赖解析。依赖方式包括指定确切版本、版本范围、分支或提交。
Package.swift配置详解
Package.swift是SPM的核心配置文件，包含以下主要部分：
- platforms：指定支持的平台和最低版本，如
.iOS(.v10)。 - products：定义包产出的类型，如可执行文件（
.executable）或库（.library），库可以是静态或动态。 - targets：定义包的构建目标，包括源代码路径、依赖、资源文件和编译设置。每个target可以依赖其他target或外部包。
- swiftLanguageVersions：指定支持的Swift语言版本。
- cLanguageStandard和cxxLanguageStandard：设置C和C++语言标准。
添加资源文件
从Swift 5.3开始，SPM支持在包中包含资源文件，如图片、本地化字符串或配置文件。在target的resources数组中，使用.process()进行优化处理或.copy()直接复制。资源文件在编译后会打包到bundle中，运行时通过Bundle.module访问。
本地化支持
SPM支持多语言本地化。在Package.swift中设置defaultLocalization，并创建对应语言的.lproj目录，包含.strings或.stringsdict文件。使用时，通过Bundle.module获取本地化字符串。
二进制依赖
SPM支持集成二进制依赖，但仅限XCFramework格式。在Package.swift中，使用.binaryTarget指定本地路径或远程URL（需提供校验和）。二进制依赖可以像普通依赖一样在target中引用。
常见错误与解决
- 混合语言编译错误：Swift和Objective-C/C代码不能放在同一个target中，需分开。
- 路径配置错误：确保
publicHeadersPath设置正确。 - 网络问题：依赖下载失败时，检查网络或使用代理。
- 解析失败：Package.swift语法错误时，仔细检查配置顺序和格式。
SPM与其他依赖管理工具对比
SPM与CocoaPods和Carthage相比，具有以下特点：
- 原理：集成于Swift构建系统，自动处理依赖。
- 语言支持：支持Swift、C、C++、Objective-C。
- 兼容性：可与CocoaPods和Carthage共存。
- 复杂度：较低，无需额外工具。
- 生态：官方维护，但相对较新，功能不断优化。
总体而言，SPM是苹果推荐的依赖管理工具，尤其适合Swift项目，随着Xcode的更新，其功能日益完善，已成为开发中的主流选择。