パッケージを追加したのに、SwiftUIのコードから使えない。 最短の確認方法は、授業指定の依存条件を選び、必要な製品をAppターゲットに追加してからビルドすることです。

この記事は、Xcodeで初めてコードパッケージを追加する学生向けです。 授業テンプレートのバージョン指定を守りたい人や、Windows・学校のPCで課題環境を用意する人も対象です。

SwiftUI課題での依存関係の役割

依存関係とは、アプリに機能を加えるため、ほかの人が公開したコードパッケージをプロジェクトから利用する設定です。Swift Package Managerは、そのパッケージを取得し、バージョンなどの条件に従ってプロジェクトで使えるように管理します。

ここで扱うのは、SwiftUIアプリのプロジェクトにパッケージを追加する作業です。コマンドラインツールを別にインストールする説明ではありません。Xcodeではプロジェクトのパッケージ依存関係から追加でき、詳しい入口と流れはAppleのXcode向けパッケージ追加手順で確認できます。

SwiftUIプロジェクトにパッケージを追加するには、どこから始めますか? 授業資料に指定されたパッケージのURLやバージョン条件を確認し、Xcodeで課題のプロジェクトを開いてから、プロジェクトのパッケージ依存関係を追加します。追加できた表示だけで完了とは判断せず、後で製品のターゲット設定とビルドも確認してください。

授業指定に合わせたバージョン選び

最初に、課題の説明、配布テンプレート、教師の指示を照合します。指定がパッケージ名だけなのか、配布元のURLやバージョン条件まで含むのかで、選ぶ設定が変わります。「最新版なら間違いない」と判断して条件を変えると、授業のサンプルと挙動が異なったり、提出環境でビルドできなくなったりする可能性があります。

Appleの説明にある主な指定方法は、バージョン条件、ブランチ、特定のコミットです。各方法の役割はAppleのパッケージ依存関係の設定説明とSwift Package Managerの依存関係ガイドで確認できます。

  • バージョン条件:指定された範囲に合うリリースを使います。授業資料が範囲を示している場合は、その条件を優先します。
  • ブランチ:特定の開発ブランチを追います。授業側がブランチを指定している場合に限って選びます。
  • コミット:特定の変更内容に固定します。先生やテンプレートがコミットを指定している場合は、別のものに置き換えないでください。
**バージョン、ブランチ、コミットのどれを選べばよいですか?** 授業に指定があるなら、その指定と同じ条件を選んでください。指定がなければ、プロジェクトの説明を先に確認し、独自の判断で固定方法を変更する前に教師へ確認するのが安全です。

パッケージ製品とAppターゲットの接続

パッケージを検索して追加できても、アプリがその機能を使える状態とは限りません。パッケージには複数の製品が含まれることがあり、必要な製品を正しいプロジェクトターゲットに関連付ける必要があります。ターゲットとは、アプリ本体など、Xcodeが別々にビルドする対象のことです。

AppleのXcodeでパッケージをアプリに追加する説明とプロジェクトターゲットの設定手順を参照しながら、次の項目を確認してください。

  • [ ] 授業資料とパッケージの配布元が一致している。
  • [ ] バージョン条件、ブランチ、コミットの選択が授業指定に合っている。
  • [ ] 追加したパッケージに、課題で使う製品が含まれている。
  • [ ] その製品がSwiftUIアプリ本体のターゲットに関連付けられている。
  • [ ] Xcodeのプロジェクト表示で依存関係を確認できる。
  • [ ] パッケージを使うコードを含めて、プロジェクトをビルドした。
**追加後にどの製品を選ぶべきですか?** 課題のコードが必要とする製品を選び、アプリ本体のターゲットに追加します。製品名が分からない場合は、配布元の説明や授業資料を照合し、似た名前のものを推測で選ばないでください。

共同作業とPackage.resolvedの扱い

Package.resolvedは、依存関係の解決結果を記録するファイルです。つまり、プロジェクトが実際に選んだパッケージの状態を、チーム内で確認する手掛かりになります。Swift Package Managerの役割や解決の考え方はAppleのSwiftパッケージ資料も参照してください。

授業プロジェクトをGitで共有する場合でも、このファイルを必ず提出・共有するとは限りません。課題テンプレートやチームの運用ルールを確認し、指定があればそれに従います。メンバー間で依存条件や解決結果が食い違ったときは、まず変更差分と授業指定を比べ、ファイルを消したりバージョンを更新したりする前に原因を絞り込みましょう。

ビルド失敗と機能が使えない場合の切り分け

エラーを見たら、すぐに依存関係を削除したり更新したりせず、どこまで設定できているかを確認します。Xcodeの構成やビルドに関する一般的な問題の確認方法も参考にし、表示されたエラーに沿って調べてください。

  • パッケージの取得や解決が終わらない:依存関係の状態、配布元、指定条件を確認します。ネットワークだけが原因と決めつけず、エラー表示や授業指定との不一致も調べます。
  • パッケージは表示されるが、型や機能を参照できない:必要な製品が選ばれているか、Appターゲットに関連付けられているかを確認します。
  • バージョンの競合が表示される:授業で指定された条件と、ほかの依存関係の条件を照合します。課題の条件を独断で変えず、エラーの内容を教師やチームに共有してください。
  • 設定後にビルドエラーが出る:最初に表示されたエラーと該当するコードを確認します。依存関係の取得、製品の追加、アプリのコードのどこで止まっているかを分けて考えます。
「追加済み」という表示だけを根拠に、パッケージがアプリで使えると判断しないことが大切です。依存関係の設定、ターゲットへの関連付け、ビルド成功は別々に確認します。

Windowsや学校のPCで作業するときの環境判断

手元にMacがなくても、SwiftUIの依存関係を設定できますか? 資料を読むことと、Xcodeで課題プロジェクトを設定してビルドすることは別です。課題でXcodeの操作やビルドが求められるなら、利用できるMac環境が必要です。必要なmacOSとXcodeの条件は、作業前にAppleのXcodeシステム要件で確認してください。

まず、提出物がコードの提出だけなのか、Xcodeでのビルドや実行まで含むのかを課題要項で確かめます。学校のPCでXcodeを起動できない、必要な権限がない、作業データを保存できない場合は、管理者や教師に利用条件を確認してください。Macを短期間だけ使いたい場合は、MACGPUのMac利用案内で利用条件を確認し、課題データを扱ってよい環境かどうかも授業の規則に照らして判断できます。

Windowsだけの環境では、Xcodeの画面操作やSwiftUIアプリのビルド確認をそのまま代替できません。一方、Macを購入すれば初期費用がかかり、学校の共有PCでは利用時間や権限に制約がある場合があります。長期にわたり毎日使うなら自分のMacを検討し、課題期間だけXcodeで依存関係を設定して確認したいなら、遠隔Macの利用も選択肢になります。短期利用を検討する場合は、MACGPUのMacプラン案内で条件を確認してください。授業で許可された環境であることを確かめたうえで、課題プロジェクトを開き、パッケージ追加からビルドまで一通り実行できるかで選ぶのが確実です。