Assistent zum Verpacken: Schritt-für-Schritt-Anleitung zum Erstellen Ihres nativen Pakets für mobile Apps

Verwenden Sie diese Schritt-für-Schritt-Anleitung für den Verpacken-Assistenten, um eine oder mehrere Canvas-Apps in ein einzelnes App-Paket mit benutzerdefiniertem Branding umzuwandeln, das in Google Play und im iOS App Store bereitgestellt werden kann.

Mit der Verpacken-Funktion in Power Apps können Sie native mobile Versionen Ihrer Canvas-Apps als mobile Android- und iOS-Apps (IPA-, APK-, AAB-Pakete) mit benutzerdefiniertem Branding erstellen. Sie können diese verpackten nativen mobilen Apps über Google Play, Apple Business Manager oder andere native Verteilungsmethoden an Endnutzer verteilen.

Wenn Sie Ihre App aktualisieren und erneut veröffentlichen, wird die verpackte App automatisch für Benutzer aktualisiert.

Schritte, um ein benutzerdefinierte Branding mit dem Verpacken-Assistenten erstellen

Führen Sie die folgenden Schritte aus, um mit Hilfe des Verpackungs-Assistenten in Power Apps ein benutzerdefiniertes, nativen mobiles App-Paket (APK, AAB oder IPA) aus Ihren Canvas-Apps anzupassen, zu erstellen, zu signieren und zu verteilen.

1. Anmelden und ein Verpacken-Projekt erstellen

1. Melden Sie sich beim Power Apps Maker Portal an.
2. Wählen Sie im linken Navigationsbereich die Option Verpacken aus. Wenn sich das Element nicht im linken Seitenbereich befindet, wählen Sie …Mehr und dann das gewünschte Element aus.
3. Wählen Sie die App aus, die Sie verpacken möchten, und wählen Sie in der Befehlsleiste Verpacken aus.

2. Wählen Sie Apps aus

1. Wählen Sie auf der Anzeige Wählen Sie die Apps zur Verpackung aus und wählen Sie primäre und sekundäre App aus.

   • Haupt-App: Die Haupt-App, die Endbenutzern beim Start der mobilen App angezeigt wird.
   • Sekundäre Apps: Optionale andere Apps, die im selben mobilen App-Paket gebündelt sind.

   Notiz

   • Sie können dieselbe primäre App in mehreren Verpackungs-Projekten verwenden.
   • Wenn der Name der primären App falsch angezeigt wird, fahren Sie mit dem nächsten Schritt fort und kehren Sie zurück, um den Namen zu aktualisieren.

2. Wählen Sie Weiter aus.

3. Wählen Sie die Zielplattform aus

1. Geben Sie auf dem Bildschirm Mobile Plattform auswählen eine Paket-ID ein.

   Notiz

   Die Paket-ID ist ein eindeutiger Bezeichner für Ihre App. Sie muss einen Punkt (.) und keine Leerzeichen enthalten. Verwenden Sie die gleiche Paket-ID, wie wenn Sie den Azure Key Vault erstellen, nachdem Sie Ihre iOS- oder Android-Zertifikate generiert oder hochgeladen haben. Wenn Sie den Azure Key Vault bereits erstellt haben, überprüfen Sie die Paket-ID im Abschnitt Tags des Azure-Portals.

2. Wählen Sie unter Zielplattformen alle mobilen Plattformen aus, die Ihre Endbenutzer auf ihren mobilen Geräten verwenden.

3. Sie benötigen Azure Key Vault, um Ihren Build in Azure Blob Storage hochzuladen. Wenn Sie noch keine erstellt haben, erstellen Sie eine. Erstellen Sie einen Azure Key Vault direkt im Wrap-Assistenten, oder folgen Sie den Anweisungen manuell.

4. Aktivieren Sie die Option "Automatisches Signieren ", um den Signiervorgang zu automatisieren.

   Notiz

   Optionen für manuelles Signieren:

   • Codezeichen für iOS
   • Codezeichen für Android
   • Codezeichen für Google Play Store Sie müssen AAB-Dateien unabhängig von der im Assistenten ausgewählten Signaturoption manuell signieren.

