ビルド番号の採番とアプリのバージョニング
すべてのBitriseビルドにはビルド番号があります。プロジェクトの最初のビルドはデフォルトで番号1となり、ビルドのたびにビルド番号が増分されます。ビルドのBitrise build numberはウェブサイトで確認できるほか、$BITRISE_BUILD_NUMBER環境変数からも取得できます。この変数は、必要に応じてStepやスクリプトでBitrise build numberを使用する際に利用できます。
ビルド番号はウェブのUIで手動で変更するこ ともできます。詳細については、ウェブUIでのビルド番号の変更。
Bitriseは、Bitriseを使用してモバイルアプリのバージョニングを自動的に管理する機能も提供します。これを行うためのStepsが2つ用意されており、1つはiOS用、もう1つはAndroid用です。詳細については、Bitriseでのアプリバージョニングの自動設定。
ウェブUIでのビルド番号の変更Click to copy link
ビルド番号はビルドを実行するたびに自動的に増分されますが、Bitrise projectのProject settingsページで手動で設定することもできます。
ビルド番号は正の整数である必要があります。0または負の数は使用できません。ただし、すでに使用したことのある番号であれば設定できます。
-
プロジェクトに対するAdminのロールを持つユーザー、またはEdit workflow権限を持つカスタムロールを持つユーザーで、Bitrise上のプロジェクトを開きます。
-
プロジェクトのメインページで、Project settingsボタンをクリックします。
-
左側でBuildsを選択します。
-
Next build numberを見つけて、Editをクリックします。

-
希望のビルド番号を入力し、Saveをクリックします。
Bitriseでのアプリバージョニングの自動設定Click to copy link
アプリに関する重要な情報を含むファイル(例えば、iOSアプリの場合はInfo.plistフ ァイル、Androidアプリの場合はbuild.gradleファイルまたはAndroidManifest.xmlファイル)を変更することで、Gitリポジトリ内でモバイルアプリのバージョンを管理できます。
Bitriseには、これを行うためのStepsが2つ用意されています。これら2つのStepsは、それぞれのファイルにBitrise build numberまたは指定した他の番号を挿入できます。
- Androidアプリ向けのChange Android versionCode and versionName。
- iOSアプリ向けのSet Xcode Project Build Number。
どちらのStepsも、該当する入力欄に数値(整数および/または数値文字列)またはenvironment variablesのいずれかを指定できます。デフォルトでは、どちらもビルド番号のdefault valueとして$BITRISE_BUILD_NUMBER環境変数を使用します。
AndroidアプリのversionCodeとversionNameの設定Click to copy link
Androidアプリでは、この設定はビルドが別のビルドより新しいかどうかを判定するための内部バージョン番号として使用されます。versionName設定は、ユーザーに表示されるバージョン番号として使用される文字列です。
Androidのバージョニングについて詳しくは、この件に関するAndroidの開発者ガイドを参照してください。
このガイドでは、build.gradleファイルでバージョン情報を設定します。これが推奨される方法です。AndroidManifest.xmlファイルで直接設定することもできますが、ビルド前にマニフェストファイルに設定されたバージョン情報は、ビルド時にbuild.gradleファイルの設定によって上書きされる点に注意してください。
Androidのバージョニングを設定するには:
-
Change Android versionCode and versionName StepをWorkflowに追加します。
-
Path to the build.gradle file入力欄に
build.gradleファイルのパスを設定します。
-
New versionName入力欄に値を追加します。
-
New versionCode入力欄に値を追加します。
default valueは$BITRISE_BUILD_NUMBER環境変数です。
iOSアプリのCFBundleVersionとCFBundleShortVersionStringの設定Click to copy link
iOSアプリの場合、CFBundleVersionキーの値(Xcodeでは「Bundle version」)がアプリのビルド番号であり、CFBundleShortVersionStringキーの値(Xcodeでは「Bundle versions string, short」)がアプリのバージョン番号です。
iOSのバージョニング、およびCFBundleVersionキーとCFBundleShortVersionStringキーの機能について詳しくは、このAppleのテクニカルノートを参照してください。また、主要なキーの概要も確認できます。
Xcode 13以降を使用するBitriseでiOSバージョニングを設定するには、Xcodeで以下を更新します:
- Build SettingsタブのPROJECTとTARGETSで、Generate Info.plist Fileを
Noに設定します。 Info.plistファイルに必要なキーがすべて定義されていることを確認してください。
- Set Xcode Project Build Number StepをWorkflowに追加します。
- Project pathとScheme入力欄を確認します。デフォルトでは、それぞれ
$BITRISE_PROJECT_PATHと$BITRISE_SCHEMEが設定されているため、通常は変更する必要はありません。必要に応じて、TargetまたはConfigurationを設定すると、変更を1つのターゲットまたはビルド構成に限定できます。 - Build Number入力欄に値を追加します。これにより、
Info.plistファイル内のCFBundleVersionキーが指定した値に設定されます。default valueは$BITRISE_BUILD_NUMBER環境変数です。 - 必要に応じて、Version Number入力欄に値を追加します。これにより、
Info.plistファイル内のCFBundleShortVersionStringキーが指定した値に設定されます。この入力欄は必須ではありません。
ビルドバージョンのオフセットClick to copy link
Bitriseを使用する前に別の方法でバージョンを管理していた場合、アプリのビルドバージョン番号をオフセットできます。例えば、Bitriseの使用を開始する前にすでに6回ビルドしていた場合、versionCodeをオフセットすることで、1から再スタートするのではなく、それまでの続きから採番できます。
- Android
- iOS
- Change Android versionCode and versionName StepをWorkflowに追加します。
- New versionCode入力欄で
$BITRISE_BUILD_NUMBERを使用します(これは入力欄のdefault valueです)。 - versionCode Offset入力欄で、ビルド番号に加算する値を設定します。これは固定の整数でも環境変数でも構いません。
Bitriseでアプリの5回目のビルドを実行しようとしていて、Bitriseの使用を開始する前にすでに6回ビルドしていたとします。versionCodeの採番を連続させるには:
- 新しいversionCode:
$BITRISE_BUILD_NUMBER - versionCode Offset:
6 - 新しいversionName:
1.0.5
$BITRISE_BUILD_NUMBER(この例では5)がversionCode Offset(6)に加算されるため、versionCodeは11に設定されます。versionNameはオフセットの影響を受けず1.0.5のままです。つまり、このビルドはversionName 1.0.5、versionCode 11(バージョン1.0.5の11回目のビルド)になります。
- Set Xcode Project Build Number StepをWorkflowに追加します。
- Build Number入力欄で
$BITRISE_BUILD_NUMBERを使用します(これは入力欄のdefault valueです)。 - Build Number Offset入力欄で、ビルド番号に加算する値を設定します。これは固定の整数でも環境変数でも構いません。
Bitriseでアプリの5回目のビルドを実行しようとしていて、Bitriseの使用を開始する前にすでに6回ビルドしていたとします。ビルド番号を連続させるには:
- Build Number:
$BITRISE_BUILD_NUMBER - Build Number Offset:
6 - バージョン番号:
1.1
$BITRISE_BUILD_NUMBER(この例では5)がBuild Number Offset(6)に加算されるため、CFBundleVersionは11に設定されます。CFBundleShortVersionStringはオフセットの影響を受けず1.1のままです。つまり、このビルドはバージョン1.1、ビルド11になります。