我想做什么

在项目开发早期构建较多的模块,每一个模块负责独立的功能.例如将一个待办事项类应用分为主工程,数据库存储两部分.

解决了什么问题

这样做能让项目更清晰,有条理.而且因为独立的出的模块是独立编译后嵌入主工程内,在独立出的模块足够多且未修改的情况下可以大幅度的减少增量编译速度.

还有比较重要的一点是,独立出的模块可以单独添加单元测试以及测试覆盖率检查工具,达到增加模块健壮性稳定性,在项目的后期也可以顺利的发布为独立的模块给更多的项目使用.(这里有一篇文章介绍了如何使用 Cocoapods 发布模块 #2 )

较常见的工程现状

现状

使用XCode默认生成的项目.使用 XCode 打开 SomeApp.xcodeproj 如图:

f0cf2857-ffc9-41b2-b2c9-da40dbcf707a

如果有使用三方的需求则通过 (Cocoapods)[] 管理三方库,然后使用 Cocoapods 自动生成的 Catnip.xcworkspace.

4890a259-9399-4653-a056-22eba455128b

模块化后工程目录

dda5a986-6f28-43a2-876e-d60b5abfb388

图片依次为 Catnip主工程 独立的模块 WhiteMilk, Cocoapods 管理的工程 Pod 以及 Cocoapods 生成的虚拟目录 WhiteMilk.(两个WhiteMilk是指向了同一个真实文件,且完全一致)

如何做到

示例环境
XCode: 10.0
Cocoapods: 1.5.3
Swift: 4.2
前置条件:
在开始之前:
1. 需要你会熟练使用 XCode 的常规操作.例如构建新工程.
2. 需要你会熟练使用 Cocoapods 的常规操作.例如为旧项目集成 Cocoapods.
3. 需要你了解一些基础的 Swift 知识.

1. 创建,链接以及嵌入 framework

a. 创建 framework 比较简单和创建一个工程的方式一致,通过 XCode 选择即可. 129eac50-e2eb-454b-90c8-76deab442e6c

b. 添加新建的 framework 在创建后选择保存的位置时勾选上已有的工程. 58d43c21-7a99-4c5b-a695-08c5521b642a

c. 如果是添加已有的 framework 则通过在需要被嵌入的工程内选择 Add File's,然后选中已存在工程. 642be90a-d0cf-4248-b60d-ea4e08e8a9cf

62b4043b-fc91-48e6-afef-03cb59613706

d. 最后一步,通过 General -> Embedded Binaries 选择新建的或者已有的 framework到链接(Linked)和嵌入(Embedded)到工程内.这样在正式编译执行时链接已有的 framework. b09cc3dc-00ff-4fe3-9517-9fd07b6498ec

注意事项

A. 首先尽量选择使用 framework 而不是 static Library .后者一般被翻译为静态库也常被叫做.a文件.使用静态库的方式组织的文件,如果多次被重复链接会导致错误.举个例子: A工程包含M1模块和M2模块,同时M1,M2还有A工程都需要使用到一个StaticLib库,静态库本身是已编译好的二进制文件,嵌入链接静态库的本质是复制粘贴,这会导致最后执行的A工程内3个地方都复制了相同的一份二进制文件,同时被链接编译,会导入重复载入的错误.

B. 最后一步一定要通过 Embedded Binaries 进行添加,如果只进行了链接未执行嵌入,那么报错的方式会非常奇怪,你将可以正常的编译工程,运行到模拟器或者真机环境,但是会在开始运行前程序崩溃,抛出dyld__abort_with_payload Thread 1: signal SIGABRT的错误

C. 三方库支持的iOS版本要高于核心工程.

2. 通过 Cocoapods 管理 framework 的依赖

顺序完成了上一步后,以及达到了模块化的目的.可以正常的编写代码,执行.当然实际的开发的情况总是会更复杂,如果需要拆分出的 framework 需要其余一些别的 framework 才能工作,建议选择 Cocoapods 的解决方案.感谢 Cocoapods 这个伟大的工具,我们只需要通过编写 Podfile 内设置,即可达到适配任意复杂的模块相互依赖情况.

a. 目前的 Demo 工程的依赖情况是主工程(Catnip)依赖了部分常见的库,且只兼容 iOS10以及以上环境. d3bb8c66-7001-4f30-ba18-75ccc6a06134