MacでiOS開発環境をゼロから構築：Xcode、Homebrew、Git、CocoaPodsから最初のAppまでの完全チュートリアル

Homebrewの公式要件は、Intel搭載MacとAppleシリコン搭載Macの両方を対象として案内しています。対応条件を確認したうえで、まずXcodeを導入し、次にHomebrewとGitを整えましょう。CocoaPodsはプロジェクトが必要とするときだけ加え、最後にXcodeでAppを起動すれば、環境が実際に使えるか確かめられます。 (Homebrewのインストール要件)

この手順は、初めてMacでiOS開発を始める人、開発ツールを入れ直す人向けです。
また、本機またはリモートMacでビルドと初回起動を確かめたい個人・チームにも役立ちます。

開始前にMacとアカウントの条件を確認する

最初に、macOSのバージョン、空きストレージ、ユーザー権限を確認します。Xcodeが対応するmacOSはリリースごとに異なるため、インストールするXcodeの版を決めてから、Appleのシステム要件で対応関係を確認してください。古いmacOSを使っている場合は、Xcodeを先にダウンロードするのではなく、OS更新の可否を確認します。

ストレージは、Xcode本体だけでなく、追加コンポーネント、シミュレータのランタイム、プロジェクトのビルド生成物にも使います。必要容量を一律の数値で決めつけず、Appleの配布画面に表示されるサイズと、追加予定のシミュレータを含めて空き容量を見積もってください。空きが足りないと、ダウンロードや初回コンポーネントの導入、ビルドの途中で止まることがあります。

管理者権限がないアカウントでは、ツールの導入やシステム設定で承認を求められる場合があります。会社や学校のMacなら、管理ポリシーでインストールが制限されていないか、事前に管理者へ確認してください。

Apple Accountは、どの作業で必要ですか？
Xcodeの取得元や、実機での署名・実行、アプリの配布など、目的によって必要なアカウント条件が異なります。シミュレータで画面を動かすだけの作業と、実機へのインストールや配布を同じ条件だと考えず、Apple Developerのアカウント案内で目的に合う条件を確認します。

Xcodeを先に入れて開発基盤を整える

XcodeはiOS SDK、シミュレータ、ビルドやデバッグの機能をまとめて提供する中心ツールです。HomebrewやGitを先に入れても、Xcodeの代わりにはなりません。取得方法はAppleのXcode公式ページで確認し、必要なXcodeを入手します。

起動後は、追加コンポーネントのダウンロードやライセンスへの同意を求められたら、画面の案内に従います。初回起動が完了する前にターミナルからビルドしようとすると、必要なコンポーネントが未導入で失敗することがあります。コンポーネントはXcodeの設定画面から管理でき、詳細はAppleの追加コンポーネント案内で確認できます。

ターミナルを開き、次のコマンドで選択中の開発ディレクトリを確認します。

xcode-select -p

続けて、Xcodeのコマンドラインビルドツールが応答するか確認します。

xcodebuild -version

結果が返らない場合は、Xcodeの初回起動が完了しているか、コマンドラインツールが正しい場所を参照しているかを見ます。Appleは、Xcode本体とは別にコマンドラインツールを導入する方法も案内しています。ターミナルから追加を求められた場合は、Appleのインストール手順に沿って進めてください。

Xcodeの取得と初期設定で何を確認すればよいですか？
利用するmacOSに対応した版を選び、初回起動を完了させたうえで、コマンドラインから版情報を取得できることを確認します。ダウンロード先や表示される確認画面は、入手方法や環境によって異なることがあります。画面が案内と違う場合は、推測で設定を変えず、Appleの公式手順と現在のXcodeの表示を照合してください。

HomebrewとGitを別々に設定する

HomebrewはMac向けのパッケージ管理ツールです。Gitはソースコードの変更履歴を管理するバージョン管理ツールです。用途が異なるため、片方を入れただけで、もう片方やXcodeが使えるようになるわけではありません。

Homebrewを使う場合は、先に公式の要件を確認し、公式のインストール案内に掲載されたコマンドを実行します。インストール後は、案内される確認方法でコマンドが利用できるかを確かめます。MacのCPU種別やシェル設定によって、実行後に必要となる環境設定が異なる場合があります。表示された手順を飛ばすと、インストール済みでもbrewが見つからないことがあります。

Gitは、まず次のコマンドで利用できるか確認します。

git --version

バージョン情報が返ったら、コミットに記録する名前とメールアドレスを設定します。ここでは実際に使用する情報に置き換えてください。

git config --global user.name "あなたの名前"
git config --global user.email "あなたのメールアドレス"

設定内容は次のコマンドで確認できます。

git config --global --list

Gitの導入方法は環境によって異なります。Homebrewから入れる方法だけに限定せず、Git公式のMac向け案内で選択肢を確認してください。名前やメールアドレスを誤った場合は、プロジェクトで作業を始める前に設定を修正します。

HomebrewとGitは、どちらを先に設定すればよいですか？
Xcodeの確認後であれば、どちらからでも構いません。Homebrewを使ってGitを導入する場合は、Homebrewを先に設定します。一方、すでにGitが利用できるなら、重ねて導入する必要はありません。Gitの実行確認とコミット情報の設定を済ませれば、プロジェクトの変更履歴を記録できます。

CocoaPodsはプロジェクトの指定を見てから選ぶ

