ビルドのナンバリングとアプリのバージョン管理

すべてのBitriseビルドにはビルド番号があります。アプリの最初のビルドはデフォルトで1であり、ビルド番号はビルドごとに増加します。ビルドのBitriseビルド番号は、Webサイト、および $BITRISE_BUILD_NUMBER 環境変数。この変数は、何らかの理由でBitriseビルド番号が必要な任意のステップまたはスクリプトで使用できます。

Bitriseを使用して、アプリのバージョン管理を自動的に処理することもできます。私たちはあなたのためにそれを行うための2つのステップがあります: Bitriseでアプリのバージョン管理を自動的に設定する

ビルドの数を変更する

Bitriseビルド番号はWebサイトで手動で設定できます。これは、たとえば、アプリにすでにいくつかのビルドが含まれている他のサービスからBitriseに移行した場合に役立ちます。このように、1から始める必要はありません!

負のビルド番号

ビルド番号は、0または正の整数である必要があります。負の数は受け入れられません。ただし、すでに使用している任意の番号を設定できます。

アプリを開いて、 設定 タブ。

Build numbering and app versioning

あなたの次のビルド番号は、次のビルドの番号が表示されます(当然のことながら)。この数は、新しいビルドがトリガーされるたびに自動的に増加しますが、ここでは手動で設定することもできます。必要な番号を入力するだけで完了です。

Bitriseでアプリのバージョン管理を自動的に設定する

アプリに関する重要な情報を含むファイルを変更して、Gitリポジトリでアプリのバージョンを追跡します(たとえば、 Info.plist iOSアプリおよびいずれかのファイル build.gradle ファイルまたは AndroidManifest.xml Androidアプリ用のファイル)。

Bitriseには、これを行うための2つのステップがあります。これらの2つのステップでは、Bitriseビルド番号またはその他の指定された番号をそれぞれのファイルに挿入できます。

  • AndroidのversionCodeとversionNameを変更します Androidアプリ用。

  • Xcodeプロジェクトのビルド番号を設定する iOSアプリ用。

どちらのステップも、関連する入力で数値(整数および/または数値文字列)または環境変数のいずれかを受け入れます。デフォルトでは、両方とも $BITRISE_BUILD_NUMBER ビルド番号のデフォルト値としての環境変数。

AndroidアプリのversionCodeとversionNameを設定する

Androidアプリの場合、この設定は内部バージョン番号として使用され、アプリのビルドが別のビルドよりも新しいかどうかを判断します。 NS versionName 設定は、ユーザーに表示されるバージョン番号として使用される文字列です。

Androidのバージョン管理の詳細については、こちらをご覧ください。 このテーマに関するAndroid開発者ガイド

マニフェストファイルのバージョン情報

このガイドでは、バージョン情報を build.gradle ファイル。これが推奨される方法です。直接で設定することもできます。 AndroidManifest.xml ファイルですが、ビルド前にマニフェストファイルに設定されたバージョン情報は、によって上書きされることに注意してください。 build.gradle ビルド中のファイルの設定。

Androidのバージョン管理を構成するには:

  1. 追加します AndroidのversionCodeとversionNameを変更します ワークフローに進みます。

  2. あなたへのパスを設定します build.gradle のファイル build.gradleファイルへのパス 入力。

    Build numbering and app versioning
  3. に値を追加します 新しいversionCode 入力。

    デフォルト値は $BITRISE_BUILD_NUMBER 環境変数。

  4. に値を追加します 新しいversionName 入力。

iOSアプリのCFBundleVersionとCFBundleShortVersionStringを設定する

iOSアプリの場合、 CFBundleVersion キー(Xcodeの「バンドルバージョン」)はアプリのビルド番号であり、 CFBundleShortVersionString キー(Xcodeの「バンドルバージョン文字列、短い」)はアプリのバージョン番号です。

iOSのバージョン管理に関する詳細情報については、 CFBundleVersion そしてその CFBundleShortVersionString キー、チェックしてください このアップルテクニカルノート;調べることもできます 最も重要なキーの概要

  1. 追加します Xcodeプロジェクトのビルド番号を設定する ワークフローに進みます。

  2. ファイルパスをに設定します Info.plist のファイル Info.plist file path 入力。

  3. に値を追加します ビルド番号 入力。これにより、 CFBundleVersion で指定された値へのキー Info.plist ファイル。デフォルト値は $BITRISE_BUILD_NUMBER 環境価値。

  4. 必要に応じて、に値を追加します バージョンナンバー 入力。これにより、 CFBundleShortVersionString で指定された値へのキー Info.plist ファイル。この入力は必要ありません。

    Set iOS version

ビルドバージョンのオフセット

同じアプリに対して以前に別の方法でバージョン追跡を処理した場合は、アプリのビルドバージョン番号をオフセットすることもできます。必要なのは、ビルド番号に追加する値を設定することだけです。値は、固定整数値または環境変数のいずれかです。

ビルドがトリガーされるたびにバージョン番号をBitriseビルド番号でオフセットするには、 $BITRISE_BUILD_NUMBER 環境変数:

  • Androidアプリの場合は、 versionCodeオフセット の入力 AndroidのversionCodeとversionNameを変更します ステップアンドセット $ BITRISE_BUILD_NUMBER その値として。変数の値は、で指定された値に追加されます versionCode 入力。

  • iOSアプリの場合は、 ビルド番号オフセット の入力 Xcodeプロジェクトのビルド番号を設定する ステップアンドセット $ BITRISE_BUILD_NUMBER その値として。変数の値は、で指定された値に追加されます ビルド番号 入力。

例1 Androidアプリのバージョンをオフセットする

アプリがあり、Bitriseで5番目のビルドを実行しようとしているとします。 Bitriseの使用を開始する前に、アプリには6つのビルドがあったため、ビルド番号を6だけオフセットしたいとします。次の構成が使用されます。

- Version Code: $BITRISE_BUILD_NUMBER
- Version Code Offset: 6
- Version Name: 1.0.5

の値 $BITRISE_BUILD_NUMBER (この例では5に等しい)がに追加されます Version Code Offset 価値。そのような、 android:versionName 値は1.0.5(11)に設定され、アプリの1.0.5バージョンの11番目のビルドであることを示します。


例2 iOSアプリのバージョンをオフセットする

アプリがあり、Bitriseで5番目のビルドを実行しようとしているとします。 Bitriseの使用を開始する前に、アプリには6つのビルドがあったため、ビルド番号を6だけオフセットしたいとします。次の構成が使用されます。

- Build Number: $BITRISE_BUILD_NUMBER
- Build Number Offset: 6
- Version Number: 1.1

の値 $BITRISE_BUILD_NUMBER (この例では5に等しい)がに追加されます Build Number Offset 価値。そのような、 CFBundleShortVersionString 1.1(11)に設定され、アプリの1.1バージョンの11番目のビルドであることを示します。