Fastlane - 從創(chuàng)建證書到上傳到App Store

簡(jiǎn)介

fastlane是一套使用Ruby寫的自動(dòng)化工具集遍搞，用于iOS和Android的自動(dòng)化簽名、配置清笨、打包月杉、發(fā)布等工作
為什么要用fastlane？
因?yàn)橐恍忻罹涂梢詫?shí)現(xiàn)編譯抠艾、打包(ad-hoc&app store)苛萎、發(fā)布（蒲公英、App Store）检号，剩下的時(shí)間你就可以愉快地喝茶看新聞了腌歉。而且配合Jenkins可以很好地實(shí)現(xiàn)持續(xù)集成，舉個(gè)例子：在公司的Gitlab上打一個(gè)v開頭的tag齐苛，就會(huì)自動(dòng)編譯打包新版本啦

話不多說直接進(jìn)入實(shí)戰(zhàn)環(huán)節(jié)翘盖，其他介紹可參考：blog.devzeng.com
安裝fastlane：

sudo gem install fastlane

注：下文的PROJECT_DIR指的是工程根目錄，eg:/Users/pan/Documents/Project/Demo/FastLaneDemo2

初始化fastlane

先創(chuàng)建工程或打開工程凹蜂，這里以創(chuàng)建FastLaneDemo2為例馍驯，在Xcode創(chuàng)建FastLaneDemo2之后，先取消Xcode自動(dòng)管理簽名選項(xiàng)：

工程設(shè)置.png

初始化fastlane炊甲，終端運(yùn)行：

fastlane init

終端： What would you like to use fastlane for?
你：選擇 3. ?? Automate App Store distribution泥彤，即發(fā)布自動(dòng)化，這里主要是想自動(dòng)配置開發(fā)者賬號(hào)
終端：Please enter your Apple ID developer credentials Apple ID Username:
你：輸入自己的AppleID（開啟兩步驗(yàn)證的賬號(hào)要輸入驗(yàn)證碼）
終端：Do you want fastlane to create the App ID for you on the Apple Developer Portal? (y/n)
你：輸入n卿啡，不在Apple Developer創(chuàng)建應(yīng)用
終端：Would you like fastlane to create the App on iTunes Connect for
you? (y/n)
你：輸入n吟吝，不在iTunes Connect 創(chuàng)建應(yīng)用
終端：Continue by pressing Enter ?
你：三次Enter鍵
執(zhí)行完這幾部就會(huì)發(fā)現(xiàn)工程根目錄新增了fastlane文件夾，打開PROJECT_DIR/fastlane/Appfile 文件颈娜，會(huì)發(fā)現(xiàn)開發(fā)者賬號(hào)配置完畢：

app_identifier("com.showu.FastlaneDemo2") # 你的應(yīng)用的 bundle identifier 
apple_id("3*******5@qq.com") # 你的AppleID郵箱

itc_team_id("11*****78") # iTunes Connect Team ID
team_id("6FB****FUR") # Developer Portal Team ID

在Apple Developer和iTunesConnect創(chuàng)建App

在PROJECT_DIR/fastlane/Fastfile 文件增加：createApp Action

    #在iTunesConnect創(chuàng)建App
    #如果出現(xiàn)The app name you entered is already being used錯(cuò)誤請(qǐng)更換app_name值
    #push_notification: "on"表示App開啟通知功能
    lane :createApp do
        produce(
            username: '3*******5@qq.com',
            app_identifier: 'com.showu.FastLaneDemo2',
            app_name: 'FastLaneDemo2018',
            language: 'English',
            #如果只在AppleDeveloper創(chuàng)建app剑逃，不在iTunesConnect創(chuàng)建app的話
            #skip_itc: true,
            app_version: '1.0',
            enable_services: {
                app_group: "on",
                push_notification: "on",
            }
        )
    end

這里用到了fastlane的第一個(gè)工具：produce（←push_notification等更多參數(shù)配置請(qǐng)戳進(jìn)去查看）。作用是使用命令行在iTunes Connect和Dev Portal上創(chuàng)建新的iOS應(yīng)用程序

終端輸入

fastlane createApp

刷新Apple Developer和iTunesConnect官網(wǎng)官辽，會(huì)發(fā)現(xiàn)新增了一個(gè)App：FastLaneDemo2018

創(chuàng)建蛹磺、下載、安裝Provisioning Profiles

