運行環境：Xcode 11.1 Swift5.0
最近參與的一個項目需要從Objective-C（以下簡稱OC）轉到Swift，期間遇到了一些坑，於是有了這篇總結性的文檔。如果你也有將OC項目Swift化的需求，可以作爲參考。
OC轉Swift有一個大前提就是你要對Swift有一定的瞭解，熟悉Swift語法，最好是完整看過一遍官方的Language Guide。
轉換的過程分自動化和手動轉譯，鑑於自動化工具的識別率不能讓人滿意，大部分情況都是需要手動轉換的。
自動化工具
有一個比較好的自動化工具Swiftify，可以將OC文件甚至OC工程整個轉成Swift，號稱準確率能達到90%。我試用了一些免費版中的功能，但感覺效果並不理想，因爲沒有使用過付費版，所以也不好評價它就是不好。
Swiftify還有一個Xcode的插件Swiftify for Xcode，可以實現對選中代碼和單文件的轉化。這個插件還挺不錯，對純系統代碼轉化還算精確，但部分代碼還存在一些識別問題，需要手動再修改。
手動Swift化
橋接文件
如果你是在項目中首次使用Swift代碼，在添加Swift文件時，Xcode會提示你添加一個.h的橋接文件。如果不小心點了不添加還可以手動導入，就是自己手動生成一個.h文件，然後在Build Settings > Swift Compiler - General > Objective-C Bridging Header中填入該.h文件的路徑。
這個橋接文件的作用就是供Swift代碼引用OC代碼，或者OC的三方庫。
#import "Utility.h"
#import <Masonry/Masonry.h>
複製代碼在Bridging Header的下面還有一個配置項是Objective-C Generated Interface Header Name，對應的值是ProjectName-Swift.h。這是由Xcode自動生成的一個隱藏頭文件，每次Build的過程會將Swift代碼中聲明爲外接調用的部分轉成OC代碼，OC部分的文件會類似pch一樣全局引用這個頭文件。因爲是Build過程中生成的，所以只有.m文件中可以直接引用，對於在.h文件中的引用下文有介紹。
Appdelegate(程序入口)
Swift中沒有main.m文件，取而代之的是@UIApplicationMain命令，該命令等效於原有的執行main.m。所以我們可以把main.m文件進行移除。
系統API
對於UIKit框架中的大部分代碼轉換可以直接查看系統API文檔進行轉換，這裏就不過多介紹。
property(屬性)
Swift沒有property，也沒有copy，nonatomic等屬性修飾詞，只有表示屬性是否可變的let和var。
注意點一
OC中一個類分.h和.m兩個文件，分別表示用於暴露給外接的方法，變量和僅供內部使用的方法變量。遷移到Swift時，應該將.m中的property標爲private，即外接無法直接訪問，對於.h中的property不做處理，取默認的internal，即同模塊可訪問。
對於函數的遷移也是相同的。
注意點二
有一種特殊情況是在OC項目中，某些屬性在內部（.m）可變，外部（.h）只讀。這種情況可以這麼處理：
private(set) var value: String
複製代碼就是隻對value的set方法就行private標記。
注意點三
Swift中針對空類型有個專門的符號?，對應OC中的nil。OC中沒有這個符號，但是可以通過在nullable和nonnull表示該種屬性，方法參數或者返回值是否可以空。
如果OC中沒有聲明一個屬性是否可以爲空，那就去默認值nonnull。
如果我們想讓一個類的所有屬性，函數返回值都是nonnull，除了手動一個個添加之外還有一個宏命令。
NS_ASSUME_NONNULL_BEGIN
/* code */
NS_ASSUME_NONNULL_END
複製代碼enum（枚舉）
OC代碼：
typedef NS_ENUM(NSInteger, PlayerState) {
PlayerStateNone = 0,
PlayerStatePlaying,
PlayerStatePause,
PlayerStateBuffer,
PlayerStateFailed,
};
typedef NS_OPTIONS(NSUInteger, XXViewAnimationOptions) {
XXViewAnimationOptionNone = 1 << 0,
XXViewAnimationOptionSelcted1 = 1 << 1,
XXViewAnimationOptionSelcted2 = 1 << 2,
}
複製代碼Swift代碼
enum PlayerState: Int {
case none = 0
case playing
case pause
case buffer
case failed
}
struct ViewAnimationOptions: OptionSet {
let rawValue: UInt
static let None = ViewAnimationOptions(rawValue: 1<<0)
static let Selected1 = ViewAnimationOptions(rawValue: 1<<0)
static let Selected2 = ViewAnimationOptions(rawValue: 1 << 2)
//...
}
複製代碼Swift沒有NS_OPTIONS的概念，取而代之的是爲了滿足OptionSet協議的struct類型。
懶加載
OC代碼：
- (MTObject *)object {
if (!_object) {
_object = [MTObject new];
}
return _object;
}
複製代碼Swift代碼：
lazy var object: MTObject = {
let object = MTObject()
return imagobjecteView
}()
複製代碼閉包
OC代碼：
typedef void (^DownloadStateBlock)(BOOL isComplete);
複製代碼Swift代碼：
typealias DownloadStateBlock = ((_ isComplete: Bool) -> Void)
複製代碼單例
OC代碼：
+ (XXManager *)shareInstance {
static dispatch_once_t onceToken;
dispatch_once(&onceToken, ^{
instance = [[self alloc] init];
});
return instance;
}
複製代碼Swift對單例的實現比較簡單，有兩種方式：
第一種
let shared = XXManager()// 聲明在全局命名區（global namespace）
Class XXManager {
}
複製代碼你可能會疑惑，爲什麼沒有dispatch_once，如何保證多線程下創建的唯一性？其實是這樣的，Swift中全局變量是懶加載，在AppDelegate中被初始化，之後所有的調用都會使用該實例。而且全局變量的初始化是默認使用dispatch_once的，這保證了全局變量的構造器（initializer）只會被調用一次，保證了shard的原子性。
第二種
Class XXManager {
static let shared = XXManager()
private override init() {
// do something
}
}
複製代碼Swift 2 開始增加了static關鍵字，用於限定變量的作用域。如果不使用static，那麼每一個shared都會對應一個實例。而使用static之後，shared成爲全局變量，就成了跟上面第一種方式原理一致。可以注意到，由於構造器使用了 private 關鍵字，所以也保證了單例的原子性。
初始化方法和析構函數
對於初始化方法OC先調用父類的初始化方法，然後初始自己的成員變量。Swift先初始化自己的成員變量，然後在調用父類的初始化方法。
OC代碼：
// 初始化方法
@interface MainView : UIView
@property (nonatomic, strong) NSString *title;
- (instancetype)initWithFrame:(CGRect)frame title:(NSString *)title NS_DESIGNATED_INITIALIZER;
@end
@implementation MainView
- (instancetype)initWithFrame:(CGRect)frame title:(NSString *)title {
if (self = [super initWithFrame:frame]) {
self.title = title;
}
return self;
}
@end
// 析構函數
- (void)dealloc {
//dealloc
}
複製代碼上面類在調用時
Swift代碼：
class MainViewSwift: UIView {
let title: String
init(frame: CGRect, title: String) {
self.title = title
super.init(frame: frame)
}
required init?(coder: NSCoder) {
fatalError("init(coder:) has not been implemented")
}
deinit {
//deinit
}
}
複製代碼函數調用
OC代碼：
// 實例函數（共有方法）
- (void)configModelWith:(XXModel *)model {}
// 實例函數（私有方法）
- (void)calculateProgress {}
// 類函數
+ (void)configModelWith:(XXModel *)model {}
複製代碼// 實例函數（共有方法）
func configModel(with model: XXModel) {}
// 實例函數（私有方法）
private func calculateProgress() {}
// 類函數（不可以被子類重寫）
static func configModel(with model: XXModel) {}
// 類函數（可以被子類重寫）
class func configModel(with model: XXModel) {}
// 類函數（不可以被子類重寫）
class final func configModel(with model: XXModel) {}
複製代碼OC可以通過是否將方法聲明在.h文件表明該方法是否爲私有方法。Swift中沒有了.h文件，對於方法的權限控制是通過權限關鍵詞進行的，各關鍵詞權限大小爲：
private < fileprivate < internal < public < open
其中internal爲默認權限，可以在同一module下訪問。
NSNotification(通知)
OC代碼：
// add observer
[[NSNotificationCenter defaultCenter] addObserver:self selector:@selector(method) name:@"NotificationName" object:nil];
// post
[NSNotificationCenter.defaultCenter postNotificationName:@"NotificationName" object:nil];
複製代碼Swift代碼：
// add observer
NotificationCenter.default.addObserver(self, selector: #selector(method), name: NSNotification.Name(rawValue: "NotificationName"), object: nil)
// post
NotificationCenter.default.post(name: NSNotification.Name(rawValue: "NotificationName"), object: self)
複製代碼可以注意到，Swift中通知中心NotificationCenter不帶NS前綴，通知名由字符串變成了NSNotification.Name的結構體。
改成結構體的目的就是爲了便於管理字符串，原本的字符串類型變成了指定的NSNotification.Name類型。上面的Swift代碼可以修改爲：
extension NSNotification.Name {
static let NotificationName = NSNotification.Name("NotificationName")
}
// add observer
NotificationCenter.default.addObserver(self, selector: #selector(method), name: .NotificationName, object: nil)
// post
NotificationCenter.default.post(name: .NotificationName, object: self)
複製代碼protocol(協議/代理)
OC代碼：
@protocol XXManagerDelegate <NSObject>
- (void)downloadFileFailed:(NSError *)error;
@optional
- (void)downloadFileComplete;
@end
@interface XXManager: NSObject
@property (nonatomic, weak) id<XXManagerDelegate> delegate;
@end
複製代碼Swift中對protocol的使用拓寬了許多，不光是class對象，struct和enum也都可以實現協議。需要注意的是struct和enum爲指引用類型，不能使用weak修飾。只有指定當前代理只支持類對象，才能使用weak。將上面的代碼轉成對應的Swift代碼，就是：
@objc protocol XXManagerDelegate {
func downloadFailFailed(error: Error)
@objc optional func downloadFileComplete() // 可選協議的實現
}
class XXManager: NSObject {
weak var delegate: XXManagerDelegate?
}
複製代碼@objc是表明當前代碼是針對NSObject對象，也就是class對象，就可以正常使用weak了。
如果不是針對NSObject對象的delegate，僅僅是普通的class對象可以這樣設置代理：
protocol XXManagerDelegate: class {
func downloadFailFailed(error: Error)
}
class XXManager {
weak var delegate: XXManagerDelegate?
}
複製代碼值得注意的是，僅@objc標記的protocol可以使用@optional。
Swift和OC混編注意事項
函數名的變化
如果你在一個Swift類裏定義了一個delegate方法：
@objc protocol MarkButtonDelegate {
func clickBtn(title: String)
}
複製代碼如果你要在OC中實現這個協議，這時候方法名就變成了：
- (void)clickBtnWithTitle:(NSString *)title {
// code
}
複製代碼這主要是因爲Swift有指定參數標籤，OC卻沒有，所以在由Swift方法名生成OC方法名時編譯器會自動加一些修飾詞，已使函數作爲一個句子可以"通順"。
在OC的頭文件裏調用Swift類
如果要在OC的頭文件裏引用Swift類，因爲Swift沒有頭文件，而爲了讓在頭文件能夠識別該Swift類，需要通過@class的方法引入。
@class SwiftClass;
@interface XXOCClass: NSObject
@property (nonatomic, strong) SwiftClass *object;
@end
複製代碼對OC類在Swift調用下重命名
因爲Swift對不同的module都有命名空間，所以Swift類都不需要添加前綴。如果有一個帶前綴的OC公共組件，在Swift環境下調用時不得不指定前綴是一件很不優雅的事情，所以蘋果添加了一個宏命令NS_SWIFT_NAME，允許在OC類在Swift環境下的重命名：
NS_SWIFT_NAME(LoginManager)
@interface XXLoginManager: NSObject
@end
複製代碼這樣我們就將XXLoginManager在Swift環境下的類名改爲了LoginManager。
引用類型和值類型
struct和enum是值類型，類class是引用類型。String，Array和Dictionary都是結構體，因此賦值直接是拷貝，而NSString,NSArray和NSDictionary則是類，所以是使用引用的方式。struct比class更“輕量級”，struct分配在棧中，class分配在堆中。
id類型和AnyObject
OC中id類型被Swift調用時會自動轉成AnyObject，他們很相似，但卻其實概念並不一致。Swift中還有一個概念是Any，他們三者的區別是：
id是一種通用的對象類型，它可以指向屬於任何類的對象，在OC中即是可以代表所有繼承於NSObject的對象。AnyObject可以代表任何class類型的實例。Any可以代表任何類型，甚至包括func類型。
從範圍大小比較就是：id < AnyObject < Any。
其他語法區別及注意事項（待補充）
1、Swift語句中不需要加分號;。
2、關於Bool類型更加嚴格，Swift不再是OC中的非0就是真，真假只對應true和false。
3、Swift類內一般不需要寫self，但是閉包內是需要寫的。
4、Swift是強類型語言，必須要指定明確的類型。在Swift中Int和Float是不能直接做運算的，必須要將他們轉成同一類型纔可以運算。
5、Swift拋棄了傳統的++，--運算，拋棄了傳統的C語言式的for循環寫法，而改爲for-in。
6、Swift的switch操作，不需要在每個case語句結束的時候都添加break。
7、Swift對enum的使用做了很大的擴展，可以支持任意類型，而OC枚舉僅支持Int類型，如果要寫兼容代碼，要選擇Int型枚舉。
8、Swift代碼要想被OC調用，需要在屬性和方法名前面加上@objc。
9、Swift獨有的特性，如泛型，struct，非Int型的enum等被包含才函數參數中，即使添加@objc也不會被編譯器通過。
10、Swift支持重載，OC不支持。
11、帶默認值的Swift函數再被OC調用時會自動展開。
語法檢查
對於OC轉Swift之後的語法變化還有很多細節值得注意，特別是對於初次使用Swift這門語言的同學，很容易遺漏或者待着OC的思想去寫代碼。這裏推薦一個語法檢查的框架SwiftLint，可以自動化的檢查我們的代碼是否符合Swift規範。
可以通過cocoapods進行引入，配置好之後，每次Build的過程，Lint腳本都會執行一遍Swift代碼的語法檢查操作，Lint還會將代碼規範進行分級，嚴重的代碼錯誤會直接報錯，導致程序無法啓動，不太嚴重的會顯示代碼警告（⚠️）。
如果你感覺SwiftLint有點過於嚴格了，還可以通過修改.swiftlint.yml文件，自定義屬於自己的語法規範。