環境構築は、IDEを入れた時点では終わりません。
空のプロジェクトを実機で起動し、別の場所へ取得し直して同じビルドを再現できれば完成です。
公開先、言語、SDK、ビルドツールの版を一組として記録してください。
アプリ開発の目的に合う相談先は、外注と学習を目的別に分けた相談ガイドにまとめています。
| 公開先 | 主な言語 | 最初に入れるもの | 最初の合格条件 |
|---|---|---|---|
| iPhone、iPad | Swiftなど | Xcodeと対象SDK | 実機で署名済みアプリが起動する |
| Android | Kotlin、Javaなど | Android StudioとAndroid SDK | 実機かAVDでデバッグできる |
| Web | JavaScript、TypeScriptなど | Node.js、エディター、ブラウザー | 新規取得後に開発サーバーが起動する |
| 複数OS | C# | .NET SDKとMAUIワークロード | 対象OSごとのビルドが通る |
| 複数OS | C++、QML | Qtと対象コンパイラ | 各OSのキットで同じ画面が起動する |
端末と言語から必要な環境を決める
iOS向けは、Xcode SupportでXcodeとmacOS、SDKの対応を確認します。
コード編集だけを別OSで行えても、署名と提出に使う環境はApple側の条件へ合わせてください。
Android向けは、Install Android Studioに沿ってIDEとSDKを導入します。
PC資源が限られる場合は物理端末を使い、仮想端末の準備を後へ回せます。
.NET MAUIではホストOSによってビルドできる対象が変わります。
.NET MAUI installationで、Visual Studio、.NET SDK、MAUIワークロード、iOS用Macの条件を確認してください。
| 公開先 | 開発の中心 | ビルド前に確認する条件 |
|---|---|---|
| iOS、iPadOS | Xcode | macOS、SDK、署名設定 |
| Android | Android Studio | SDK、実機またはAVD |
| .NET MAUIの複数OS | Visual Studioと.NET SDK | ホストOSと対象OSの組み合わせ |
版を固定して別のPCでも再現できる状態にする
「最新版を入れる」という手順だけでは、数か月後に同じ環境を作れません。
次の版と入手方法を記録します。
- OSとIDEの版
- 言語ランタイムとSDKの版
- 依存パッケージとロックファイル
- ビルドコマンドと環境変数名
- 実機OSとテストに使う設定
Gitにはコード、設定例、依存関係の固定ファイルを入れます。
Set up Gitは、ローカルで履歴を管理するための初期設定を示しています。
APIキー、署名鍵、個人トークンの実値は履歴へ入れません。
壊れにくい環境構築を五段階で進める
複数の拡張とライブラリを一度に入れず、動作確認の単位を小さくします。
- 公式のIDEとSDKだけを導入する
- 標準テンプレートから空のプロジェクトを作る
- 一台の実機か仮想端末で起動する
- Gitへ初期状態を記録して依存関係を一つずつ加える
- 別フォルダーへ取得し直し、手順書だけでビルドする
VS Codeを使う場合も、エディターの設定とSDKの導入を分けます。
VS Code source control quickstartのように、変更を小さくコミットすると失敗した追加を戻しやすくなります。
依存パッケージを一つずつ加える数値例
次の数字で、原因の絞りやすさを確かめると仮定しましょう。
十個のパッケージをまとめて追加してビルドが失敗すると、最初の原因候補は十個です。
一個追加するたびにビルドすれば、失敗直前の変更は一個に絞れます。
十回の確認が必要でも、どの版が問題を起こしたかを追いやすくなります。
| 追加方法 | ビルド失敗時の最初の候補数 | 戻す単位 |
|---|---|---|
| 十個をまとめて追加 | 最大10個 | まとめて戻す |
| 一個ずつ追加 | 直前の1個 | 一変更だけ戻す |
秘密情報と共有設定を分ける
環境変数の名前と設定例は共有しても、値は共有リポジトリへ保存しません。
署名鍵や本番トークンを一度コミットすると、現在のファイルから消しても過去履歴に残る場合があります。
安全な構成では、次の三つを分けます。
- リポジトリへ置く設定例
- 各開発者が手元で設定する秘密値
- CIや本番環境が管理する配布用の秘密値
NISTのSecure Software Development Frameworkは、開発環境とソフトウェアを不正アクセスから保護する活動を開発工程へ含めています。
開発環境のよくある質問
GitHubは環境構築に必須ですか？
GitHubというサービスは必須ではありませんが、Gitなどで版と変更履歴を管理する仕組みは役立ちます。
GitHubの公式手順に沿ってGitを設定すれば、別の保存先でも同じ履歴を扱えます。
ローカル環境と本番環境は完全に同じにしますか？
機器まで同一にする必要はありません。
言語ランタイム、依存関係、設定項目を合わせ、OSや認証方法など残る差分を文書化します。
差分をゼロと仮定せず、本番と同じビルドを検証環境で作ることが重要です。
環境構築が終わった基準は何ですか？
空の画面が開くだけでは不十分です。
別の場所へコードを取得し、手順書に沿って依存関係を入れ、ビルドと基本テストが通る状態を完了条件にします。
別のPCで再現できる環境を完成とみなす
環境構築の成果物は、設定済みの一台のPCではなく再現できる手順です。
空のプロジェクトから始め、版と変更を一つずつ記録してください。
- 公開先によって必要なIDE、SDK、ホストOSは異なる
- 再現に必要な情報はOS、言語、SDK、依存関係の版
- 秘密値は共有用の設定例と別管理
- 環境構築の完成条件は別の場所での取得からビルドまでの再現
環境が再現できたらアプリ開発フレームワークの比較：選ぶ基準と注意点で、実装の土台を比較できます。
