Swift Package Manager
一句话:Swift Package Manager(swift包管理器,简称:SPM)就是在swift开发中用来替代CocoaPod的;在swift开发中,SPM完全可以替代CocoaPod的功能,并且速度更快,体验更佳;
一、安装SPM
SPM随Xcode 8.x 一起发布,终端上可查看SPM版本:
swift package --version
Swift Package Manager - Swift 3.0.0-dev
二、使用SPM创建项目
创建一个可执行项目,如SPMDemo:
mkdir SPMDemo
// 创建文件夹
$ cd SPMDemo
// 进入文件夹
swift package init --type executable
// 初始化为可执行项目
Creating executable package: SPMDemo
Creating Package.swift
Creating .gitignore
Creating Sources/
Creating Sources/main.swift
Creating Tests/
swift package generate-xcodeproj
//生成Xcode工程,可用Xcode打开
generated: ./SPMDemo.xcodeproj
swift build
// swift 编译并生成可执行文件
// 执行效果
Compile Swift Module 'SPMDemo' (1 sources)
Linking ./.build/debug/SPMDemo
$ ./.build/debug/SPMDemo // 执行生成的文件
Hello, world!
三、添加外部模块
我们试着把Alamofire模块添加到SPMDemo中;
1、编辑Package.swift文件,内容如下:
import PackageDescription
let package = Package(
name: "SPMDemo",
dependencies: [
.Package(url: "https://github.com/Alamofire/Alamofire.git", Version(4,2,0))
]
)
2、main.swift中引入并使用Alamofire
import Alamofire
print(Alamofire.request("https://httpbin.org/get"))
3、编译并运行
swift build
Compile Swift Module 'SPMDemo' (1 sources)
Linking ./.build/debug/SPMDemo
$ ./.build/debug/SPMDemo
GET https://httpbin.org/get
四、更新依赖包
假设我们需要将Alamofire 4.2.0“更新”到4.1.0;
1、编辑Package.swift,将Version(4,2,0)改为Version(4,1,0);
2、更新依赖:
swift package update
Cloning https://github.com/Alamofire/Alamofire.git
HEAD is now at c2134d7 Added release notes to the CHANGELOG and bumped the version to 4.1.0.
Resolved version: 4.1.0
可以用 swift package generate-xcodeproj更新一下Xcode工程文件,然后就可以build的运行了
五、创建模块(库)
假设我们需要创建一个BarModule,步骤如下:
1、初始化模块
mkdir BarModule
cd BarModule
swift package init --type library
// 初始化为一个库
Creating library package: BarModule
Creating Package.swift
Creating .gitignore
Creating Sources/
Creating Sources/BarModule.swift
Creating Tests/
Creating Tests/LinuxMain.swift
Creating Tests/BarModuleTests/
Creating Tests/BarModuleTests/BarModuleTests.swift
$ swift package generate-xcodeproj // 创建Xcode项目
generated: ./BarModule.xcodeproj
2、编写模块代码
初始化为库时,自动生成了一个文件BarModule.swift,编辑BarModule.swift文件如下:
public struct BarModule {
public var text = "Hello, Module!"
public var num: Int
public init() {
num = 12
}
}
3、添加git tag
$ git init
$ git add .
$ git commit -m "Init Commit"
$ git tag 1.0.0 // 添加tag
这个 tag 1.0.0就是我们引用时的版本号;
如果把这个BarModule推送到外部,如github上,就是可以通过引入外部引入的方式引入到项目中;
当然,我们还能本地引入模块;
六、本地引入模块
我们将在SPMDemo项目中引入BarModule;
1、编辑SPMDemo的Package.swift文件
import PackageDescription
let package = Package(
name: "SPMDemo",
dependencies: [
.Package(url: "https://github.com/Alamofire/Alamofire.git", Version(4,1,0)),
.Package(url: "../BarModule", Version(1, 0, 0)) // 添加的代码,版本号就是刚才的tag
]
)
2、swift build将BarModule添加到SPMDemo项目中
3、编辑main.swift文件
import Alamofire
import BarModule
print(Alamofire.request("https://httpbin.org/get"))
let bar = BarModule()
print(bar.num)
print(bar.text)
4、编译运行
swift build
./.build/debug/SPMDemo
GET https://httpbin.org/get
12
Hello, Module!