ページビューの合計

2026年8月10日月曜日

iOSアプリの開発(VS Code) 環境構築

ではVS Codeを使ってiOSアプリの開発をしていきたいと思います。
検索したところいくつかのプラグインを導入する必要があるようです。

前提条件
これらの機能は内部でApple公式のツールを呼び出しているので、Mac環境でXcodeがインストールされている必要があります。

1. Apple公式:Swift 拡張機能
Swift言語の「テキストエディタ」としての基本機能をカバーします。
コードの自動補完(IntelliSense)、シンタックスハイライト、エラーのリアルタイム検出(SourceKit-LSP連携)などの機能を持ちます。
この公式プラグインは主に Swift Package Manager(SPM)やサーバーサイドSwift 向けに設計されており、iOSアプリ特有の「Xcodeプロジェクト(.xcodeproj)」のビルドやシミュレーターの起動には単体で対応していません。
→そのために次のSweetPadが必要になります。

2. サードパーティ製:SweetPad 拡張機能
VS Codeを「iOSアプリ用の開発環境(IDE)」にするための橋渡しをします。
iOSシミュレーターや実機の管理、Xcodeプロジェクトのビルド(xcodebuild の呼び出し)、デバッガの接続などを行います。

3. 個人開発のOSS:CodeLLDB
Visual Studio Code(VS Code)などのエディタで、C++やRustなどのネイティブ言語をデバッグするための高機能なLLDBベースのデバッガー拡張機能(DAPラッパー)です。
Swiftにも対応しています。

では、VS Codeを起動して上記のプラグインをインストールしましょう。
この一番上と5番目のプラグインですね。


次はCodeLLDBですが、すでにインストールされていました。
Swift 拡張機能の依存関係でついでにインストールされたようです。

この後はサイトによって、コマンドラインでなんか実行しろ的なことが書いてあるけど、サイトによってバラバラです。
とりあえず無視して、Xcodeでプロジェクト作ってVS Codeで開くことにします。
Xcodeの起動
「File」>「New」>「Project...」で画面を開きます。

テンプレート選択画面で、上のタブが 「iOS」 になっているのを確認し、「App」 を選択して 「Next」 を押します。

プロジェクト情報を設定します。情報を入力して「Next」を押下します。


必須

  • Product Name: アプリ名(例: MySampleApp など英数字で記入)

  • Organization Identifier: 逆ドメイン形式(例: com.example や com.yourname)

  • Interface: SwiftUI(または Storyboard)を選択

  • Language: Swift を選択

任意
  • Team: 実機で動作させたいときやApp StoreにリリースするときにApple IDを設定します。後から追加できます。

  • Storage: アプリ内でデータを保存する仕組み(SwiftData や Core Data など)を使うための設定です。とりあえずNoneで構いません。

  • Host in CloudKit: Appleのクラウド(iCloud)を使って、iPhoneやiPadなど複数の端末間でアプリのデータを自動同期させる機能です。StorageでNoneを選択しているので無効になっています。

  • Include Tests: アプリが正しく動くかを自動でチェックするための「テスト用コード(Unit Test / UI Test)」のファイル群をあらかじめ作っておく設定です。オンにしておいてもアプリ本体の動作には何も影響しません。後々「テストコードも書いてみたい」となった時に便利ですし、使わなければ無視しておけばOKです。


任意のフォルダにプロジェクトを保存します。
Gitによるソースコード管理がデフォルトでONになっています、このままにしておきます。




次にXcodeで作成したプロジェクトをVS Codeで開きます。
以下のように4つのフォルダがあります。


1. MytestApp(アプリ本体のコードフォルダ)
アプリの画面を作る ContentView.swift や、アプリの起動処理を書くMytestAppApp.swift(今開いているファイル)、画像や色を管理する Assets などが入っています。
新しくSwiftファイルや画像を追加するときは、すべてこのフォルダの中に入れます。

