关于 Swift Package Manager 的一些经验分享

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

一些实践

---

目前笔者有一个开源的私人项目使用了 SPM，可以拉下仓库来看一看。Xcode 在解析各种依赖方面并不稳定，所以项目采用的方案是将所有代码拉到本地并通过修改 dependencies 的方式采用本地解析集成。本地集成的方式非常稳定，而且最大程度的保证了你修改源码的能力。Swift 发展非常快，目前不推荐 url 直接集成远端仓库。

https://github.com/SailyTeam/Saily

在本地创建 xcworkspace 以后便可以直接将 Package.swift 中的 product 添加到项目的编译流程内。这里再次赞赏 Swift Package 的多元兼容，其中有一些库是纯 Objective-C 撰写的，可以一键无缝集成。

本地集成的其他好处自然也包含 0 编译警告，遇到任何问题你都可以直接打断点到 Swift Package 的代码上。而 Cocoapod 经常不灵。关于编译警告，养眼准备！

其中可以重点关注几个混合编译的库的定义和 Fluent Icon 库的定义文件。其中就如上面描述的一样，include 文件会被自动导出给 Swift 使用。

常见问题

---

Q: 我导入了 Swift Package 到项目，但无法 import

A: 请 command + shift + K 清理项目重新编译。Swift Package 有 module 缓存。

Q: 我的 include 指向上级目录的头文件，导出失败了

A: 请清理项目重新编译，有时需要重启 Xcode。

Q: 我在编译的时候指定了最低要求 iOS 13，为何 Swift Package 无法调用 API？

自我介绍一下，小编13年上海交大毕业，曾经在小公司待过，也去过华为、OPPO等大厂，18年进入阿里一直到现在。

深知大多数初中级Android工程师，想要提升技能，往往是自己摸索成长或者是报班学习，但对于培训机构动则近万的学费，着实压力不小。自己不成体系的自学效果低效又漫长，而且极易碰到天花板技术停滞不前！

因此收集整理了一份《2024年Android移动开发全套学习资料》，初衷也很简单，就是希望能够帮助到想自学提升又不知道该从何学起的朋友，同时减轻大家的负担。

既有适合小白学习的零基础资料，也有适合3年以上经验的小伙伴深入学习提升的进阶课程，基本涵盖了95%以上Android开发知识点，真正体系化！

由于文件比较大，这里只是将部分目录截图出来，每个节点里面都包含大厂面经、学习笔记、源码讲义、实战项目、讲解视频，并且会持续更新！

如果你觉得这些内容对你有帮助，可以扫码获取！！（备注：Android）

如何做好面试突击，规划学习方向？

面试题集可以帮助你查漏补缺，有方向有针对性的学习，为之后进大厂做准备。但是如果你仅仅是看一遍，而不去学习和深究。那么这份面试题对你的帮助会很有限。最终还是要靠资深技术水平说话。

网上学习 Android的资料一大堆，但如果学到的知识不成体系，遇到问题时只是浅尝辄止，不再深入研究，那么很难做到真正的技术提升。建议先制定学习计划，根据学习计划把知识点关联起来，形成一个系统化的知识体系。

学习方向很容易规划，但是如果只通过碎片化的学习，对自己的提升是很慢的。

我们搜集整理过这几年字节跳动，以及腾讯，阿里，华为，小米等公司的面试题，把面试的要求和技术点梳理成一份大而全的“ Android架构师”面试 Xmind（实际上比预期多花了不少精力），包含知识脉络 + 分支细节。

我们在搭建这些技术框架的时候，还整理了系统的高级进阶教程，会比自己碎片化学习效果强太多

《Android学习笔记总结+移动架构视频+大厂面试真题+项目实战源码》，点击传送门即可获取！

划，根据学习计划把知识点关联起来，形成一个系统化的知识体系。

学习方向很容易规划，但是如果只通过碎片化的学习，对自己的提升是很慢的。

我们搜集整理过这几年字节跳动，以及腾讯，阿里，华为，小米等公司的面试题，把面试的要求和技术点梳理成一份大而全的“ Android架构师”面试 Xmind（实际上比预期多花了不少精力），包含知识脉络 + 分支细节。

[外链图片转存中…(img-2ypICXj4-1712377280828)]

我们在搭建这些技术框架的时候，还整理了系统的高级进阶教程，会比自己碎片化学习效果强太多

《Android学习笔记总结+移动架构视频+大厂面试真题+项目实战源码》，点击传送门即可获取！