01 | 开发环境:如何使用 Ruby 工具链统一开发环境?

[toc]

本文来自拉勾网课程整理。

开发环境

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

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

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

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

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

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

Ruby 工具链

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

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

ce61b923c0dc2a15d35cdae49e7e69f5

开发环境统一配置图

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

Xcode

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

像我们将要开发的这款类似朋友圈的 Moments App 项目,我就在对应的 README.md 文件里标明了需要使用 Xcode Version 12.2 (12B45b)。具体内容你也可以在代码仓库找到。

96b37a6560410fdf9cdbba71aaa4663d

那我们怎样才能保证每个人都安装同一个版本号的 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 环境管理工具有 RVMrbenv。我推荐使用的是 rbenv,因为它使用shims 文件夹来分离各个 Ruby 版本,相对于 RVM 更加轻装而方便使用。千万注意,团队内部不要同时使用不同的 Ruby 环境管理工具,否则项目编译会出错。

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

$ /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 进行管理。如果要更新版本,可以通过rbenvlocal命令进行,每次更新也由 Git 统一管理,这样就能让其他开发者使用同一版本的 Ruby 开发环境了。

RubyGems 和 Bundler

RubyGemsBundler主要是用来安装和管理 CocoaPodsfastlane 等第三方工具。

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

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

具体代码如下:

source "https://rubygems.org"
gem "cocoapods", "1.10.0"
gem "fastlane", "2.166.0"

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

DEPENDENCIES
  cocoapods (= 1.10.0)
  fastlane (= 2.166.0)

为了保证团队其他成员都可以使用版本号一致的 Gem,我们需要把GemfileGemfile.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 安装 CocoaPodsfastlane 等依赖包,
最后安装各个 Pod。这样,一个统一的项目环境就搭建完成了,接下来开发者就可以打开 Moments.xcworkspace进行开发了。

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

.gitignore 文件

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

如何创建 .gitignore 文件呢?

我一般会在gitignore.io 里面输入关键字,例如 Xcode,Swift等,然后该网站会帮我们生成一个默认的.gitignore文件。咱们项目 Moments App.gitignore 文件你可以到拉勾教育的仓库中查看。

总结

以上,我们通过Xcode、rbenv、RubyGems 和 Bundler 搭建一个统一的 iOS 开发和构建环境。

9e9486751281fbe2e942cf7c48dddd51

再次强调下,为了让各个开发和构建环境能保持一致,我们要把 .ruby-versionGemfileGemfile.lock 文件通过Git统一管理起来,并共享给整个项目团队使用。

而且,由于我们的开发环境已经通过Bundler管理起来,今后,当使用各个 Gem工具的时候,也需要使用 Bundler。例如在使用 CocoaPods 时要执行bundle exec pod,以保证我们使用的是项目级别而不是操作系统级别的 Gem 工具。

相关配置连接

安装ruby

rbenv可以帮助你在一台机器上建立多个版本的ruby环境, 并提供方便的切换方法。
注意:rbenvrvm是不兼容的,所以安装rbenv之前要先把rvm卸载。

Mac 安装ruby
使用 rbenv 安装和管理 Ruby 版本

安装ruby

Mac 解决brew一直卡在Updating Homebrew

安装问题记录

  • 报错
curl: (35) LibreSSL SSL_connect: SSL_ERROR_SYSCALL in connection to github.com:443

输入命令移除代理

git config --global --unset http.proxy

Bundler

Bundler in iOS project浅析

fastlane使用说明书

fastlane使用说明书

FastLane

FastLane

iOS效率神器fastlane自动打包

iOS效率神器fastlane自动打包
使用Fastlane对iOS项目持续交付(自动打包)

你可能感兴趣的:(01 | 开发环境:如何使用 Ruby 工具链统一开发环境?)