58同城Swift版小游戏研发之路

同城虽然是由几十个有着丰富研发经验人员组成的团队， 但平时业务研发基本都使用OC语言。虽然一直对Swift语言有所关注，但确实没有在一个复杂的业务场景中使用，那么如何克服这个困难呢？主要通过一下3个方面：

Swift ABI稳定后， 随着苹果越来越多的技术、SimpleCode都向Swift倾斜， 团队内部部分研发已经从Swift函数执行原理、Swift代码在Mach-O中的存储结构进行语言深入的理解，并定期组织Swift语言相关分享。同时，为了让更多技术参与其中，首批由5人组成Swift语言兴趣小组，迅速从Swift官方文档、WWDC视频、Swift研发群/社区快速积累语言的使用经验， 并通过重写同城首页，积累实战经验。掌握Swift相比OC语言不同的特点以及性能相关的数据，发现Swift在代码数量、函数执行速度上优势明显。

因为业内并没有发现其他原生App+SpriteKit游戏框架的业务模式，为了快速验证梦想小镇的游戏在同城的可行性， 我们迅速从SpriteKit官方文档掌握游戏开发的基础知识，在Github下载相关的开源游戏的进行学习，快速掌握了SKScene、SKNode、SKSpriteNode等场景以及精灵之间的关系， 以及了解了通过SKAction实现复杂游戏动效。并且针对最核心的游戏场景，快速实现了车、房场景的布局，以及车、房合并处理（涉及精灵间的碰撞检测）。

完成了Swift语言学习以及SpriteKit游戏框架相关知识点的积累， 我们内部通过多人合作的方式，将梦想小镇游戏进行任务分解， 将游戏的各个模块已天为维度进行划分，并每日收集完成进度， 确保游戏整体进度的顺利推进。

因为同城在梦想小镇业务之前， 99%的代码都是纯OC组成的，因此，想使用Swift+SpriteKit的语言以及游戏框架，首先要解决Swift与OC不同语言间混编的问题。这样，游戏场景中的网络请求、数据存储等基础能力， 就可以使用OC中的基础库，大大降低研发成本，下面介绍一下小游戏中混编的解决方案。

当在某个Pod下第一次创建Swift文件，会提示生成桥接文件(bridge), 规则是Pod名-Bridge-Header.h，在这个文件中如果引入OC头文件，在Swift的代码环境中就可以调用到OC的类或者创建OC的对象。

那么，相同Pod下，如何在OC中调用到Swift类呢？通常情况下， 当前Pod添加Swift文件后，会自动生成一个Pod名-Swift.h的头文件， 如果OC要调用Swift的类的方法， 就要在头文件中引用Pod名-Swift.h文件。当然，Swift接口想要暴露在OC环境下，需要用@objc声明，同时接口要声明成public, 这样就可以顺利在OC中调用Swift的类和方法了。

梦想小镇中，游戏区域由<strong>游戏场景</strong>呈现。游戏场景中，主要合并区域为中心<strong>十二宫格</strong>区域，十二宫格上有十二个<strong>地基</strong>，地基承载着<strong>房子</strong>节点。

