使用 Xcode 和 Android Studio 管理 iOS 和 Android 項目版本

在移動應用開發和運營的過程中，版本管理是一個老生常談的基礎問題，一些版本的基本概念也常常會困擾我們的研發和運營人員。同時，手動管理軟件版本，也常常會因為不小心導致后續的發布和更新問題。

這里，我准備了一些 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 中的版本信息：

  1. 打開工程，選擇編譯目標，點擊 Build Phases 選項卡。

     
     

     img_03.png

  2. 點擊左上角的 + 添加，選擇 New Run Script Phase 添加一個編譯腳本。

     
     

     img_04.png
     
     

     img_05.png

  3. 在腳本編輯其中輸入下面的腳本：

      #!/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 中。

  4. 我們需要讓該段代碼在應用打包前執行，以便將修改應用到App包內，因此我們將該編譯過程重命名為 Increase Version Code 並移動到 Copy Bundle Resources之前。

     
     

     img_06.png

  5. 這樣，當我們每次編譯該 Target 時 ，就會執行改腳本將 CFBundleVersion 值增加1，但沒次調試運行時，該值都會加1，這並不是我們想要的，我們只需要在每次打包發布時增加1就行，因此，我們將 Run script only wehn installing 前的勾打上，這樣就只會在打包應用時執行改腳本。

     
     

     img_07.png

• Android Studio
  Android Studio 的 versionCode 自增原理和 Xcode 類似，不同的是我們不能讓編譯腳本修改自身，而是通過一個額外的 Java Properties 來文件存儲版本信息：

  1. 打開工程，選擇 Module: app 的編譯腳本 build.gradle。

     
     

     img_08.png

  2. 找到 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 。

  3. 此時，點擊 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 了，說明該腳本被執行了兩次，但這並不符合我們的預期。

  4. 同 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 ，否則直接使用讀取到的值。

小結

版本管理是產品和項目管理中非常重要的一環，但在開發初期也常常容易被忽略，等到遇到問題時候才感到頭痛。其實，產品經理和開發人員在產品的立項階段就應該對產品版本有一個一致的理解，我個人通常在項目框架建立之初就將這些規則腳本添加到項目文件中，以期降低后續版本維護的成本。