Teilen über


Veröffentlichen einer iOS-App für ad-hoc-Verteilung

Ad-hoc-Verteilung wird hauptsächlich zum Testen von Apps innerhalb einer breiten Gruppe von Personen verwendet und steht für das Apple-Entwicklerprogramm und das Apple Developer Enterprise-Programm zur Verfügung. Ein weiterer Anwendungsfall für die Ad-hoc-Verteilung ist die Verteilung innerhalb eines Unternehmens, wenn app Store-Verbinden keine Option ist.

Ad-hoc-Verteilung hat den Vorteil, dass keine App Store-Genehmigung erforderlich ist, wobei Apps mit Apple-Konfigurator installiert werden. Es ist jedoch auf 100 Geräte pro Mitgliedschaftsjahr beschränkt, sowohl für die Entwicklung als auch für die Verteilung, und die Geräte müssen Ihrem Apple-Entwicklerkonto hinzugefügt werden.

Für die Verteilung einer iOS-App muss die App mithilfe eines Bereitstellungsprofils bereitgestellt werden. Bereitstellungsprofile sind Dateien, die Codesignaturinformationen sowie die Identität der App und des vorgesehenen Verteilungsmechanismus enthalten.

Um eine .NET Multi-Platform App UI (.NET MAUI)-iOS-App zu verteilen, müssen Sie ein spezifisches Verteilungsbereitstellungsprofil erstellen. Mit diesem Profil kann die App zur Freigabe digital signiert werden, damit sie auf einem iOS-Gerät installiert werden kann. Ein Ad-hoc-Verteilungsprofil enthält eine App-ID, ein Verteilungszertifikat und eine Liste der Geräte, die die App installieren können. Sie können dieselbe App-ID verwenden, die Sie beim Bereitstellen Ihrer App auf einem Gerät zum Testen verwendet haben. Sie müssen jedoch ein Verteilungszertifikat erstellen, um sich oder Ihre Organisation zu identifizieren, wenn Sie noch kein Zertifikat besitzen.

Der Prozess zum Erstellen eines Ad-hoc-Verteilungsbereitstellungsprofils lautet wie folgt:

  1. Erstellen Sie ein Verteilungszertifikat. Weitere Informationen finden Sie unter Verteilungszertifikat erstellen.
  2. Fügen Sie Ihrem Apple-Entwicklerkonto Geräte hinzu. Weitere Informationen finden Sie unter Hinzufügen eines Geräts.
  3. Erstellen Sie eine App-ID. Weitere Informationen finden Sie unter Erstellen einer App-ID.
  4. Erstellen Sie ein Bereitstellungsprofil. Weitere Informationen finden Sie unter Erstellen eines Bereitstellungsprofils.

Ein Verteilungszertifikat erstellen

Ein Verteilungszertifikat wird verwendet, um Ihre Identität zu bestätigen. Bevor Sie ein Verteilungszertifikat erstellen, sollten Sie sicherstellen, dass Sie Ihr Apple-Entwicklerkonto zu Visual Studio hinzugefügt haben. Weitere Informationen finden Sie unter Apple-Kontoverwaltung.

Sie müssen nur ein Verteilungszertifikat erstellen, wenn Sie noch kein Zertifikat besitzen. Das Distributionszertifikat muss unter Verwendung der Apple ID für Ihr Apple Developer Account erstellt werden.

So erstellen Sie ein Verteilungszertifikat:

  1. Wechseln Sie in Visual Studio zu extras Options >> Xamarin > Apple Accounts.
  2. Wählen Sie im Dialogfeld "Apple-Entwicklerkonten " ein Team aus, und klicken Sie auf die Schaltfläche "Details anzeigen" .
  3. Klicken Sie im Dialogfeld "Details" auf "Zertifikat erstellen", und wählen Sie "iOS-Verteilung" aus. Eine neue Signaturidentität wird erstellt und mit Apple synchronisiert, sofern Sie über die richtigen Berechtigungen verfügen.

Wichtig

