Fastlane- app自動編譯、打包多個版本、上傳到app store


Fastlane是一套使用Ruby寫的自動化工具集,用於iOS和Android的自動化打包、發布等工作,可以節省大量的時間。

Github:https://github.com/fastlane/fastlane

官網:https://fastlane.tools/

文檔:https://docs.fastlane.tools/

安裝

1、首先要安裝正確的 Ruby 版本。在終端窗口中用下列命令來確認:

ruby -v

2、然后檢查 Xcode 命令行工具是否安裝。在終端窗口中輸入命令:

xcode-select --install

如果未安裝,終端會開始安裝,如果報錯誤:command line tools are already installed, use "Software Update" to install updates.代表已經安裝。

3、以上依賴配置好之后就可以通過 rubygem 進行安裝了:

$ sudo gem install fastlane

安心等待一會,fastlane就安裝完成了。

初始化

進入到工程目錄執行:

 

fastlane init

 

中間需要輸入開發者賬號、密碼。

初始化之后目錄下多了一個fastlane目錄,內容:

Appfile

Appfile用來存放app_identifier,apple_id和team_id。 了解詳情,它的格式是這樣的:

app_identifier "com.xxx.xxx" # app的bundle identifier
apple_id "xxx@xxx.com" # 你的Apple ID
 
team_id "XXXXXXXXXX" # Team ID

你也可以為每個lane(后面會講到)提供不同的 app_identifier, apple_id 和 team_id,例如:

app_identifier "com.aaa.aaa"
apple_id "aaa@aaa.com"
team_id "AAAAAAAAAA"
 
for_lane :inhouse do
  app_identifier "com.bbb.bbb"
  apple_id "bbb@bbb.com"
  team_id "AAAAAAAAAA"
end

這里就是為Fastfile中定義的:inhouse設置單獨的信息。

Fastfile

Fastfile管理你所創建的 lane ,了解詳情。它的格式是這樣的:

···
# 自動更新fastlane 工具
# update_fastlane
 
#需要的fastlane的最小版本,在每次執行之后會檢查是否有新版本,如果有會在最后末尾追加新版本提醒
fastlane_version "2.30.1"
 
#默認使用平台是 ios,也就是說文件可以定義多個平台
default_platform :ios
 
platform :ios do
  before_all do
    # ENV["SLACK_URL"] = "https://hooks.slack.com/services/..."
    cocoapods
 
  end
 
  desc "Runs all the tests"
  lane :test do
    scan
  end
 
  desc "提交一個新的Beta版本到 Apple TestFlight"
  desc "This will also make sure the profile is up to date"
  lane :beta do
    # match(type: "appstore") # more information: https://codesigning.guide
    gym(scheme: "Docment") # Build your app - more options available
    pilot
 
    # sh "your_script.sh"
  end
 
  desc "部署一個新版本到App Store"
  lane :release do
    # match(type: "appstore")
    # snapshot
    gym(scheme: "Docment") # Build your app - more options available
    deliver(force: true)
    # frameit
  end
 
  # 你可以定義自己的lane
 
  #執行lane成功后的回調
  after_all do |lane|
    # slack(
    #   message: "Successfully deployed new App Update."
    # )
  end
 
  # 如果流程發生異常會走這里並終止
  error do |lane, exception|
    # slack(
    #   message: exception.message,
    #   success: false
    # )
  end
end

我們也可以定義一個自己的lane:

 desc "企業版"
  lane :inHouse do
  gym(scheme: "XXX",
      export_method:"enterprise",
      output_directory "./build", # 打包后的 ipa 文件存放的目錄
      output_name "XXX"  # ipa 文件名
   )
  end

其中一個lane就是一個任務,里面是一個個的action組成的工作流。

 

修改項目版本號:

修改Build Settings中的Versioning配置,Current Project Version隨便填一個,Versioning System選擇Apple Generic。

def prepare_version(options)
    increment_version_number(
       version_number: options[:version]
     )

     increment_build_number(
       build_number: options[:build]
    )
  end

 

利用目前支持的工具可以做所有包含自動化和可持續化構建的每個環節,例如:

  • scan 自動化測試工具,很好的封裝了 Unit Test

  • sigh 針對於 iOS 項目開發證書和 Provision file 的下載工具

  • match 同步團隊每個人的證書和 Provision file 的超贊工具

  • gym 針對於 iOS 編譯打包生成 ipa 文件

  • deliver 用於上傳應用的二進制代碼,應用截屏和元數據到 App Store

  • snapshot 可以自動化iOS應用在每個設備上的本地化截屏過程

執行

定義完lane之后怎么執行呢?打開終端,切換到項目的根目錄:執行fastlane lane'name就可以了。成功之后會在相應的路徑下生成ipa文件,如果報錯的話就根據錯誤信息好好查看文檔

其他

1、這里是官方提供的一些例子

2、想了解fastlane命令的話可以執行$ fastlane --help

3、查看可用任務的列表,可以執行命令$ fastlane lanes

4、fastlane也提供了很多插件方便我們使用,例如pgyer(發布app到蒲公英)。我們也可以打完包直接傳到蒲公英上,具體的可以看蒲公英提供的文檔

如果你感覺有些插件不符合自己的情況,你甚至可以自定義插件

5、多個 lane 的話實際上是可以相互調用的,這個其實特別實用。例如:

default_platform :ios
 
platform :ios do
 
  lane :prepare do
    cocoapods
    match
  end
 
 
  desc 'fastlane build'   'fastlane build type:adhoc'
  lane :build do |options|
    # 調用上面的 prepare 任務
    prepare
 
    case options[:type]
    when 'adhoc'
      adhoc
    else
      appstore
    end
  end
 
 
  lane : adhoc do
  ···
  end
 
  lane : appstore do
  ···
  end
 
end

6、我們可以在 Fastfile 文件中添加一個函數來設置version號和build號。

default_platform :ios
 
def prepare_version(options)
    increment_version_number(
        version_number: options[:version]
    )
 
    increment_build_number(
        build_number: options[:build]
    )
end

然后可以在一個lane中使用這個函數:

lane :appstore do |options|
   ···
    prepare_version(options)
   ···
end

然后執行這個lane的時候:

    
$ fastlane appstore version:2.4.0 build:2.0

Fastlane能做的事情還有很多,大家可以去好好看看文檔,研究一些高級的用法吧!

 


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM