Swift 6.4: Wie erstellen Sie Ihr erstes Swift Package? Einsteiger-Tutorial 2026

Datenpunkt: Die Swift.org-Installationsseite führt release/6.4.x unter „Development Snapshots“; sie kennzeichnet diese Snapshots als Vorabversionen, nicht als reguläre Veröffentlichung. Prüfen Sie daher zuerst die aktive Toolchain und die Kursvorgabe. Erstellen Sie dann mit dem Swift Package Manager ein kleines Bibliotheks- oder Kommandozeilenprojekt und kontrollieren Sie es durch Build und Tests. Verwenden Sie einen solchen Snapshot zunächst nur für ein separates Übungsprojekt, nicht ungeprüft für eine benotete Abgabe (Swift.org: macOS-Installation und Snapshot-Status).

Geeignet für: Swift-Anfänger, die erstmals ein Projekt erstellen und bauen möchten.
Auch passend für Windows- oder Schulcomputer-Nutzende, deren Kurs eine macOS-Umgebung verlangt.
Wer einer festgelegten Kursversion folgt, kann damit zunächst die Toolchain prüfen, statt sie vorschnell zu wechseln.

Zuletzt geprüft am 05.10.2026. Quellenabgleich: Swift.org macOS-Installationsseite, Swift Package-Einstieg und Apple-Dokumentation zu Command Line Tools.

[ SECTION_01 ] Vor dem ersten Befehl: Das richtige Projekt für die Übung wählen

Ein Swift Package ist eine organisierte Sammlung von Swift-Dateien mit einer Projektbeschreibung. Es hilft, Code zu bauen und zu testen. Es ist aber nicht automatisch ein vollständiges iOS-App-Projekt mit Bedienoberfläche, App-Einstellungen und allen Xcode-Arbeitsabläufen. Wenn eine Kursaufgabe ausdrücklich ein Xcode-App-Projekt verlangt, sollte ein einfaches Package nicht als Ersatz dafür eingereicht werden.

Für die Entscheidung genügt zunächst ein Blick auf das gewünschte Ergebnis: Soll eine Funktion später in mehreren Projekten verwendbar sein, passt eine Bibliothek. Soll ein kleines Programm direkt im Terminal laufen, ist eine ausführbare Vorlage naheliegend. Wird eine iOS-App mit Oberfläche verlangt, sollten Sie klären, ob zusätzlich ein Xcode-Projekt erforderlich ist. Die offizielle Einführung in den Aufbau und Zweck von Swift Packages beschreibt, wie Manifest, Quellcode und Tests zusammengehören.

Übungsziel	Passender Einstieg	Woran Sie die Vorlage erkennen	Bewertung für den Einstieg
Kleine Funktion bereitstellen und testen	Bibliotheks-Package	Swift-Code liegt in einem Bibliotheksziel; Tests prüfen dessen Verhalten	Gut, wenn die Aufgabe wiederverwendbaren Code behandelt
Ein Programm im Terminal starten	Ausführbares Package	Ein ausführbares Ziel enthält den Programmeinstieg	Gut für eine kurze, direkt sichtbare Übung
iOS-App mit Oberfläche bauen	Xcode-App-Projekt nach Kursvorgabe	Die Aufgabe verlangt eine App und gegebenenfalls Xcode-Funktionen	Nicht durch ein Package allein abgedeckt

Die Bewertung bezieht sich auf den Übungszweck, nicht auf eine allgemeine Rangliste. Ein Bibliotheksprojekt ist nicht „besser“ als ein Kommandozeilenprojekt; es löst eine andere Aufgabe.

Achtung: Wenn die Abgabe ein bestimmtes Projektformat oder eine bestimmte Swift-Version verlangt, hat diese Vorgabe Vorrang vor einer neueren Snapshot-Version. Fragen Sie bei unklaren Anforderungen nach, bevor Sie Ihre Kursumgebung wechseln.

[ SECTION_02 ] Erster Schritt: Die aktive Swift-Toolchain prüfen

Die Toolchain ist der Werkzeugsatz, der Swift-Code verarbeitet. Der Swift Package Manager gehört zu diesem Arbeitsablauf: Er legt Packages an und unterstützt deren Build und Tests. Als einfache Merkhilfe: Die Toolchain ist die Werkbank; das Package beschreibt, welche Teile zu Ihrem Projekt gehören und wie sie zusammenarbeiten.

Öffnen Sie ein Terminal in der Umgebung, in der Sie arbeiten möchten, und führen Sie aus:

swift --version