Der private Schlüssel und das Zertifikat, aus dem Ihre Signaturidentität besteht, werden auch in den Schlüsselbundzugriff auf Ihrem Mac-Buildhost exportiert, vorausgesetzt, die IDE ist gekoppelt. Weitere Informationen finden Sie unter Mit Mac für die iOS-Entwicklung koppeln.

Grundlegendes zu Zertifikatschlüsselpaaren

Ein Verteilungsprofil enthält Zertifikate, die zugehörigen Schlüssel und alle Bereitstellungsprofile, die Ihrem Apple-Entwicklerkonto zugeordnet sind. Es gibt zwei Versionen eines Verteilungsprofils – eines ist in Ihrem Apple-Entwicklerkonto vorhanden, und das andere befindet sich auf einem lokalen Computer. Der Unterschied zwischen den beiden Schlüsseln besteht darin, welche Art von Schlüsseln sie enthalten: Das Profil in Ihrem Apple-Entwicklerkonto enthält alle öffentlichen Schlüssel, die Ihren Zertifikaten zugeordnet sind, während die Kopie auf Ihrem lokalen Computer alle privaten Schlüssel enthält. Damit Zertifikate gültig sind, müssen die Schlüsselpaare übereinstimmen.

Warnung

Der Verlust des Zertifikats und der zugehörigen Schlüssel kann unglaublich störend sein, da vorhandene Zertifikate widerrufen und Bereitstellungsprofile neu erstellt werden müssen.

Erstellen eines Verteilungsprofils

Mit einem Ad-hoc-Verteilungsprofil kann Ihre .NET MAUI iOS-App digital signiert werden, damit sie auf bestimmten iOS-Geräten installiert werden kann. Ein Ad-hoc-Verteilungsprofil enthält eine App-ID, ein Verteilungszertifikat und eine Liste der Geräte, die die App installieren können. Die geräte, die Sie unterstützen möchten, müssen eine Version von iOS ausführen, die von Xcode unterstützt wird.

Hinzufügen eines Geräts

Wenn Sie ein Bereitstellungsprofil erstellen, muss das Profil angeben, welche Geräte die App ausführen können. Bevor Sie ein Gerät auswählen, das einem Bereitstellungsprofil hinzugefügt werden soll, müssen Sie das Gerät zuerst Ihrem Apple-Entwicklerkonto hinzufügen. Sie können das Gerät mit den folgenden Schritten hinzufügen:

  1. Verbinden das Gerät, das mit einem USB-Kabel auf Ihrem lokalen Mac bereitgestellt werden soll.

  2. Öffnen Sie Xcode, und navigieren Sie zu Fenstergeräten > und Simulatoren.

  3. Wählen Sie in Xcode die Registerkarte "Geräte " und dann das Gerät aus der Liste der verbundenen Geräte aus.

  4. Kopieren Sie in Xcode den Bezeichnerwert in die Zwischenablage:

    Xcode devices and simulator window with the iOS identifier string location highlighted.

  5. Wechseln Sie in einem Webbrowser zum Abschnitt "Geräte" Ihres Apple-Entwicklerkontos, und klicken Sie auf die + Schaltfläche.

  6. Legen Sie auf der Seite "Neues Gerät registrieren" die richtige Plattform fest, und geben Sie einen Namen für das neue Gerät an. Fügen Sie dann den Bezeichner aus der Zwischenablage in das Feld "Geräte-ID(UDID) " ein, und klicken Sie auf " Weiter":

    Register a device by naming it and entering its unique device identifier.

  7. Überprüfen Sie auf der Seite "Neues Gerät registrieren" die Informationen, und klicken Sie dann auf " Registrieren".

Wiederholen Sie die vorherigen Schritte für jedes iOS-Gerät, auf dem Sie eine .NET MAUI iOS-App bereitstellen möchten.

Erstellen einer App-ID

Eine App-ID ist erforderlich, um die App zu identifizieren, die Sie verteilen. Eine App-ID ähnelt einer Reverse-DNS-Zeichenfolge, die eine App eindeutig identifiziert und mit dem Bündelbezeichner für Ihre App identisch sein sollte. Sie können dieselbe App-ID verwenden, die Sie beim Bereitstellen Ihrer App auf einem Gerät zum Testen verwendet haben.

