“踩坑”经验分享：Swift语言落地实践

点击蓝字，关注我们

百度App 已在工程和环境上支持 Swift 开发，百度搜索大前端团队负责搜索服务的稳定落地，我们积极探索 Swift的应用，希望能大幅提升开发效率和灵活性、提升端用户的搜索体验。然而，在实施过程中可能会遇到各种问题，例如代码陈旧且不支持Swift，人员对Swift掌握不够熟练、意识不足，协作方对Swift的支持不足等。

对于其他语言来说，Swift相对年轻，我们在实践过程中整理一些常见问题及其解决方法，希望能帮助读者更顺利地使用Swift进行编程，提高研发效率。

在决定是否引入Swift前，我们需要判断场景是否适合。通常情况下，可以用OC的场景均适合使用Swift，但也有一些不太适合直接替换的场景，需要慎重，比如：

此外，对使用OC比较久远的工程，使用Swift前也应注意：

△注：本文中的“组件”均指代工程中的“Target”。

如：字符串不能通过索引取字符

• 原因：Swift认为字符串是由一个个字形群集 （grapheme clusters）组成的，字形群集的大小不固定所以不能用整数去索引 (字形群集其实就是Swift中的Character（字符）类)。

• 解决方案：如要通过下标取字符可以为String添加扩展在下标subscript实现通过传入Int索引，在subscript转为String.index获取对应字符的方式。

当你进行文件操作时，可能会遇到需要使用try、try?和try!的情况。它们在异常处理方面有所不同。

因此，在文件操作中，你可以根据需要选择合适的异常处理方式。在百度App中一般推荐使用try?。

在Swift语言中，public和open都是用于在模块中声明需要对外界暴露的函数的关键字，但它们在继承和公开程度上有所不同。

从公开程度上来说，public的限制比open更严格，所以可以说public < open，即public的公开程度比open要低。

在Swift中解析JSON的情况，如果自行将JSON转换为字典，需要涉及到类型判断、转换等操作，代码比较复杂。这时可以使用第三方库SwiftyJSON、ObjectMapper或者系统库JSONEncoder来简化操作，提高开发效率。

Swift的类和子类初始化涉及到两个关键阶段。首先，确保所有的存储属性被赋予初始值，然后，在实例准备使用之前，可以自定义存储属性的值。为了确保这两个阶段成功，实施了四步安全检查，详细如下：

总之，类初始化必须完成的一个任务就是让所有的存储属性都有初始值（optional 除外）。如果父类有指定初始化，子类必须也有指定初始化，并且必须调用父类的其中一个指定初始化（如果是必须初始化，就是重载），并遵循两段式初始化的规则。一个便利初始化必须调用同一类中的初始化方法（可以是另一个便利初始化，也可以是指定初始化），但最终一定会调用到一个指定初始化。便利初始化不遵循两段式初始化的规则，不能被子类调用或者重载。

组件应该尽可能少的公开暴露头文件，但Swift和OC混编不可避免使用OC非公开头文件，因此我们可以采取以下措施：将Framework 中将私有头文件声明为一个私有 module（modulemap内声明），由组件内的 Swift 源码 import 该私有 module 即可。

1、创建Private.modulemap文件，以NewModule做为组件名为例，可以命名为NewModule.private.modulemap，内容为下，module后面加_Private

• 罗列头文件的形式

framework module NewModule_Private {  header "xxxxx.h"}

• 使用根头文件的形式，添加头文件NewModule_Private.h
  

framework module NewModule_Private {  umbrella header "NewModule_Private.h"
  export *  module * { export * }}

2、在组件build settings中配置MODULEMAP_PRIVATE_FILE路径，MODULEMAP_PRIVATE_FILE='NewModule.private.modulemap'；百度App中在NewModule.boxspec中如下代码设置路径；

s.xcconfig = {    'MODULEMAP_PRIVATE_FILE' => '${BOX_ROOT}/NewModule.private.modulemap'}

3、将NewModule.private.modulemap添加到工程目录；百度App中在NewModule.boxspec中如下代码设置路径；

s.refer_files = [      "NewModule.private.modulemap",]

4、将xxxxx.h设置为Private header，百度App中在NewModule.boxspec中如下代码设置xxxxx.h到Private header

