Symptom: Das Paket wird in Xcode angezeigt, aber im SwiftUI-Projekt lässt sich die benötigte Funktion nicht verwenden. Schnellste Lösung: Verwenden Sie den Xcode-Einstieg für Paketabhängigkeiten, halten Sie die Kursvorgabe zur Version ein, ordnen Sie das benötigte Produkt dem App-Ziel zu und prüfen Sie anschließend den Build.

Dieser Leitfaden ist für Sie, wenn Sie einem SwiftUI-Projekt erstmals ein Paket hinzufügen und den richtigen Einstieg in Xcode suchen. Er hilft Ihnen außerdem, eine vorgegebene Paketversion nicht versehentlich zu ändern und die Einbindung in Ihrem Projekt zu kontrollieren. Wenn Sie hauptsächlich Windows oder einen Schulcomputer nutzen, erfahren Sie, wann Sie tatsächlich eine macOS-Umgebung für die Aufgabe brauchen.

Erst klären: Was verlangt Ihre SwiftUI-Aufgabe?

Swift Package Manager verwaltet Abhängigkeiten: Damit sind Pakete gemeint, deren wiederverwendbarer Code Ihr Projekt verwenden soll. Für eine SwiftUI-Aufgabe geht es normalerweise nicht darum, ein allgemeines Kommandozeilenwerkzeug zu installieren. Entscheidend ist, dass Xcode das Paket für Ihr App-Projekt auflöst und das benötigte Produkt mit dem richtigen Ziel verbindet.

Ein Paket kann Funktionen oder Bibliotheken enthalten. Ein Produkt ist der Teil des Pakets, den ein anderes Projekt einbinden kann. Ein Projektziel – in Xcode als Target bezeichnet – beschreibt, was gebaut wird, etwa Ihre App. Hat ein Paket mehrere Produkte oder verwendet Ihr Projekt mehrere Ziele, reicht es nicht, nur den Paketnamen zu sehen: Sie müssen kontrollieren, welches Produkt Ihre App tatsächlich erhält.

Bevor Sie Xcode öffnen, lesen Sie die Aufgabenbeschreibung und gegebenenfalls die Projektvorlage. Halten Sie fest, welche Paketadresse, Versionsregel und App-Funktion verlangt werden. Wenn dort eine konkrete Auswahl steht, ist diese für die Abgabe wichtiger als der Wunsch, automatisch „das Neueste“ zu verwenden.

