React Native開發中自動打包指令碼

光強發表於2018-09-07
React Native指令碼

React Native開發中自動打包指令碼

在日常的RN開發中，我們避免不了需要將我們編寫的程式碼編譯成安裝包，然後生成二維碼，供需要測試的人員掃描下載。但是對於非原生的開發人員來說，可能不知如何使用Xcode或者Android studio來匯出ipa、apk安裝包，為了解決非原生開發的同學們打安裝包的痛苦，這裡作者就提供一個shell指令碼檔案來實現一鍵式自動打包並生成安裝二維碼 (這裡上傳安裝包生成二維碼需要藉助於三方平臺fir.im)

打包指令碼檔案下載地址

https://github.com/guangqiang-liu/AutoPackageScript

iOS

指令碼執行效果

gif
gif

使用指令碼注意事項

  • 指令碼配置環境變數中，is_workspace ：如果是使用pod進行管理三方庫就賦值為true，否則是false
  • firim_token：fir_token請設定成自己的token，fir im_token如何獲取請參考fir官網https://fir.im/
  • scheme_name：請更換為自己專案的scheme名稱
  • info_plist_name：請更換為自己專案中的plist檔名稱
  • 如果沒有註冊登入fir.im的同學們，請先去註冊登入fir.im，相關操作請參照fir.im官方文件
  • 指令碼資料夾放在專案的跟目錄下即可
  • 除了is_workspace firim_token scheme_name info_plist_name 這四個變數需要改為自己的，其它的地方指令碼不需要修改
  • 在打包之前請確保iOS除錯證書有效
  • fir.im 的token和註冊登入流程是可有可無的，如果之前沒有使用過fir.im的同學們也可以忽略fir.im相關的操作，因為fir.im只是輔助將生成的ipa安裝包檔案上傳到fir, 然後生成一個可以掃碼安裝的二維碼而已，不使用fir.im 不影響生成ipa，只是不會生成安裝二維碼

特別注意（指令碼存放路徑）：

img
img

如何使用指令碼檔案

  • 將下載下來的指令碼資料夾整個拖進自己的iOS工程的專案根目錄下
  • 開啟終端，進入到指令碼檔案 autoPackageScript.sh 所在的目錄
  • 執行指令碼 sh autoPackageScript.sh
  • 等待打包生成ipa和二維碼，這裡預設打包後的檔案會存放在桌面

核心指令碼程式碼

#!/bin/sh

#  autoPackageScript.sh
#  LSBuyer
#
#  Created by 劉光強 on 2017/6/3.
#  Copyright © 2017年 Facebook. All rights reserved.

envionmentVariables() {

    # ==================== 工程配置環境變數 ==================== #

    echo " 33[37;45m*************************  step1:初始化環境變數 ? ? ?  *************************   33[0m"

    sleep 0.5
    # 計時
    SECONDS=0
    # 工作空間 (例:若是用Cocopods管理的.xcworkspace專案,賦值true;用Xcode預設建立的.xcodeproj,賦值false)
    is_workspace="false"
    # 指定要打包編譯的方式 : Release or Debug (預設是Release)
    build_configuration="Release"
    # fir賬戶的token, 這個token換成自己fir賬號生成的token即可
    firim_token="1b91e3f54c6e6b106be7afdd13674a43"

    # 打包指令碼資料夾路徑
    script_path=$(pwd)
    # 指定專案的scheme名稱（預設為one，需要再次賦值）
    scheme_name="one"
    # 工程中Target對應的配置plist檔名稱, Xcode預設的配置檔案為info.plist (需要再次賦值)
    info_plist_name="info"
    # 匯出ipa所需要的對應的plist檔案路徑 (預設為EnterpriseExportOptionsPlist.plist)
    ExportOptionsPlistPath="$script_path/EnterpriseExportOptionsPlist.plist"

    # 返回上上級目錄,進入專案工程根目錄
    cd ..
    cd ..
    # 工程根目錄
    project_dir=$(pwd)
    # 獲取工程名稱（LSBuyer）
    project_name=`find . -name *.xcodeproj | awk -F "[/.]" `{print $(NF-1)}``

    # Dev,Pre,Pro三種環境
    echo " 33[31;1m請選擇打包型別(輸入序號,按回車即可)  33[0m"
    echo " 33[31;1m1. 測試        33[0m"
    echo " 33[31;1m2. 預發     33[0m"
    echo " 33[31;1m3. 生產   33[0m"

    # 捕獲使用者鍵盤輸入
    read packageType
    sleep 0.5
    method="$packageType"

    # 判斷使用者是否有輸入
    if [ -n "$method" ] ; then
        if [ "$method" = "1" ] ; then
            ExportOptionsPlistPath="$script_path/EnterpriseExportOptionsPlist.plist"
            # 根據使用者選擇的打包型別來設定對應的scheme和plist檔案
            scheme_name="one"
            info_plist_name="info"
        elif [ "$method" = "2" ] ; then
            ExportOptionsPlistPath="$script_path/EnterpriseExportOptionsPlist.plist"
            scheme_name="LSBuyerPre"
            info_plist_name="LSBuyerPre"
        elif [ "$method" = "3" ] ; then
            ExportOptionsPlistPath="$script_path/AppStoreExportOptionsPlist.plist"
            scheme_name="LSBuyer"
            info_plist_name="Info"
        else
            echo " 33[37;45m*************************  你是不是瞎，是不是瞎  ? ? ?  *************************   33[0m"
            exit 1
        fi
    fi

    # 獲取對應的plist檔案
    info_plist_path="$project_dir/$project_name/$info_plist_name.plist"

    # 對應plist中的Bundle versions string, short
    bundle_short_version=`/usr/libexec/PlistBuddy -c "Print CFBundleShortVersionString" "$info_plist_path"`
    # 對應plist中的Bundle version
    bundle_version=`/usr/libexec/PlistBuddy -c "Print CFBundleVersion" "$info_plist_path"`

    # 指定輸出ipa資料夾路徑 (需要再次賦值)
    export_path=~/Desktop/$scheme_name-IPA
    # 指定輸出xcarchive路徑
    export_archive_path="$export_path/$scheme_name.xcarchive"
    # 刪除舊.xcarchive檔案
    rm -rf "$export_archive_path"

    # 指定輸出ipa路徑
    export_ipa_path="$export_path"
    # 指定輸出ipa名稱 : scheme_name + bundle_short_version (需要重新賦值)
    ipa_name="$scheme_name-v$bundle_short_version"

}