5. Richten Sie die automatische Signierung über den Assistent ein.

   1. Schalten Sie im Zielplattformschritt die Option " Autosigning" ein. Der Dienst überprüft, ob Key Vault und Zertifikat bereits verknüpft sind.

      Notiz

      Azure Key Vault wird zum sicheren Speichern und Verwalten von Anwendungsschlüsseln und Zertifikaten mit zentralisiertem Zugriff und vollständiger Überwachungsprotokollierung verwendet.

   2. Wenn Sie keinen Schlüsseltresor und kein Zertifikat besitzen oder sie ändern möchten, wählen Sie "Konfigurieren" aus.

      Notiz

      Nur Azure-Administratoren können über den Einrichtungsassistent einen Schlüsseltresor erstellen. Andere Benutzer müssen dem manuellen Key Vault-Erstellungsprozess folgen.

      

   3. Wählen Sie im Seitenbereich das Abonnement und die Ressourcengruppe aus und wählen Sie dann den Schlüsseltresor aus. Um einen neuen Schlüsseltresor zu erstellen, wählen Sie "Neuen Keyvault erstellen" aus. Nachdem Sie den Schlüsseltresor ausgewählt haben, wählen Sie "Weiter" aus.

      

   4. Der Dienst überprüft, ob der entsprechende Dienstprinzipal, die Leserolle, die Zugriffsrichtlinien sowie die Umgebungsvariablen für den Schlüsseltresor eingerichtet sind. Wenn Fehler angezeigt werden, beheben Sie sie. Nachdem alle Prüfungen bestanden haben, wählen Sie "Weiter" aus.

   5. Geben Sie auf dem nächsten Bildschirm den Namen des Zertifikats im Key Vault ein.

   6. Wenn kein Zertifikat vorhanden ist oder Sie das Zertifikat ändern möchten, lesen Sie "Generieren von Schlüssel- und Signaturhash ", um ein neues Zertifikat zu erstellen. Wählen Sie dann auf diesem Bildschirm "Zertifikat erstellen " aus. Diese Aktion führt Sie zum Speicherort des Azure-Portal Schlüsseltresors. Laden Sie das generierte Zertifikat in den konfigurierten Schlüsseltresor hoch.

      Notiz

      Benutzer sind für das Erstellen des Zertifikats verantwortlich.

      

   7. Wählen Sie "Fertig stellen" aus.

   8. Auf dem Hauptbildschirm werden der Azure Key Vault und das Zertifikat als bestätigt angezeigt.

   9. Wählen Sie auf dem Hauptbildschirm "Weiter" aus.

6. Einrichten der automatischen Signatur über das Azure-Portal.

   1. Anweisungen zum Erstellen eines Azure Key Vault finden Sie unter Azure Key Vault. Nachdem der Tresor erstellt wurde, müssen Sie die erforderlichen Tags, geheimen Schlüssel und Zertifikate hinzufügen. Fügen Sie die Umgebungsvariable hinzu, falls sie noch nicht erstellt wurde.
   2. Um die Umgebungsvariable zu erstellen, wechseln Sie zu Power Apps>Lösungen>Standardlösung. Wählen Sie dann Neu>Mehr>Umgebungsvariable aus, und fügen Sie den Anzeigenamen als PA_Wrap_KV_ResourceID hinzu. Der Name der neuen Umgebungsvariable muss das Präfix "neu" aufweisen. Wenn dies nicht der Fehler ist, finden Sie ausführliche Schritte unter "Umgebungsvariablenpräfix festlegen ".
   3. Um Ihren Umgebungsvariablen Tresorinformationen hinzuzufügen, greifen Sie als Administrator auf das Azure-Portal zu. Navigieren Sie zu Alle Ressourcen>Ihr Key Vault>Eigenschaften, und kopieren Sie dann die Ressourcen-ID.
   4. Um die Eingabe zur Umgebungsvariablen hinzuzufügen, wechseln Sie zu Power Apps>ApplicationName>Alle>Umgebungsvariable. Klicken Sie auf die drei Punkte, wählen Sie Bearbeiten aus, fügen Sie den kopierten Wert zum Standardwert hinzu, und speichern Sie.
   5. Um zu überprüfen, ob der Tabellenwert aktualisiert wurde, wechseln Sie zu Power Apps>Tabellen>Umgebungsvariablendefinition>new_PA_Wrap_KV_ResourceID. Der Wert unter Standardwert muss mit dem Wert der resourceID identisch sein, für die Sie den Tresor hinzufügen möchten.

      Notiz

      Richtlinien für das Hinzufügen der Eingabe hinter den Umgebungsvariablen für Key Vault-Informationen:

      • Umgebungsvariablen dürfen nicht leer sein oder mehrere Einträge enthalten.
      • Stellen Sie sicher, dass die hinzugefügte resourceID korrekt ist (überprüfen Sie die Rechtschreibung).
      • Stellen Sie sicher, dass die hinzugefügte resourceID nicht leere Tags sowie alle Tags enthält, die mit der im Verpacken-Assistenten verwendeten Paket-ID erwartet werden.
   6. Führen Sie die Schritte unter Schritte für die automatisierte Codesignatur aus, um die Tags, Geheimnisse und Zertifikate zu erstellen, die während des automatischen Signaturvorgangs erforderlich sind.

