iOS两个客户端代码复用小技巧
<p>一般一个App只有一个客户端,因此也只有一份代码仓库,也就无所谓复用不复用。但两个客户端也不是没有,美团、饿了么等就分商家版和买家版,贝聊App也分为老师版和家长版两个客户端。有两个客户端代码复用就在所难免,比如基本的工具类,比如一些共用的业务。本文就以贝聊App为例,分享当有两个客户端时代码复用的小技巧。</p> <h2>repository仓库划分</h2> <p>贝聊APP远程仓库划分为三个,一个 家长端repository ,一个 老师端repository ,一个两端共用的 BLKit repository 。</p> <p style="text-align:center"><img src="https://simg.open-open.com/show/de196e021f5abaf57bf4d089f510580f.png"></p> <p>家长端的本地 repository 包含远程的 家长端repository 和两端共用的 Kit repository 。</p> <p>老师端的本地 repository 包含远程的 老师端repository 和两端共用的 Kit repository 。</p> <p style="text-align:center"><img src="https://simg.open-open.com/show/7a25fc13b39ea0ed5a984df256dc5b6a.png"></p> <h2>用submodule管理共用模块BLKit</h2> <p>一个端要包括两个 repository ,而且这两个 repository 还是相互依赖,怎么管理也是个问题。</p> <p>git 中 submodule 允许在一个 主git 中存在另外独立的 子git ,而且 主git 还能记录每一次 commit 中 子git 所在的 commit ,这是完美的仓库独立却又相互依赖的管理方案。</p> <p>如下图:</p> <p><img src="https://simg.open-open.com/show/150ea3e4fa1e703956d310c682ba5c5b.png"></p> <h2>通过cocoapods将BLKit引入项目</h2> <p>虽然利用 submodule 可以很好的管理共用模块 BLKit ,但又如何将 BLKit 引入到 project 中呢?</p> <p>有两个方案,</p> <p>直接加入主project</p> <p>可以通过 add files to project ,选择所有 BLKit 中的文件,添加到 主project 中。但这样做的隐患非常大:</p> <ul> <li> <p>BLKit不独立</p> <p>BLKit 是两端共用模块,因此 BLKit 只能使用 BLKit 内部的类,否则在另外一个端中是不能编译的。如果 BLKit 的文件被添加到 主project 中,很容易在 BLKit 的某个文件中初始化了主项目中的一个类,导致 BLKit 很难维护。</p> </li> <li> <p>BLKit不能更新</p> <p>BLKit 直接添加到 主project 中,如果一端有添加新文件,另外一端拉取下来后,还得手动通过 add files to project 将新添加的文件添加到 主project 中。如果每次只是添加一个文件还好,如果文件一多,想死的心都有。</p> </li> </ul> <p>通过cocoapods管理</p> <p>将 BLKit 像其他第三方依赖库一样,用 cocoapods 管理,只不过 pods 的文件源连接到本地的 BLKit 仓库而已。</p> <p>首先在主项目中的 submodule 文件夹中,创建一个 BLKit.podspec ,然后按照 podspec 的规则,填写 podsspec ,然后在主项目中的 Podfile ,像添加普通 pod 一样,将 BLKit 添加到 Podfile 中,</p> <pre> <code class="language-objectivec">pod 'BLKit', :path => "./BLKit/" </code></pre> <p>然后 pod update 即可,这时 BLKit 就像普通的第三方依赖库一样,出现在 pods 中:</p> <p style="text-align:center"><img src="https://simg.open-open.com/show/b1ba16b3eda1e67eee995e2c9ceac6e8.jpg"></p> <p>用 cocoapods 管理好处是很明显的:</p> <ul> <li>BLKit完全独立<br> BLKit 由于在 pods 中,不能引用主项目中的类,完全独立,不会出现一端更新,另外一端不能使用的情况。</li> <li>BLKit自动更新<br> 由于 BLKit 其实就是个 pods 而已,如果 远程BLKit 有更新,拉取到本地后,运行 pod update --no-repo-update 即可。千万加上 --no-repo-update 这个选项,因为 pod update 很慢很慢很慢。(当然如果利用 proxychain , pod update 也很快,但实在没有必要为乐更新 BLKit 更新整个 pod )</li> </ul> <h2>如何在BLKit中引用主项目业务模块</h2> <p>两端共用的模块,一般都是基础功能模块,比如网络模块,数据缓存模块、图片下载模块、视频发送模块等,都完全独立,与主项目没有耦合。但有时业务模块也有共用,比如聊天模块、大图浏览模块等。业务模块与主项目很难完全没有耦合,比如大图浏览模块长按时的操作逻辑,比如聊天模块长按消息的跳转逻辑,况且有时,有些业务模块被抽象成共用的,有些业务模块却没有,共用模块却要引用主项目中没有抽象成共用的业务模块。比如贝聊App中的聊天模块是共用的聊天模块,但大图浏览模块却不是共用的,因为历史原因,家长端和老师端各有各的实现,但点击聊天页面的图片消息,会进入大图浏览模块。</p> <p>那如何在 BLKit 中引用主项目中业务模块?</p> <p>以 BLKit 中的聊天模块为例,</p> <pre> <code class="language-objectivec">// 这个类在Pods中 class ChatViewController: UIViewController { let chatID: String init(chatID: String) { self.chatID = chatID } // 其他业务代码 // Table Cell delegate func didTapImageIn(cell: UITableViewCell) { // 进入大图浏览模块 let allImages: [URL] = [self getAllMessageImages] } } </code></pre> <p>聊天的 Cell 的代理为 ChatViewController ,当点击到图片 Cell ,会调用代理方法 didTapImageIn(cell:) 。 ChatViewController 实现了这个代理方法,获取到所有图片的 URL 后,需要调用主项目中的大图浏览模块。但 Pods 中是不可能直接调用主项目中的方法的。所以需要一个桥梁。</p> <p>定义一个信使协议</p> <p>可以定义一个信使协议,然后在主项目中初始化 ChatViewController 时,传入具体实现这个信使协议的类。</p> <pre> <code class="language-objectivec">// pods中 // 信使协议 protocol ChatMessenger { func openPhotoViewer(with photoes: [URL], in context: UIViewController) } </code></pre> <p>然后主项目中创建一个类实现 ChatMessenger 协议,</p> <pre> <code class="language-objectivec">// 主项目中 class ChatMessengerConcrete: ChatMessenger { func openPhotoViewer(with photoes: [URL], in context: UIViewController) { // 具体调用主项目中的大图浏览模块 } } </code></pre> <p>修改 ChatViewController 接受一个 ChatMessenger 作为初始化参数,然后在点击图片的 cell 代理方法中调用 ChatMessenger 的大图浏览:</p> <pre> <code class="language-objectivec">// 这个类在Pods中 class ChatViewController: UIViewController { let chatMessenger: ChatMessenger let chatID: String // 初始化方法中传入ChatMessenger init(chatMessenger: ChatMessenger, chatID: String) { self.chatMessenger = chatMessenger self.chatID = chatID } // 其他业务代码 // Table Cell delegate func didTapImageIn(cell: UITableViewCell) { let allImages: [URL] = [self getAllMessageImages] // 进入大图浏览模块 chatMessenger.openPhotoViewer(with: allImages, in: self) } } </code></pre> <p>然后在主项目中的聊天入口,初始化 ChatViewController ,并传入实现 ChatMessenger 协议的 ChatMessengerConcrete :</p> <pre> <code class="language-objectivec">// 比如消息列表页 class ChatListViewController: UIViewController { func tableView(_ tableView: UITableView, didSelectRowAt indexPath: IndexPath) { // 获取对应indexPath的聊天ID let chatID = "" let chatVC = ChatViewController(chatMessenger: ChatMessengerConcrete(), chatID: ) navigationController?.pushViewController(chatVC, animated: true) } } </code></pre> <p>使用协议扩展</p> <p>虽然可以在主项目中聊天的入口处,传入 ChatMessenger 的实体类,达到在 Pods 中调用主项目业务模块,但如果聊天入口也都抽象到 Pods 中的 BLKit 中,那在 Pods 中是无法初始化一个主项目中的 ChatMessenger 实体类的。</p> <p>这时可以利用 Swift 中的 protocol extension ,在主项目中给 Pods 中的 ChatMessenger 协议一个默认实现。</p> <pre> <code class="language-objectivec">// 主项目中 extension ChatMessenger { func openPhotoViewer(with photoes: [URL], in context: UIViewController) { // 具体调用主项目中的大图浏览模块 } } </code></pre> <p>再让 Pods 中聊天页类 ChatViewController 遵循 ChatMessenger 协议,然后需要主项目中的业务直接调用对应的方法即可。</p> <pre> <code class="language-objectivec">// 这个类在Pods中 class ChatViewController: UIViewController, ChatMessenger { let chatID: String // 初始化方法中传入ChatMessenger init(chatID: String) { self.chatID = chatID } // 其他业务代码 // Table Cell delegate func didTapImageIn(cell: UITableViewCell) { let allImages: [URL] = [self getAllMessageImages] // 进入大图浏览模块 openPhotoViewer(with: allImages, in: self) } } </code></pre> <p>协议扩展是实现 Pods 中调用主项目业务模块的最好方式。</p> <h2>总结</h2> <p>当有两个客户端时,</p> <p>1)建立一个或多个两端共用的 repository ,管理两端相同的业务模块和功能模块</p> <p>2)利用 submodule 在主项目中管理两端共用的 repository</p> <p>3)利用私有 pods 将 submodule 中的共用代码引入 project 中</p> <p>4)利用协议扩展轻松实现在 pods 中调用主项目中的业务模块</p> <p> </p> <p>来自:http://shellhue.github.io/2017/04/08/sharecode/</p> <p> </p>
本文由用户 SangDahl 自行上传分享,仅供网友学习交流。所有权归原作者,若您的权利被侵害,请联系管理员。
转载本站原创文章,请注明出处,并保留原始链接、图片水印。
本站是一个以用户分享为主的开源技术平台,欢迎各类分享!