【保存版】Apple Watchアプリ開発を始めるための環境構築と、実機デプロイでハマったポイント
はじめに
「Apple Watchで自分専用のツールを作りたい！」と思い立ち、いざ開発を始めてみると、iPhoneアプリ開発とは違った独特の作法や「お作法」に戸惑うことが多々ありました。
今回は、開発を始めるための環境構築から、実機で動かすまでに私が実際に遭遇したトラブルとその解決策をシンプルにまとめます。
1. 開発環境の準備（必要なもの）
まずはここからです。2026年現在の最新環境をベースにしています。
- Mac: Xcodeを動かすための必須アイテム。
- Xcode: App Storeから最新版をインストール。
- iPhone & Apple Watch: 実機テスト用。
- Apple Developer Program (無料枠でOK): 実機転送に必要。
2. プロジェクトの作成手順
Xcodeを開いてからの最短手順です。
- File > New > Project を選択。
- watchOS > App を選ぶ。
-
Deployment Type は、Watch単体で動かすなら「Watch-only」、iPhoneと連携させるなら「Watch App with Companion iPhone App」を選択。
- ※最初は「Watch-only」の方がシンプルで始めやすいです。
3. 実機デプロイで絶対にハマる「3つの壁」と解決策
シミュレーターでは動くのに、実機（自分の腕）で動かそうとすると急に難易度が上がります。
① 「デベロッパモード」がOFFで起動しない
iPhoneとWatchの両方で、開発用モードをONにする必要があります。
- 解決策: iPhoneの「設定 > プライバシーとセキュリティ > デベロッパモード」をONにして再起動。Watch側でもプロンプトが出たら承認します。
② XcodeがWatchを認識しない
MacにiPhoneを繋いでも、ペアリングされているはずのWatchが候補に出てこないことがあります。
- 解決策: iPhoneとMacを有線で繋ぎ、iPhoneのロックを解除した状態でしばらく待つと、Watchがデプロイ先として現れます。
③ アプリアイコンが「白いグリッド」のまま
アイコンを変えたはずなのに、Watchのホーム画面で反映されない問題です。
-
解決策:
Assets.xcassets内のすべてのサイズ（特に1024pxのマスター）を埋めること。反映されない場合は、一度Watchからアプリを消して、Watch本体を再起動してから入れ直すと直ります。
4. 開発中に「これには参った」と思ったこと
-
画面が小さすぎる: SwiftUIの
VStackやHStackを多用すると、すぐに要素が画面外に消えます。ScrollViewで囲むのが鉄則だと学びました。 - プレビューが遅い: XcodeのCanvas（プレビュー）が止まることが多いため、こまめに実機かシミュレーターでビルドする方が結果的に速いです。
おわりに
Apple Watchアプリの開発は、iPhoneとは違う「制約の中での楽しさ」があります。自分の腕で自作のコードが動いた瞬間の感動は、何物にも代えがたいものです。
これからWatchアプリを作ろうとしている皆さん、環境構築でつまずいていませんか？
もし「ここが動かない！」「こんなエラーが出た」ということがあれば、ぜひコメントで教えてください。みんなで知見を共有して、楽しいアプリ開発ライフを送りましょう！