Unity dokumentiert den iOS-Ablauf als zwei getrennte Arbeitsschritte: Unity erzeugt das Xcode-Projekt, anschließend erstellt Xcode den Build. Die Unity-Anleitung zum Bauen und Bereitstellen für iOS beschreibt diese Aufteilung. Für Sie heißt das: Exportieren Sie das Projekt auf Ihrem Entwicklungsrechner, übertragen Sie eine vollständige und konsistente Kopie und erledigen Sie Build, iOS-Code-Signierung und Archivierung auf einem Remote-Mac. Prüfen Sie danach das Archiv separat. Ein erfolgreiches Archiv ist weder ein bestätigter Upload noch eine Freigabe durch den App-Review-Prozess.
Dieser Ablauf richtet sich an Sie, wenn Sie Unity 6.6 überwiegend unter Windows oder Linux verwenden und ein iOS-Spiel veröffentlichungsbereit machen möchten.
Er ist auch für Entwickler hilfreich, die bereits ein Xcode-Projekt exportiert haben und eine kontrollierbare Umgebung für Signierung und Archivierung benötigen.
Kleine Teams können damit einen nachvollziehbaren Übergang vom manuellen Unity-Build zum Remote-Mac festlegen.
Vor dem Export: Ziel und Projektumfang festlegen
Bevor Sie Unity öffnen, halten Sie fest, für welches Release Sie bauen. Ein exportiertes Projekt allein ist noch keine fertige iOS-App. Die Unity-Dokumentation für Version 6000.6 beschreibt die iOS-Umgebung und die relevanten Build-Einstellungen; vergleichen Sie die verfügbaren Optionen mit dem Projekt, das Sie tatsächlich ausliefern möchten. Die Umgebungsanforderungen für iOS in Unity 6.6 und die Referenz zu den iOS-Build-Einstellungen sind dafür die Ausgangspunkte.
Notieren Sie vor dem Export:
- Zielgerät und Build-Zweck: Soll die App auf einem Gerät getestet, für eine Beta vorbereitet oder zur Veröffentlichung archiviert werden? Wählen Sie Einstellungen passend zu diesem Ziel; verwechseln Sie einen lokalen Testbuild nicht mit einem Release-Artefakt.
- Bundle Identifier: Legen Sie die App-Kennung fest und vergleichen Sie sie mit der Kennung, die für das vorgesehene Apple-Entwicklerkonto und die App registriert ist.
- Unity-Konfiguration: Dokumentieren Sie die ausgewählten Build-Einstellungen und den Versionsstand des Projekts. So können Sie einen späteren Fehler einer konkreten Projektänderung zuordnen.
- Native Bestandteile: Erfassen Sie Plugins, eingebundene Bibliotheken, zusätzliche Xcode-Konfigurationen und eigene Build-Skripte. Ein Projekt, das ausschließlich aus Unity-Dateien besteht, kann andere Schritte benötigen als ein Projekt mit nativen Erweiterungen.
- Abhängigkeiten: Prüfen Sie, ob Pakete oder externe Ressourcen beim Export erneut aufgelöst werden müssen und ob der Remote-Mac dafür Zugang zu den notwendigen Quellen hat.
Die Kennung, die in Unity und später in den Xcode-Targets verwendet wird, darf nicht versehentlich auseinanderlaufen. Auch der gewünschte Build-Zweck muss durch die Projektkonfiguration und die Signierung abgedeckt sein. Verlassen Sie sich deshalb nicht auf einen früheren Export, wenn sich seitdem Bundle Identifier, Plugins oder Release-Einstellungen geändert haben.
Frage: Was muss vor dem Unity-Export für den späteren Xcode-Build feststehen?
Mindestens Ziel und Build-Zweck, Bundle Identifier sowie der Umfang der nativen Abhängigkeiten. Wenn Sie diese Angaben erst auf dem Remote-Mac zusammensuchen, steigt das Risiko, eine Signierungs- oder Plugin-Abweichung für einen Fehler im Unity-Export zu halten.
Erster Schritt: Ein vollständiges Xcode-Projekt exportieren
Exportieren Sie das iOS-Projekt aus dem für Ihr Release vorgesehenen Unity-Projektstand. Unity trennt die Generierung des Xcode-Projekts vom anschließenden Build in Xcode; ändern Sie daher nicht in Gedanken nur den Exportordner und erwarten Sie eine fertig signierte App. Die Unity-Dokumentation zum Aufbau eines von Unity erzeugten Xcode-Projekts hilft dabei, die erzeugten Bestandteile einzuordnen.
Behandeln Sie den Projektordner als Einheit. Übertragen Sie nicht nur eine einzelne .xcodeproj-Datei, wenn das Projekt weitere Dateien, Ressourcen, generierte Einstellungen oder native Bestandteile benötigt. Bewahren Sie die Ordnerstruktur und die Dateien, auf die das Xcode-Projekt verweist. Bei einer nachgelagerten CocoaPods- oder Swift-Package-Konfiguration können zusätzliche Projektdateien oder ein Workspace relevant sein. Welche davon benötigt werden, hängt von den Abhängigkeiten des konkreten Projekts ab.
Vor der Übertragung sollten Sie außerdem unterscheiden zwischen:
- Projektdateien, die für die Reproduktion des Builds nötig sind;
- lokalen Zwischendateien, die sich beim Öffnen oder Bauen erneut erzeugen lassen;
- geheimen Zugangsdaten, die niemals als gewöhnliche Projektdateien behandelt werden dürfen.
Ein Versionskontrollsystem oder ein sicherer Dateiübertragungsweg kann helfen, auf Entwicklungsrechner und Remote-Mac denselben Projektstand zu verwenden. Notieren Sie dazu die Revision oder ein anderes eindeutiges Kennzeichen Ihres Ausgangsstands. Prüfen Sie nach der Übertragung, ob alle erwarteten Projektordner vorhanden sind und ob die Xcode-Projektdateien nicht auf lokale Pfade zeigen, die nur auf Ihrem Entwicklungsrechner existieren.
Achtung: Committen Sie weder den privaten Schlüssel eines Zertifikats noch exportierte Zertifikatsdateien oder Zugangstoken in das Projekt-Repository. Apple beschreibt Zertifikate als Teil der Identitäts- und Signierungsinfrastruktur und weist auf den Schutz der zugehörigen privaten Schlüssel hin. Maßgeblich sind die Informationen von Apple zu Zertifikatstypen und ihrem Schutz.
Frage: Wie übertragen Sie das Unity-iOS-Projekt zum Remote-Mac?
Übertragen Sie eine vollständige, konsistente Projektkopie einschließlich der für den Build erforderlichen Ressourcen und nativen Bestandteile. Vergleichen Sie vor dem Build den Projektstand mit Ihrer dokumentierten Revision und halten Sie Signiergeheimnisse davon getrennt.
Auf dem Remote-Mac: Werkzeugkette und Abhängigkeiten prüfen
Öffnen Sie das übertragene Projekt erst dann für den Release-Build, wenn Sie wissen, welche Xcode-Version und welche nativen Abhängigkeiten dafür vorgesehen sind. Die Unity-Handbücher für Unity 6.6 erläutern den iOS-Workflow und die Einstellungen, sie belegen aber nicht automatisch, dass jedes Plugin oder jedes projektspezifische Skript mit jeder installierten Xcode-Version zusammenarbeitet. Prüfen Sie für die konkrete Unity-Version die offiziellen Hinweise und gleichen Sie sie mit den Anforderungen der verwendeten Plugins ab.
Erfassen Sie auf dem Remote-Mac zunächst die installierte Xcode-Version:
xcodebuild -version
Die Ausgabe sollte die installierte Xcode-Version und deren Build-Kennung anzeigen. Notieren Sie diese Angaben zusammen mit der Unity-Projektrevision. Das ist keine Garantie für Kompatibilität, schafft aber eine belastbare Grundlage, wenn ein Build auf einem anderen Rechner anders ausfällt.
Ermitteln Sie anschließend, welche Projektdatei und Schemes Xcode erkennt. Verwenden Sie die passende Variante für das Projekt:
xcodebuild -list -project "Pfad/zum/Projekt.xcodeproj"
Falls die Abhängigkeiten einen Workspace erzeugt haben, prüfen Sie diesen stattdessen:
xcodebuild -list -workspace "Pfad/zum/Projekt.xcworkspace"
Die Pfade sind Platzhalter und müssen durch die tatsächlichen Namen Ihrer exportierten Dateien ersetzt werden. Wenn der Workspace fehlt oder Xcode ein erwartetes Scheme nicht anzeigt, beginnen Sie nicht mit der Signierung: Klären Sie zuerst, ob das Projekt vollständig übertragen und die vorgesehene Abhängigkeitsauflösung durchgeführt wurde.
Bei nativen Plugins, Pods, Swift Packages oder eigenen Skripten gilt: Folgen Sie der offiziellen Anleitung der jeweiligen Abhängigkeit und prüfen Sie deren Ergebnis im konkreten Projekt. Ändern Sie nicht vorsorglich mehrere Einstellungen zugleich. Sonst ist bei einem Fehler schwer festzustellen, ob die Ursache der Unity-Export, eine nicht aufgelöste Abhängigkeit oder eine Änderung in Xcode war.
Vor dem Build: Signierung und Build-Ziel abgleichen
iOS-Code-Signierung umfasst mehr als das Auswählen eines Zertifikats. Das Xcode-Target muss zur App-Kennung, zum Team, zum vorgesehenen Profil und zu den benötigten Entitlements passen. Die Angaben müssen außerdem dem Veröffentlichungsziel entsprechen. Apple beschreibt in seiner Dokumentation zur Vorbereitung einer App für die Verteilung die zu prüfenden Projekteinstellungen.
Gehen Sie die Konfiguration in einer festen Reihenfolge durch:
- Bundle Identifier vergleichen: Prüfen Sie die Kennung in den Xcode-Targets gegen die Release-Angaben, die Sie vor dem Export festgelegt haben.
- Team zuordnen: Kontrollieren Sie, dass das gewählte Team zum vorgesehenen Konto und zur App gehört.
- Signierungsmodus prüfen: Stellen Sie fest, ob Xcode die Signierung automatisch verwalten soll oder ob Sie Zertifikat und Provisioning Profile gezielt zuordnen. Vermeiden Sie widersprüchliche manuelle und automatische Einstellungen.
- Entitlements abgleichen: Prüfen Sie Funktionen, die besondere Berechtigungen erfordern, gegen die Projektkonfiguration und das verwendete Profil. Aktivieren Sie keine Entitlements allein deshalb, weil sie in einer alten Konfiguration auftauchen.
- Build-Konfiguration kontrollieren: Vergewissern Sie sich, dass Sie das gewünschte Scheme und die passende Release-Konfiguration verwenden. Prüfen Sie Version und Build-Nummer gegen den aktuellen Veröffentlichungsvorgang.
- Profilvalidität bestätigen: Verwenden Sie ein zum Zweck und zur App-Kennung passendes Profil. Apple erläutert die Erstellung eines Entwicklungsprofils in der Anleitung zu Development Provisioning Profiles; ein Entwicklungsprofil ist nicht automatisch das passende Mittel für jede Verteilungsart.
Apple-API-Schlüssel und App-Store-Connect-Zugangsdaten sind nicht dasselbe wie Code-Signaturmaterial. Ein API-Schlüssel kann für eine autorisierte Automatisierung oder einen Uploadprozess vorgesehen sein, ersetzt aber weder ein Signaturzertifikat noch ein Provisioning Profile. Speichern Sie private Schlüssel und Zugangsdaten ausschließlich in einem dafür vorgesehenen, zugriffsbeschränkten Speicher. Beschränken Sie die Berechtigungen des Remote-Mac auf die Personen, die den Build tatsächlich ausführen müssen.
Hinweis zum Datenschutz: Bevor Sie Projektdateien, Benutzerkonten oder Signierungsmaterial auf eine gehostete Maschine übertragen, klären Sie, wer Zugriff hat, wie die Datenübertragung geschützt ist und wie Sie Daten nach dem Build entfernen können. Die Hinweise zur Datenschutzpraxis von VPSOmni können Sie in Ihre Prüfung des Dienstes einbeziehen; sie ersetzen nicht Ihre eigene Sicherheitsbewertung.
Frage: Welche Signierungseinstellungen sollten Sie auf dem Remote-Mac prüfen?
Vergleichen Sie Bundle Identifier, Team, Zertifikat, Provisioning Profile, Entitlements und Build-Konfiguration. Wenn eine dieser Zuordnungen nicht zum geplanten Ziel passt, stoppen Sie vor dem Archivieren und korrigieren Sie zuerst die Konfiguration.
Build und Archiv: Fehler nach der tatsächlichen Phase eingrenzen
Bauen Sie zunächst ein repräsentatives Ziel mit dem vorgesehenen Scheme. Wenn der Build scheitert, notieren Sie die genaue Fehlermeldung und ordnen Sie sie einer Phase zu, statt unmittelbar Zertifikate auszutauschen oder Projektdateien neu zu exportieren:
- Unity-Export: Fehlen erwartete Dateien, Einstellungen oder Ressourcen, überprüfen Sie Exportoptionen und Projektstand.
- Abhängigkeiten: Scheitert die Auflösung eines Plugins, Pods oder Pakets, folgen Sie dessen Dokumentation und prüfen Sie Netzwerkzugriff sowie Pfade.
- Xcode-Kompilierung: Bei Compiler- oder SDK-Fehlern vergleichen Sie die verwendete Xcode-Version mit den Vorgaben Ihrer Unity-Version und den nativen Abhängigkeiten.
- Code-Signierung: Bei Identitäts-, Profil- oder Entitlement-Fehlern prüfen Sie die Zuordnung im vorherigen Abschnitt, statt ungeprüft eine andere Identität zu wählen.
- Archivierung: Wenn der Build funktioniert, die Archivierung aber nicht, kontrollieren Sie das gewählte Scheme und die für die Verteilung vorgesehene Konfiguration.
Halten Sie pro Versuch mindestens den Projektstand, die Xcode-Version, das Scheme, die Build-Konfiguration und die relevante Fehlermeldung fest. Entfernen Sie aus Logs alle privaten Schlüssel, Token und sonstigen Zugangsdaten, bevor Sie sie weitergeben. So bleibt die Diagnose brauchbar, ohne Geheimnisse offenzulegen.
Für das Archiv verwenden Sie den vorgesehenen Xcode-Archivierungsablauf. Apple beschreibt Archivierung und Verteilung in der Dokumentation zur Verteilung von Apps für Betatests und Releases. Öffnen Sie anschließend das Archiv in Xcode Organizer und prüfen Sie, ob es zum erwarteten Projekt und Build gehört. Eine erfolgreiche Kompilierung ist noch keine abgeschlossene Archivierung; ein Archiv ist wiederum noch keine Bestätigung, dass ein Upload angenommen oder eine App veröffentlicht wurde.
Frage: Wie erstellen Sie nach dem Unity-Export ein iOS-Archiv auf dem Mac?
Öffnen Sie das exportierte Projekt beziehungsweise den dazugehörigen Workspace in Xcode, prüfen Sie Scheme und Signierung und führen Sie dann den Archivierungsablauf für das vorgesehene Ziel aus. Kontrollieren Sie danach das erzeugte Archiv in Organizer, bevor Sie einen Upload starten.
Vor dem Upload: Ergebnis kontrollieren und den nächsten Schritt wählen
Behandeln Sie das Archiv als prüfbares Übergabeartefakt. Kontrollieren Sie in Xcode Organizer, ob App-Kennung, Versionsangaben, Build-Nummer und Signierung zu Ihrem aktuellen Release-Auftrag passen. Führen Sie die für das gewählte Distributionsziel angebotene Prüfung durch. Wenn Xcode einen Validierungsfehler meldet, korrigieren Sie die Ursache und erstellen Sie ein neues Archiv, statt die Warnung als bloße Formalität zu übergehen.
Nach einem Upload müssen Sie den Status gesondert prüfen. Die Dokumentation von Apple beschreibt, wie Sie hochgeladene Builds und zugehörige Metadaten in App Store Connect anzeigen. Ein lokal validiertes Archiv sagt noch nicht aus, dass der Build auf der Plattform verarbeitet wurde oder für den nächsten Veröffentlichungsschritt bereitsteht. Warten Sie auf den dort angezeigten Status und prüfen Sie, ob der Build dem richtigen App-Datensatz zugeordnet ist.
Für die Entscheidung, ob Sie mit dem Upload fortfahren, verwenden Sie diese Bedingungen:
- Wenn das Archiv zum richtigen Bundle Identifier gehört, die Signierung zum Release-Ziel passt und Organizer keine ungelösten Validierungsfehler meldet, dann können Sie den vorgesehenen Upload-Schritt ausführen.
- Wenn Xcode die Identität oder das Profil nicht eindeutig zuordnet, dann stoppen Sie und gleichen Team, Zertifikat, Profil und Entitlements erneut ab.
- Wenn das Archiv zwar erstellt wurde, aber Version oder Build-Nummer nicht zum Auftrag passen, dann korrigieren Sie die Release-Einstellungen und archivieren Sie erneut.
- Wenn der Upload erfolgt ist, aber App Store Connect den Build noch verarbeitet oder einen Fehler anzeigt, dann behandeln Sie ihn nicht als akzeptiert und prüfen Sie den dort ausgewiesenen Status.
- Wenn die native Abhängigkeit oder Xcode-Kompatibilität ungeklärt ist, dann erstellen Sie zuerst einen reproduzierbaren Projektstand und lösen Sie diese Frage, bevor Sie Signierungsmaterial für weitere Versuche ändern.
| Prüfschritt | Was Sie abgleichen | Weitergehen, wenn … |
|---|---|---|
| Projektstand | Revision, Ressourcen und native Abhängigkeiten | der Remote-Mac denselben vollständigen Stand enthält |
| Werkzeugkette | installierte Xcode-Version und Projektanforderungen | Unity- und Plugin-Hinweise mit der Umgebung vereinbar sind |
| Signierung | Bundle Identifier, Team, Identität, Profil und Entitlements | alle Werte zum vorgesehenen Release-Ziel passen |
| Archiv | Scheme, Konfiguration, Version und Build-Nummer | das Archiv in Organizer dem Auftrag entspricht |
| Upload | Verarbeitung und Build-Zuordnung | App Store Connect den erwarteten Status anzeigt |
Für einen wiederholbaren Ablauf: Übergabe dokumentieren
Wenn Sie den Prozess regelmäßig ausführen, legen Sie eine kurze Übergabevorlage an. Sie sollte keine Geheimnisse enthalten, aber alle Informationen, die für einen reproduzierbaren Build nötig sind: Projektrevision, Unity- und Xcode-Version, ausgewähltes Scheme, verwendete Build-Konfiguration, Abhängigkeiten und Ergebnis der Archivprüfung.
Dokumentieren Sie außerdem, wer Zugriff auf den Remote-Mac und auf die Signierungsidentitäten hat. Ein dauerhaft erreichbarer Build-Rechner ist nur dann hilfreich, wenn Zugänge kontrolliert und Build-Artefakte geordnet abgelegt werden. Verwenden Sie getrennte Speicherorte für Projektkopien, Logs und fertige Archive. Löschen Sie nicht mehr benötigte Kopien sensibler Dateien nach Ihrem festgelegten Verfahren.
Wenn ein Teammitglied den Build übernimmt, sollte es den dokumentierten Projektstand reproduzieren können, ohne private Schlüssel aus einem Repository zu beziehen oder lokale Pfade Ihres Rechners nachzubauen. Prüfen Sie die Einrichtungsinformationen für VPSOmni, bevor Sie den Arbeitsablauf auf einen Remote-Mac übertragen, und klären Sie, welche Zugriffsmethode und Übergabeschritte zu Ihrem Vorhaben passen.
Ein eigener Mac bietet direkten Zugriff auf die lokale Hardware und ist für dauerhaft hohe Build-Last oder den Anschluss bestimmter physischer Geräte oft die passendere Lösung. Ein rein cloudbasierter Build-Dienst kann dagegen Einschränkungen mit projektspezifischen Plugins oder dem benötigten interaktiven Zugriff mitbringen. Ein Remote-Mac ist eine weitere Option, wenn Sie eine echte macOS-Umgebung für Xcode benötigen, aber kein eigenes Gerät dauerhaft für Builds vorhalten möchten. Prüfen Sie dabei vorab, ob die konkrete Umgebung Ihre Unity-Abhängigkeiten, den benötigten Xcode-Ablauf, sichere Zugangsdatenverwaltung und die gewünschte Archivkontrolle unterstützt.
Wenn Ihr aktueller Weg darin besteht, den Xcode-Export auf einem Windows- oder Linux-Rechner liegen zu lassen, bleiben Signierung und Archivierung dennoch offen. Ein einzelner Kauf bindet Kapital und Hardware an diesen Zweck; ein allgemeiner Build-Dienst passt möglicherweise nicht zu allen nativen Bestandteilen; ein unkontrollierter Fernzugriff erschwert die sichere Verwaltung von Signiergeheimnissen. Für einen zeitlich begrenzten Release-Zyklus kann ein gemieteter Remote-Mac von VPSOmni die fehlende macOS-Arbeitsumgebung bereitstellen, ohne dass Sie dafür einen eigenen Mac als Build-Rechner anschaffen müssen. Entscheiden Sie anhand Ihrer tatsächlichen Xcode- und Plugin-Anforderungen und prüfen Sie die verfügbaren Remote-Mac-Optionen von VPSOmni, bevor Sie Projektdateien oder Signierungsmaterial übertragen.
Weiterlesen
Signieren und archivieren Sie Ihr iOS-Projekt mit VPSOmni
Mit VPSOmni nutzen Sie einen dedizierten physischen Mac mini mit Apple Silicon statt einer virtuellen Maschine.
Remote-Mac mieten