Swift Package Manager 使用

swift

Copied!

import PackageDescription

let package = Package(

    name: "HLPackages", // package 的名, 但是与生成的最终 product 无关, 就像 iOS 工程与生成的软件名关系一样, 此名决定了 swift package
    // generate-xcodeproj 生成的工程名

    platforms: [ // 本 Package 适用的平台
        .iOS(.v10),
        .macOS(.v10_12),
        .tvOS(.v10),
        .watchOS(.v3)
    ],

    products: [ // 最后生成的 product, name 是 product 的名称, targets 是产生此 product 的源
        // SPM 的结果默认是静态库
        .library(name: "HLPackage", type: .static, targets: ["HLPackage"]), // 推荐, 原因见下方使用步骤 -> 注意点
        .library(name: "product2", type: .static, targets: ["target2", "target3"]) // 原因见下方 使用步骤 → 注意点
        .executable(name: "EXEC", targets: ["EXEC"]) // 产生的是可执行文件
    ],

    dependencies: [ // 外部依赖 (外部依赖的全部作用是被 targets 中的 target 使用)
        .package(url: "https://github.com/Alamofire/Alamofire.git", .upToNextMajor(from: "5.0.0")), // 外部的 Alamofire 库
        .package(url: "../LCLib", from: "1.0.0") // 本地库, 只在本地, 使用的是相对路径

        // 外部依赖的其他配置方法
        // .package(url:"https://github.com/test/test.git", from: "1.0.0")                               (1.0.0 ..< 2.0.0)
        // .package(url:"https://github.com/test/test.git", .exactItem(Version(stringLiteral: "1.2.0"))  (==1.2.0)
        // .package(url:"https://github.com/test/test.git", .revisionItem("74663ec"))                    某次提交的 revision 的值
        // .package(url:"https://github.com/test/test.git", .branchItem("develop"))                      分支名
        // .package(url:"https://github.com/test/test.git", .localPackageItem)                           本地依赖
        // .package(url:"https://github.com/test/test.git", Version(stringLiteral: "1.2.3")..<Version(stringLiteral: "1.2.8"))   (>=1.2.3 && <1.2.8)
        // .product(name: "Bluetooth", condition: .when(platforms: [.macOS])),                          // 指定生效平台Mac
        // .product(name: "BluetoothLinux", condition: .when(platforms: [.linux])),                     // 指定生效平台Linux
        // .target(name: "DebugHelpers", condition: .when(configuration: .debug)),                      // 指定在Debug下生效
    ],

    targets: [
        .target( // 最简单的 target, 无外部依赖, 其源文件都位于 "Sources" 文件夹下的 "target1" 文件夹
            name: "target1",
            dependencies: [],
            resources: [.copy("Resources"), .process("logo.png")] // 定义资源文件夹或文件, copy 表示不需要优化直接拷贝, process 会针对不同平台不同类型进行优化

        ),
        .target( // 开发中最频繁的用法, 外部依赖为 Alamofire
            name: "target2",
            dependencies: ["Alamofire"] // Alamofire 是上方 dependencies 部分第一个 package 的一个 product
        ),
        .executableTarget( // 开发中最频繁的用法, 外部依赖为 Alamofire
            name: "target3",
            dependencies: ["Alamofire"], // Alamofire 是上方 dependencies 部分第一个 package 的一个 product
            path: "Sources"
        ),
        .target(
            name: "EXEC", // target 的名称
            path: "Custom", // target 的路径, 如果自定义文件夹需要设置此参数, 如果不设置此项的话默认路径是 "Sources" 文件夹下的 "target2" 文件夹
            exclude: ["SwiftUI"] // 希望在 path 中排除的 "SwiftUI" 文件夹
        ),
//      .testTarget( // 用于测试的 target, iOS 开发一般不使用, 使用场景在服务器端开发
//      name: "OC2SwiftTests",
//      dependencies: ["OC2Swift"]
//      ),
    ]
)

swift

Copied!

resources: [.copy("Resources"), .process("logo.png")] // 定义资源文件夹或文件

swift

Copied!

import Foundation
extension Bundle {
    static let module = Bundle(path: "\(Bundle.main.bundlePath)/path/to/this/targets/resource/bundle")
}

swift

Copied!

import Foundation

let picturePath = Bundle.module.path(forResource: "image", ofType: "png")
print(picturePath) // Optional("/Users/wendyliga/resource-spm/.build/x86_64-apple-macosx/debug/resource-spm_resource-spm.bundle/image.png")