Es gibt zwei Arten von App-ID:

  • Platzhalter Mit einer Wild Karte-App-ID können Sie eine einzelne App-ID verwenden, um mit mehreren Apps übereinzugleichen, und in der Regel wird die Form com.domainname.*verwendet. Eine wild Karte App-ID kann verwendet werden, um mehrere Apps zu verteilen und sollte für Apps verwendet werden, die keine appspezifischen Funktionen aktivieren.
  • Explizit. Eine explizite App ID ist eindeutig für eine einzelne App und hat normalerweise die Form com.domainname.myid. Eine explizite App-ID ermöglicht die Verteilung einer App mit einem übereinstimmenden Bündelbezeichner. Explizite App-IDs werden in der Regel für Apps verwendet, die appspezifische Funktionen wie Apple Pay oder Game Center aktivieren. Weitere Informationen zu Funktionen finden Sie unter "Funktionen".

So erstellen Sie eine neue App-ID:

  1. Navigieren Sie in Ihrem Apple-Entwicklerkonto zu Zertifikaten, IDs und Profilen.

  2. Wählen Sie auf der Seite "Zertifikate, Bezeichner und Profile " die Registerkarte "Bezeichner " aus.

  3. Klicken Sie auf der Seite "Bezeichner " auf die + Schaltfläche, um eine neue App-ID zu erstellen.

  4. Wählen Sie auf der Seite "Neue ID registrieren" das Optionsfeld "App-IDs " aus, bevor Sie auf die Schaltfläche "Weiter " klicken:

    Create an App ID.

  5. Wählen Sie auf der Seite "Neue ID registrieren" die Option "App" aus, bevor Sie auf die Schaltfläche "Weiter" klicken:

    Register an App ID.

  6. Geben Sie auf der Seite "App-ID registrieren" eine Beschreibung ein, und wählen Sie entweder das Optionsfeld "Explizit" oder "Wild Karte Bundle ID" aus. Geben Sie dann die Bundle-ID für Ihre App im umgekehrten DS-Format ein:

    Specify the bundle identifier for the app.

    Wichtig

    Die eingegebene Bündel-ID muss der Bündel-ID in der Datei "Info.plist " in Ihrem App-Projekt entsprechen.

    Der Bundle-Identifikator für eine .NET MAUI-Anwendung wird in der Projektdatei als Anwendungs-ID-Eigenschaft gespeichert:

    • Klicken Sie in Visual Studio im Solution Explorer mit der rechten Maustaste auf Ihr .NET MAUI-App-Projekt und wählen Sie Eigenschaften. Navigieren Sie dann zur Registerkarte MAUI Shared > Allgemein. Das Feld Anwendungs-ID listet den Bundle-Identifikator auf.
    • Klicken Sie in Visual Studio für Mac im Lösungsfenster mit der rechten Maustaste auf Ihr .NET MAUI-App-Projekt und wählen Sie Eigenschaften. Wählen Sie dann im Fenster Projekteigenschaften die Registerkarte Build >App Info. Das Feld Anwendungs-ID listet den Bundle-Identifikator auf.

    Wenn der Wert des Feldes Anwendungs-ID aktualisiert wird, wird der Wert des Bundle-Identifikators in der Info.plist automatisch aktualisiert.

  7. Wählen Sie auf der Seite "App-ID registrieren " alle funktionen aus, die die App verwendet. Alle Funktionen müssen sowohl auf dieser Seite als auch in der Datei "Entitlements.plist " in Ihrem App-Projekt konfiguriert werden. Weitere Informationen finden Sie unter "Funktionen und Berechtigungen".

  8. Klicken Sie auf der Seite "App-ID registrieren" auf die Schaltfläche "Weiter ".

  9. Klicken Sie auf der Seite "App-ID bestätigen" auf die Schaltfläche "Registrieren ".

