将本地已有代码制作成 Swift Package
1. 创建一个 Swift Package
如果你的项目代码还未放入 Swift Package 中,可以先通过以下命令创建一个 Swift Package:
swift package init --type library
这个命令会在当前目录下创建一个 Swift Package 项目,包含以下文件和目录:
• Package.swift: Swift Package 的配置文件。
• Sources: 包含 Swift 代码的目录。
• Tests: 单元测试目录。
你可以选择 --type,可以是 library 或 executable。这里我们选择 library。
**2. 迁移已有代码**
将你现有的代码(例如 .swift 文件)移动到 Swift Package 的 Sources 目录中。如果你有多个模块,可以创建多个子目录来组织代码。
**3. 编辑 Package.swift**
Package.swift 文件是 Swift Package 的配置文件,你需要在这里定义包的名称、依赖项、支持的最低版本以及平台等信息。一个基本的 Package.swift 文件如下:
// swift-tools-version: 5.8
import PackageDescription
let package = Package(
name: "YourPackageName",
platforms: [
.iOS(.v13), // 指定支持的平台及最低版本
],
products: [
.library(
name: "YourPackageName",
targets: ["YourPackageName"]),
],
dependencies: [
// 这里添加你的依赖项
],
targets: [
.target(
name: "YourPackageName",
dependencies: []), // 如果有依赖项可以在此指定
.testTarget(
name: "YourPackageNameTests",
dependencies: ["YourPackageName"]),
]
)
你需要根据你的项目调整这个配置文件。例如:
• name: 你的包的名称。
• platforms: 支持的平台及其最低版本。
• dependencies: 其他依赖的包。
**4. 编译和测试 Swift Package**
在命令行中执行以下命令,验证 Swift Package 是否能够正确编译:
swift build
如果你有编写单元测试,可以通过以下命令运行测试:
swift test
**5. 将 Swift Package 添加到项目中**
要在 Xcode 项目中使用 Swift Package,可以通过两种方式:
1. **将本地 Swift Package 添加到 Xcode 项目**:
• 打开 Xcode 项目。
• 选择项目文件,进入 **Swift Packages** 选项卡。
• 点击 **+** 按钮,选择 **Add Local…**,然后选择你本地的 Swift Package。
2. **通过 GitHub 或其他 Git 仓库托管**:
• 将 Swift Package 上传到 Git 仓库(如 GitHub、GitLab 等)。
• 在 Xcode 项目中,选择项目文件,进入 **Swift Packages** 选项卡。
• 点击 **+** 按钮,选择 **Add Package Dependency**,输入 Swift Package 的 Git 仓库 URL。
**6. 发布 Swift Package**
如果你想将 Swift Package 发布到公开的包管理仓库(例如 GitHub),需要在你的代码仓库中创建版本标签(Tag):
git tag 1.0.0
git push origin --tags
这样,其他人可以通过该标签版本来引用你的 Swift Package。
至此,你已经成功将现有的代码制作成一个 Swift Package,并且可以在其他项目中进行使用或发布到公开仓库。
这个 Markdown 文档包含了从创建 Swift Package 到发布的完整步骤,适用于将现有的 iOS 代码打包成 Swift Package。