iOS使用fastlane实现持续集成的方法教程

brew cask install fastlane

sudo gem install fastlane -NV

➜ PlushGame fastlane -vfastlane installation at path:/Users/aron/.rvm/gems/ruby-2.3.0@global/gems/fastlane-2.62.0/bin/fastlane-----------------------------fastlane 2.62.0

➜ PlushGame fastlane init[20:37:45]: Get started using a Gemfile for fastlane https://docs.fastlane.tools/getting-started/ios/setup/#use-a-gemfile[20:37:48]: Detected iOS/Mac project in current directory......# 根据提示输入项目的Apple ID和对应的密码，会自动登录到苹果开发者后台，拉取开发者账号对应的信息完成设置[20:37:52]: Your Apple ID (e.g. fastlane@krausefx.com): XXXXXX@126.com[20:37:55]: Verifying that app is available on the Apple Developer Portal and iTunes Connect...[20:37:55]: Starting login with user 'XXXXXX@126.com'-------------------------------------------------------------------------------------Please provide your Apple Developer Program account credentialsThe login information you enter will be stored in your macOS KeychainYou can also pass the password using the `FASTLANE_PASSWORD` environment variableMore information about it on GitHub: https://github.com/fastlane/fastlane/tree/master/credentials_manager-------------------------------------------------------------------------------------# 输入Apple ID 对应的密码Password (for XXXXXX@126.com): **************+----------------+------------------------------------------------------+|       Detected Values       |+----------------+------------------------------------------------------+| Apple ID  | XXXXXX@126.com         || App Name  | PlushGame           || App Identifier | com.xxxx.xxxx        || Workspace  | /Users/aron/PuTaoWorkSpace/project/PlushGame/PlushG ||    | ame.xcworkspace          |+----------------+------------------------------------------------------+# 检测到的项目信息要求确认，按y即可[20:38:50]: Please confirm the above values (y/n)y[20:39:03]: Created new file './fastlane/Appfile'. Edit it to manage your preferred app metadata information.[20:39:03]: Loading up 'deliver', this might take a few seconds[20:39:03]: Login to iTunes Connect (XXXXXXX@126.com)[20:39:16]: Login successful+--------------------------------------+------------------------+|     deliver 2.62.0 Summary      |+--------------------------------------+------------------------+| run_precheck_before_submit   | false     || screenshots_path      | ./fastlane/screenshots || metadata_path      | ./fastlane/metadata || username        | XXXXXX@126.com || app_identifier      | com.xxxx.xxxxx || edit_live       | false     || platform        | ios     || skip_binary_upload     | false     || skip_screenshots      | false     || skip_metadata      | false     || skip_app_version_update    | false     || force        | false     || submit_for_review     | false     || automatic_release     | false     || dev_portal_team_id     | JN55YSQ744    || overwrite_screenshots    | false     || precheck_default_rule_level   | warn     || ignore_language_directory_validation | false     |+--------------------------------------+------------------------+# 从ituneconnect拉取已存在的元数据，这里只有截屏的信息[20:39:34]: Downloading all existing screenshots...[20:39:37]: Downloading existing screenshot '1_iphone58_1.X1_1.jpg' for language 'zh-Hans'[20:39:42]: Downloading existing screenshot '2_iphone58_2.X2_1.jpg' for language 'zh-Hans'[20:40:22]: Downloading existing screenshot '3_iphone58_3.X3_1.jpg' for language 'zh-Hans'[20:40:49]: Downloading existing screenshot '4_iphone58_4.X5_1.jpg' for language 'zh-Hans'....

➜ fastlane tree.├── Appfile├── Deliverfile├── Fastfile├── metadata│ ├── app_icon.jpg│ ├── copyright.txt│ └── zh-Hans│  ├── description.txt│  ├── keywords.txt│  ├── marketing_url.txt│  ├── name.txt│  ├── privacy_url.txt│  ├── promotional_text.txt│  ├── release_notes.txt│  ├── subtitle.txt│  └── support_url.txt└── screenshots ├── README.txt └── zh-Hans  ├── 1_iphone58_1.X1_1.jpg  ├── 1_iphone6Plus_1.1.png  ├── 2_iphone58_2.X2_1.jpg  ├── 2_iphone6Plus_2.2.png  ├── 3_iphone58_3.X3_1.jpg  ├── 3_iphone6Plus_3.3.png  ├── 4_iphone58_4.X5_1.jpg  ├── 4_iphone6Plus_4.4.png  └── 5_iphone6Plus_5.5.png8 directories, 62 files

app_identifier "com.xxxx.xxxx" # The bundle identifier of your appapple_id "XXXXXX@126.com" # Your Apple email addressteam_id "XXXXXSQ744" # Developer Portal Team ID

app_identifier "com.sanshuai.FunCatch" # The bundle identifier of your appusername "sanshuai2017@126.com" # your Apple ID user

fastlane_version "2.62.0"default_platform :iosplatform :ios do desc "Deploy a new version to the App Store" lane :release do # match(type: "appstore") # snapshot gym(scheme: "PlushGame") # Build your app - more options available deliver(force: true) # frameit end # You can define as many lanes as you want after_all do |lane| # This block is called, only if the executed lane was successful # slack( # message: "Successfully deployed new App Update." # ) endend