Xcodebuild() {

    echo " 33[37;45m*************************  step2:開始構建專案 ? ? ?  *************************   33[0m"
    sleep 1
    if [ -d "$export_path" ]; then
        echo $export_path
    else
        mkdir $export_path
    fi

    # 判斷編譯的專案型別是workspace還是project
    if $is_workspace ; then
        # 編譯前做clear操作
        xcodebuild clean -workspace ${project_name}.xcworkspace 
        -scheme ${scheme_name} 
        -configuration ${build_configuration}
        # archive操作
        xcodebuild archive -workspace ${project_name}.xcworkspace 
        -scheme ${scheme_name} 
        -configuration ${build_configuration} 
        -archivePath ${export_archive_path}
    else
        xcodebuild clean -project ${project_name}.xcodeproj 
        -scheme ${scheme_name} 
        -configuration ${build_configuration}

        xcodebuild archive -project ${project_name}.xcodeproj 
        -scheme ${scheme_name} 
        -configuration ${build_configuration} 
        -archivePath ${export_archive_path}
    fi

    #  檢查是否構建成功
    #  xcarchive 是一個資料夾不是一個檔案所以使用 -d 判斷
    if [ -d "$export_archive_path" ] ; then
        echo " 33[37;45m專案構建成功 ? ? ?   33[0m"
    else
        echo " 33[37;45m專案構建失敗 ? ? ?   33[0m"
        exit 1
    fi

}

ExportArchive() {
    echo " 33[37;43m*************************  step3:開始匯出ipa檔案 ? ? ?  *************************   33[0m"
    sleep 0.5
    # 匯出ipa
    xcodebuild  -exportArchive 
    -archivePath ${export_archive_path} 
    -exportPath ${export_ipa_path} 
    -exportOptionsPlist ${ExportOptionsPlistPath}

    # 修改ipa檔名稱
    mv $export_ipa_path/$scheme_name.ipa $export_ipa_path/$ipa_name.ipa
    # 檢查檔案是否存在
    if [ -f "$export_ipa_path/$ipa_name.ipa" ] ; then
        echo " 33[37;45m匯出 ${ipa_name}.ipa 包成功 ?  ?  ?    33[0m"
    else
        echo " 33[37;45m匯出 ${ipa_name}.ipa 包失敗 ? ? ?      33[0m"
        exit 1
    fi
    # 輸出打包總用時
    echo " 33[37;46m總用時: ${SECONDS}s  33[0m"
    open $export_path

}

previewIPAInfo() {
    echo " 33[37;43m*************************  step4:預覽IPA資訊 ? ? ?  *************************   33[0m"
    fir info $export_ipa_path/$ipa_name.ipa

}

publishIPAToFir() {
    echo " 33[37;43m*************************  step5:上傳中 ? ? ?  *************************   33[0m"
    echo " 33[37;43m*************************  step4:預覽使用者登入資訊 ? ? ?  *************************   33[0m"
    fir login "$firim_token"
    fir publish $export_ipa_path/$ipa_name.ipa -Q
    echo " 33[37;43m*************************  step6:上傳完成 ? ? ?  *************************   33[0m"
    # 輸出總用時
    echo " 33[37;46m總用時: ${SECONDS}s ? ? ?  33[0m"
    open $export_path

}

