“踩坑”經驗分享：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開發這片浩渺的海洋，更多獨特的問題將會逐漸浮現。我們會持續將這些新問題以及其對應的解決方案整理併發布出來，為廣大的開發者們提供有價值的參考。歡迎大家留言探討。