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

小結

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

最后編輯于
?著作權歸作者所有,轉載或內容合作請聯系作者
平臺聲明:文章內容(如有圖片或視頻亦包括在內)由作者上傳并發布,文章內容僅代表作者本人觀點,簡書系信息發布平臺,僅提供信息存儲服務。

推薦閱讀更多精彩內容

  • Android 自定義View的各種姿勢1 Activity的顯示之ViewRootImpl詳解 Activity...
    passiontim閱讀 173,287評論 25 708
  • 近期有一個工作任務:按照某個規則,給Android應用設置一個在編譯時自動生成的versionCode與versi...
    匿蟒閱讀 20,732評論 11 28
  • Rstudio-server連接出錯,如題。 重新編譯,加入--enable-R-shlib選項 R升級到3.2后...
    gada閱讀 1,554評論 0 1
  • 書柜里有好多好書,一直都沒有時間去好好的看。最近,總是沒來由的隨手拿起一本,然后被它吸引。 《黑暗,也是一種...
    Gracee224閱讀 2,528評論 0 0
  • 文/午言 提起母親兩字 兒子淚如雨下 愧疚感負身不能自已 只能悄悄的在旁邊擦干眼淚...
    許勇閱讀 512評論 4 2