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 Ausgangslage | Sinnvolle Wahl | Was 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 Version | Prü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 Gruppenarbeit | Stimmen 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 Windows | Prü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. |
**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.
| Auswahl in Xcode | Woran die Abhängigkeit gebunden ist | Wann Sie sie verwenden |
|---|---|---|
| Versionsregel | An veröffentlichte Versionen innerhalb der gewählten Regel | Wenn die Kursvorgabe eine veröffentlichte Version oder einen entsprechenden Rahmen beschreibt |
| Branch | An den Entwicklungsstand eines benannten Zweigs | Wenn die Aufgabe ausdrücklich einen Branch vorgibt |
| Commit | An einen bestimmten Änderungsstand | Wenn die Vorlage oder Kursanweisung diesen Stand nennt |
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.
- Ö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.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
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.resolvedund 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.
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.