Cocopods 本身是一個優秀的 iOS 開發的包管理工具,涵蓋了 7k+ 的開源組件,包管理庫是托管在 Github。
由於眾所周知的原因它的速度日漸緩慢,有時會頻繁報如下錯誤:
$ pod install Cloning into '/path/to/ios/project/Pods/xxx' error: RPC failed; result=52, HTTP code = 0 fatal: The remote end hung up unexpectedly
本文主要為解決該問題而誕生的,以下的加速方案不局限於目前已流傳的優化方案,而是在此基礎上徹底的加速!
使用淘寶 Ruby Gems 源(Cocoapods 使用 ruby 開發)
pod install 時不設置包的更新:參考文章
使用國內 git 服務器鏡像 Cocoapods Spec: 參考文章
如果你對 Cocoapods 有更深層次的理解,請參見:objc.io: Cocoapods under the hood 中文版本
今天早晨看到微博眾多 iOS 開發者贊同轉發《CocoaPods最佳實踐探討》一文,
針對 Pods 建議納入版本控制也是無奈之舉。之前公司項目中也是這樣施行很長一段時間,不排除更新可能會造成很多無用信息”刷屏”,偶爾還會因為版本沖突造成一些混亂狀況需要處理。個人還是更傾向於精簡原則,遵循官方的建議。
大家都是技術人員,其實這些小問題難道因為 github 倒下就沒有解決方案了嗎?!看我如何撕破這層紙老虎:
技術概述
Cocopods v0.34.0+
gitlab: 自建私有 git 服務器
gitlab-mirrors: 專用於 github 鏡像至 gitlab 並保持定期更新
rake: ruby 的代碼構建工具(不懂 ruby 的可以把它理解為命令聚合工具)
技術剖析
Cocoapods 自身支持私有倉庫,
恰好的是就在前不久發布的 0.34.0 版本支持 Podfile
添加多個的包源倉庫,舉個例子:
source 'https://github.com/artsy/Specs.git' source 'https://github.com/CocoaPods/Specs.git' pod 'AFNetworking' pod 'Mantle'
這個特性其實是為了擴充官方 Spec 的同時可以更好的讓開發者管理私有的公共組件,那我同樣是從這裡下手:
前提是自己以及搭建好 gitlab 服務器:官方教程 (Ubuntu) | 本人教程 (CentOS)
自力更生
首先我們需要創建一個自己的 Spec 倉庫,目錄結構如下:
. ├── CocoaPods-version.yml ├── Specs/ ├── README.md ├── Rakefile └── Gemfile
配置不做詳細描述,這裡比官方多了兩個文件 Rakefile 和 Gemfile 都是 rake 所需的文件,這個後面會講到。
再者就是配置 gitlab-mirrors,教程很詳細不再重復。
偷梁換柱
利用私有 Spec 倉庫特性,可以把官方 Spec 目錄下面的包按需或全部鏡像過來,再次基礎上把裡面涉及 github 的地址替換成 gitlab 的地址
你沒有看錯,這是核心步驟,如果這步沒有做那麼和國內鏡像的地址沒有任何差別。核心代碼如下:
Rakefile
require 'uri' require 'fileutils' require 'multi_json' require 'net/ssh' desc '鏡像一個 github 包至 gitlab 倉庫' task :clone, [:name] do |t, p| name = p[:name] current_path = Dir.pwd specs = Dir[File.join(File.expand_path('~'), '.cocoapods/repos/master/Specs/*')] repo = specs.select { |s| File.basename(s) == name }.first if repo puts " * found repo, copy it here" repo_store_path = File.join(current_path, 'Specs') FileUtils.cp_r repo, repo_store_path puts " * updating repo url" Dir["#{repo_store_path}/#{name}/*"].each do |f| pod_file = File.join(f, "#{name}.podspec.json") json = File.read(pod_file) data = MultiJson.load json if data['source']['git'] puts " -> #{data['version']}: git" orginal_repo_url = data['source']['git'] coverted_repo_name = URI.parse(orginal_repo_url).path[1..-1].gsub('/', '-').downcase data['source']['git'] = "http://gitlab.dev/mirrors/#{coverted_repo_name}" File.write(pod_file, JSON.pretty_generate(data)) else data['source']['http'] puts " -> #{data['version']}: http url, do you want speed up?" else data['source']['svn'] puts " -> #{data['version']}: svn repo, do you want speed up?" end end else puts "Not find spec named: #{name}" end end desc 'gitlab 服務器鏡像 Cocoapod Spec' task :mirror, [:repo] do |t, p| host = '172..0.1' user = 'icyleaf' options = {:keys => '~/.ssh/keys/id_rsa.pub'} puts "Connect gitlab server and mirror" Net::SSH.start(host, user, options) do |ssh| gitmirror_path = '/home/gitmirror/gitlab-mirrors' cmd = "sudo -u gitmirror -H rake \"add[#{p[:repo]}]\"" stdout = ssh.exec!("echo 'cd #{gitmirror_path} && #{cmd}'") puts stdout ssh.loop end end
Gemfile
source "http://ruby.taobao.org" gem 'rest_client' gem 'multi_json' gem 'rake' gem 'net-ssh'
rake 裡面有兩個 task:
mirror: 鏡像 iOS 開源組件
clone: 負責把官方 spec 指定包(開源組件的版本控制)替換 gitlab 地址並加入到私有包倉庫
總結
通過工具總有辦法可以改進和提升開發者的效率和解決各種的問題,希望本文可以給大家帶來更多的靈感!
答疑解惑
F: 這套理論靠譜嗎?
A: 目前我們團隊已經采用並運行了很長一段時間,沒有任何風險。最大的優勢在於兼容官方的倉庫,
就算無法鏈接自己的私有服務器,使用官方和國內鏡像的都可以瞬間切換。
F: 如果沒有服務器可以實現嗎?
A: 醒醒吧孩子,就連單純的鏡像官方 Cocoapods Spec 還需要一個服務器執行定期同步腳本呢。
F: 國內 git 托管服務器能夠支持嗎?
A: 據我所知國內大部分 git 托管服務器的解決方案都是基於 gitlab 二次開發的,理論上可行,
上面提到的 gitlab-mirror 本身依賴於 gitlab 的 api 在鏡像的同時自動新建倉庫。如果有成功的歡迎反饋。
F: 我從你代碼發現服務器同樣調用了一個 rake 腳本,你沒有開源!
A: 眼睛真夠敏銳的,個人對 gitlab-mirror 再做鏡像時做了一個約束,新建一個 Rakefile 文件放到你的 gitlab-mirror 項目根目錄即可:
require 'uri' desc "Adding repo to gitmirror" task :add, [:repo] do |t, p| repo = p[:repo] begin name = URI.parse(repo).path[1..-1].gsub('/', '-').gsub('.git', '') if name `./add_mirror.sh -f --git --project-name #{name} --mirror #{repo}` end rescue Error => e puts 'not url' end end
(本文作者:icyleaf)