# Customise this file, documentation can be found here:# https://docs.fastlane.tools/actions/# All available actions: https://docs.fastlane.tools/actions# can also be listed using the `fastlane actions` command# Change the syntax highlighting to Ruby# All lines starting with a # are ignored when running `fastlane`# If you want to automatically update fastlane if a new version is available:# update_fastlane# This is the minimum version number required.# Update this, if you use features of a newer versionfastlane_version "2.62.0"default_platform :iosplatform :ios do before_all do # ENV["SLACK_URL"] = "https://hooks.slack.com/services/..." # cocoapods # carthage end desc "Runs all the tests" lane :test do scan end # 定义全局参数：项目名称 projName = "Plush" # 定义全局参数：Assets路径 projAssetsPath = "../#{projName}/Resources/Assets.xcassets" # 定义全局参数：Info.plist路径 plistPath = "./#{projName}/Resources/Info.plist" # 定义全局参数：包名（接收之后压缩使用） pkgName = "" # 定义全局参数：基本包名 basePkgName = "Plush" # 定义全局参数：输出目录，对应output_directory配置 outputBaseDir = "output"  desc "自定义的渠道打包" desc "使用方式：苹果助手：`bundle exec fastlane customChannelBeta ch:pgzs shouldUp:0`" desc "使用方式：91助手：`bundle exec fastlane customChannelBeta ch:91zs shouldUp:0`" desc "op 支持参数： ch:渠道类型[pgzs, 91zs, AppStore(默认)]" desc "op 支持参数： shouldUp:是否需要上传[0, 1]" desc "op 支持参数： up:上传类型[testflight, fir]" desc "op 支持参数： exportMethod: export_method 配置[app-store, ad-hoc, package, enterprise, development（默认）, developer-id] ** up为testflight需要制定为app-store **" desc "op 支持参数： version:版本(可选)" desc "op 支持参数： build:构建版本(可选，testflight和appstore这个参数需要制定一个不重复的)" lane :customChannelBeta do |op|  # 渠道 channel = op[:ch] if channel.nil? || channel.empty?  channel = "AppStore" end # 打包名字 time = Time.new dateTimeStr = "#{time.year}-#{time.month}-#{time.day}_#{time.hour}-#{time.min}" pkgName = "#{dateTimeStr}_#{channel}_#{basePkgName}.ipa" # match(type: "appstore") # more information: https://codesigning.guide #设置plist，此处传入plist路径，可以用来做环境配置 set_info_plist_value(path: plistPath, key: "pt_channel", value: channel) # # 设置AppIcon # iconPath = op[:iconPath] # if iconPath.nil? || iconPath.empty? # iconPath = "channel_config/#{channel}/icon1024.png" # iconPath = "channel_config/91zs/icon1024.png" # end # puts "iconPath = #{iconPath}" # appicon(appicon_image_file: iconPath, # appicon_devices: [:ipad, :iphone, :ios_marketing, :watch, :watch_marketing]) # 拷贝AppIcon.appiconset替换图标 iconAssetPath = op[:iconPath] if iconAssetPath.nil? || iconAssetPath.empty?  iconAssetPath = "../channel_config/#{channel}/AppIcon.appiconset" end cpCmd = "cp -fRv #{iconAssetPath} #{projAssetsPath}" `#{cpCmd}` puts "cpCmd = #{cpCmd}" # 设置显示版本和构建版本 version = op[:version] build = op[:build] if version.nil? || version.empty? else  increment_version_number(version_number: version) end if build.nil? || build.empty? else  increment_build_number(build_number: build) end exportMethod = op[:exportMethod] if exportMethod.nil? || exportMethod.empty?  exportMethod = "development" end puts "exportMethod = #{exportMethod} pkgName = #{pkgName} outputBaseDir = #{outputBaseDir}" # build_ios_app 参数配置 gym(  export_method: exportMethod, # 相当于配置 Archives->Export->mehtod:[app-store, ad-hoc, package, enterprise, development(默认), developer-id]  output_name: pkgName,  configuration: "Release", # 相当于配置Scheme->Build Configuration:[Release, Debug]，Release会生成dsym文件，而Debug不会  output_directory: outputBaseDir,  scheme: "Plush", ) # 是否需要上传配置，默认不上传 shouldUp = op[:shouldUp] if shouldUp == "1"  # 上传测试包到测试平台类型，默认上传到fir，可以支持多种测试平台使用逗号分隔  # testflight, fir  upType = op[:up]  if upType.nil? || upType.empty?  upType = "fir"  end  if upType.include? "testflight"  pilot # 上传到testflight  elsif upType.include? "fir"  firim(firim_api_token: "xxxxxxxx")#上传fir，如果是新项目，fir会自动创建  end end end desc "上传到 App Store" lane :release do # match(type: "appstore") # snapshot gym(  export_method: "app-store", # 相当于配置 Archives->Export->mehtod:[app-store, ad-hoc, package, enterprise, development, developer-id]  output_name: pkgName,  configuration: "Release", # 相当于配置Scheme->Build Configuration:[Release, Debug]，Release会生成dsym文件，而Debug不会  output_directory: outputBaseDir,  scheme: "Plush", ) deliver(force: true) # frameit end # You can define as many lanes as you want after_all do |lane, op| # This block is called, only if the executed lane was successful # slack( # message: "Successfully deployed new App Update." # ) if !pkgName.empty?  fileName = pkgName.gsub(".ipa", "")  dsymName = "#{fileName}.app.dSYM.zip"  zipFileName = "#{fileName}.zip"  # 使用zip命令压缩  zipCmd = "zip ../#{outputBaseDir}/#{zipFileName} ../#{outputBaseDir}/#{dsymName} ../#{outputBaseDir}/#{pkgName}"  puts "begin zip #{zipCmd}"  `#{zipCmd}` end end error do |lane, exception| # slack( # message: exception.message, # success: false # ) endend