PROJECT_DIR/fastlane/Fastfile 文件增加：adhoc_profile Action

    #下載provisioning_profile
    lane :adhoc_profile do
        #如果沒有在Apple Developer創(chuàng)建證書的話同仆，get_certificates會(huì)幫你自動(dòng)創(chuàng)建證書
        get_certificates
        sigh(
            username: '3*******5@qq.com',
            app_identifier: 'com.showu.FastLaneDemo2',
            force: true,
            provisioning_name: 'com.showu.FastLaneDemo2_AdHoc',
            ignore_profiles_with_different_name: true,
            adhoc: true
        )
    end

終端輸入

fastlane adhoc_profile

小插曲：

{"responseId"=>"2914996e-aaef-47d8-b279-f0ca557275a4", "resultCode"=>35, "resultString"=>"There were errors in the data supplied. Please correct and re-submit.", "userString"=>"There are no current IOS devices on this team matching the provided device IDs.", "creationTimestamp"=>"2018-06-04T09:11:01Z", "protocolVersion"=>"QH65B2", "userLocale"=>"en_US", "requestUrl"=>"https://developer.apple.com/services-account/QH65B2/account/ios/profile/createProvisioningProfile.action", "httpCode"=>200, "validationMessages"=>[{"validationKey"=>"deviceIds", "validationUserMessage"=>"There are no current IOS devices on this team matching the provided device IDs."}]}

原因：There are no current IOS devices on this team matching the provided device IDs.
因?yàn)橛玫氖切碌拈_發(fā)者賬號(hào)萤捆，所以AppleDeveloper沒有添加設(shè)備，所以需要添加至少一臺(tái)設(shè)備才能打Ad-Hoc包
既然用了fastlane俗批，咱就可以用命令行來做這個(gè)操作：

添加Devices到AppleDeveloper

創(chuàng)建一個(gè)制表符tab分隔的文件devices.txt如下：

Device ID   Device Name
6ccb3dc72b0c574fa5e****29d3cad609d3cb080    Pan
4af771e47a9067610d****846be8ea5f9bc0faa1    Yan

注意：
要放在PROJECT_DIR路徑下面俗或，每行包含一個(gè)設(shè)備ID和一個(gè)設(shè)備名稱。您可以將第一行用于標(biāo)題岁忘，因?yàn)樵撔性诜治鰰r(shí)會(huì)被忽略辛慰。
第二行是設(shè)備ID和自定義名稱，中間要加tab符號(hào)干像，推薦使用Sublime Text文本編輯器
打開AppleDeveloper的TXT文件帅腌，參考：help.apple.com

PROJECT_DIR/fastlane/Fastfile文件增加：add_device action

    lane :add_device do
        register_devices(
            devices_file: "./devices.txt"
        ) 
    end

終端輸入

fastlane add_device

設(shè)備添加成功驰弄！

重新下載安裝provisioning profile：

fastlane adhoc_profile

會(huì)發(fā)現(xiàn)工程根目錄多了AdHoc_com.showu.FastLaneDemo2.mobileprovision文件，現(xiàn)在我們就可以愉快地打包了

打Ad-Hoc包

如果有多個(gè)Target速客，需要先設(shè)置scheme戚篙，參考：developer.apple.com
Product > Schemes > Manage Schemes, 點(diǎn)擊 '+' 按鈕, 選擇自己剛才新建的target (FastLaneDemoDev)，點(diǎn)擊 'OK' 按鈕挽封，右側(cè)的Shared選項(xiàng)記得勾上

PROJECT_DIR/fastlane/Fastfile文件增加：adhoc Action

    #打ad-hoc包
    lane :adhoc do
        #build_app 是gym的別名已球，可以換成gym
        build_app(
            scheme: "FastLaneDemoDev",
            export_method: "ad-hoc"
        )
        
    end

然后打開Xcode工程臣镣，選擇合適的配置文件：

選擇合格的配置辅愿，請(qǐng)忽略細(xì)節(jié).png

終端輸入：

fastlane adhoc

即可在工程根目錄看到生成的ipa

如果需要上傳ipa到蒲公英，可先安裝蒲公英的 Fastlane 插件忆某，終端輸入：

fastlane add_plugin pgyer