Vergleichen Sie die angezeigte Version mit der Kursvorgabe. Entscheidend ist nicht, welche Swift-Version Sie irgendwann installiert haben, sondern welcher Swift-Befehl in diesem Terminal tatsächlich ausgeführt wird. Wenn die Ausgabe unerwartet ist, prüfen Sie zuerst, ob Sie im richtigen Terminal beziehungsweise auf dem richtigen Mac arbeiten. Bei einer Xcode-basierten Umgebung können die ausgewählten Command Line Tools relevant sein; die Apple-Dokumentation zur Installation der Command Line Tools und die Referenz zu Xcode-Kommandozeilenwerkzeugen erklären deren Rolle.

Für diese erste Übung ist es meist nicht nötig, mehrere Toolchains zu installieren. Stimmen Kursvorgabe und aktuell aktives Werkzeug überein, arbeiten Sie zunächst damit weiter. Stimmen sie nicht überein, klären Sie die Abweichung vor einer Abgabe. Ein zusätzlicher Snapshot kann beim Ausprobieren neuer Funktionen sinnvoll sein, sollte aber einen funktionierenden Kursstand nicht stillschweigend ersetzen.

[ SECTION_03 ] Zweiter Schritt: Ein leeres Übungsverzeichnis und eine Vorlage anlegen

Legen Sie einen eigenen Ordner für die Übung an. So halten Sie sie von vorhandenen Kursdateien getrennt. Wechseln Sie im Terminal in diesen Ordner und erzeugen Sie das gewünschte Package. Die Swift.org-Anleitungen zeigen die folgenden Vorlagen für Kommandozeilenprojekte und Bibliotheken:

mkdir HalloSwift
cd HalloSwift
swift package init --type executable

Für eine Bibliothek lautet der letzte Befehl stattdessen:

swift package init --type library

Der Ordnername hilft, Ihre Übung wiederzufinden. Der Parameter --type entscheidet, welche Art Vorlage erzeugt wird: ein startbares Programm oder eine Bibliothek. Verwenden Sie für eine einzelne Übung nicht beide Vorlagen im selben Verzeichnis. Wenn Sie beide Varianten kennenlernen möchten, legen Sie dafür zwei getrennte Ordner an.

Nach dem Erzeugen finden Sie in der Regel ein Manifest namens Package.swift, Swift-Quelldateien und – abhängig von der Vorlage – Dateien für Tests. Das Manifest ist die Projektbeschreibung: Es hält fest, wie das Package aufgebaut ist. Für die erste Übung müssen Sie es normalerweise nicht selbst erweitern oder Abhängigkeiten hinzufügen. Die offizielle Dokumentation zum Package-Aufbau hilft, die einzelnen Bestandteile einzuordnen.

[ SECTION_04 ] Dritter Schritt: Eine kleine Änderung im erzeugten Code vornehmen

Öffnen Sie den neu erzeugten Projektordner in Ihrem Editor. Ändern Sie zunächst nur eine Quelldatei aus der Vorlage, nicht das Manifest. Eine kleine Änderung ist leichter nachzuvollziehen als mehrere Umbauten auf einmal.

Bei einem ausführbaren Package können Sie den vorhandenen Einstiegspunkt durch eine einfache Ausgabe ergänzen oder ersetzen:

print("Hallo, Swift!")

Die Ausgabe dient hier als sichtbarer Beleg dafür, dass Ihr Programm gestartet wurde. Sie ist keine besondere Swift-Funktion; sie macht lediglich das Ergebnis der Übung unmittelbar erkennbar.

Bei einer Bibliothek schreiben Sie stattdessen eine kleine Funktion in die dafür erzeugte Quelldatei. Eine Funktion kann beispielsweise einen übergebenen Namen begrüßen. Nutzen Sie dabei den Namen des Moduls, den die Vorlage erzeugt hat, und ändern Sie nicht gleichzeitig die Ordnerstruktur. Die zugehörige Testdatei kann anschließend prüfen, ob die Funktion das erwartete Ergebnis liefert. Die Bibliotheksanleitung von Swift.org zeigt das Zusammenspiel aus Quellcode und Testvorlage.

Speichern Sie die Datei und prüfen Sie den geöffneten Pfad. Bei einer Verbindung zu einem Remote Mac muss die Änderung im Projektordner auf dem Remote-Rechner landen. Eine lokale Kopie auf Ihrem Windows-PC ist nicht automatisch dieselbe Datei. Das lässt sich leicht übersehen, wenn Editor und Terminal in unterschiedlichen Umgebungen geöffnet sind.

[ SECTION_05 ] Vierter Schritt: Build, Programmstart und Tests getrennt prüfen

Gehen Sie im Terminal in das Verzeichnis, das Package.swift enthält. Führen Sie zunächst den Build aus:

