在移動應用開發和運營的過程中,版本管理是一個老生常談的基礎問題,一些版本的基本概念也常常會困擾我們的研發和運營人員。同時,手動管理軟件版本,也常常會因為不小心導致后續的發布和更新問題。
這里,我準備了一些 iOS 和 Android 版本的基礎知識,以及如何在應用中獲取版本信息和如何使用 Xcode 和 Android Studio 自動管理版本號。
版本號解釋
無論是 iOS 還是 Android 都定義了兩個版本屬性:
-
iOS
在Info.plist
中定義CFBundleShortVersionString
在Xcode中解釋為Version
,這個就是我們常說的版本號,一般用戶可見,通常由<主版本號>.<次版本號>.<維護號>
三部分組成,主要用來識別不同時期不同功能的產品。CFBundleVersion
在Xcode中解釋為Build
,一般用于應用市場和程序內部識別版本,作為更新判斷的依據,通常是一個遞增的 INT 類型。
這兩個值可以在 Xcode 的項目信息里面進行管理,
img_01.png
當然,你也可以直接編輯Info.plist
。 -
Android
在AndroidManifest.xml
中定義android:versionName
對應 iOS 中的CFBundleShortVersionString
版本號,用作產品管理。android:versionCode
對應 iOS 中的CFBundleVersion
編譯號,作為內部識別。
在使用 Eclipse 開發時,可以通過直接編輯
AndroidManifest.xml
文件修改,在使用 Android Studio 時,這些信息由 Gradle 腳本管理,找到并打開項目目錄下 app 目錄內的build.gradle
文件,版本信息在defaultConfig
段,
img_02.png
程序內獲取版本信息
一般在應用的關于頁面,我們都會顯示應用的版本,方便客服定位問題,在應用檢查更新時,也常常需要用到版本信息。其實,無論是在 iOS 上,還是 Android 平臺,獲取版本信息都比較簡便:
-
iOS
索引 Bundle 信息中的相關字段:NSBundle *bundle = [NSBundle mainBundle]; NSString *name = [[bundle localizedInfoDictionary] objectForKey:@"CFBundleDisplayName"]; NSString *version = [bundle objectForInfoDictionaryKey:@"CFBundleShortVersionString"]; NSString *build = [bundle objectForInfoDictionaryKey:@"CFBundleVersion"]; NSString *fullVersion = [NSString stringWithFormat:@"version: %@ (%@)", version, build];
上述的代碼中,
name
為本地化的程序名稱,version
為版本號,build
為編譯號,'fullVersion' 則將版本號和編譯號組成一個完整的版本信息。 -
Android
獲取PackageInfo
中的相關信息:PackageInfo pi = sContext.getPackageManager().getPackageInfo(sContext.getPackageName(), 0); String versionName = pi.versionName; int versionCode = pi.versionCode; String fullVersion = String.format("version: %s (%d)", versionName, versionCode);
同樣,
versionName
為版本號,versionCode
為編譯號,不同的是,在 Android 中versionCode
使用 int 類型存儲。
Xcode 和 Android Studio 編譯號自增
一般應用的 版本號 都會由 產品經理 或 項目經理 決定,根據產品所處的階段和功能決定修改版本號的哪一個段。但 編譯號 更多時候是根據每次發布遞增,有時候還會遇到同一個版本號對應多個編譯號的情況,如,緊急修復了一個關鍵 Bug 并更新發布一個版本,但如果每次發布都要手動去修改編譯號回很繁瑣,也很容易忘記和出錯,而不管是 Xcode 還是 Android Studio 都沒有提供自增編譯號的功能,我們只有手動添加編譯腳本來達到自增的目的。
-
Xcode
添加編譯過程,讀取并修改Info.plist
中的版本信息:-
打開工程,選擇編譯目標,點擊
Build Phases
選項卡。
img_03.png -
點擊左上角的 + 添加,選擇
New Run Script Phase
添加一個編譯腳本。
img_04.png
img_05.png -
在腳本編輯其中輸入下面的腳本:
#!/bin/bash buildNumber=$(/usr/libexec/PlistBuddy -c "Print CFBundleVersion" "$INFOPLIST_FILE") buildNumber=$(($buildNumber + 1)) /usr/libexec/PlistBuddy -c "Set :CFBundleVersion $buildNumber" "$INFOPLIST_FILE"
上述腳本使用 PlistBuddy工具,讀取
Info.plist
中的CFBundleVersion
值,+1 后寫回Info.plist
中。 -
我們需要讓該段代碼在應用打包前執行,以便將修改應用到App包內,因此我們將該編譯過程重命名為
Increase Version Code
并移動到Copy Bundle Resources
之前。
img_06.png -
這樣,當我們每次編譯該 Target 時 ,就會執行改腳本將
CFBundleVersion
值增加1,但沒次調試運行時,該值都會加1,這并不是我們想要的,我們只需要在每次打包發布時增加1就行,因此,我們將Run script only wehn installing
前的勾打上,這樣就只會在打包應用時執行改腳本。
img_07.png
-
-
Android Studio
Android Studio 的 versionCode 自增原理和 Xcode 類似,不同的是我們不能讓編譯腳本修改自身,而是通過一個額外的 Java Properties 來文件存儲版本信息:-
打開工程,選擇
Module: app
的編譯腳本build.gradle
。
img_08.png -
找到
defaultConfig
段,替換為下面的腳本:def versionPropsFile = file('version.properties') if (versionPropsFile.canRead()) { Properties versionProps = new Properties() versionProps.load(new FileInputStream(versionPropsFile)) def verCode = versionProps['VERSION_CODE'].toInteger() versionProps['VERSION_CODE'] = (++verCode).toString() versionProps.store(versionPropsFile.newWriter(), null) defaultConfig { applicationId "com.example.versionexample" minSdkVersion 19 targetSdkVersion 23 versionCode verCode versionName "1.0.1" } } else { throw new GradleException("Could not read version.properties!") }
這段腳本會打開 app 目錄下的
version.properties
配置文件,讀取VERSION_CODE
字段并增加1后寫回,同時將值賦給defaultConfig
中的versionCode
。 -
此時,點擊 Sync 會報錯
Could not read version.properties!
,這是我們剛剛在腳本中拋出的,原因是找不到version.properties
文件,我們需要新建一個。打開命令行定為到項目目錄下:$ cd app/ $ echo "VERSION_CODE=1" > version.properties
再次點擊 Sync 就不會報錯了。查看
version.properties
文件,$ cat version.properties #Mon Nov 02 15:18:49 CST 2015 VERSION_CODE=3
發現 VERSION_CODE 已經增加到 3 了,說明該腳本被執行了兩次,但這并不符合我們的預期。
-
同 Xcode 中一樣,我們期望僅僅在應用打包時將
versionCode
增加 1 。因此我們需要獲取編譯參數,僅當release
時才將versionCode
增加 1 。修改后的腳本如下:def versionPropsFile = file('version.properties') if (versionPropsFile.canRead()) { Properties versionProps = new Properties() versionProps.load(new FileInputStream(versionPropsFile)) def verCode = versionProps['VERSION_CODE'].toInteger() def runTasks = gradle.startParameter.taskNames if (':app:assembleRelease' in runTasks) { versionProps['VERSION_CODE'] = (++verCode).toString() versionProps.store(versionPropsFile.newWriter(), null) } defaultConfig { applicationId "com.example.versionexample" minSdkVersion 19 targetSdkVersion 23 versionCode verCode versionName "1.0.1" } } else { throw new GradleException("Could not read version.properties!") }
這里獲取當前task的名稱,僅當task包含
:app:assembleRelease
時才會將versionCode
加 1 ,否則直接使用讀取到的值。
-
小結
版本管理是產品和項目管理中非常重要的一環,但在開發初期也常常容易被忽略,等到遇到問題時候才感到頭痛。其實,產品經理和開發人員在產品的立項階段就應該對產品版本有一個一致的理解,我個人通常在項目框架建立之初就將這些規則腳本添加到項目文件中,以期降低后續版本維護的成本。