Geräteregistrierung und Erneutes Signieren der App

  • Artikel

Wichtig

Visual Studio App Center wird am 31. März 2025 eingestellt. Sie können Visual Studio App Center zwar weiterhin verwenden, bis es vollständig eingestellt ist, es gibt jedoch mehrere empfohlene Alternativen, zu denen Sie eine Migration in Betracht ziehen können.

Erfahren Sie mehr über Supportzeitpläne und Alternativen.

Auf dieser Seite können Sie die Schritte lesen, die beim Verteilen einer iOS-Anwendung an bestimmte Tester ausgeführt werden müssen. Erfahren Sie, was Geräteregistrierung, -bereitstellung und -Neusignierung von Apps sind. Sie können auch erfahren, wie Sie app Center-Funktionen verwenden, um diesen Prozess so schmerzlos wie möglich zu gestalten. Schließlich gibt es Lösungen für einige häufige Probleme, auf die Sie stoßen können.

App-Signierung, erneutes Signieren und Gerätebereitstellung

Entwickler signieren Apps aus Sicherheitsgründen, wie von Apple bei der Verteilung erforderlich. Die Anforderung ist für die Verteilung über Xcode, App Center oder den iTunes Store identisch. Die Codesignierung ist eine Vorsichtsmaßnahme, um sicherzustellen, dass ihre App nicht manipuliert wurde. Weitere Informationen finden Sie in der Apple-Dokumentation zum Signieren von Apps.

Das folgende Diagramm zeigt den gesamten Ablauf für die erneute Signierung der App in App Center. Lassen Sie uns diese Schritte ausführlicher erläutern.

App Center-Geräteregistrierung und App-Neusignierungsflow

Die erneute Signierung von Apps wird nur angewendet, wenn Sie eine iOS-App an bestimmte Testgeräte verteilen möchten. Im Diagramm möchten Sie eine App-Version an die Geräte von Tester 1 und Tester 2 verteilen. Dazu signieren Sie Ihre App mit einem Ad-hoc-Bereitstellungsprofil . Dieses Bereitstellungsprofil enthält eine Liste mit eindeutigen Gerätebezeichnern (UDIDs). Nur Geräte, die sich in dieser Liste befinden, werden bereitgestellt oder können die IPA installieren. App Center kann erkennen, ob ein Gerät bereitgestellt wird, da wir die UDID des Geräts aus dem Zeitpunkt kennen, an dem der Tester sein Gerät zum ersten Mal bei App Center registriert hat. Wenn wir feststellen, dass das Gerät, das der Tester verwendet, nicht in der Liste der bereitgestellten Geräte für die IPA-Datei steht, die sie herunterladen möchten, wird die Meldung "Die Entwickler arbeiten an einer Version für Ihr Gerät" angezeigt.

Sobald Sie wissen, welche Geräte Sie zum Testen verwenden möchten:

  1. Registrieren Sie die Geräte in Ihrem Apple-Entwicklerkonto.
  2. Fügen Sie sie Ihrem Bereitstellungsprofil hinzu.
  3. Generieren Sie ein neues Bereitstellungsprofil.
  4. Laden Sie das Bereitstellungsprofil herunter.
  5. Erstellen Sie Ihre App mit diesem Profil.

Wenn ein anderes neues Gerät angezeigt wird, z. B. das Gerät mit UDID 3 im Diagramm, wiederholen Sie diese Schritte. Dies kann umständlich sein, und Sie möchten Ihr Continuous Integration-System nicht ändern oder den Entwickler bitten, dem Profil immer neue Geräte hinzuzufügen und neue Builds zu veröffentlichen. Hier kommt die erneute Anmeldung ins Ziel. Dies bedeutet, dass Sie einen vorhandenen Anwendungsbuild erstellen und erneut signieren (neu signieren) mit einem anderen Bereitstellungsprofil, damit Sie keinen neuen Build erstellen müssen.

App Center unterstützt Sie bei diesem Prozess und kann ihn auch automatisieren. Dies sind die im Diagramm gezeigten manuellen und automatischen Schritte zur Bereitstellung des Geräts mit UDID 3. App Center unterstützt Sie beim Registrieren von Testergeräte-IDs in Ihrem Apple-Entwicklerkonto, beim Erstellen eines neuen Bereitstellungsprofils und beim erneuten Signieren der App über das App Center-Portal. App Center erfordert Zugriff auf Ihr Apple-Entwicklerkonto, um die Geräte zu registrieren.