swift build

Der Build prüft, ob Swift den Projektcode übersetzen kann. Er beweist noch nicht, dass das Programm das gewünschte Verhalten zeigt. Bei einer ausführbaren Vorlage können Sie es anschließend starten:

swift run

Achten Sie darauf, ob die von Ihnen erwartete Ausgabe erscheint. Wenn Ihre Vorlage oder Kursaufgabe Tests enthält, führen Sie sie separat aus:

swift test

Die Swift.org-Anleitung zum Testen von Packages erläutert diesen Testschritt. Bei einem Bibliotheksprojekt ist ein Test besonders hilfreich: Er prüft das Verhalten einer Funktion, ohne dass Sie daraus ein eigenständiges Terminalprogramm machen müssen. Bei einem ausführbaren Projekt zeigt swift run zunächst den Programmstart; Tests kommen hinzu, wenn Testfälle vorhanden oder für die Aufgabe verlangt sind.

Ein erfolgreicher Build und ein erfolgreicher Test beantworten unterschiedliche Fragen. Der Build zeigt, dass der Code übersetzt werden kann. Ein Test überprüft eine festgelegte Erwartung. Der Programmstart zeigt, was ein ausführbares Ziel tatsächlich ausgibt. Für eine saubere Abnahme sollten Sie den passenden Nachweis entsprechend der Kursaufgabe wählen.

Hinweis bei Fehlern: Prüfen Sie erst das aktuelle Verzeichnis, den Befehl und die tatsächliche Swift-Version. Eine Fehlermeldung kann auch durch einen Tippfehler, eine nicht gespeicherte Datei oder eine andere Vorlage entstehen. Ändern Sie die Toolchain nicht, bevor Sie diese einfacheren Ursachen ausgeschlossen haben.

[ SECTION_06 ] Die Übung mit einer kurzen Prüfung abschließen

Nutzen Sie diese Liste, bevor Sie das Projekt als erledigt betrachten:

• [ ] Die Kursaufgabe verlangt wirklich eine Bibliothek, ein Kommandozeilenprogramm oder ein Xcode-App-Projekt.
• [ ] swift --version wurde in genau der Umgebung ausgeführt, in der das Projekt gebaut wird.
• [ ] Die angezeigte Version entspricht der Kursvorgabe oder eine Abweichung wurde geklärt.
• [ ] Das Package liegt in einem eigenen Übungsordner.
• [ ] Bearbeitet wurde die generierte Quelldatei, nicht versehentlich eine lokale oder andere Projektkopie.
• [ ] swift build wurde ausgeführt; bei einem Programm wurde zusätzlich swift run geprüft.
• [ ] Tests wurden ausgeführt, wenn die Vorlage oder die Aufgabe Testfälle vorsieht.
• [ ] Für die Abgabe bleiben die von der Kursvorgabe benötigten Dateien erhalten.

Wenn ein Kurs eine bestimmte Toolchain vorgibt, dokumentieren Sie diese Information zusammen mit Ihrer Übung. Ein Snapshot, der auf dem eigenen Rechner funktioniert, garantiert nicht, dass die Kursumgebung oder die Bewertungsumgebung denselben Stand verwendet. Das ist kein Grund, Snapshots grundsätzlich zu vermeiden; es ist ein Grund, sie zunächst getrennt zu testen.

[ SECTION_07 ] Häufige Fragen zu Swift Packages

Muss für jedes Swift Package Xcode geöffnet werden?

Nein. Ein Package kann über das Terminal angelegt, gebaut und – je nach Inhalt – getestet werden. Xcode wird wichtig, wenn die Kursaufgabe dessen Funktionen voraussetzt, etwa ein vollständiges App-Projekt oder eine bestimmte grafische Arbeitsweise. Entscheidend ist daher nicht, ob ein Projekt „Swift“ verwendet, sondern welches Ergebnis die Aufgabe verlangt. Klären Sie das Format, bevor Sie ein Package als Abgabeformat auswählen.

Was ist zu tun, wenn swift test fehlschlägt?

Lesen Sie die erste aussagekräftige Fehlermeldung und prüfen Sie, ob das Terminal im Ordner mit Package.swift steht. Kontrollieren Sie danach, ob die Testdatei zum erzeugten Modul passt und ob Ihre Änderung gespeichert wurde. Vergleichen Sie erst anschließend die Toolchain mit der Kursvorgabe. Ein fehlgeschlagener Test allein beweist nicht, dass die Swift-Version falsch ist oder eine neue Installation benötigt wird.

Kann ein Package eine iOS-App ersetzen?