Erstellen eines Bereitstellungsprofils

Nachdem die App-ID erstellt wurde, sollten Sie ein Verteilungsbereitstellungsprofil erstellen. Mit diesem Profil kann die App zur Freigabe digital signiert werden, damit sie auf einem iOS-Gerät installiert werden kann.

So erstellen Sie ein Bereitstellungsprofil für die Ad-hoc-Verteilung:

  1. Wählen Sie auf der Seite "Zertifikate, Bezeichner und Profile" Ihres Apple-Entwicklerkontos die Registerkarte "Profile" aus.

  2. Klicken Sie auf der Registerkarte "Profile " auf die + Schaltfläche, um ein neues Profil zu erstellen.

  3. Wählen Sie auf der Seite "Neues Bereitstellungsprofil registrieren" das Optionsfeld "Ad Hoc " aus, bevor Sie auf die Schaltfläche "Weiter " klicken:

    Register a provisioning profile for ad hoc distribution.

  4. Wählen Sie auf der Seite "Bereitstellungsprofil generieren" in der Dropdownliste "App-ID " die App-ID aus, die Sie zuvor erstellt haben, und wählen Sie aus, ob sie ein Offlineprofil erstellen möchten, bevor Sie auf die Schaltfläche "Weiter " klicken:

    Select your App ID.

  5. Wählen Sie auf der Seite "Bereitstellungsprofil generieren" das Optionsfeld aus, das Ihrem Verteilungszertifikat entspricht, bevor Sie auf die Schaltfläche "Weiter " klicken:

    Select your distribution certificate.

  6. Wählen Sie auf der Seite "Bereitstellungsprofil generieren" die Geräte aus, auf denen die App installiert wird, und klicken Sie dann auf die Schaltfläche "Weiter" .

    Screenshot of adding a device to a provisioning profile.

  7. Geben Sie auf der Seite "Bereitstellungsprofil generieren" einen Namen für das Bereitstellungsprofil ein, bevor Sie auf die Schaltfläche "Generieren " klicken:

    Generate the provisioning profile.

    Hinweis

    Notieren Sie sich den Namen des Bereitstellungsprofils, da er beim Signieren Ihrer App erforderlich ist.

  8. Klicken Sie auf der Seite "Bereitstellungsprofil generieren" optional auf die Schaltfläche "Herunterladen ", um Ihr Bereitstellungsprofil herunterzuladen.

    Hinweis

    Es ist nicht erforderlich, Ihr Bereitstellungsprofil jetzt herunterzuladen. Stattdessen führen Sie dies in Visual Studio aus.

Herunterladen von Bereitstellungsprofilen in Visual Studio

Nachdem Sie ein Verteilungsbereitstellungsprofil in Ihrem Apple-Entwicklerkonto erstellt haben, kann Visual Studio es herunterladen, damit es zum Signieren Ihrer App verfügbar ist.

  1. Wechseln Sie in Visual Studio zu extras Options >> Xamarin > Apple Accounts.
  2. Wählen Sie im Dialogfeld "Apple-Entwicklerkonten " Ihr Team aus, und klicken Sie auf " Details anzeigen".
  3. Überprüfen Sie im Dialogfeld "Details ", ob das neue Profil in der Liste " Bereitstellungsprofile" angezeigt wird. Möglicherweise müssen Sie Visual Studio neu starten, um die Liste zu aktualisieren.
  4. Klicken Sie im Dialogfeld "Details " auf " Alle Profile herunterladen".

Die Bereitstellungsprofile werden unter Windows heruntergeladen und in Ihren Mac-Buildhost exportiert, wenn die IDE mit ihr gekoppelt ist. Weitere Informationen finden Sie unter Mit Mac für die iOS-Entwicklung koppeln.

Veröffentlichen der App