4. Ausgabe verwalten

Um Ihren Build in Azure Blob Storage hochzuladen, benötigen Sie ein Azure Blob Storage-Konto und einen Container. Wenn Sie keins haben, erstellen Sie eins.

1. Wählen Sie unter "Ausgabe verwalten" die Option "Konfigurieren" aus, um Ihre Schlüsseltresor-, Speicherkonto- und Containerinformationen hinzuzufügen.
2. Wählen Sie im Bereich "Keyvault konfigurieren" den Schlüsseltresor aus, der Zugriffsanmeldeinformationen für Ihren Azure Blob Storage speichert, und wählen Sie dann "Weiter" aus.
3. Wählen Sie auf dem Bildschirm " Speicher konfigurieren" den Namen und den Containernamen aus, und geben Sie dann den Namen des geheimen Schlüssels ein, der Zugriff auf den Speicher enthält. Um einen neuen geheimen Schlüssel zu erstellen, folgen Sie den Anweisungen im Abschnitt "Erstellen eines geheimen Schlüssels" auf demselben Bildschirm.
4. Wählen Sie "Fertig stellen" aus.

5. Registrieren Ihrer App

Registrieren Sie auf dem Bildschirm Ihre App registrieren Ihre Anwendung manuell in Azure, um eine Vertrauensstellung zwischen Ihrer App und der Microsoft-Identitätsplattform herzustellen.

• Wenn Sie bereits eine App registriert haben:

  • Sie finden Ihre Registrierung im eigenen Registrierungsfeld.

• Wenn Sie Ihre registrierte App nicht sehen:

  1. Wählen Sie Neu App Registrierung aus, um eine neue App-Registrierung zu erstellen.
  2. Versorgen:
     • Anwendungsname: Der Name Ihrer App, der Kunden angezeigt wird
     • Android-Signatur-Hash (wenn für Android): eine 28-Zeichen lange alphanumerische Zeichenfolge
  3. Speichern Sie Ihre Änderungen.

Drittanbieter-Apps als Azure-Mandantenadministrator konfigurieren

Die registrierte App muss als Drittanbieter-App konfiguriert werden. Um die App zu konfigurieren, führt der Azure-Mandantenadministrator die folgenden Schritte aus.

Nachdem Sie diese Schritte ausgeführt haben, sieht der Registrierungsbildschirm wie folgt aus:

API-Berechtigungen als Azure-Mandantenadmin erteilen

Für die App sind die folgenden API-Berechtigungen erforderlich, um ordnungsgemäß zu funktionieren.

Erforderliche API-Berechtigungen

Berechtigungen im Verpacken-Assistenten konfigurieren

Der Wrap-Assistent überprüft und kennzeichnet Berechtigungen, die für die App nicht verfügbar sind. Wählen Sie als Azure-Administrator den Ein-Klick-Zugang im Wrap-Assistenten aus, um die ausstehenden Berechtigungen zu erteilen. Alternativ können Sie Berechtigungen über die folgenden PowerShell-Befehle konfigurieren.

Konfigurieren von Berechtigungen über PowerShell-Befehle:

Stellen Sie sicher, dass DeviceManagementManagedApplication auf Ja festgelegt ist, wenn Sie die Administratoreinwilligung für Ihre App erteilen.

Führen Sie diese PowerShell-Befehle als Azure Administrator aus, wenn Sie die Berechtigungen nicht unter APIs, die meine Organisation verwendet finden:

1. Stellen Sie sicher, dass das Modul Microsoft Graph verfügbar ist, oder installieren Sie es mit dem folgenden Befehl:

   Install-Module -Name Microsoft.Graph
   

2. Erteilen Sie die Berechtigung für Azure-API-Verbindungen für die statische AppId fe053c5f-3692-4f14-aef2-ee34fc081cae:

   Connect-MgGraph -TenantId <your tenant ID>
   New-MgServicePrincipal -AppId fe053c5f-3692-4f14-aef2-ee34fc081cae -DisplayName "Azure API Connections"
   