Nicht automatisch. Ein Package kann Swift-Code, der in Projekten genutzt wird, organisieren und testen. Eine iOS-App-Aufgabe kann darüber hinaus ein App-Projekt, eine Oberfläche und weitere Xcode-Einstellungen verlangen. Wenn die Lehrkraft ausdrücklich eine App oder ein Xcode-Projekt fordert, verwenden Sie die dafür vorgegebene Projektform. Ein Package eignet sich dann allenfalls als ergänzender Baustein, sofern die Aufgabe das vorsieht.

Wann ist ein Remote Mac für diese Übung sinnvoll?

Wenn Ihr vorhandener Rechner die benötigte macOS- oder Xcode-Umgebung nicht bereitstellt und der Kurs sie tatsächlich verlangt, kann ein Remote Mac eine Arbeitsumgebung sein. Prüfen Sie vorher, ob die Aufgabe lokal ein Package oder ausdrücklich eine App verlangt und ob die Verbindung zu einer entfernten Maschine in Ihrer Schule zulässig ist. Wenn Ihr bestehendes Gerät die geforderten Schritte erledigt, müssen Sie nicht allein für ein erstes Package die Umgebung wechseln.

Wenn das Package auf dem vorhandenen Rechner korrekt baut und die Tests zur Kursaufgabe passen, können Sie direkt mit der nächsten Swift-Übung fortfahren. Fehlt dagegen eine verbindlich benötigte macOS- oder Xcode-Umgebung, vergleichen Sie zunächst den Aufwand eines eigenen Macs mit einer zeitweisen Nutzung: Ein eigener Rechner bindet Geld und verlangt eigene Pflege; eine nicht passende Umgebung kann Kursanforderungen verfehlen; bei einer entfernten Arbeitsumgebung müssen Verbindung, Datenschutz und Schulregeln berücksichtigt werden. Für einen zeitlich begrenzten Kursversuch kann das Mieten eines echten Macs über NOVAKVM eine Alternative zum sofortigen Kauf sein. Prüfen Sie vorab die Informationen zur Mac-Umgebung und die Mac-mini-Angebotsübersicht, und nutzen Sie diese Option nur, wenn sie die konkrete Aufgabe tatsächlich abdeckt.

Häufige Fragen

Wie lege ich unter Swift 6.4 mein erstes Swift Package an?

Prüfen Sie zuerst mit swift --version, welche Toolchain Ihr Terminal tatsächlich verwendet, und vergleichen Sie diese mit der Vorgabe Ihres Kurses. Wechseln Sie anschließend in einen neuen Übungsordner und erzeugen Sie dort ein ausführbares Package oder eine Bibliothek. Bearbeiten Sie die erzeugten Dateien und prüfen Sie das Ergebnis mit Build und Tests. Ein als Snapshot geführtes Swift 6.4 sollten Sie zunächst nur in einem separaten Übungsprojekt verwenden.

Wie erzeugt der Swift Package Manager ein Swift-Projekt?

Der Swift Package Manager erstellt aus einer Vorlage die Projektstruktur und eine Package.swift-Datei. Für ein ausführbares Übungsprojekt dient swift package init --type executable, für eine Bibliothek swift package init --type library. Die Vorlagen unterscheiden sich bei den Quelldateien und Tests. Beginnen Sie in einem leeren, eigens dafür angelegten Verzeichnis, damit vorhandene Kursdateien nicht versehentlich verändert werden.

Wie prüfe ich, welche Swift-Version mein Mac-Terminal verwendet?

Führen Sie im Terminal swift --version aus. Die Ausgabe beschreibt die Swift-Version des Befehls, den Ihre aktuelle Umgebung aufruft. Wenn auf dem Mac Xcode Command Line Tools oder eine andere Swift-Toolchain eingerichtet ist, kann die ausgewählte Entwicklungsumgebung entscheidend sein. Prüfen Sie deshalb bei abweichenden Ergebnissen zusätzlich den Kursstandard und die aktive Xcode-Entwicklerumgebung, statt vorschnell eine weitere Toolchain zu installieren.

Wie baue und teste ich ein Swift Package nach der Erstellung?

Wechseln Sie in das Verzeichnis mit Package.swift. Mit swift build prüfen Sie, ob das Package kompiliert; bei einer Bibliotheksvorlage können Sie anschließend swift test ausführen. Bei einer ausführbaren Vorlage starten Sie das Programm mit swift run und verwenden Tests, sofern die Vorlage oder Ihr Kurs passende Tests enthält. Schlägt ein Schritt fehl, kontrollieren Sie zuerst Verzeichnis, Toolchain-Version und die konkrete Fehlermeldung.