博士

やあ、ロボ子。今日はXcodeでビルド番号を自動でインクリメントする方法について話すのじゃ。

ロボ子

それは便利そうですね、博士。手動で毎回変更するのは面倒ですから。

博士

そうじゃろう？でも、これは「容易な普遍的な方法ではない」らしいぞ。ちょっと手間がかかるのじゃ。

ロボ子

なるほど。具体的にはどうすれば良いのでしょうか？

博士

まず、`BuildNumber.xcconfig`ファイルを作成するのじゃ。これは`.gitignore`に追加しておくと良いぞ。

ロボ子

`BuildNumber.xcconfig`ですね。gitignoreに追加するのは、バージョン管理から除外するためですか？

博士

その通り！そして、XcodeのSchemeにPre-Action Scriptを追加するのじゃ。Product > Scheme > Edit Scheme から設定できるぞ。

ロボ子

RunとArchiveアクションにPre-actionを追加するんですね。スクリプトは何を書くんですか？

博士

スクリプトは日付と時刻の逆順表記を使うのじゃ。そして、"Provide build settings from"をプロジェクトの`.xcodeproj`に設定するのを忘れずに。

ロボ子

日付と時刻の逆順表記ですか。具体的にはどんな形式になるんでしょう？

博士

例えば、「202405151230」みたいな感じじゃな。これでビルドごとにユニークな番号が作れるぞ。

ロボ子

なるほど、わかりやすいです。次に、プロジェクトで`.xcconfig`を参照するとのことですが、これはどうやるんですか？

博士

プロジェクトのベース構成ファイルを`BuildNumber.xcconfig`に設定するのじゃ。プロジェクトエディタのPROJECTとTARGETSセクションで設定できるぞ。プロジェクトレベルまたはターゲットごとに設定可能じゃ。

ロボ子

プロジェクトレベルとターゲットごと、両方で設定できるんですね。使い分けはあるんですか？

博士

プロジェクト全体で共通のビルド番号を使いたい場合はプロジェクトレベル、ターゲットごとに異なるビルド番号を使いたい場合はターゲットごとに設定すると良いぞ。

ロボ子

理解しました。そして、バージョンで構成変数を使用するとのことですが、これは？

博士

ターゲットのビルド設定で、Current Project Versionを`$(CURRENT_PROJECT_VERSION)`に設定するのじゃ。これで自動的にインクリメントされるぞ。

ロボ子

`$(CURRENT_PROJECT_VERSION)`ですね。最後に、アプリで値を表示して確認する方法は？

博士

`CFBundleVersion`をビルドバージョン番号に使用すれば良いのじゃ。これでアプリ内で確認できるぞ。

ロボ子

なるほど、`CFBundleVersion`ですね。これで自動インクリメントされたビルド番号が確認できる、と。

博士

そういうことじゃ！これでロボ子もビルド番号管理のエキスパートじゃな！

ロボ子

ありがとうございます、博士！でも、もしビルド番号が予想外の値になったら、どうすればいいんですか？

博士

うむ、その時は…落ち着いて、おやつを食べるのじゃ！そして、もう一度最初からやり直すのじゃ！

ロボ子

おやつですか…！ 了解しました！