iOS

Swift热更新（1）- 免费版接入

SOT学习和使用的成本主要集中在前期，主要涉及编译流程的修改。之前介绍了纯OC项目如何接入「 OC接入例子」。本文介绍如何给纯Swift项目接入SOT，包括免费版和网站版。

本文以开源的「 SwiftMessages 」Demo为例，该工程全部用Swift语言开发。这里把修改好的版本上传到了git上，分支为「 sotdemo 」，Debug模式下接入了免费版，Release模式接入了网站版，读者也可以直接用该分支测试。

现在开始从头讲解，clone原本的工程后，命令行cd进入根目录，使用版本切换命令：git checkout 1e49de7b3780b699（因本文档制作于21年10月21号，以当日版本为准）。首先进入Demo目录，打开Demo.xcodeproj工程，scheme默认就已经选中了Demo：

我使用的是Xcode12.4，可以直接编译成功，启动APP能看到画面（模拟器）：

点击最上面的MESSAGE VIEW控件，会弹出一个错误提示窗口，今天我们就来用SOT热更的方式修改错误提示的文案：

参考「免费版」的step1到step3，step3拷贝的sotconfig.sh放到项目的Demo的目录下：

用文本编辑器打开sotconfig.sh，修改EnableSot=1:

添加热更需要的编译选项，添加SOT虚拟机静态库等，步骤如下：

选中Demo工程，然后选择Demo这个Target，再选择Build Settings:
在Other Linker Flags添加-sotmodule $(PRODUCT_NAME) /Users/sotsdk-1.0/libs/libsot_free.a -sotsaved $(SRCROOT)/sotsaved/$(CONFIGURATION)/$(CURRENT_ARCH) -sotconfig $(SRCROOT)/sotconfig.sh，每个选项的意义如下：
- -sotmodule是module的名字，可以直接用$(PRODUCT_NAME)，也可以自定义名字;
- -sotsaved是编译中间产物保存的目录，补丁自动化生成需要对比前后编译的产物来生成补丁;
- -sotconfig指定了项目sotconfig.sh的路径，该脚本控制sot编译器的工作，用$(SRCROOT)引用到
- /Users/sotsdk-1.0/libs/libsot_free.a是SOT虚拟机静态库的路径，链接的是免费版的虚拟机
在Other C Flags以及Other Swift Flags添加-sotmodule $(PRODUCT_NAME) -sotconfig $(SRCROOT)/sotconfig.sh，意义跟上一步是一样的，需要保持一致。经过上面两步，相关的编译配置结果如下图：
因为SOT SDK库文件编译时不带Bitcode，所以也需要把Target的Enable Bitcode设为No。

SDK里提供了一个便利脚本，路径在sdk目录的project-script/sot_package.sh，它会把生成的补丁拷贝到Bundle文件夹下，在每次项目编译成功时调用该脚本，添加步骤如下：

脚本内容为：sh /Users/sotsdk-1.0/project-script/sot_package.sh "$SOURCE_ROOT/sotconfig.sh" "$SOURCE_ROOT/sotsaved/$CONFIGURATION" Demo

把Based on dependency analysis的勾去掉

SOT需要压缩库和c++标准库的支持，还是在这个页面下，打开Link Binary With Libraries页

点击加号，分别加入这两，libz.tbd和libc++.tbd

需要用Swift代码调用OC代码，已经提供了一个样例代码在SDK的swift-call-objc目录中，可以直接添加到Demo工程中。点击Xcode软件的File按钮，接着点击Add Files to "Demo"，如下图所示：

选择到SDK目录swift-call-objc中，同时选中callsot.h和callsot.m两个文件，勾选下面的Copy items if needed，勾选Add to targets：中的Demo target，如下图所示：

点击Add按钮，添加后会弹出询问：是否创建桥接文件。点击按钮Create Bridging Header：

然后可以看到项目中多了3个文件，分别是callsot.h，callsot.m和Demo-Bridging-Header.h：

打开Demo-Bridging-Header.h，加入一行代码#import "callsot.h"：

打开AppDelegate.swift，加入两行代码let sot = CallSot()和sot.initSot()

测试热更

按上面配置完之后，确保sotconfig.sh的配置是，EnableSot=1以及GenerateSotShip=0，先Clean Build Folder一下，然后再Build：

然后看编译日志的输出，Link日志可以看到run sot link等输出，会告诉你每个文件里哪些函数可以被热更等信息：

项目编译成功了，该APP可以正常启动。同时它具备了热更能力，可以加载补丁改变程序的代码逻辑，下面介绍如何生成补丁来测试它。

上一步进行了热更注入的编译，当时的代码保存到了Demo/sotsaved这个文件夹下，用来和新代码比较生成补丁。生成补丁步骤如下：

首先启动SOT生成补丁模式，修改sotconfig.sh为EnableSot=1，GenerateSotShip=1
接下来直接在Xcode里修改源代码，把ViewController.swift文件的”Something is horribly wrong!“改成了”SOT is great“：
生成补丁跟OC项目不一样，每次都需要先Clean项目，再Build项目。然后查看编译日志输出，可以看到生成了补丁并且被脚本拷贝到了Bundle目录下，然后再展开Link Demo（x86_64)的编译日志：可以看到此时的Link是用来生成补丁的，日志里也显示了函数demoBasics被修改了：
生成出来的补丁原始文件保存到了Demo/sotsaved/Debug/x86_64/ship/ship.sot，还记得之前加了一个script到Build Phase中吗？它会每次编译结束时，会把这个补丁拷贝到了Bundle目录中，并且添加CPU架构到文件名中。可以在Bundle中看到这个补丁，至此完毕。