一些缺点
-
文档难找。
-
使用远端仓库对网络要求非常高。
使用方法
创建组件
创建组件可以在 Xcode 中选择 Swift Package,也可以在命令行中写入 swift package init。命令行创建会将当前目录名称用作包名。
Creating library package: Desktop
Creating Package.swift
Creating README.md
Creating .gitignore
Creating Sources/
Creating Sources/Desktop/Desktop.swift
Creating Tests/
Creating Tests/DesktopTests/
Creating Tests/DesktopTests/DesktopTests.swift
定义组件
基础的定义看起来长这个样子。别急,我们一行一行来看。
// swift-tools-version:5.5
请勿忽略本行,当打包编译出现工具链版本不匹配、 SDK 版本、系统 API 最低版本等问题时需要首先到这里排查可能存在的问题。
// swift-tools-version:5.5
import PackageDescription
let package = Package(
name: “MyLibrary”,
products: [
.library(name: “MyLibrary”, targets: [“MyLibrary”]),
],
dependencies: [ ],
targets: [
.target(name: “MyLibrary”, dependencies: []),
.testTarget(name: “MyLibraryTests”, dependencies: [“MyLibrary”]),
]
)
基础定义
Swift Package 的定义稍微有一些绕,但是稍微解释一下也就明了了。
Targets
先看 targets,定义是 A target can define a module or a test suite. 翻译来说,就是一个 target 对应一个 clang module 或者 一个测试目标。一个 target 内只允许使用一类语言,比方说 Swift 或者 Objective-C/C/CPP。此处的 name 只对当前 package 可见,可以填写在任意一个 dependencies 内。Target 支持 binary Target,可使用 XCFramwork 或 .a .so 等二进制。
Products
再看 products,定义是 Products define the executables and libraries a package produces, and make them visible to other packages. 一个 product 可以包含多个 target,他们会被编译成产物提供给项目。如果其他项目依赖当前的 Swift Package,此处的 name 可以填写入其他 Package 的依赖需求内,一般对内不可用。最后来看一下 product 的几种类型。一般来说,常见的 .library 可 type 包含 .static (默认) 和 .dynamic。除开 .library 还有 .executable 可选,用于编译测试用二进制和 macOS 命令行工具。
.library(name: “MorphingLabel”, targets: [“MorphingLabel”]),
.library(name: “MorphingLabelDynamic”, type: .dynamic, targets: [“MorphingLabel”]),
.executable(name: “appdecrypt”, targets: [“appdecrypt”])
资源文件
Swift Package 需要对每一个文件指明用途。代码文件会自动识别并编译打包,资源文件需要指定和说明。Swift Package 会为每一个 Package 生成一个 module 扩展,以便直接调用。使用命令行将项目文件 Package.swift 转换成 xcproj 则不会生成该模版定义文件。以下定义会在 Bundle 类内生成 .module 属性专门用于获取 Particles 文件夹内的资源。
.target(
name: “MorphingLabel”,
exclude: [“Info.plist”, “tvOS-Info.plist”],
resources: [ .process(“Particles”) ] // <-- 资源文件
),
目录结构
Swift Package 推荐使用原生目录结构,不推荐自定义 Path。
Swift Package 导出头文件有规定的位置,在当前 Source Path 内创建 include 会自动导出。
Swift Package 需要对每一个资源文件/文件夹显示声明,对通配符的适配存在 Bug。
当需要特定的文件目录组织的时候可以使用 符号连接 来链接目标文件。
总体来说 Swift Package 中一个 Target 对应一个 name,而 项目根目录/Sources/name 会作为当前 Target 的工作搜索路径。
.
├── Package.swift # 定义文件
├── README.md # 可忽略
├── Sources # 此文件夹内全部文件都需要定义 不然会报错
│ └── demo # target demo 的默认目录
│ ├── Particles. # 在 target 内声明为资源文件
│ │ └── fire.png # 会自动打包成 bundle 拷贝并传递
│ ├── demo.swift # target demo 的项目源代码
│ └── include # 导出头文件
│ └── export.h # 头文件
# 在 Sources / target name 厘头的资源文件可在 Package.swift 内定义。
# 需要在 target 内添加 resources: [ .process(“Particles”) ]
其他说明
XCFramework
关于编译产物,基础的 Swift Package 可以生成静态库、动态库,在这以后可以手动打包成 XCFramework。SPM 的打包工作流对 XCFramework 非常友好,可以参考下面这个脚本。
xcodebuild -create-xcframework \
-framework “$BUILD_FOLDER/iOS.xcarchive/Products/Library/Frameworks/MorphingLabel.framework” \
-framework “$BUILD_FOLDER/tvOS.xcarchive/Products/Library/Frameworks/MorphingLabel.framework” \
-framework “$BUILD_FOLDER/Simulator.xcarchive/Products/Library/Frameworks/MorphingLabel.framework” \
-framework “$BUILD_FOLDER/tvOSSimulator.xcarchive/Products/Library/Frameworks/MorphingLabel.framework” \
-output Build/LTMorphingLabel.xcframework
https://github.com/lexrus/LTMorphingLabel/blob/master/build_xcframework.sh
product -> .library(name: “MorphinglabelXCFramework”, targets: [“LTMorphingLabel”])
// 需要手动打包,此处仅提供名称给其他项目调用,依赖会使用二进制库
target -> .binaryTarget(
name: “LTMorphingLabel”,
url: “https://github.com/lexrus/LTMorphingLabel/releases/download/0.9.3/LTMorphingLabel.xcframework.zip”,
checksum: “28a0ed8b7df12c763d45b7dde2aa41fd843984b79e6fbd3750f2fc1a6c247a13”
)
目前有针对 Package.swift 生成并编译 XCFrameowrk 的懒人工具,但是由于其依赖将项目转换成 xcproj 的编译方法,携带资源文件的 Swift Package 并不能用。
https://github.com/akkyie/XPM
题外话
我在一线互联网企业工作十余年里,指导过不少同行后辈。帮助很多人得到了学习和成长。
我意识到有很多经验和知识值得分享给大家,也可以通过我们的能力和经验解答大家在IT学习中的很多困惑,所以在工作繁忙的情况下还是坚持各种整理和分享。但苦于知识传播途径有限,很多程序员朋友无法获得正确的资料得到学习提升,故此将并将重要的Android进阶资料包括自定义view、性能优化、MVC与MVP与MVVM三大框架的区别、NDK技术、阿里面试题精编汇总、常见源码分析等学习资料。
【Android思维脑图(技能树)】
知识不体系?这里还有整理出来的Android进阶学习的思维脑图,给大家参考一个方向。
希望我能够用我的力量帮助更多迷茫、困惑的朋友们,帮助大家在IT道路上学习和发展~
网上学习资料一大堆,但如果学到的知识不成体系,遇到问题时只是浅尝辄止,不再深入研究,那么很难做到真正的技术提升。
一个人可以走的很快,但一群人才能走的更远!不论你是正从事IT行业的老鸟或是对IT行业感兴趣的新人,都欢迎加入我们的的圈子(技术交流、学习资源、职场吐槽、大厂内推、面试辅导),让我们一起学习成长!
外链图片转存中…(img-FpIzJdVO-1714567815344)]
希望我能够用我的力量帮助更多迷茫、困惑的朋友们,帮助大家在IT道路上学习和发展~
网上学习资料一大堆,但如果学到的知识不成体系,遇到问题时只是浅尝辄止,不再深入研究,那么很难做到真正的技术提升。
一个人可以走的很快,但一群人才能走的更远!不论你是正从事IT行业的老鸟或是对IT行业感兴趣的新人,都欢迎加入我们的的圈子(技术交流、学习资源、职场吐槽、大厂内推、面试辅导),让我们一起学习成长!