小游戏中，游戏场景为GameScene的实例。GameScene是<strong>SKScene</strong>的子类。一个SKScene对象表示SpriteKit中的内容场景，SpriteKit中，所有内容都是通过SKScene对象进行展示的。我们通过<strong>SKView</strong>对象来呈现游戏场景：
override func viewDidLoad() { super.viewDidLoad() // SKView为UIView的子类，可以呈现一个游戏场景 let skView: SKView = SKView(frame: view.bounds) view.addSubview(skView) // 场景大小可以设置为任意大小，与UIKit结合使用 let GameScene = GameScene(size: view.bounds.size) // 通过presentScene(_:)方法呈现游戏场景 skView.presentScene(GameScene) }

小游戏中心合并区域十二宫格为GridNode的实例，GridNode是<strong>SKNode</strong>的子类。SKNode是所有SpriteKit节点的基类，其本身并不展示任何内容，而是为其子类提供基本属性，并可用作其他节点的容器或布局工具。在梦想小镇中，GridNode便承载了12个地基节点，并通过position(for:)方法为地基布局：func position(for location: Int) -> CGPoint { // 将传入的location转换为基于 0 的 locationIndex let locationIndex = location - 1  // column and row are 0 based; // For example, locationIndex = 11, (column = 2, row = 3) let column = CGFloat(locationIndex % 3) let row = CGFloat(locationIndex / 3)  let positionX: CGFloat = groundNodeWidth / 2 + (groundNodeWidth + nodeMargin) * column let positionY: CGFloat = -groundNodeHeight / 2 - groundNodeHeight * row return CGPoint(x: positionX, y: positionY)}

groundNode.position = position(for: location)

// 场景被视图展示时调用override func didMove(to view: SKView) { super.didMove(to: view) // 创建十二宫格节点 let foundation = GridNode() // 设置十二宫格节点位置坐标 foundation.position = CGPoint(x: sideMargin, y: kScreenHeight / 2 + 2 * groundNodeHeight) // 添加节点 self.addChild(self.foundation)}

网格节点上有12个地基节点，均为GroundNode的实例。GroundNode为SKSpriteNode的子类，SKSpriteNode是一个屏幕上的图形元素，可以用图像或纯色初始化。

init(level: Int?) { // 使用"base"图片作为地基纹理 super.init(texture: SKTexture(imageNamed: "base"), color: .clear, size: CGSize(width: groundNodeWidth, height: groundNodeHeight)) // 更新等级信息更新地基节点 update(level: level)}
在GridNode中，根据十二宫格信息gridInfo来配置地基。gridInfo类型为[Int: Int?]，key为地基节点位置，value为节点等级。
func updateGroundNode(gridInfo: [Int: Int?]) { for (location, level) in gridInfo { if let groundNode = self.houseGroundNodes[location] { // 如果该位置已存在地基节点，则进行更新 groundNode.update(level: level) } else { // 如果该location不存在地基节点，则创建新的地基节点并将其添加到十二宫格中，并设置其position let groundNode = GroundNode(level: level) groundNode.position = position(for: location) addChild(groundNode) houseGroundNodes[location] = groundNode } }}

地基节点上可以承载不同等级的房子节点，房子节点类型为HouseNode，HouseNode也是SKSpriteNode的子类。我们通过配置gridInfo，如果对应location地基上存在房子节点，则该location对应的value为房子等级，否则，为nil。在GroundNode的update(level:)方法中，根据等级信息来配置房子节点：
// 更新元素节点func update(level: Int?) { guard let level = level else { // 如果根据十二宫格该地基上没有房子，则清除该地基上的房子节点 clearElement() return } if houseNode == nil { addElement(level: level) } else if self.currentLevel != level { // 如果房子等级发生变化，则更新房子节点等级信息 houseNode?.updateLevelInfo(level: level) } self.currentLevel = level}

private func addElement(level: Int) { let node = ElementNode(size: self.size, level: level) houseNode = node node.position = CGPoint(x: 0, y: -groundNodeHeight / 2) addChild(node)}
private func clearElement() { self.houseNode?.removeFromParent(); self.houseNode = nil;}

init(size: CGSize, level: Int) { let texture: SKTexture = SKTexture(imageNamed: "lv.(level)") super.init(texture: texture, color: .clear, size: size) self.anchorPoint = CGPoint(x: 0.5, y: 0)}
func updateLevelInfo(level: Int) { texture = SKTexture(imageNamed: "lv.(level)")}接下来，我们便可以在十二宫格网格信息方式变化时，调用GridNode的updateGroundNode(gridInfo:)方法，来配置/更新游戏合并区域。

Swift作为最现代的语言，完美的支持了函数式编程的思想，即一切皆函数，函数作为一等公民，可以是被当作变量，参数，返回值。因此系统提供了很多高阶函数，所以filter，map，reduce，flatmap是必备的高阶函数，那么小游戏中如何结合具体的业务场景应用函数式编程思想的呢？

Swift中的reduce函数的作用就是接受一个初始化值，并且接受一个闭包作为规则，自动遍历集合的每一个元素，使用闭包的规则去处理这些元素，合并处理结果

private var _text : String = "" { didSet { let start = _text.startIndex for i in 0..<_text.count { let index = _text.index(start, offsetBy: i) update(charactor: _text[index], at: i) } if _text.count < nodes.count { while nodes.count > _text.count { nodes.removeLast().removeFromParent() } } let width = nodes.reduce(0, {$0 + $1.size.width}) let height = nodes.reduce(0, {max($0, $1.size.height)}) self.size = CGSize(width:width, height: height) if let first = nodes.first { let firstX = -(width / 2 - first.size.width / 2) first.position = CGPoint(x: firstX , y: 0) _ = nodes.reduce(nil) { (prev, cur) -> SKSpriteNode? in guard let pre = prev else { return cur } let x = pre.position.x + pre.size.width / 2 + cur.size.width / 2 let y = pre.position.y cur.position = CGPoint(x: x, y: y) return cur } } }   }  

Swift中的filter函数的作用就是接受一个闭包作为筛选规则，自动遍历集合的每一个元素，保留符合闭包规则的元素，生成一个新的集合

//弹窗展示埋点let logKeys = ["elementtype", "userlevel", "houselevel"]let adLogs = logParams.filter({ logKeys.contains($0.key) })log(pageType: "mergehousegame", actionType: "nocoinsremindshow", logParams: adLogs)

Swift中的map函数的作用就是接受一个闭包作为规则，自动遍历集合的每一个元素，使用闭包的规则去处理这些元素，生成一个结构相同的集合

func createFormBody(_ params: [String: Any]) -> Data?{ if params.isEmpty { return nil } return params.map { (key, value) -> String in return "(key)=(value)" }.joined(separator: "&").data(using: .utf8)}

Swift中的compactMap函数的作用就是接受一个闭包作为规则，自动遍历集合的每一个元素，使用闭包的规则去处理这些元素，将处理结果直接放入到一个新的集合里面，可以出现数组降维，并且会自动过滤nil(自动解包)，如果是不包含nil元素的一维数组的和map的作用效果是一样的，所以推荐使用flatMap

 let textures = atlas.textureNames.sorted { (first, second) -> Bool in let firstInt = Int(first.replacingOccurrences(of: "merge", with: "")) ?? 0 let secondInt = Int(second.replacingOccurrences(of: "merge", with: "")) ?? 0 return firstInt < secondInt }.compactMap({atlas.textureNamed($0)})

泛型式编程是现代编程语言中比较常见的一种能力很多主流编程语言如JAVA，也已经有了泛型的思想。Swift中的泛型可以结合协议（Protocol），类（class），方法（method），拓展（extension）起到抽象类类功能或限制拓展的实现范围等功能。可谓是非常强大。Swift Foundation库中的Array， Dictionary，等基础数据结构都广泛的使用了泛型来达到支持多种数据结构的目的。

通常函数的多态性可以使用继承关系来实现。但是如果对于同一个接口，需要传入的入参不确定，且不具有继承关系这种情况。一种方法是，对于所有该方法需要支持的数据类型进行分别实现。但这种方法会产生大量的冗余代码。大大降低了代码的可读性和维护性。另一种方法是使用泛型实现，同时，对泛化的类型做约束，保证实现的正确性。

func show<T: Config, V: CenterConfig & AnimatedView>(with data: T, content: V.Type) { let window = Popup(frame: view.bounds) window.tag = Popup.offlineTag popupView = window let promotion = content.init(frame: .zero) view.addSubview(window) window.centerContent = promotion window.config(with: data...) window.showContent(animated: true)}

该方法是为了给Popup容器输送展示的内容物，并展示出来。由于Popup的内容物和其数据模型的不确定性。如果为每个内容View实现一个show方法，一方面重复代码过多。另一方面，接口过于分散，后期更改时难以维护。所以这里使用了泛型，对数据模型进行一定程度的约束。只要传入遵循`Config `的模型`T`、同时遵循`CenterConfig `和`AnimatedView `的内容View，就可以展示。目前使用泛型的概念，达到了如下图通过一个方法，生成多个弹窗的效果

使用这种方式，方便修改，易于维护。当弹窗管理由对单个弹窗实例的管理转变为对多个弹窗实例的弹窗队列管理时。添加队列的方法就可以只对一个弹窗方法进行修改，由设置单一变量，改为添加至队列。

泛型不仅仅可以应用在解决多态性问题上，对数据模型的抽象和封装也有很大的帮助。当多个不同数据结构存在某些共同特征时，可以将共同的特征抽象出来，形成数据容器，这样数据层级一目了然，利于不同层级的View获取数据。例如，小镇的网络请求数据。

{"msg": "操作成功","result": {},"status": 1}

外层是用来标识服务端数据状态的信息，data里层是非同质化的数据。这里通常的方案是使用字典来表示内部数据，然后需要用到的时候再使用对应的key值进行获取。但是小镇的数据模型使用了Swift的Codable协议，使用协议的目标是网络请求回传数据直接生成封装好的数据模型。所以，这里可以将所有网络请求返回数据封装成一个同质化的数据结构NetworkResult,内容的特质化数据`Result`则可以使用泛型，在运行时由调用程序决定。这样上面的json数据则可以转化成为下面的模型。

 struct NetworkResult<T>: Codable where T: Codable {
  enum CustomKeys: String, CodingKey { case code case message case result} var code: Int? var message: String? var result: T?}

这样使用泛型抽象了特质化的数据，在调用时指定内容数据的数据结构。再结合Swift Codable，网络请求就可以直接返回所需要的数据模型类。如果担心抽象的result太过泛化，则可以如上面的`NetworkResult`，使用`where`关键字要求传入的泛型T遵守Codable的协议。这样可以放心的使用`NetworkResult`结构体对返回的网络请求进行解析了。

NetworkManager.shared.request(remote: info, resultType: NetworkResult<Bool>.self) {[weak self] (status) in switch status { case .fail(let error): //失败处理 debugPrint(error?.localizedDescription) //当返回出现问题，无法解析数据，返回nil, handler状态不变 case .success(let data): if data.message == "成功", let resultData = data as? NetworkResult<Bool>, let result = resultData.result { //改变handler状态 //获取result的内容Bool } else { //当服务器返回请求失败时，返回nil，handler状态不变 }

上面提到的Swift Codable，是系统提供的对JSON数据转换为数据模型类的方法。这种方法的API要求数据模型中的每个变量的类型与JSON数据保持一致，否则在解析过程中就会出现异常，如下：

 struct ElementModel: Codable {  enum CodingKeys: String, CodingKey {  case level case name  }  var level: Int?  var name: String?  init(from decoder: Decoder) throws {  let container = try decoder.container(keyedBy: CodingKeys.self)  level = try container.decodeIfPresent(Int.self, forKey: .level)  name = try container.decodeIfPresent(String.self, forKey: .name)  }}

上面的**ElementModel**是一个Swift Codable 的数据模型，只有level、name参数类型与数据模型一直的JSON数据才能够正常解析。如：

/* 与模型参数类型一致的JSON数据可以解析出 ElementModellevel = 10name = "小五"*/{ "level":10, "name":"小五"}
/* 与模型参数类型不一致的JSON数据，其ElementModel参数会有缺失level = nilname = nil*/{ "level":"10", "name":"小五"}

虽然在日常开发中一般情况下客户端与服务端接口在定制接口协议的时候会提前约定下发字段的类型，然而在实际后端接口下发中，有时会遇到类型不匹配， 发生崩溃。为了解决这个问题，可以采取如下的方式兼容Codable的解析:

struct ElementModel: Codable {  enum CodingKeys: String, CodingKey { case level case name }  var level: Int? var name: String?
 init(from decoder: Decoder) throws { let container = try decoder.container(keyedBy: CodingKeys.self) level = ElementModel.decodeIntValue(by: decoder, for: .level, container: container); name = ElementModel.decodeStringValue(by: decoder, for: .name, container: container); } //兼容解析Int类型的数据 static func decodeIntValue(by decoder:Decoder,for key:ElementModel.CodingKeys,container:KeyedDecodingContainer<CodingKeys>) -> Int { var rtValue:Int = 0; if let intValue = try? container.decodeIfPresent(Int.self, forKey: key) { rtValue = intValue } else if let stringValue = try? container.decodeIfPresent(String.self, forKey: key) { rtValue = Int(stringValue) ?? 0 } else if let doubleValue = try? container.decodeIfPresent(Double.self, forKey: key) { rtValue = Int(doubleValue) } else { rtValue = 0 } return rtValue } //兼容解析String类型的数据 static func decodeStringValue(by decoder:Decoder,for key:ElementModel.CodingKeys,container:KeyedDecodingContainer<CodingKeys>) -> String { var rtValue:String = ""; if let stringValue = try? container.decodeIfPresent(String.self, forKey: key) { rtValue = stringValue } else if let intValue = try? container.decodeIfPresent(Int.self, forKey: key) { rtValue = String(intValue) } else if let doubleValue = try? container.decodeIfPresent(Double.self, forKey: key) { rtValue = String(doubleValue) } else { rtValue = "" } return rtValue }}

UIView的坐标系默认原点在左上角，也就是左上角坐标为（0，0），锚点的位置为中心（0.5，0.5）；

//使用默认锚点位置（0.5，0.5），此时的原点在中心位置 private lazy var sellButtonNode: SKSpriteNode = { let texture = SKTexture(imageNamed: "btn_bottom_sell") let node = SKSpriteNode(texture: texture, size: CGSize(width: 60, height: 60))// node.anchorPoint = CGPoint(x: 0, y: 0) node.position = CGPoint(x: 30, y: 114) let sellBody = SKPhysicsBody(rectangleOf: node.size) sellBody.categoryBitMask = PhysicsCategory.sellButton sellBody.isDynamic = false node.physicsBody = sellBody node.name = "normalsell" return node }()

self.view.addSubview(skView)skView.presentScene(GameScene)GameScene.addChild(foundationNode)

在App冷启动过程中，游戏中大部分图片资源都通过预加载的方式下载，节约了4.7M的包大小。同时，在相较之前H5小游戏， 因为很难使用资源预加载方案，导致首次进入游戏场景较慢。而Native版小游戏，在不同机型中，成功将首次启动时间控制在2秒以下， 较H5的游戏进入时间提升了3倍以上，具体数据详见下图：           

由于Swift良好的代码执行速度，相对于H5小游戏，在不同的业务场景下小游戏FPS（帧率）提升至少15%以上

内存占用方面，因Swift语言特点，业务中大量使用了值类型而非引用类型，在出栈后会变量会直接释放；同时，Swift中引用类型也是通过引用计数管理对象的生命周期，而非GC，所以原生小游戏内存占用比H5小游戏在主要的业务场景中， 内存使用至少降低了20%。