3. Erteilen Sie die Berechtigung PowerApps-Dienst für die statische AppId 475226c6-020e-4fb2-8a90-7a972cbfc1d4:

   Connect-MgGraph -TenantId <your tenant ID>
   New-MgServicePrincipal -AppId 475226c6-020e-4fb2-8a90-7a972cbfc1d4 -DisplayName "PowerApps Service"
   

API-Berechtigungen manuell konfigurieren (optional)

Wenn Sie Fehlermeldungen erhalten, konfigurieren Sie die API-Berechtigungen manuell. Weitere Informationen finden Sie unter Hinzufügen und konfigurieren.

Fügen Sie Umleitungs-URIs als App-Administrator hinzu

1. Gehen Sie bei Ihrer App-Registrierung >Authentifizierung im Azure-Portal.
2. Wählen Sie Plattform hinzufügen und dann iOS oder Android aus.
3. Geben Sie für iOS die Paket-ID ein. Geben Sie für Android die Paket-ID und den Signatur-Hash-Schlüssel ein.

6. Konfigurieren des Brandings

1. Legen Sie im Branding-Schritt konfigurieren die folgenden Optionen für Ihre App fest:

2. Wählen Sie Weiter aus.

7. Fragen und Zusammenfassung

1. Überprüfen Sie auf dem Zusammenfassungsbildschirm Ihre App-Details, und wählen Sie Erstellen aus.
2. Nach einem erfolgreichen Build ist Ihr App-Paket in dem von Ihnen angegebenen Azure Blob Storage verfügbar.

Build anzeigen

Sie können Ihren Build auf verschiedene Arten anzeigen:

• Wählen Sie nach dem Erstellen die Option Builds anzeigen
• Gehen Sie im Seitenbereich zu Verpackungsprojekte, zeigen Sie mit der Maus auf das gewünschte Projekt, und wählen Sie es aus
• Wählen Sie die Option Builds anzeigen in der oberen Kopfzeile angezeigt

Ihre App testen und verteilen

Testen Sie Ihre App, und verteilen Sie sie nach Bedarf. Wenn Probleme auftreten, finden Sie weitere Informationen auf der Seite zur Fehlerbehebung.

Festlegen des Präfixes für Umgebungsvariable

Der Name der neuen Umgebungsvariable muss das Präfix "neu" aufweisen. Wenn nicht, führen Sie die folgenden Schritte durch:

1. Wechseln Sie zu "Lösungen>Neue Lösung".
2. Wählen Sie einen Herausgeber aus, oder erstellen Sie einen.
3. Wählen Sie das Bearbeitungssymbol neben publisher aus, um das Präfix anzuzeigen oder zu ändern.
4. Wenn das Präfix nicht "neu" ist, ändern Sie es in "neu".
5. Speichern Sie Ihre Änderungen.

Registrieren Sie Ihre App manuell auf Azure-Portal (optional)

Sie können Ihre App-Registrierung automatisch im Assistenten oder manuell in Azure erstellen. Mehr Informationen: Schnellstart: Eine Anwendung bei der Microsoft Identity Platform registrieren

Wählen Sie bei der Registrierung einen Kontotyp aus, der Beliebiges Microsoft Entra-Verzeichnis – mehrinstanzenfähig enthält:

• Konten in einem beliebigen Organisationsverzeichnis (Beliebiges Microsoft Entra-Verzeichnis – mehrinstanzenfähig)
• Konten in einem beliebigen Organisationsverzeichnis (Beliebiges Microsoft Entra-Verzeichnis – mehrinstanzenfähig) und persönliche Microsoft-Konten (z. B. Skype oder Xbox)

Signieren Sie Ihr Mobile-App Paket manuell (optional)

Sie können Ihre App automatisch in Schritt 2 oder manuell nach der Erstellung signieren. Der Prozess der Codesignierung ist anders für Android- und iOS-Geräte.

Vorteile der automatischen Signatur für iOS und Android (APK):

• Sie müssen den Signiervorgang während des erneuten Verpackens nicht wiederholen.
• Sie müssen nicht warten, bis App-Entwickler den Prozess abgeschlossen haben.
• Sie müssen Android Studio nicht manuell einrichten oder sich das Kennwort merken.
• Zum iOS-Signieren benötigen Sie kein Mac-Gerät.

Siehe auch

• Problembehandlung für die Verpacken-Funktion in Power Apps
• Verpacken – Überblick
• Manuelles Code-Signieren für iOS
• Manuelles Code-Signieren für Android
• Azure Key Vault für die automatische Code-Signierung erstellen
• Häufig gestellte Fragen zum Verpacken