Visual Studio kann eine .NET MAUI iOS-App für die Ad-hoc-Verteilung veröffentlichen. Informationen zum Veröffentlichen einer iOS-App mithilfe der Befehlszeilenschnittstelle (Command Line Interface, CLI) finden Sie unter Veröffentlichen einer iOS-App mithilfe der Befehlszeile.

  1. Stellen Sie in Visual Studio sicher, dass die IDE mit einem Mac Build-Host gekoppelt ist. Weitere Informationen finden Sie unter Mit Mac für die iOS-Entwicklung koppeln.

  2. Verwenden Sie in der Visual Studio-Symbolleiste die Dropdownliste "Debugziel", um iOS-Remotegeräte und dann Remotegerät auszuwählen:

    Select your remote device in Visual Studio.

  3. Verwenden Sie in der Visual Studio-Symbolleiste die Dropdownliste "Lösungenkonfiguration ", um von der Debugkonfiguration zur Releasekonfiguration zu wechseln:

    Select the release configuration in Visual Studio.

  4. Klicken Sie in Projektmappen-Explorer mit der rechten Maustaste auf Ihr .NET MAUI-App-Projekt, und wählen Sie "Eigenschaften" aus. Navigieren Sie dann zur Registerkarte "iOS Bundle Signing ", und stellen Sie sicher, dass das Schema auf "Manuelle Bereitstellung" festgelegt ist, die Signaturidentität auf Verteilung (automatisch) festgelegt ist und das Bereitstellungsprofil auf "Automatisch" festgelegt ist:

    Screenshot of bundle signing tab for iOS in Visual Studio.

    Diese Einstellungen stellen sicher, dass Visual Studio das richtige Bereitstellungsprofil basierend auf dem Bundlebezeichner in Info.plist auswählt (das identisch mit dem Wert der Anwendungs-ID-Eigenschaft in Ihrer Projektdatei ist). Alternativ können Sie die Signaturidentität auf das entsprechende Verteilungszertifikat und das Bereitstellungsprofil auf das Profil festlegen, das Sie in Ihrem Apple-Entwicklerkonto erstellt haben.

  5. Klicken Sie in Projektmappen-Explorer mit der rechten Maustaste auf Ihr .NET MAUI-App-Projekt, und wählen Sie "Veröffentlichen" aus:

    Select the publish menu item in Visual Studio.

    Der Archiv-Manager wird geöffnet, und Visual Studio beginnt mit dem Archivieren Ihres App-Bündels:

    Screenshot of the archive manager in Visual Studio.

    Der Archivierungsprozess signiert die App mit den Zertifikat- und Bereitstellungsprofilen, die Sie auf der Registerkarte "Signatur für iOS-Bündelsignatur " für die ausgewählte Lösungskonfiguration angegeben haben.

  6. Stellen Sie im Archiv-Manager nach erfolgreicher Archivierung sicher, dass Ihr Archiv ausgewählt ist, und wählen Sie dann die Schaltfläche "Verteilen" aus, um mit dem Packen Ihrer App für die Verteilung zu beginnen:

    Screenshot of the archive manager in Visual Studio once archiving is complete.

    Das Dialogfeld "Verteilen – Kanal auswählen" wird angezeigt.

  1. Wählen Sie im Dialogfeld "Verteilen - Kanal auswählen" die Schaltfläche "Ad Hoc " aus:

    Screenshot of selecting a distribution channel in the distribution dialog.

  2. Wählen Sie im Dialogfeld "Verteilen – Signaturidentität " Ihre Signaturidentität und ihr Bereitstellungsprofil aus:

    Screenshot of selecting a signing identity in the distribution dialog.

    Hinweis

    Sie sollten die Signaturidentität und das Bereitstellungsprofil verwenden, das für Ihre App und den ausgewählten Verteilungskanal erstellt wurden.

  3. Wählen Sie im Dialogfeld "Verteilen – Signaturidentität " die Schaltfläche "Speichern unter " aus, und geben Sie einen Dateinamen ein. Ihre App wird dann erneut signiert und in einer IPA-Datei im Dateisystem veröffentlicht.

Die App kann dann mithilfe des Apple-Konfigurators verteilt werden. Weitere Informationen finden Sie im Apple-Konfigurator-Benutzerhandbuch zu support.apple.com.