#打91助手渠道的包不上传bundle exec fastlane customChannelBeta ch:91zs shouldUp:0# 91助手渠道打包并且上传到firbundle exec fastlane customChannelBeta ch:91zs shouldUp:1 up:fir# testflight 打包上传bundle exec fastlane customChannelBeta shouldUp:1 up:testflight exportMethod:app-store# AppStore 打包上传bundle exec fastlane release

➜ output tree.├── 2018-1-17_11-53_pgzs_Plush.app.dSYM.zip├── 2018-1-17_11-53_pgzs_Plush.ipa└── 2018-1-17_11-53_pgzs_Plush.zip

➜ output fastlane search_plugins fir...+----------+-------------------------------------+-----------+|     fastlane plugins 'fir'     |+----------+-------------------------------------+-----------+| Name  | Description       | Downloads |+----------+-------------------------------------+-----------+| firebase | Unofficial tool to access Firebase | 1393  ||   | project settings     |   || firim | firim        | 1142  || fir  | Upload a new build to fir.im  | 807  |+----------+-------------------------------------+-----------+

# fastlane 安装firim插件➜ PlushGame fastlane add_plugin firim# 添加 `bundle exec` 使用本地的插件，加快速度➜ PlushGame bundle exec fastlane add_plugin firim[15:08:48]: Plugin 'fastlane-plugin-firim' was added to './fastlane/Pluginfile'[15:08:48]: Make sure to commit your Gemfile, Gemfile.lock and Pluginfile to version controlInstalling plugin dependencies...Successfully installed plugins

# Autogenerated by fastlane## Ensure this file is checked in to source control!gem 'fastlane-plugin-firim'

➜ Plush.app fastlane action firim[23:50:31]: fastlane detected a Gemfile in the current directory[23:50:31]: however it seems like you don't use `bundle exec`[23:50:31]: to launch fastlane faster, please use[23:50:31]: [23:50:31]: $ bundle exec fastlane action firim[23:50:31]: [23:50:31]: Get started using a Gemfile for fastlane https://docs.fastlane.tools/getting-started/ios/setup/#use-a-gemfile+-------------------------+---------+-------------------------+|      Used plugins       |+-------------------------+---------+-------------------------+| Plugin     | Version | Action     |+-------------------------+---------+-------------------------+| fastlane-plugin-firim | 0.1.0 | firim     || fastlane-plugin-appicon | 0.11.0 | android_appicon appicon |+-------------------------+---------+-------------------------+Loading documentation for firim:+------------------------------------+|    firim    |+------------------------------------+| Uses firim to upload ipa to fir.im ||         || Created by whlsxl     |+------------------------------------++------------------------+--------------------------+------------------+---------+|         firim Options         |+------------------------+--------------------------+------------------+---------+| Key     | Description    | Env Var   | Default |+------------------------+--------------------------+------------------+---------+| firim_api_token  | fir.im user api token |     |   || firim_username   | fir.im username, a sign |     |   ||      | for identify different |     |   ||      | token     |     |   || ipa     | Path to your ipa file | DELIVER_IPA_PATH |   || icon     | Path to the app icon, |     |   ||      | MUST BE jpg    |     |   || app_identifier   | The app's identifier  |     |   || app_name    | The app's name   |     |   || app_desc    | The app's desc   |     |   || app_short    | The app's short URL  |     |   || app_is_opened   | APP's download link  |     |   ||      | whether opened   |     |   || app_is_show_plaza  | Whether the app show in |     |   ||      | plaza     |     |   || app_passwd    | The app's download page |     |   ||      | password     |     |   || app_store_link_visible | Whether show store link |     |   ||      | in download page   |     |   || app_version   | The app's version  |     |   || app_build_version  | The app's build version |     |   || app_release_type  | The app's release type |     |   ||      | (Adhoc, Inhouse)   |     |   || app_changelog   | The app's changelog  |     |   || app_info_to_file_path | Append all [app's name] |     |   ||      | : [URL] to this file  |     |   |+------------------------+--------------------------+------------------+---------+More information can be found on https://docs.fastlane.tools/actions

firim(firim_api_token: "xxxxxx")#上传fir，如果是新项目，fir会自动创建