2. MytestApp.xcodeproj(Xcodeのプロジェクト設定パッケージ)
Xcodeがプロジェクト全体の設定(ビルド設定やターゲット、使っているファイルの一覧など)を管理するためのパッケージです。
VS Codeでコードを書くときは直接触る(開く)必要はありません。無視して大丈夫です。

3. MytestAppTests(単体テスト用フォルダ)
プロジェクト作成時に「Include Tests」をONにしたことで作られた、ユニットテスト(単体テスト)用のフォルダです。
計算処理やロジックが正しく動くか自動検証するコードを書く場所です。テストコードを書かない間は触らなくて問題ありません。

4. MytestAppUITests(UIテスト用フォルダ)
UI(画面操作)の自動テスト用のフォルダです。
ボタンを押したら画面が遷移するか」といった画面操作のテストコードを書く場所です。こちらも最初は使わないため、放置しておいて大丈夫です。


開発に関係あるファイルとフォルダ
MytestApp(アプリ本体のコードフォルダ)
の下を見るとさらに以下のように分かれています。


Assets.xcassets(画像やカラーの素材管理フォルダ)
アプリ内で使う「画像ファイル(PNGやJPEG)」や「アプリのテーマカラー」、「アプリのアイコン」などを保存・管理するカタログです。
アプリに画像を表示させたい時は、ここに画像をドラッグ&ドロップして登録します。

Preview Content(開発用のダミーデータ保存フォルダ)
開発中の画面プレビュー時だけ使うダミー画像やサンプルデータを入れておく場所です。
実際のアプリ(本番)には読み込まれないため、テスト用の仮データを置く時に使いますが、基本は放置で大丈夫です。

ContentView.swift(画面デザイン・メインロジック)
アプリの実際の画面(レイアウト、テキスト、ボタン、リストなど)を作るファイルです。
開発の9割はこのファイルを書き換えて進めます。「ボタンを押した時の動き」や「画面の装飾」はすべてここに書きます。

MytestAppApp.swift(アプリの起動・エントリーポイント)
アプリが起動した時に「最初にどの画面を表示するか」を決めている設定ファイルです。
最初は触らなくてOKです。将来的にアプリ起動時にデータを読み込みたい時などに少し編集します。


SweetPadの起動
VS Code左端の「SweetPadアイコン」をクリックします。


SweetPadアイコンを押したら
No Xcode scheme was found, Select the workspace that has the Xcode project to use Sweetpad.
と表示されました。
どうも開いたフォルダの位置がおかしくて、プロジェクトを認識できないらしいです。
Select Workspaceを押下して設定します。

画面で、Select Xcode workspace or SPM package
その下に候補で「MytestApp.xcodeprj/project.xcworkspace」
と表示されるので、それを選択します。
その後で「Do you want to update path to xcode workspace in the workspace settings(.vscode/settings.json)」
と表示して、その下にYes, Noボタンを表示します。
Yesボタンを押下します。

メッセージ通りに、.vscode/settings.jsonにSweetPad用の設定を書き込みます。
これで次回からSweetPadアイコンを押下してもエラーになりません。


SweetPadアイコンを押すとSweetPadサイドバー内の各ビュー(BUILD / DESTINATIONS / TOOLS)が表示されます。
  • BUILD:🔧アイコン Build (without Run)と▶️アイコンBuild & Run(Launch)
  • DESTINATIONS:ターゲットのデバイスです。iOS Simulatorsの下から選択ができます。
  • TOOLS:各種ツールです。インストールの必要があります。(下記参照)

TOOLSの説明

【シミュレータ開発での導入の目安】

  • 最低限おすすめセット: Homebrew + xcode-build-server + xcbeautify
    VS Codeでコード補完を効かせ、ビルドエラーを読みやすくするための環境です。

  • コードを綺麗に保ちたい人向け: swift-format / SwiftLint
    個人開発の初期段階では後回しでもOKです。


1. 超重要・基本ツール(最優先)

