[toc]
本文来自拉勾网课程整理。
开发环境
在 iOS
开发过程中,你是不是会经常遇到这些情况:
每次打开一个新项目,都需要手动搭建开发环境;有时候在安装第三方工具时使用到 sudo
权限,导致以后安装工具都需要手工输入密码而无法实施自动化。还有,每当启动一台新 CI
时,就需要手工登录并配置一遍,更可怕的是,原先搭建好的CI
会随着Xcode
版本更新需要重新配置。
为什么会这么麻烦呢?就是因为你在项目开始之初没有做好统一配置。
所谓统一配置,就是所有的配置信息都以文本的格式存放在 Git
里面,我们可以随时查看修改记录,以此来帮助我们比较不同配置之间的差异性,然后在这个基础上不断更新迭代。
可以说,有了统一配置,任何工程师都可以搭建出一模一样的开发环境,构建出功能一致的 App
;有了统一配置,还可以让我们按需延展 CI
服务,而不用任何手工操作。更重要的是,它还可以应用到各个类似的iOS
项目中,极大地减轻了项目前期的搭建成本。
既然统一的配置那么重要,那么我们怎样搭建统一配置的开发环境呢?
Ruby 工具链
我们可以通过 Ruby
工具链为整个项目搭建一致的开发
和构建环境。为什么选择 Ruby
而不是其他语言环境呢? 因为在 iOS
开发方面,目前流行的第三方工具 CocoaPods
和 fastlane
都是使用 Ruby
来开发的。特别是 Ruby
有非常成熟的依赖库管理工具 RubyGems
和 Bundler
,其中 Bundler
可以帮我们有效地管理 CocoaPods
和 fastlane
的版本。
下面一起来看看怎样搭建一个统一的开发环境吧。
ce61b923c0dc2a15d35cdae49e7e69f5开发环境统一配置图
通常,统一的开发环境应该从操作系统开始。对于 iOS
开发来说,MacOS
是目前 iOS
开发唯一支持的操作系统。在公司,MacOS
的版本一般由 IT 部门统一管理和更新。要注意,当公司统一更新了我们开发环境的 MacOS
版本以后,需要同时更新 CI
上MacOS
的版本,以保持一致。
Xcode
位于 MacOS
上层的是 Xcode
和 rbenv
。其中,Xcode
是 iOS
开发和构建工具,在同一个项目里,最好使用同一个版本的Xcode
进行开发和构建,我们可以在项目的 README.md
文件标注 Xcode
的版本。
像我们将要开发的这款类似朋友圈的 Moments App
项目,我就在对应的 README.md
文件里标明了需要使用 Xcode Version 12.2 (12B45b)
。具体内容你也可以在代码仓库找到。
那我们怎样才能保证每个人都安装同一个版本号的 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
文件,能减轻后续的管理工作。
如何创建 .gitignore 文件呢?
我一般会在gitignore.io
里面输入关键字,例如 Xcode,Swift
等,然后该网站会帮我们生成一个默认的.gitignore
文件。咱们项目 Moments App
的.gitignore
文件你可以到拉勾教育的仓库中查看。
总结
以上,我们通过Xcode、rbenv、RubyGems 和 Bundler
搭建一个统一的 iOS 开发和构建环境。
再次强调下,为了让各个开发和构建环境能保持一致,我们要把 .ruby-version
、 Gemfile
和 Gemfile.lock
文件通过Git
统一管理起来,并共享给整个项目团队使用。
而且,由于我们的开发环境已经通过Bundler
管理起来,今后,当使用各个 Gem
工具的时候,也需要使用 Bundler
。例如在使用 CocoaPods
时要执行bundle exec pod
,以保证我们使用的是项目级别而不是操作系统级别的 Gem
工具。
相关配置连接
安装ruby
rbenv
可以帮助你在一台机器上建立多个版本的ruby
环境, 并提供方便的切换方法。
注意:rbenv
和rvm
是不兼容的,所以安装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
网友评论