會(huì)在PROJECT_DIR/fastlane/新增Pluginfile文件点待、修改Gemfile文件
修改PROJECT_DIR/fastlane/Fastfile文件，增加如下action弃舒，增加上傳到蒲公英功能癞埠，參數(shù)獲取請(qǐng)參考：蒲公英官網(wǎng)

    #打ad-hoc包
    lane :adhoc do
        #build_app 是gym的別名，可以換成gym
        build_app(
            scheme: "FastLaneDemoDev",
            export_method: "ad-hoc"
        )
        #上傳到蒲公英
        pgyer(api_key: "c9f01d6**************c206ea2cd", user_key: "2dfd4fc**************c7b758b1")
        # upload_to_app_store(skip_metadata: true, skip_screenshots: true)
    end

打App Store包

修改PROJECT_DIR/fastlane/Fastfile文件聋呢，增加如下action

lane :appstore_ipa do
    #下載安裝provisioning profile
    sigh(
      username: '3*******3@qq.com',
      app_identifier: 'com.*****.FastlaneDemo1',
      force: true,
      provisioning_name: 'com.*****.FastlaneDemo1 AppStore',
      ignore_profiles_with_different_name: true,
    )
    gym(
      scheme: "FastlaneDemo1",
      export_method: "app-store",
      #如果用到了LLVM混淆工具的話可以指定toolchain(下面是https://github.com/HikariObfuscator/Hikari)：
      #toolchain:"com.naville.hikari",
      output_name:"FastlaneDemo1_AppStore.ipa"
    )
  end

然后打開Xcode工程苗踪，在Target - General - Signing(Release) 選擇合適的配置文件（同上），運(yùn)行fastlane appstore_ipa即可生成ipa

上傳ipa到iTunesConnect

在PROJECT_DIR/fastlane/Fastfile文件新增以下Action：

    lane :upload do
        # upload_to_app_store
        # submit_for_review：上傳完成后提交新版本進(jìn)行審查削锰，這里選擇不通铲，提交審核前自己檢查下
        # force:跳過HTML報(bào)告文件驗(yàn)證
        # ignore_language_directory_validation：在元數(shù)據(jù)和screeenshot目錄中發(fā)現(xiàn)無效語言時(shí)忽略錯(cuò)誤
        deliver(
            submit_for_review: false,
            force: true,
            ignore_language_directory_validation:true,
            metadata_path: "./metadata"
        )
    end

這里用到了一個(gè)deliver工具，可上傳二進(jìn)制文件到iTunesConnect器贩，我這里忽略了商店截圖等參數(shù)的配置颅夺，直接上傳二進(jìn)制文件，如果不想登錄iTunesConnect一個(gè)個(gè)地設(shè)置請(qǐng)參考(deliver章節(jié)](https://docs.fastlane.tools/actions/deliver/)蛹稍，這樣在本地填好了txt文本就可以自動(dòng)幫你填寫提交審核需要的資料了
終端運(yùn)行fastlane upload吧黄，幾分鐘后就可以在構(gòu)建版本里看到了

當(dāng)然，你也可以把前面的所有action實(shí)現(xiàn)組合一下唆姐，用一個(gè)新action代替

其他實(shí)用Action

生成不同尺寸的icon

準(zhǔn)備一張1024*1024的圖片拗慨，放到根目錄，
先安裝appicon插件奉芦，更多參數(shù)請(qǐng)參考appicon README：

fastlane add_plugin appicon

再在PROJECT_DIR/fastlane/Fastfile文件新增以下代碼：

    lane :generate_icon do 
    #執(zhí)行自定義腳本赵抢，比如修改啟動(dòng)頁圖片
    # sh "your_shell.sh"
    #如果支持iPad請(qǐng)使用[:ipad, :iphone, :ios_marketing]
    appicon(
      appicon_image_file: './AppIcon.png',
      appicon_devices: [:iphone, :ios_marketing],
      appicon_path: 'FastlaneDemo2/Assets.xcassets'
    )
  end

運(yùn)行fastlane generate_icon，即可在Xcode工程生成各種尺寸的icon

Fastlane - 從創(chuàng)建證書到上傳到App Store

Fastlane - 從創(chuàng)建證書到上傳到App Store

簡(jiǎn)介

初始化fastlane

在Apple Developer和iTunesConnect創(chuàng)建App

創(chuàng)建蛹磺、下載、安裝Provisioning Profiles

添加Devices到AppleDeveloper

打Ad-Hoc包

打App Store包

上傳ipa到iTunesConnect

其他實(shí)用Action

生成不同尺寸的icon

更多使用指令仗阅，請(qǐng)去官網(wǎng)探索吧昌讲！

推薦閱讀更多精彩內(nèi)容