s.private_headers = [    "Sources/xxxxx.h"  ]

5、调用方式

import NewModule_Privatelet objectX = xxxxx()print(objectX)

如error: cannot find protocol definition for 'xxxProtocol'

• 原因：此报错在OC中是代码警告，百度App中默认情况Swift中SWIFT_TREAT_WARNINGS_AS_ERRORS 设置为 YES，导致OC中的Warning视为Error；

• 解决方案：三选一

• 在Swift中，能直接使用定义为常量的宏，不能使用带有方法调用的宏，也不能使用静态常量。

下面这种定义为常量的宏可以使用#define APP_LANGUAGE_EN @"en" #define kNavigationBarHeight 44.0
下面带有方法调用的宏不可以使用#define kScreenHeight [[UIScreen mainScreen] bounds].size.height#define kScreenWidth [[UIScreen mainScreen] bounds].size.width
下面带有静态常量swift不能使用，可以改成宏static NSString *const StopTabRefreshNotifyNameHtml = @"TabRefreshNotifyNameHtml";

• 在我分们基础框架中，有一个使用了OC泛型的类，如：

@interface BBAXYZ<T> : NSObject <BBAXYZEventProtocol>  @property (nonatomic, weak) T page;  @end

这个泛型的使用导致无法使用Swift来继承和开发BBAXYZ的子类。然而，这个基础框架是业务的核心部分，因此，我们需要在未来支持Swift的开发。

• 经过仔细观察和分析，我们发现泛型主要被用于指定page属性的类型。因此，我们可以考虑去掉泛型，改为提供一个返回适当类型的方法。这样，我们就可以在Swift中顺利地继承和使用这个基础框架。修改后的代码如下：

@interface BBAXYZ : NSObject <BBAXYZEventProtocol>  - (id<BBAXYZEventProtocol>)page;  @end

然后，我们可以创建一个OC类来实现这个基础框架，并让所有的子类继承这个OC类并实现 page 方法，以返回适当类型的对象。这样，我们就可以在Swift中顺利地继承和使用这个基础框架。

例如：

@interface BBAABC : BBAXYZ  - (UIViewController<BBAXYZEventProtocol> *)page; @end

需要注意的是，虽然这样的修改增加了轻量级的中间OC类，但它仍然实现了Swift与OC的混编，并允许我们在Swift中开发新的子类。这种方式既保证了代码的兼容性，又使得我们可以继续利用OC的优点。

• 使用方式

class BBAEFG: BBAABC {    }

问题场景：

解决方式：

• 原因：使用Swift语言开发的组件，依赖了不支持Module化的组件，导致组件都能编译成功，但整个工程却编译失败了；

• 解决方案：二选一

错误显示：@objc' instance method in extension of subclass of 'xxxxx' requires iOS 13.0.0

这是由于组件开启了Library Evolution导致，开关BUILD_LIBRARY_FOR_DISTRIBUTION 控制的。

一个库开启了Library Evolution，在依赖链下游的库中将：

这些功能是实现的局限。估计是需要在 Swift 运行时有一些对应的更改，所以只在 swift 5.1 （iOS 13）运行时里才可以运行。

除此之外，还会有一些编译时没有报错，但运行时 crash 或结果不正确的情况。

百度App中默认开启Library Evolution，一个组件关闭Library Evolution会导致二进制存在不兼容的情况，暂时无解决方案。

如果使用import <xxxx.h>，Project下其他Target就引用不到了，如百度App中Debug模块引用此Private头文件时，会报错 not found with <angled> include, use "quotes" instead。

• 原因：这是由于其他Target对主模块引用时默认是从当前项目下引用头文件，而尖括号方式从系统库或用户库中引用；

• 解决方案：其他Target将Private Header 配置到其 HEADER_SEARCH_PATHS，使用双引号和尖括号均可。

以上是我们在Swift开发过程中所遇到的一些常见问题及其相应的解决方案。然而，随着我们不断深入Swift开发这片浩渺的海洋，更多独特的问题将会逐渐浮现。我们会持续将这些新问题以及其对应的解决方案整理并发布出来，为广大的开发者们提供有价值的参考。欢迎大家留言探讨。