fir
fir.im 是一個免費的應用內測平臺,可上傳測試包到 fir 上,然后測試人員就可以下載安裝應用測試了。fir 提供了一個命令行工具
fir-cli,可編譯 iOS/Android 應用,并上傳應用到 fir 平臺上。
安裝 fir-cli
$ gem install fir-cli
獲取 fir 賬號的 token,執行 fir login
,當使用 fir login 登錄了之后, 后續命令都不需要加上 -T 參數, 會默認使用當前用戶的 token 進行相關操作。
$ fir login XXX_YOUR_API_TOKEN_XXX
fir build_ipa 編譯打包 ipa 文件:
schema="testFir"
fir build_ipa ~/Developer/$schema -o ~/Developer/build -w -C Release -S "$schema"
參數說明:-w 是 --workspace 的簡寫,表示編譯 *.xcworkspace, 沒有帶這個參數則編譯 xcodeproj 文件。 -C Release, 以 Release 方式打包,若 Debug 則是打調試包。 -S: 編譯用 CocoaPods 做依賴管理的 .ipa 包。
上傳包命令:
fir publish -c "first version log" ${schema}*.ipa
-c 后帶 log。該命令將上傳上一步生成的 ipa 包。默認的包名是 schema-版本號-build-build 號,如 testFir-2.5.3-build-576.ipa。把這幾行代碼保存成一個 shell 腳本,然后運行這個腳本就可以自動編譯打包并上傳應用到 fir 上,一步到位!
Fastlane
Fastlane 是一個 ruby 腳本集合成的工具套件,旨在實現iOS應用發布流程的自動化。Fastlane 包括了向 App Store 提交新應用或更新已有應用所需要的常用任務。
- gym 編譯打包生成 ipa 文件
- deliver 用于上傳應用的二進制代碼,應用截屏和元數據到 App Store
- sigh 可以生成并下載開發者的 App Store 配置文件
- snapshot 可以自動化iOS應用在每個設備上的本地化截屏過程
使用 gem 安裝 fastlane
sudo gem install fastlane
確保 Xcode 命令行工具已安裝:
xcode-select --install
進入工程目錄,初始化 fastlane 配置,運行命令
fastlane init
如圖
在“Your Apple ID" 這一步輸入蘋果開發者賬號,fastlane 會自動獲取工程文件名,目錄等其他數據。這一步“Please confirm the above values”,確認信息,沒問題則輸入 y。然后,fastlane 會進行一系列的初始化操作,包括下載 App Store 上的元數據和截屏文件。等待初始化完成之后,工程目錄下就多了一個 fastlane目錄:
$ cd fastlane && ls
Appfile Fastfile metadata report.xml
Deliverfile README.md screenshots
metadata 和 screenshots 是目錄,metadata 下會存放元數據文件,包括關鍵詞,版本更新日志等信息。screenshots 下是 App Store 上的截屏圖片。
Appfile 記錄應用的 bundle ID、Apple ID、Team ID,這個文件不用修改。
Fastfile 是執行腳本,有幾個默認的選項,可直接使用。
打包并上傳應用到 Apple TestFlight,運行命令:
$ fastlane beta
打包并上傳應用到 App Store,執行命令
$ fastlane appstore
默認的腳本會上傳元數據、應用截屏圖片到 App Store,但我們可能只想傳包。我們還需要設置版本號和編譯號,這個時候就得修改 Fastfile。
首先在 Fastfile 文件開頭添加一個函數,prepare_version
設置版本號。
default_platform :ios
scheme = "xiaoxinyong"
def prepare_version(options)
increment_version_number(
version_number: options[:version]
)
increment_build_number(
build_number: options[:build]
)
end
編譯生成 ipa 文件,并上傳至 App Store 的部分代碼修改如下:
desc "Deploy a new version to the App Store"
lane :appstore do |options|
# match(type: "appstore")
# snapshot
prepare_version(options)
full_version = options[:version] + '_' + options[:build]
gym(scheme: "#{scheme}",
workspace: "#{scheme}.xcworkspace",
silent: true,
clean: true,
output_directory: "./build",
output_name: "#{scheme}_#{full_version}.ipa" ,
configuration: "Release") # 編譯打包 ipa 文件
deliver(force: true,
skip_screenshots:true,
skip_metadata: true) # 不上傳截屏文件和元數據。
# frameit
end
gym 是編譯打包工具,可設置的參數:
scheme "Example" # 工程名
clean true # 編譯前執行 clean,可減少 ipa 文件大小
output_directory "./build" # 打包后的 ipa 文件存放的目錄
output_name "MyApp" # ipa 文件名
configuration: "Release" # 打包方式,Release 或者 Debug
需要注意的是,用 gym 打包的 ipa 文件會比直接用 Xcode 導出 ipa 文件大,但實際上傳到 App Store 上的文件大小和 Xcode 的差不多。所以如果發現 ipa 文件大了許多,不用在意。
修改完之后,打包并上傳應用到 App Store 的命令如下:
$ fastlane appstore version:2.5.4 build:200
如果我們想讓 build number 自動生成,而不是每次都手動輸入,使用increment_build_number
即可,但我在執行的時候,總會報錯,于是改用其他方式,shell 腳本如下:
#!/bin/sh
#
# usage:
# > sh build_appstore.sh 2.5.4
#
SCHEMA="your schema"
PROJECT_PATH="/Users/your username/Developer/$SCHEMA"
BUILD_PATH="$PROJECT_PATH/build"
echo $PROJECT_PATH
# echo $BUILD_PATH
function useExample {
echo "\nUse Example: sh build_appstore.sh 2.5.4\n"
exit 1
}
[ -z "$1" ] && echo '請輸入版本號' && useExample
PRODUCT_SETTINGS_PATH="$PROJECT_PATH/$SCHEMA/Info.plist"
OLD_NUMBER=`/usr/libexec/PlistBuddy -c "Print CFBundleVersion" "$PRODUCT_SETTINGS_PATH"`
# If the build number key doesn't exist in the plist, we'll add it by setting its initial value to 1.
if [ $? -ne 0 ]; then
STARTING_NUMBER=1
OLD_NUMBER=1
echo "No build number present. Starting from ${STARTING_NUMBER}."
`/usr/libexec/PlistBuddy -c "Add CFBundleVersion string $STARTING_NUMBER" "$PRODUCT_SETTINGS_PATH"`
# exit 0
fi
NEW_NUMBER=$((OLD_NUMBER+=1))
`/usr/libexec/PlistBuddy -c "Set CFBundleVersion $NEW_NUMBER" "$PRODUCT_SETTINGS_PATH"`
[ $? -ne 0 ] && echo "error for increment build number" && exit 1
buildNumber=$NEW_NUMBER # 2000
versionNumber=$1 # 2.5.4
laneName=appstore
echo "build: $buildNumber, version: $versionNumber, lane: $laneName"
fastlane $laneName version:$versionNumber build:$buildNumber
之后要上傳新版本到 App Store,運行如下命令即可:
$ sh build_appstore.sh 2.5.4
有了這幾個腳本,編譯發包只需一條命令,是不是很簡單!
參考鏈接:
使用fastlane實現iOS持續集成
Automating Version and Build Numbers Using agvtool
Automatically Incrementing Version and Build Numbers