Homebrew

  • 概要: Mac用のパッケージ管理ツール(アプリや開発ツールをコマンド一発でインストールできる「MacのApp Store」のようなもの)。

  • 役割: このリストにある他のツール(SwiftLintやXcodeGenなど)をMacに読み込むためにほぼ必須となります。

  • 重要度: ★★★★★ (絶対必須)

2. 入れておくと非常に役立つ(おすすめ)

SwiftLint

  • 概要: Swiftの「コードの書き方ルール」を自動チェックしてくれるツール。

  • 役割: インデントのズレ、無駄なスペース、危険なコード(強制的アンラップなど)を注意・警告してくれ、コードを綺麗な状態に保てます。

  • 重要度: ★★★★☆ (おすすめ)

swift-format(スウィフト・フォーマット)

  • 概要: Apple公式のコード自動整形(フォーマッター)ツール。

  • 役割: 保存時などに、ぐちゃぐちゃなコードのレイアウトや改行をルール通りに一瞬で綺麗に揃えてくれます。

  • 重要度: ★★★★☆ (おすすめ)

xcbeautify

  • 概要: VS Codeやターミナルに出力される「文字だらけで読みづらいXcodeのビルドログ」を、色付きで綺麗に見やすく整形してくれるツール。

  • 役割: ビルドエラーが起きたときに、どこで落ちたかを一目で探しやすくしてくれます。

  • 重要度: ★★★☆☆ (あると便利)

3. VS Codeでビルド・連携するために使う(必要に応じて)

xcode-build-server

  • 概要: VS Code(のSourceKit-LSP機能)とXcodeを連携させ、補完や定義ジャンプをスムーズにするための裏方ツール。

  • 役割: VS Code上でSwiftコードを書く際に、コード補完や構文チェックを正確に行わせるためにSweetPadが裏で利用します。

  • 重要度: ★★★☆☆ (VS Codeでガッツリコード補完させたいなら便利)

ios-deploy

  • 概要: Xcodeを使わずに、コマンドラインから直接iPhone実機にアプリをインストール・デバッグ起動するツール。

  • 役割: シミュレータではなく「実機」でVS Codeからテストしたいときに裏で必要になります。

  • 重要度: ★★☆☆☆ (実機テストをVS Codeからやりたい場合)

4. 中〜上級者向け・大規模プロジェクト用(最初は不要)

XcodeGen

  • 概要: project.yml というテキスト設定ファイルから、.xcodeproj(Xcodeのプロジェクトファイル)を自動生成するツール。

  • 役割: チーム開発時に発生しやすい「Xcodeのプロジェクト競合(コンフリクト)」を防ぐために使われます。

  • 重要度: ★☆☆☆☆ (個人開発の初期は不要)

tuist

  • 概要: XcodeGenよりもさらに大規模・複雑なモジュール化プロジェクト(複数のアプリやライブラリ)を管理・生成するツール。

  • 役割: 巨大なアプリ開発チームでビルド時間を短縮したり管理を楽にするために使われます。

  • 重要度: ★☆☆☆☆ (最初は完全に不要)

InjectionNext

  • 概要: コードを変更した際、アプリを再起動・再ビルドせずにリアルタイムで画面に反映(ホットリロード)させるツール。

  • 役割: UIの微調整を高速化できますが、設定に少しコツが必要です。

  • 重要度: ★★☆☆☆ (慣れてきてUIのリアルタイム反映をしたいとき)


ちょっと長くなってきたので、一旦ここで切ります。



0 件のコメント:

コメントを投稿

iOSアプリの開発(100 Days of SwiftUI) Day 26 – Project 4, part one

100 Days of SwiftUIの Day26 です。 今日から新しいプロジェクトを始めます。SwiftUIのスキルをさらに磨きながら、プログラミングの魅力的な分野である機械学習にも挑戦していきます。 オックスフォード大学で教鞭を執るスウェーデン人教授、ニック・ボストロムは...