
作者:@請叫我汪二 授權本站轉載。
前陣子做了一個簡單又蠢萌的機器人 Uther,主要實現了以下功能:
收到消息後解析情感,並返回對應情感的顏文字
用動畫切換顏文字
展示並可編輯歷史消息
我花了一週做出 1.0 並上線,如今 1.2 版本也剛剛通過審核。這裡簡單分享一下 Uther 從誕生到上線的整個過程。
代碼已開源在 GitHub:Uther。寫得比較粗糙、沒仔細整理,各位見笑了。
AppStore 下載地址:Uther。
Project
對於一個全新的 iOS 項目,我的流程大致分為以下幾步。
Xcode
這步就不多囉嗦了,直接創建一個 Swift 項目即可。不過我通常不勾選 Xcode 自帶的 git 選項,而是留到後面手動配置。
Git
用 git init 初始化倉庫,再到 gitignore.io 找到對應配置,填進 .gitignore 文件。至此 git 初始化完成,可以先提交一次 commit 保存。注意,我習慣把 Pods 文件夾目錄也放進 .gitignore,若用自動生成的配置,把那一行的注釋取消即可。
CocoaPods
創建 Podfile 文件,用 def 按模塊定義,再給各個 target 配置:
platform :ios, '8.0' use_frameworks! def import_networking pod 'Alamofire' pod 'Moya' end target '__placeholder__' do import_networking end
Font
字體方面,我以前一直用 Consolas,後來在微博上看到湯哥推薦,從此就成了 Monoid 的忠實擁躉。
Develop
Folder
開發過程中,我的文件夾目錄大致如下:
General |- Macro |- Models |- Tools |- LOG.swift |- GCD.swift |- Models Sections |- Main |- Preview |- Setting |- User Resources
Tool
接下來聊聊項目裡的通用工具類。
GCD
項目裡引入了 GCD 這個庫,封裝了一些常見操作。然後我用一個簡單的 struct 把最常用的兩個方法包了一層:
struct GCD { static func async_in_worker(closure: GCDClosure) { gcd.async(.Default, closure: closure) } static func async_in_main(closure: GCDClosure) { gcd.async(.Main, closure: closure) } }LOG
項目裡用 XCGLogger 作為 Log 工具,配置起來很方便,聲明一個全局常量就行:
let log: XCGLogger = { let log = XCGLogger.defaultInstance() let logPath : NSURL = cacheDirectory.URLByAppendingPathComponent("XCGLogger.Log") log.setup(logLevel: .Debug, showThreadName: true, showLogLevel: true, showFileNames: true, showLineNumbers: false, writeToFile: logPath, fileLogLevel: .Info) log.xcodeColorsEnabled = true log.xcodeColors = [ .Verbose: .lightGrey, .Debug: .darkGrey, .Info: .darkGreen, .Warning: .orange, .Error: .red, .Severe: .whiteOnRed ] return log }()DB
數據庫方面,我用的是 SQLite.swift,可以借助泛型方便地拼接各種 SQL 語句:
typealias Pid = Int64 struct DB { private static let db = SQLite.Database(documentsDirectory.URLByAppendingPathComponent("uther.db").absoluteString!) struct MessageDB { static let table = db["message"] // 唯一索引,主鍵 static let pid = Expression("pid") // 消息創建的時間 static let createdTime = Expression("created_time") // 消息的內容 static let content = Expression("content") } static func setupDatabase() { db.create(table: MessageDB.table, ifNotExists: true) { t in t.column(MessageDB.pid, primaryKey: true) t.column(MessageDB.createdTime) t.column(MessageDB.content) } } }Flurry
用 Flurry 做一些簡單的統計,我通過 extension 添加了一些代碼。
比如一個全局配置的靜態方法:
extension Flurry { static func start() { Flurry.setUserID(Keychain.userId); Flurry.startSession("YOUR_SESSION_ID"); } }比如用 enum 打一些 error log:
// ERROR extension Flurry { enum Error: String { case Setup = "SetupError" case Wenzhi = "WenzhiError" func logError(message: String) { let error = NSError(domain: "com.callmewhy.uther", code: 1001, userInfo: ["Message": message]) Flurry.logError(self.rawValue, message: message, error: error) log.error(message) } } }比如內嵌一個 struct 來統計 Message 相關的行為數據:
// MESSAGE extension Flurry { struct Message { private static let send = "Send Message" private static let receive = "Receive Positive" static func sendMessage(l: Int) { Flurry.logEvent(send, withParameters: ["MessageLength": l]) } static func receivePositive(p: Double) { Flurry.logEvent(receive, withParameters: ["MessagePositive": p]) } } }Localization
我們可以通過 extension 給 String 加上一個 localized 屬性,返回本地化後的字符串:
extension String { var localized: String { let s = NSLocalizedString(self, tableName: nil, bundle: NSBundle.mainBundle(), value: "", comment: "") return s } }使用時直接調用 "LOCALIZATION_KEY".localized 即可。
Network
網絡方面用 Moya 作為業務與 Alamofire 之間的中間層。以前我自己寫了個 WhyEngine 封裝 Task 和 Request,有了 Moya 之後就省事多了:
// MARK: - MoyaProvider let endpointResolver = { (endpoint: Endpoint) -> (NSURLRequest) in let request: NSMutableURLRequest = endpoint.urlRequest.mutableCopy() as! NSMutableURLRequest request.timeoutInterval = 2.0 return request } let SentimentProvider = MoyaProvider(endpointResolver: endpointResolver) // TODO: extension MoyaTarget to handle respose extension MoyaProvider { typealias positiveHandler = PositiveValue? -> Void func requestPositive(endpoint: T, completion: positiveHandler) -> Cancellable { ... } } // MARK: - MoyaTarget extension Sentiment: MoyaTarget { public var baseURL: NSURL { return NSURL(string: "https://wenzhi.api.qcloud.com")! } public var path: String { return "api/sentiment/" } }等升上 Swift 2.0、協議可以擴展之後,就能直接用 MoyaTarget 處理 Response 了。想把返回結果封裝成 JSON 也很簡單:
extension MoyaProvider { func requestJSON(endpoint: T, completion: (JSON?) -> Void) -> Cancellable { return self.request(endpoint) { (data, status, response, error) in if let d = data { let json = JSON(data: d) log.debug("\(json)") completion(json) }else { log.error("\(error)") completion(nil) } } } }小結
此前我做過幾個 Swift 項目,但都是練手的 Demo 級別。Uther 算是我第一個純粹的 Swift 項目,沒有摻任何 Objective-C 代碼。這種感覺真是清爽利落。
Swift 的最佳實踐仍在探索之中,Uther 還有許多可以改進的地方。接下來的項目,我打算融入一些函數式編程的元素,進一步體驗各種有趣的編程範式。
歡迎討論,多多指教~