CocoaPodsは、対応するiOSプロジェクトで外部ライブラリを管理するためのツールです。すべてのプロジェクトに必須ではありません。プロジェクトのREADMEや依存関係の説明にCocoaPodsが指定されていなければ、学習のためだけに追加せず、プロジェクトが指定する方法を使います。

Appleの開発環境にはSwift Package Managerを使う選択肢もあります。Appleのパッケージ依存関係の追加手順と、プロジェクトの指定を確認してから方法を決めてください。既存プロジェクトの依存管理方式を途中で入れ替えると、ロックファイルやワークスペースの扱いが変わり、チームの環境とずれるおそれがあります。

どんなときにCocoaPodsを入れますか？
プロジェクトにPodfileがある、または開発手順でpod installが指定されている場合に導入を検討します。導入前にCocoaPodsの公式ガイドで環境条件を確認し、指示に沿ってインストールしてください。プロジェクトでpod installを実行したら、依存関係の取得が完了したか、生成されたPodfile.lockと.xcworkspaceがあるかを確認します。CocoaPodsを使うプロジェクトは、通常、生成されたワークスペースをXcodeで開きます。導入コマンドやRuby環境の条件を決めつけず、CocoaPodsの公式入門と対象プロジェクトの案内を優先してください。

次の条件分岐で選ぶと、不要な導入を避けられます。

• プロジェクトにPodfileがあり、手順にCocoaPodsが指定されている場合は、公式ガイドに沿って導入し、pod install後に生成物を確認します。
• プロジェクトがSwift Package Managerを指定している場合は、Xcodeのパッケージ機能を使い、CocoaPodsを追加しません。
• 既存の依存管理方法が読み取れない場合は、インストールを進めず、プロジェクトのREADMEやチームの手順を確認します。

Xcodeで最初のAppを作り、起動まで確かめる

準備が整ったら、Xcodeで新しいプロジェクトを作成します。AppleのAppプロジェクト作成手順を参照し、iOS向けのテンプレートを選びます。最初は画面表示を確認できるシンプルなテンプレートにし、プロジェクト名、保存場所、インターフェースなどの選択肢は、学習目的と既存プロジェクトの方針に合わせます。

Bundle Identifierはアプリを識別する値です。サンプルのままではなく、自分のプロジェクト用に重複しにくい値を設定します。実機で動かす場合は署名設定も確認します。シミュレータでの実行と実機での実行では、署名やデバイス側の準備が同じとは限りません。

プロジェクトを開いたら、画面上部の実行先で利用できるiOSシミュレータを選び、ビルドして実行します。エラーが出たときは、メッセージの最初の原因、選択中の実行先、コンポーネントの導入状態の順に確認します。起動後にシミュレータ上でAppの画面が表示されれば、少なくともプロジェクトの読み込み、ビルド、シミュレータでの起動まで確認できたことになります。

最初のAppをどう実行すればよいですか？
まずはシミュレータを実行先に選び、Xcodeからビルドと起動を行います。実機で試す必要がある場合は、端末の接続と署名に関する表示を別に確認してください。Apple Accountやチーム設定が求められたら、画面の案内と開発者アカウントの条件を照合します。

失敗した工程から順に原因を切り分ける

一度に複数の設定を変えると、原因がわからなくなります。インストール、依存関係の解決、ビルド、起動の順に、最後に成功した工程を起点に調べてください。

• インストールで止まる場合：macOSとXcodeの対応、空き容量、管理者による制限、ダウンロード元を確認します。
• コマンドが見つからない場合：Xcodeの初回起動、コマンドラインツールの選択、Homebrewの案内にあるシェル設定、Gitの導入状況を確認します。
• 依存関係を解決できない場合：プロジェクトの指定方式を確認し、CocoaPodsを使うならPodfileとインストール結果を見ます。依存方式の変更やロックファイルの削除を、原因確認前に行わないでください。
• ビルドで失敗する場合：エラーの対象ターゲット、選択した実行先、必要コンポーネントの導入状況を見直します。
• ビルド後に起動しない場合：シミュレータが起動しているか、Appの実行先が正しいかを確認します。実機なら署名関連の表示も調べます。

確認が済んだら、チェック項目を一つずつ消してください。

• [ ] macOSとXcodeの対応を公式要件で確認した
• [ ] Xcodeが起動し、xcode-select -pとxcodebuild -versionが応答した
• [ ] Homebrewを使う場合、公式手順どおりに導入して確認した
• [ ] Gitが利用でき、コミット用の名前とメールアドレスを確認した
• [ ] CocoaPodsはプロジェクトが必要とする場合だけ導入した
• [ ] Xcodeでビルドが完了し、シミュレータまたは適切な実機でAppが起動した

手元のMacに必要なmacOSやストレージの条件がそろわない場合、WindowsやLinuxの環境だけではXcodeを使ったiOSビルドを完結できません。環境を整えるまで作業を止める方法もありますが、短期間の検証なら、Macを購入する前にリモートMacを選択肢として比較できます。リモート接続では通信状態に左右され、手元の端末と同じ操作感にならないこともあります。また、長期にわたり安定して使う場合や物理端子が必要な作業は、自分のMacのほうが適しています。

利用を検討するなら、作業前にXcodeの対応条件、必要なストレージ、接続方法、実機接続の可否を確認してください。Hashvpsの案内で利用の概要を確認し、プラン詳細で自分の開発手順に合う条件か照らし合わせられます。本記事の確認項目に沿って、依存関係の解決とAppの起動までできる環境かを判断してから選ぶと、導入後の行き違いを減らせます。