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

小結

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

最后編輯于
?著作權歸作者所有,轉載或內容合作請聯系作者
平臺聲明:文章內容(如有圖片或視頻亦包括在內)由作者上傳并發布,文章內容僅代表作者本人觀點,簡書系信息發布平臺,僅提供信息存儲服務。
  • 序言:七十年代末,一起剝皮案震驚了整個濱河市,隨后出現的幾起案子,更是在濱河造成了極大的恐慌,老刑警劉巖,帶你破解...
    沈念sama閱讀 227,797評論 6 531
  • 序言:濱河連續發生了三起死亡事件,死亡現場離奇詭異,居然都是意外死亡,警方通過查閱死者的電腦和手機,發現死者居然都...
    沈念sama閱讀 98,179評論 3 414
  • 文/潘曉璐 我一進店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人,你說我怎么就攤上這事。” “怎么了?”我有些...
    開封第一講書人閱讀 175,628評論 0 373
  • 文/不壞的土叔 我叫張陵,是天一觀的道長。 經常有香客問我,道長,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 62,642評論 1 309
  • 正文 為了忘掉前任,我火速辦了婚禮,結果婚禮上,老公的妹妹穿的比我還像新娘。我一直安慰自己,他們只是感情好,可當我...
    茶點故事閱讀 71,444評論 6 405
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著,像睡著了一般。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發上,一...
    開封第一講書人閱讀 54,948評論 1 321
  • 那天,我揣著相機與錄音,去河邊找鬼。 笑死,一個胖子當著我的面吹牛,可吹牛的內容都是我干的。 我是一名探鬼主播,決...
    沈念sama閱讀 43,040評論 3 440
  • 文/蒼蘭香墨 我猛地睜開眼,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了?” 一聲冷哼從身側響起,我...
    開封第一講書人閱讀 42,185評論 0 287
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎,沒想到半個月后,有當地人在樹林里發現了一具尸體,經...
    沈念sama閱讀 48,717評論 1 333
  • 正文 獨居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內容為張勛視角 年9月15日...
    茶點故事閱讀 40,602評論 3 354
  • 正文 我和宋清朗相戀三年,在試婚紗的時候發現自己被綠了。 大學時的朋友給我發了我未婚夫和他白月光在一起吃飯的照片。...
    茶點故事閱讀 42,794評論 1 369
  • 序言:一個原本活蹦亂跳的男人離奇死亡,死狀恐怖,靈堂內的尸體忽然破棺而出,到底是詐尸還是另有隱情,我是刑警寧澤,帶...
    沈念sama閱讀 38,316評論 5 358
  • 正文 年R本政府宣布,位于F島的核電站,受9級特大地震影響,放射性物質發生泄漏。R本人自食惡果不足惜,卻給世界環境...
    茶點故事閱讀 44,045評論 3 347
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧,春花似錦、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 34,418評論 0 26
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至,卻和暖如春,著一層夾襖步出監牢的瞬間,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 35,671評論 1 281
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留,地道東北人。 一個月前我還...
    沈念sama閱讀 51,414評論 3 390
  • 正文 我出身青樓,卻偏偏與公主長得像,于是被迫代替她去往敵國和親。 傳聞我的和親對象是個殘疾皇子,可洞房花燭夜當晚...
    茶點故事閱讀 47,750評論 2 370

推薦閱讀更多精彩內容

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