Zum manuellen Hinzufügen von Geräten zu einem vorhandenen Release können Sie Geräte registrieren auf der Seite für eine Verteilergruppe verwenden. Weitere Informationen finden Sie unter Geräteregistrierung.

Um Geräte automatisch hinzuzufügen, aktivieren Sie Geräte automatisch verwalten unter den Verteilergruppeneinstellungen. Auf diese Option kann nur über eine Verteilergruppe auf App-Ebene zugegriffen werden und ist nicht über eine globale Gruppe verfügbar. Sie können auf eine Verteilergruppe auf App-Ebene zugreifen, indem Sie die App im App Center auswählen und dann auf Verteilen klicken. Klicken Sie unter Verteilen auf Gruppen , und klicken Sie dann auf die bestimmte Gruppe, die Sie verwalten möchten. Sie können sich auch für das automatische Hinzufügen von Geräten entscheiden, wenn Sie ein neues Release verteilen. Diese Option befindet sich im Schritt Geräte im Assistenten zum Verteilen einer neuen Version.

App Center fügt das neue Gerät der Liste im Bereitstellungsprofil hinzu und signiert Ihre App mit diesem Bereitstellungsprofil erneut. Jetzt kann das neue Gerät auch die App installieren. Dies sind die unteren Schritte im Diagramm.

Funktionen für erneutes Signieren

Beachten Sie folgendes, wenn Sie die erneute Anmeldung in App Center verwenden:

  • Die automatische Verwaltung von Geräten in Gruppen funktioniert nur für die Verteilung an nicht öffentliche und nicht freigegebene Gruppen.
  • Wenn Sie die Verteilung an einzelne Benutzer durchführen, registrieren Sie deren Geräte manuell, und signieren Sie die App erneut. Um die in diesem Artikel genannten Tools verwenden zu können, müssen Sie die Tester zunächst einer Gruppe hinzufügen.
  • Wenn Sie Ihrer Version mehrere Gruppen hinzufügen, konfigurieren Sie jede Gruppe separat mithilfe von Geräte automatisch verwalten unter den Gruppeneinstellungen.
  • Die Verwaltung von Geräten ist nur für iOS-Apps erforderlich, die mit einem Entwickler- oder Ad-hoc-Profil signiert sind.

Voraussetzungen

Bevor Sie die Gerätefunktionen von App Center verwenden können, sollten Sie:

  1. Verwenden Sie das Produktionszertifikat für die ursprüngliche App-Signatur.
  2. Verfügen Sie über die Anmeldeinformationen für Ihr Apple-Entwicklerkonto, das die Rolle Kontoinhaber, Admin oder App-Manager hat.
  3. Verwenden Sie beim Verteilen der App aus Xcode die Option Signierung manuell verwalten anstelle von Signierung automatisch verwalten .

Geräteregistrierung

Das Registrieren eines Geräts bedeutet, dass es in die Liste der Geräte im Apple-Entwicklerportal aufgenommen wird, die dann in ein Bereitstellungsprofil aufgenommen werden können. Um ein Gerät zu registrieren, wählen Sie eine Verteilergruppe mit mindestens einem Gerät aus, das noch nicht bereitgestellt wurde, und navigieren Sie zur Registerkarte Geräte. Hier sehen Sie ein Gerät mit dem status "nicht bereitgestellt" und einer Meldung oben, die besagt, dass nicht bereitgestellte Geräte vorhanden sind. Führen Sie die folgenden Schritte aus, um die Geräte zu registrieren:

  1. Wählen Sie die Schaltfläche Geräte registrieren aus.
  2. In einem Dialogfeld werden Sie aufgefordert, Ihren Benutzernamen und Ihr Kennwort einzugeben, die im Apple-Entwicklerportal verwendet werden.
  3. Nachdem Sie sich mit Ihrem Apple-Benutzernamen und -Kennwort angemeldet haben, fügt App Center die nicht bereitgestellten Geräte sowohl Ihrem Apple-Entwicklerkonto als auch dem Bereitstellungsprofil für Releases hinzu.
  4. Optional können Sie eine P12-Datei hochladen, um die App erneut zu signieren und an die neu hinzugefügten Geräte zu verteilen. Weitere Informationen zum Generieren einer P12-Datei finden Sie hier.

Wenn Sie die Neuerstellung Ihrer App mit dem aktualisierten Bereitstellungsprofil separat durchführen möchten, können Sie app Center weiterhin verwenden, um die Geräte Ihres Testers automatisch im Apple-Entwicklerportal zu registrieren, ohne den Schritt für die erneute Signatur zu verwenden. Lassen Sie hierzu meine App erneut signieren deaktiviert, und laden Sie das aktualisierte Bereitstellungsprofil mit der Schaltfläche auf dem Überprüfungsbildschirm herunter. Sie können das Bereitstellungsprofil auch über Xcode oder das Apple-Entwicklerportal herunterladen.