envionmentVariables
Xcodebuild
ExportArchive
previewIPAInfo
publishIPAToFir

Android

執行指令碼效果

gif
gif

注意事項

  • 環境配置項中的 firim_token：換成自己的token
  • fir.im的註冊與登入操作同iOS操作，詳細參考fir.im官方文件 教程
  • apk預設匯出路徑為：app/build/outputs/apk
  • 打包前請確保jks簽名是否有效，如果有對生成 jks 簽名檔案不熟悉的同學，請檢視作者對生成jks簽名檔案的講解：https://www.jianshu.com/p/b28a5be05029
  • 指令碼檔案存放的路徑，最好放在專案根目錄下，也即是與 settings.gradle 檔案同級目錄
  • fir.im 的token和註冊登入流程是可有可無的，如果之前沒有使用過fir.im的同學們也可以忽略fir.im相關的操作，因為fir.im只是輔助將生成的ipa安裝包檔案上傳到fir, 然後生成一個可以掃碼安裝的二維碼而已，不使用fir.im 不影響生成ipa，只是不會生成安裝二維碼
img
img

如何執行指令碼

  • 將下載的指令碼資料夾中的 autoPackage.sh 檔案 拖到Android 專案的根目錄下
  • 開啟終端，進入到 autoPackage.sh 指令碼檔案所在的目錄
  • 執行指令碼 sh autoPackage.sh
  • 等待指令碼執行，打包生成的apk檔案與二維碼統一存放在 /build/outputs/apk 路徑下

核心指令碼程式碼

#!/bin/sh

#  autoPackage.sh
#  CRM
#
#  Created by 劉光強 on 2017/6/19.
#  Copyright © 2017年 Facebook. All rights reserved.

#  ******************** 安卓一鍵式打包並上傳到fir生成二維碼並直接掃描安裝 ********************

# 預先定義對應的環境變數
envionmentVariables(){

# 打包時間初始值
SECONDS=0
# 當前的路徑
pwd
#安卓專案工程路徑
android_project_path=$(pwd)
# 安卓apk目錄路徑
apk_dir_path="$android_project_path/app/build/outputs/apk"
# apk 路徑
apk_path="$apk_dir_path/app-dev-release.apk"
# fir賬戶的token,這個token換成自己fir賬號生成的token即可
firim_token="1b91e3f54c6e6b106be7afdd13674a43"
}

apkBuild(){

# 刪除老的apk
rm -rf $apk_path
cd "$android_project_path"
echo " 33[37;45m打包開始！！！ ?  ?  ?    33[0m"
sleep 1
# 執行安卓打包指令碼
./gradlew assembleRelease
# 檢查apk檔案（app-LSW-release.apk）是否存在
if [ -f "$apk_path" ]; then
echo "$apk_path"
echo " 33[37;45m打包成功 ?  ?  ?    33[0m"
sleep 1
else
echo " 33[37;45m沒有找到對應的apk檔案 ? ? ?    33[0m"
exit 1
fi
}

# 預覽apk資訊
previewIPAInfo(){
echo " 33[37;43m*************************  step4:預覽apk資訊 ? ? ?  *************************   33[0m"
fir info $apk_path
sleep 1
}

# 將apk目錄下的app-LSW-release.apk 上傳到fir
publishIPAToFir(){

open $apk_dir_path
echo " 33[37;43m*************************  step5:上傳中 ? ? ?  *************************   33[0m"
echo " 33[37;43m*************************  step4:預覽使用者登入資訊 ? ? ?  *************************   33[0m"
fir login "$firim_token"
fir publish $apk_path -Q
echo " 33[37;43m*************************  step6:上傳完成 ? ? ?  *************************   33[0m"
# 輸出總用時
echo " 33[37;46m總用時: ${SECONDS}s ? ? ?  33[0m"
open $apk_dir_path
}

envionmentVariables
apkBuild
previewIPAInfo
publishIPAToFir

待完成

  • 將打包指令碼與Jenkins結合實現動態構建

更多文章

  • 作者React Native開源專案OneM【500+ star】地址(按照企業開發標準搭建框架完成開發的)：https://github.com/guangqiang-liu/OneM：歡迎小夥伴們 star
  • 作者簡書主頁：包含60多篇RN開發相關的技術文章http://www.jianshu.com/u/023338566ca5歡迎小夥伴們：多多關注，多多點贊
  • 作者React Native QQ技術交流群：620792950 歡迎小夥伴進群交流學習
  • 友情提示：在開發中有遇到RN相關的技術問題，歡迎小夥伴加入交流群（620792950），在群裡提問、互相交流學習。交流群也定期更新最新的RN學習資料給大家，謝謝大家支援！

小夥伴們掃下方二維碼加入RN技術交流QQ群

QQ群二維碼，500+ RN工程師在等你加入哦
QQ群二維碼，500+ RN工程師在等你加入哦

相關文章