2021-06-21

在 iOS 开发过程中,你是不是会经常遇到这些情况:

每次打开一个新项目,都需要手动搭建开发环境;有时候在安装第三方工具时使用到 sudo 权限,导致以后安装工具都需要手工输入密码而无法实施自动化。还有,每当启动一台新 CI 时,就需要手工登录并配置一遍,更可怕的是,原先搭建好的 CI 会随着 Xcode 版本更新需要重新配置。

为什么会这么麻烦呢?就是因为你在项目开始之初没有做好统一配置。

所谓统一配置,就是所有的配置信息都以文本的格式存放在 Git 里面,我们可以随时查看修改记录,以此来帮助我们比较不同配置之间的差异性,然后在这个基础上不断更新迭代。

可以说,有了统一配置,任何工程师都可以搭建出一模一样的开发环境,构建出功能一致的 App;有了统一配置,还可以让我们按需延展 CI 服务,而不用任何手工操作。更重要的是,它还可以应用到各个类似的 iOS 项目中,极大地减轻了项目前期的搭建成本。

既然统一的配置那么重要,那么我们怎样搭建统一配置的开发环境呢?

Ruby 工具链

我们可以通过 Ruby 工具链为整个项目搭建一致的开发和构建环境。为什么选择 Ruby 而不是其他语言环境呢?因为在 iOS 开发方面,目前流行的第三方工具 CocoaPods 和 fastlane 都是使用 Ruby 来开发的。特别是 Ruby 有非常成熟的依赖库管理工具 RubyGems 和 Bundler,其中 Bundler 可以帮我们有效地管理 CocoaPods 和 fastlane 的版本。

下面一起来看看怎样搭建一个统一的开发环境吧。


开发环境统一配置图


通常,统一的开发环境应该从操作系统开始。对于 iOS 开发来说,MacOS 是目前 iOS 开发唯一支持的操作系统。在公司,MacOS 的版本一般由 IT 部门统一管理和更新。要注意,当公司统一更新了我们开发环境的 MacOS 版本以后,需要同时更新 CI 上 MacOS 的版本,以保持一致。

Xcode

位于 MacOS 上层的是 Xcode 和 rbenv。其中,Xcode 是 iOS 开发和构建工具,在同一个项目里,最好使用同一个版本的 Xcode 进行开发和构建,我们可以在项目的 README.md 文件标注 Xcode 的版本。


那我们怎样才能保证每个人都安装同一个版本号的 Xcode 呢?技巧就是我们不要到有自动更新功能的 Mac App Store 中下载 Xcode,而是到苹果的开发者网站搜索并下载。

有时候我们会同时开发多个项目,这样有可能要安装多个不同版本的 Xcode。如果你的机器有多于一个版本的 Xcode,此时需要特别注意,为了保证所使用的编译器版本一致,在每次执行自动化命令之前(如执行bundle exec fastlane test),要先使用xcode-select -s来选择该项目所对应版本的 Xcode。

比如说我的电脑上有多个 Xcode 版本,在开发 Moments App 时,每次执行自动化命令之前都会执行这样一条命令xcode-select -s /Applications/Xcode12.2.app/Contents/Developer来选择 Moments App 项目所使用的 Xcode。这里的Xcode12.2.app就是我安装的 Xcode 12.2 版所在的位置。

rbenv

有了版本一致的 Xcode 以后,因为后期我们会用到 CocoaPods 等第三方 Ruby 工具,为了自动化安装和管理这些工具,整个项目团队所使用的 Ruby 版本也必须保持一致。为此,我们就需要用到 Ruby 环境管理工具。

目前流行的 Ruby 环境管理工具有 RVM 和 rbenv。我推荐使用的是 rbenv,因为它使用 shims 文件夹来分离各个 Ruby 版本,相对于 RVM 更加轻装而方便使用。千万注意,团队内部不要同时使用不同的 Ruby 环境管理工具,否则项目编译会出错。

rbenv 是 Ruby 环境管理工具,能够安装、管理、隔离以及在多个 Ruby 版本之间切换。要使用 rbenv,我们可以通过 Homebrew 来安装它,下面是安装 Homebrew 和 rbenv 的脚本。


$ /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install.sh)"

brew install rbenv ruby-build rbenv-vars