<
Ihre AusgangslageSinnvolle WahlWas Sie damit vermeiden
Die Kursvorlage nennt Paketadresse und VersionsregelÜbernehmen Sie beide Angaben unverändert und vergleichen Sie sie vor dem Hinzufügen mit der Vorlage.Eine Abweichung, die das Projekt Ihrer Lehrkraft oder Ihrer Gruppe anders auflöst.
Die Aufgabe nennt nur eine Adresse, aber keine genaue VersionPrüfen Sie Kursunterlagen und Hinweise zum Paket, bevor Sie eine Versionsregel auswählen.Eine scheinbar naheliegende Auswahl, die nicht zu den Erwartungen des Projekts passt.
Ihr Projekt ist Teil einer GruppenarbeitStimmen Sie Versionsregel und Umgang mit Package.resolved im Team ab.Unterschiede zwischen lokalen Entwicklungsständen, die sich erst beim Bauen bemerkbar machen.
Sie arbeiten an einem Schulcomputer oder unter WindowsPrüfen Sie, ob Sie Xcode öffnen und die App bauen müssen oder ob nur eine Erklärung verlangt wird.Zeit für eine ungeeignete Umgebung einzuplanen, obwohl die Aufgabe keinen Xcode-Build verlangt.
Die offizielle [Xcode-Dokumentation zum Hinzufügen von Paketabhängigkeiten](https://developer.apple.com/documentation/xcode/adding-package-dependencies-to-your-app?language=swift) beschreibt, wie Paketabhängigkeiten in ein App-Projekt aufgenommen und Anforderungen für die Auflösung festgelegt werden. Die allgemeine [Übersicht zu Swift-Paketen in Xcode](https://developer.apple.com/documentation/xcode/swift-packages) hilft Ihnen, den Paketbegriff von einer fertigen App oder einem einzelnen Quelltext zu unterscheiden.

**Achtung:** Wenn die Aufgabenbeschreibung eine Paketadresse oder einen Stand ausdrücklich nennt, ändern Sie diese Vorgabe nicht eigenmächtig. Eine geänderte Abhängigkeit kann dazu führen, dass Ihre Abgabe nicht mehr dem Kursprojekt entspricht, selbst wenn Xcode sie erfolgreich baut.

Die Versionswahl an Kurs und Vorlage ausrichten

Xcode kann Anforderungen verwenden, die sich auf eine Version, einen Branch oder einen Commit beziehen. Das sind drei unterschiedliche Arten, den gewünschten Stand eines Pakets zu beschreiben; die Apple-Erklärung zu Paketabhängigkeiten führt diese Auswahlmöglichkeiten im Kontext des Hinzufügens auf.

  • Versionsregel: Sie legen fest, welchen veröffentlichten Versionsbereich Xcode berücksichtigen darf. Das passt, wenn die Kursunterlagen eine Version oder Regel für veröffentlichte Versionen vorgeben.
  • Branch: Die Abhängigkeit orientiert sich an einem benannten Entwicklungszweig. Verwenden Sie dies nur, wenn die Vorlage oder die Lehrkraft genau diesen Weg verlangt.
  • Commit: Die Auswahl verweist auf einen bestimmten Änderungsstand. Das ist eine präzise Vorgabe, die Sie nicht durch eine allgemeine Versionsregel ersetzen sollten.
Die Optionen sind keine Qualitätsstufen. Ein Branch ist nicht automatisch „aktueller und besser“, und ein fester Commit ist nicht automatisch für jede Aufgabe richtig. Ihre Entscheidung richtet sich nach dem Material, mit dem Ihr Kursprojekt erstellt wurde. Wenn die Vorlage eine konkrete Regel nennt, dokumentieren Sie diese für Ihre Gruppe und übernehmen Sie sie im Xcode-Dialog. <
Auswahl in XcodeWoran die Abhängigkeit gebunden istWann Sie sie verwenden
VersionsregelAn veröffentlichte Versionen innerhalb der gewählten RegelWenn die Kursvorgabe eine veröffentlichte Version oder einen entsprechenden Rahmen beschreibt
BranchAn den Entwicklungsstand eines benannten ZweigsWenn die Aufgabe ausdrücklich einen Branch vorgibt
CommitAn einen bestimmten ÄnderungsstandWenn die Vorlage oder Kursanweisung diesen Stand nennt
Lassen Sie sich nicht von der Bezeichnung eines Auswahlfelds zu einer Aktualisierung verleiten. Wenn eine vorhandene Kursvorlage mit einer bestimmten Regel arbeitet, kann eine andere Auswahl die aufgelöste Abhängigkeit verändern. Klären Sie Unklarheiten erst anhand der Unterlagen oder mit der Lehrkraft, statt mehrere Varianten auszuprobieren und anschließend nicht mehr zu wissen, welche Variante zur Abgabe gehört.

Die Dokumentation des Swift Package Manager zum Hinzufügen von Abhängigkeiten ergänzt die Xcode-Beschreibung um die Begriffe und Abläufe auf Ebene des Paketmanagers. Verwenden Sie sie zum Nachschlagen; für die konkrete Einbindung in eine SwiftUI-App folgen Sie dem Xcode-Projekt und dessen Kursvorgaben.

Das Paket hinzufügen und dem App-Ziel zuordnen

Gehen Sie in Xcode gezielt vor. Die genauen Bezeichnungen und die Darstellung der Oberfläche können sich mit der installierten Xcode-Version ändern; orientieren Sie sich daher bei abweichenden Menüs an der aktuellen Anleitung zum Hinzufügen von Paketabhängigkeiten.

  1. Öffnen Sie das richtige Projekt. Prüfen Sie den Projektnamen und stellen Sie sicher, dass Sie nicht versehentlich eine Kopie oder eine andere Abgabe geöffnet haben.
  2. Rufen Sie den Bereich zum Hinzufügen von Paketabhängigkeiten auf. Nutzen Sie den dafür vorgesehenen Xcode-Einstieg, nicht eine Anleitung zur Installation eines beliebigen Kommandozeilenprogramms.
  3. Geben Sie die Paketadresse aus der Kursvorgabe ein. Vergleichen Sie Schreibweise und Quelle mit der Vorlage. Raten Sie keine Adresse, wenn die Aufgabenunterlagen sie nicht nennen.
  4. Wählen Sie die verlangte Versionsart und Regel. Übernehmen Sie eine angegebene Version, einen Branch oder einen Commit. Ist die Vorgabe unklar, halten Sie vor der Auswahl Rücksprache.
  5. Prüfen Sie die angebotenen Paketprodukte. Wählen Sie das Produkt, das zur Aufgabe gehört, und kontrollieren Sie, ob es dem App-Ziel Ihrer SwiftUI-Anwendung zugewiesen wird.
  6. Warten Sie die Auflösung ab und bauen Sie das Projekt. Beachten Sie die Meldungen in Xcode. Eine erfolgreiche Paketauflösung allein beweist noch nicht, dass die App mit der gewünschten Funktion gebaut werden kann.
  7. Kontrollieren Sie den Projektstand für die Abgabe. Prüfen Sie, ob die Paketangaben und die Änderungen der Projektvorlage entsprechen, bevor Sie die Arbeit teilen oder einreichen.
Ein häufiger Denkfehler ist „Paket gefunden = App fertig“. Xcode kann ein Paket erkennen und auflösen, während das benötigte Produkt noch nicht mit dem App-Ziel verbunden ist. Falls Ihre Datei den erwarteten Modulnamen nicht verwenden kann oder die Funktion beim Bauen fehlt, kontrollieren Sie zuerst die Produkt- und Zielzuordnung. Die Apple-Anleitung zum [Konfigurieren eines neuen Projektziels](https://developer.apple.com/documentation/xcode/configuring-a-new-target-in-your-project?language=objc) erklärt, warum Ziele eigene Einstellungen und Zuständigkeiten haben können.

In der Gruppe Package.resolved nachvollziehbar behandeln

Arbeiten Sie mit anderen an einem SwiftUI-Kursprojekt, sollten alle Beteiligten verstehen, welche Abhängigkeit Xcode tatsächlich aufgelöst hat. Package.resolved hält den aufgelösten Paketstand fest. Es ist damit eine Information über die konkrete Auflösung und nicht bloß ein Ersatz für die verständliche Versionsvorgabe, die Sie im Projekt oder in der Kursdokumentation festhalten.

Vereinbaren Sie im Team, wie die Datei im gemeinsamen Projekt behandelt wird. Folgen Sie dabei den Kursunterlagen und den Regeln des verwendeten Versionsverwaltungssystems. Es gibt keine pauschale Regel, dass jede Lehrveranstaltung die Datei auf genau dieselbe Weise ein- oder ausschließen muss. Die passende Entscheidung hängt vom Projektaufbau und der Abgabeform ab.

Wenn ein Gruppenmitglied nach dem Abruf des Projektstands andere Paketversionen oder Build-Ergebnisse sieht, vergleichen Sie zunächst die Kursvorgabe, die Xcode-Anforderungen und die lokale Meldung zur Abhängigkeitsauflösung. Vermeiden Sie es, Package.resolved ohne Diagnose zu löschen: Damit entfernen Sie möglicherweise genau den Hinweis, der den Unterschied zwischen den Entwicklungsständen sichtbar macht. Informationen zur Verfügbarkeit und Auflösung von Abhängigkeiten in Xcode finden Sie in der Apple-Dokumentation zu Abhängigkeiten in Xcode Cloud; verwenden Sie sie als technische Einordnung, nicht als Vorgabe für die Abgaberegel Ihres Kurses.

Bei einem Fehler nach sichtbarem Symptom prüfen

Wenn das Paket erscheint, aber der Build scheitert, ordnen Sie die Meldung zunächst einer Fehlerart zu. So ändern Sie nicht vorschnell eine funktionierende Versionsregel, obwohl das eigentliche Problem eine fehlende Zielzuordnung oder ein Fehler im App-Code ist.

  • Die Abhängigkeit wird nicht aufgelöst: Prüfen Sie Paketadresse, ausgewählte Versionsanforderung und die von Xcode angezeigte Auflösungsmeldung. Eine Netzwerkstörung ist möglich, aber nicht die einzige Erklärung; auch eine unpassende Vorgabe oder nicht erreichbare Paketquelle kann relevant sein.
  • Das Paket ist sichtbar, der Code erkennt das Modul aber nicht: Prüfen Sie, ob Sie das passende Produkt dem App-Ziel hinzugefügt haben. Kontrollieren Sie, ob die betreffende Datei tatsächlich zu diesem Ziel gehört.
  • Xcode meldet einen Versions- oder Anforderungsfehler: Vergleichen Sie die gewählte Regel mit der Kursvorlage. Ändern Sie nicht auf Branch oder Commit, nur um die Meldung zu umgehen; klären Sie zuerst, welcher Stand verlangt wird.
  • Die Fehlermeldung verweist auf Ihren App-Code: Unterscheiden Sie einen Fehler in der Abhängigkeit von einem Fehler in Ihrer Nutzung der Schnittstelle. Ein Paket kann korrekt eingebunden sein, während der Aufruf oder die SwiftUI-Ansicht nicht zur erwarteten API passt.
  • Der Build stoppt mit einer allgemeinen Projekt- oder Konfigurationsmeldung: Lesen Sie die erste konkrete Fehlermeldung und prüfen Sie anschließend die betroffenen Einstellungen. Die Apple-Seite zu häufigen Konfigurations- und Build-Problemen in Xcode bietet dafür eine offizielle Orientierung.

**Erst prüfen, dann zurücksetzen:** Löschen Sie weder Projektdateien noch Paketdaten auf Verdacht. Notieren Sie die genaue Fehlermeldung, vergleichen Sie sie mit der Vorlage und ändern Sie jeweils nur den Punkt, der zur beobachteten Fehlerart passt.

Checkliste für die Abnahme Ihres Kursprojekts

Bevor Sie die Arbeit als fertig betrachten, führen Sie diese Prüfungen am tatsächlichen SwiftUI-Projekt aus. Die Liste trennt die Vorgabe, die Xcode-Einbindung und den erfolgreichen Bau voneinander:

  • [ ] Die Aufgabenbeschreibung oder Vorlage nennt die benötigte Paketquelle.
  • [ ] Die gewählte Versionsregel entspricht der Kursvorgabe.
  • [ ] Das passende Paketprodukt ist dem App-Ziel zugeordnet.
  • [ ] Package.resolved und die Teamabsprache widersprechen der Projektvorgabe nicht.
  • [ ] Xcode hat die Abhängigkeit ohne ungeklärte Auflösungsmeldung verarbeitet.
  • [ ] Das Projekt baut nach der Einbindung erfolgreich.
  • [ ] Die Funktion, für die das Paket benötigt wird, ist im Kursprojekt an der vorgesehenen Stelle verwendbar.
  • [ ] Vor der Abgabe ist nachvollziehbar, welche Version oder Anforderung verwendet wurde.
Für eine Abnahme zählt nicht nur, dass Xcode den Paketnamen anzeigt. Sie brauchen einen erfolgreichen Build und müssen die geforderte Funktion in Ihrem Projekt prüfen. Die Dokumentation zu den [Systemvoraussetzungen von Xcode](https://developer.apple.com/xcode/system-requirements/) hilft Ihnen außerdem festzustellen, ob Ihre verfügbare macOS-Umgebung grundsätzlich zu Ihrer installierten Xcode-Version passt; verlassen Sie sich dabei auf die Angaben für die tatsächlich verwendete Version.

Wenn Windows oder der Schulcomputer Xcode verhindert

Sie können Konzepte von Swift Package Manager und Paketabhängigkeiten auch ohne Xcode nachlesen. Das ersetzt aber nicht die Konfiguration in einem SwiftUI-App-Projekt, wenn die Lehrveranstaltung verlangt, die Abhängigkeit in Xcode hinzuzufügen, einen Build auszuführen oder das Ergebnis dort zu prüfen. Fragen Sie deshalb zuerst, was genau eingereicht werden muss: eine Erklärung, der Quelltext oder ein in Xcode gebautes Projekt.

Prüfen Sie bei einem Schulcomputer zusätzlich, ob Sie Software installieren dürfen, ob ein bereits eingerichtetes macOS-Gerät zur Verfügung steht und ob die Kursregeln eine entfernte Entwicklungsumgebung zulassen. Beachten Sie bei einem geteilten Gerät auch, wer auf Projektdateien und Zugangsdaten zugreifen kann. Speichern Sie keine privaten Schlüssel oder persönlichen Daten in einer Umgebung, deren Datenschutz- und Zugriffsregeln Sie nicht kennen.

Wenn Ihr Kurs Xcode ausdrücklich voraussetzt und Ihnen kein geeigneter Mac zur Verfügung steht, kann eine entfernte Mac-Umgebung die fehlende Arbeitsumgebung bereitstellen. Sie sollten vorab klären, ob Ihre Hochschule oder Lehrkraft eine solche Nutzung erlaubt, wie Sie das Projekt übertragen dürfen und ob Sie den Build selbst prüfen können. Informationen zu einer möglichen Mac-Umgebung bei MACGPU können Sie erst nach dieser Prüfung heranziehen; eine Remote-Umgebung ist nicht automatisch für jede Datenschutzregel, jede Geräteanforderung oder jede Abgabe geeignet.

Entscheidung: Wenn Sie nur Swift-Syntax üben oder die Dokumentation lesen sollen, brauchen Sie für diese Vorbereitung nicht automatisch eine Xcode-Umgebung. Wenn Sie dagegen ein SwiftUI-Projekt in Xcode konfigurieren und bauen müssen, reicht ein Windows-Rechner allein für diesen Arbeitsschritt nicht aus. Prüfen Sie außerdem, ob Sie eine Umgebung nur für eine begrenzte Kursaufgabe benötigen oder regelmäßig an iOS-Projekten arbeiten: Bei langfristiger, gleichmäßiger Nutzung kann ein eigener Mac sinnvoller sein als eine wiederkehrende Miete.

Ein Schulcomputer kann bei Installationsrechten, Verfügbarkeit und gleichbleibendem Projektzugriff Grenzen setzen; unter Windows fehlt Ihnen für den Xcode-Schritt die native macOS-Entwicklungsumgebung. Wenn Sie diese Hürden umgehen müssen, aber noch keinen eigenen Mac anschaffen möchten, kann das Mieten eines Mac über MACGPU für die konkrete Xcode-Aufgabe komfortabler sein: Sie arbeiten an einer echten macOS-Umgebung, statt den entscheidenden Projektschritt auf einem ungeeigneten Gerät zu erzwingen. Prüfen Sie vorab die Kursregeln und Ihre Zugriffsanforderungen; Details zu einer möglichen Mac-Miete bei MACGPU sollten Sie anhand Ihres tatsächlichen Bedarfs bewerten.