Verteilen einer neuen Version

Wenn Sie ein neues Release an eine Gruppe verteilen, für die die automatische Geräteverwaltung nicht aktiviert ist, ist ein Geräteschritt Teil des Assistenten. In diesem Schritt wird überprüft, ob nicht bereitgestellte Geräte in der Verteilergruppe vorhanden sind. In diesem Fall können Sie das Kontrollkästchen Geräte registrieren und App erneut signieren aktivieren. App Center führt dann drei Vorgänge für Sie aus:

  1. Registrieren Sie neue Geräte-IDs im Apple-Entwicklerportal.
  2. Fügen Sie die Geräte zum Bereitstellungsprofil hinzu, und laden Sie es herunter.
  3. Signieren Sie die hochgeladene Binärdatei erneut, damit sie von allen Testern installiert werden kann.

Für den Flow sind der Benutzername und das Kennwort für das Apple-Entwicklerportal und das Zertifikat erforderlich, das zum Signieren der App zur Buildzeit verwendet wird. Sie stellen das Zertifikat als exportierte P12-Datei bereit. Weitere Informationen zum Generieren einer P12-Datei finden Sie hier. Wenn Sie Ihre Apple-ID und Ihr Zertifikat bereits im App Center gespeichert haben, können Sie sie in den Dropdownmenüs auswählen.

Datenschutzbedenken in Bezug auf Benutzername und Kennwort

Wenn Sie Ihre Apple-Anmeldeinformationen und ein Signaturzertifikat zum App Center hinzufügen, verwenden wir eine sichere Verbindung. App Center speichert die Informationen in einem verschlüsselten Tresor. Es ist keinem Benutzer möglich, vertrauliche Informationen aus dem Tresor herunterzuladen oder abzurufen.

Wenn Sie diesen Satz von Anmeldeinformationen und ein Zertifikat angeben, ist er automatisch für App-Mitarbeiter verfügbar, aber nur für diesen bestimmten Dienst. Angenommen, Entwickler X fügt Anmeldeinformationen und Zertifikate zur Verteilergruppe "Tester" hinzu. Wenn Entwickler Y dann ein neues Release an die Gruppe "Tester" verteilt, sind der Benutzername, das Kennwort und das Zertifikat von X standardmäßig ausgewählt. App Center verwendet sie für Entwickler Y. App Center verwendet nur Ihre Apple-ID während der Transaktion und wird nicht für andere Zwecke verwendet.

Grenzwert für die Registrierung von Apple-Geräten

Jedes Apple-Entwicklerkonto verfügt über eine endliche Anzahl von Spots für Geräte pro Gerätetyp. Apple arbeitet mit fünf Gerätetypen: iPad, iPhone, iPod, Apple TV und Apple Watch. Jedes dieser Geräte ist auf 100 Geräte beschränkt. Stellen Sie sich vor, Sie registrieren sechs Geräte, die alle iPhones sind. Sie haben dann 94 Geräte-IDs für iPhones und noch 100 für jeden der vier anderen Gerätetypen übrig. Sie können die Registrierung von Geräten nur einmal pro Jahr aufheben, um diese Slots wieder zu erhalten.

Generieren einer P12-Datei

Sie können ein Apple-Verteilungszertifikat und einen privaten Schlüssel in einer Datei mit privatem Informationsaustausch (P12) speichern. Dazu benötigen Sie ein Apple-Produktionszertifikat, das auf Ihrem lokalen Computer gespeichert ist. Wenn Sie dies nicht getan haben, verfügen Sie nicht über den privaten Schlüssel.

  1. Öffnen Sie die Keychain Access-App auf Ihrem Mac, und wählen Sie links die Kategorie Meine Zertifikate aus.
  2. Suchen Sie das richtige Verteilungszertifikat, und erweitern Sie es, um den entsprechenden privaten Schlüssel anzuzeigen. a. Wenn der private Schlüssel nicht vorhanden ist, müssen Sie entweder ein neues Zertifikat erstellen oder diese Schritte auf dem Computer ausführen, auf dem Sie das Zertifikat erstellt haben.
  3. Wählen Sie entweder das Zertifikat oder den privaten Schlüssel oder beides aus. Klicken Sie dann mit der rechten Maustaste auf die ausgewählten Elemente, um das Kontextmenü abzurufen und die Aktion auszuwählen, die mit Exportieren beginnt. Exportieren des Zertifikats aus Keychain
  4. Wählen Sie einen Speicherort auf dem Datenträger aus, um die Datei als P12 zu speichern. Wählen Sie ein sicheres Kennwort für die Datei aus.