一旦安装 rbenv 完毕,我们需要把以下的设置信息放到你的 Shell 配置文件里面,例如 ~/.bash_profile 或者 ~/.zshrc 等文件,这样能保证每次打开终端的时候都会初始化 rbenv。


export PATH="$HOME/.rbenv/bin:$PATH"

eval "$(rbenv init -)"

接着我们就可以安装和设置项目的 Ruby 环境了。


$ cd $(PROJECT_DIR)

$ rbenv install 2.7.1

$ rbenv local 2.7.1

此处是把项目的 Ruby 环境配置为 2.7.1 版本。rbenv 会帮我们建立 一个叫作.ruby-version 的文件,该文件里面只保存一个版本号(例如2.7.1)的字符串。这个包含了版本号的文件可以用 Git 进行管理。如果要更新版本,可以通过rbenv local命令进行,每次更新也由 Git 统一管理,这样就能让其他开发者使用同一版本的 Ruby 开发环境了。

RubyGems 和 Bundler

RubyGems 和 Bundler 主要是用来安装和管理 CocoaPods 和 fastlane 等第三方工具。

具体来说,RubyGems 是 Ruby 依赖包管理工具。在 Ruby 的世界,包叫作 Gem,我们可以通过gem install命令来安装。但是 RubyGems 在管理 Gem 版本的时候有些缺陷,就有人开发了 Bundler,用它来检查和安装 Gem 的特定版本,以此为 Ruby 项目提供一致性的环境。

要安装 Bundler,我们可执行gem install bundler命令进行,之后,再执行bundle init就可以生成一个 Gemfile 文件,像 CocoaPods 和 fastlane 等依赖包,我们就可以添加到这个文件里面。

具体代码如下:


source "https://rubygems.org"

gem "cocoapods", "1.10.0"

gem "fastlane", "2.166.0"

注意我们在gem命令里面都指定了依赖包的特定版本号。例如,在我们的 Moment App 就使用了1.10.0版的 CocoaPods,然后执行bundle install来安装各个 Gem。 Bundler 会自动生成一个 Gemfile.lock 文件来锁定所安装的 Gem 的版本,例如:


DEPENDENCIES

  cocoapods (= 1.10.0)

  fastlane (= 2.166.0)

为了保证团队其他成员都可以使用版本号一致的 Gem,我们需要把 Gemfile 和 Gemfile.lock 一同保存到 Git 里面统一管理起来。

到此为止,我们已经知道怎样使用 Ruby 工具链配置一个统一的开发环境。但在真实的开发环境中,搭建环境只需要一个人来完成即可,其他成员执行以下脚本就能完成整套开发环境的搭建。


$ ./scripts/setup.sh

我们一起看看这个脚本做了些什么?


# Install ruby using rbenv

ruby_version=`cat .ruby-version`

if [[ ! -d "$HOME/.rbenv/versions/$ruby_version" ]]; then

  rbenv install $ruby_version;

fi

# Install bunlder

gem install bundler

# Install all gems

bundle install

# Install all pods

bundle exec pod install

该脚本主要做了四件事情,第一步是在 rbenv 下安装特定版本的 Ruby 开发环境,然后通过 RubyGems 安装 Bunlder,接着使用 Bundler 安装 CocoaPods 和 fastlane 等依赖包,最后安装各个 Pod。这样,一个统一的项目环境就搭建完成了,接下来开发者就可以打开 Moments.xcworkspace进行开发了。

说完 Ruby 环境搭建以后,最后我们一起聊聊保证项目文件一致性的 .gitignore 文件。

.gitignore 文件

.gitignore 文件是一个配置文件,用来指定让 Git 需要忽略的文件或者目录。如果没有 .gitignore 文件,项目成员可能会不小心把一些自动生成等无关重要的文件或者具有个人信息(例如 xcuserdata)的文件保存到 Git 里面。这就大大增加了查看 Git 修改历史的难度。因此,在项目初期就配置一个合适的 .gitignore 文件,能减轻后续的管理工作。

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 206,839评论 6 482
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 88,543评论 2 382
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 153,116评论 0 344
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 55,371评论 1 279
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 64,384评论 5 374
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 49,111评论 1 285
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,416评论 3 400
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 37,053评论 0 259
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 43,558评论 1 300
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,007评论 2 325
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,117评论 1 334
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,756评论 4 324
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,324评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,315评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,539评论 1 262
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 45,578评论 2 355
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,877评论 2 345

推荐阅读更多精彩内容