组件化开发之-基于Jenkins搭建iOS持续集成开发环境

2017-03-06  本文已影响633人  一根聪

原创 2017-03-06

关键点

  • Jenkins安装及配置
  • Pipeline创建及配置
  • ruby的版本管理工具rbenv安装
  • fastlane安装
  • 常见构建问题
  • 相关工具及技术网站推荐

CI持续集成

什么是持续集成 ？

持续集成: 是一种软件开发实践，团队开发成员经常集成他们的工作，通常每个成员每天至少集成一次，也就意味着每天可能会发生多次集成。每次集成都通过自动化的构建（包括编译，发布，自动化测试)来验证，从而尽快地发现集成错误。团队发现这个过程可以大大减少集成的问题，让团队能够更快的开发内聚的软件。
参考文章：阮一峰日志

Jenkins安装及配置

配置Node时几个重要参数介绍

  • Name：节点名称
  • Description：节点描述，支持中文
  • Remote root directionary：节点的根目录
    (注意：如果目录不存在，会自动创建目录。但是必须对该目录有读写权限，否则会报错：hudson.util.IOException2: Failed to copy xxxx)
  • Labels：标记(又叫做标签)用来对多节点分组,标记之间用空格分隔.例如'iOSMobile AndrodMobile',将会把一个节点标记上'iOSMobile'和'AndrodMobile'.
  • Launch method：运行方式有四个选项。建议选择第1、2种方式配置。详细如下：
    【推荐】Launch slave agents on Unix machines via SSH 在Unix(包括Linux)机器上通
    过SSH通道连接节点 (适用于Unix和Linux)
    Host：节点主机的ip地址
    Credentials：凭据(如果为空或者不可选择，请在系统管理→Manage Credentials中配置。
    Port：端口默认22

ruby环境安装

在mac上计算机已经安装了ruby,在终端下输入命令：ruby --version
为了能更好的管理ruby版本，我们使用rbenv工具

$ git clone https://github.com/rbenv/rbenv.git ~/.rbenv  
$ cd ~/.rbenv && src/configure && make -C src

安装成功后执行 rbenv init 按照终端输出的提示将 eval "$(rbenv init -)" 拷贝到指定文件（注意: 如果你是使用的iterm2 则拷贝至~/.zshrc 否则拷贝至./bash_profile


配置好以后，重新开启一个终端，我们安装ruby 2.4.0版本 
$ rbenv install -l       # 查看ruby可用版本  
$ rbenv install 2.3.0   # 安装ruby2.3.0  
$ gem install bundler  # 安装ruby gems  
$ rbenv rehash           # 成功操作后，执行rehash操作  
$ rbenv global 2.3.0   # ruby 系统全局环境  
$ rbenv local 2.3.0     # ruby 本地环境  
$ rbenv shell 2.3.0     # ruby作用于当前终端环境

注意： 由于rbenv可能与另一个ruby环境管理工具rvm发生冲突，可以使用rvm implode 彻底删除rvm

Pipeline 创建及配置

Pipeline创建
  1. 设置Pipeline名称
  2. 选择单线程Pipeline （在现目前项目中创建单线程已能够满足条件，多线程Multibranch Pipeline暂不知如何使用，后续补上）
  3. 创建Pipeline时，可以根据一个已有的Pipeline创建
    创建Pipeline
Pipeline配置
node('Mobile') {
    stage('SVN Checkout') {
        checkout([$class: 'SubversionSCM', additionalCredentials: [], excludedCommitMessages: '', excludedRegions: '', excludedRevprop: '', excludedUsers: '', filterChangelog: false, ignoreDirPropChanges: false, includedRegions: '', locations: [[credentialsId: 'sclocman', depthOption: 'infinity', ignoreExternalsOption: true, local: '.', remote: 'svn://svn地址信息']], workspaceUpdater: [$class: 'CheckoutUpdater']])
        sh "svn upgrade #{HOME}/.JenkinsAgent"
    }  
    stage('Unit Testing') {
        dir('./fastlane') {
            // sh 'source ~/.bash_profile && bundle exec fastlane ios test'
        }
    }  
    stage('Generate Test Report') {
        dir('./fastlane') {
            // sh 'source ~/.bash_profile && bundle exec fastlane ios test_report'
        }
    }
    stage('Update the Version NO.') {
        dir('./fastlane') {
            sh 'source ~/.bash_profile && bundle exec fastlane ios update_version'
        }
    }  
    stage('Functional Testing') {
        dir('./fastlane') {
            sh 'source ~/.bash_profile && bundle exec fastlane ios function_test'
        }
    }  
    stage('Build') {
        dir('./fastlane') {
            sh 'source ~/.bash_profile && bundle exec fastlane ios build config:Debug'
        }
    }  
    stage('Release Version') {
        dir('./fastlane') {
            sh 'source ~/.bash_profile && bundle exec fastlane ios deploy config:Debug' 
        }
    }
}

fastlane

$ xcode-select --install    #确保安装了最新的xcode command line tools  
$  sudo gem install fastlane -NV   # 安装fastlane

$ fastlane init

按照提示进行即可。成功后你的目录工程下会多出一个fastlane目录，更多fastlane使用请参考。

构建故障排查

找不到打包的ipa，造成不能上传蒲公英，couldn't open file "/Users/apple/.JenkinsAgent/workspace/locmanYZY-Test/fastlane/fastlane_build/fastlane/result/archive/Debug/ipa/Debug.ipa
原因：未在Pipeline配置打包stage

#27

打包未签名，Code signing is required for product type 'Application' in SDK 'iOS 10.2
原因：Agent机器为配置对应证书及Profile

Could not find lane 'ios build_app_for_simulator'. Available lanes: ios test, ios build_ipa, ios build_simulator_app, ios deploy_to_pgyer, ios update_build_number
原因：stage配置执行的lane找不到，直接参考提示修改即可

![](https://img.haomeiwen.com/i2010692/84a3e4a957aaaf3a.jpg?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)

curl error SSLRead
配置curl ssl：

        $ php -i |grep "SSL Version"  #看看SSL Version的信息
        SSL Version => SecureTransport
        
        // 执行下面命令
        $ brew tap homebrew/dupes
        $ brew tap homebrew/versions
        $ brew tap homebrew/php
        
        $ brew install --with-openssl curl
        
        $ brew install \
                --with-apache \
                --with-homebrew-curl \
                --with-homebrew-openssl \
                --without-snmp php55
        $ php -i | grep "SSL Version"  #如果看到以下，则操作成功
        SSL Version => OpenSSL/1.0.1j

结后语

本文参考了很多blog、github、stackoverflow的文章及问题，感谢作者的分享！特别感谢ThoughtWorks的周教练耐心指导！本文提到的后续补充问题及深入详解将会持续更新，也欢迎各位修改文档使其更加丰富细致。

上一篇 下一篇

猜你喜欢

热点阅读