Entfernen von Zertifikaten und Apple-IDs aus App Center

Sie können die Zertifikate und Apple-IDs aus App Center in den Entwicklerkonten entfernen.

  1. Wählen Sie unter Ihrem Profilbild in der oberen rechten Ecke Kontoeinstellungen aus.
  2. Wählen Sie Entwicklerkonten aus.
  3. Entfernen Sie das Geheimnis mithilfe der drei vertikalen Punkte auf der rechten Seite der Tabelle, und löschen Sie dann das Zertifikat.
  4. Überprüfen Sie den Namen des Zertifikats, und bestätigen Sie Ihre irreversible Aktion, indem Sie erneut Löschen auswählen.

Erfahren Sie mehr über die Verwaltung Ihrer Apple-ID und Ihrer Zertifikate.

Manuelles Registrieren von Geräten bei Apple

Wenn Sie versuchen, direkt an Benutzer außerhalb von App Center zu verteilen, können Sie die Schritte auf der Apple Developer-Website zum Verteilen auf registrierten Geräten ausführen. In den Schritten wird beschrieben, wie Sie Ihrem Konto Manuell Geräte hinzufügen und Ihre App erneut signieren.

Bekannte Fehler

Profil nicht gefunden

Wenn Sie sich über App Center bei Apple anmelden, überprüfen wir die bereitstellungsprofile, die in Ihrer Anwendung enthalten sind, mit denen in Ihrem Entwicklerkonto. Wenn ein in einer Binärdatei verwendetes Profil in Ihrem Apple-Entwicklerkonto nicht gefunden wird, kann App Center Ihre Anwendung nicht erneut signieren. Um dies zu beheben, stellen Sie sicher, dass Ihr Apple-Entwicklerkonto alle bereitstellungsprofile enthält, die in Ihrer Anwendung verwendet werden. Sie können Anwendungsprofile auf der Registerkarte Allgemein ihrer Xcode-Projekteigenschaften oder die iOS Bundle-Signaturoptionen in Visual Studio für Mac überprüfen.

Hinweis

Wenn Sie versuchen, eine Binärdatei über App Center automatisch bereitzustellen, führen bereitstellungsprofile, die automatisch von Xcode generiert werden, in einigen Fällen dazu, dass die automatische Bereitstellung mit dem folgenden Fehler fehlschlägt: Profil mit dem Namen "iOS Team ..." wurde im Konto nicht gefunden. Erstellen Sie ein manuell erstelltes Bereitstellungsprofil, und verwenden Sie es, um das Problem zu beheben.

Team nicht gefunden

Wenn Sie sich über App Center bei Apple anmelden, werden die in Ihren Anwendungen enthaltenen Teams mit denen in Ihrem Entwicklerkonto abgeglichen. Wenn ein Team, das in der Binärdatei verwendet wird, in Ihrem Apple-Entwicklerkonto nicht gefunden wird, kann App Center Ihre Anwendung nicht erneut signieren. Um dies zu beheben, stellen Sie sicher, dass Ihr Apple-Entwicklerkonto das team enthält, das in Ihrer Anwendung verwendet wird. Sie können das Anwendungsteam auf der Registerkarte Allgemein ihrer Xcode-Projekteigenschaften oder die Optionen für die iOS Bundle-Signatur in Visual Studio für Mac überprüfen.

Aktualisierter Lizenzvertrag

Apple aktualisiert seinen Lizenzvertrag in regelmäßigen Abständen. Um das Apple-Entwicklerportal weiterhin nutzen zu können, müssen Sie die aktualisierte Lizenz lesen und damit einverstanden sein.

  1. Melden Sie sich beim Apple-Entwicklerportal an.
  2. Befolgen Sie die Anweisungen, um den Lizenzvertrag zu akzeptieren.

App Center kann nicht bei Inhalten in der Lizenz oder im Flow für den Lizenzvertrag helfen.

Unser Tester hat seine Geräte-ID nicht registriert.

Wenn ein Tester versehentlich I already registered ausgewählt hat, führen Sie die folgenden Schritte aus, um ein Gerät manuell zu registrieren:

  1. Wechseln Sie auf Ihrem mobilen Gerät zu https://install.appcenter.ms/register-device .
  2. Wählen Sie Registrieren aus, und folgen Sie den Anweisungen auf dem Bildschirm.