Wrap-Assistent: 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 dem Verpacken-Feature in Power Apps können Sie native mobile Versionen Ihrer Canvas-Apps als benutzerdefinierte mobile Android- und iOS-Apps (IPA-, APK-, AAB-Pakete) 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

1. Anmelden und ein Verpacken-Projekt erstellen

1. Navigieren Sie zum Power Apps Maker Portal.
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 dem Bildschirm Zu umschließende Apps aus, wählen Ihre primäre App (die Haupt-App, die Benutzern beim Start angezeigt wird) und alle optionalen sekundären Apps aus, die gebündelt werden sollen.

   • Haupt-App: Die Haupt-App, die Benutzern angezeigt wird, wenn die mobile App gestartet wird.
   • Sekundäre Apps: Optionale zusätzliche Apps, die im selben mobilen App-Paket gebündelt sind.

   

   Anmerkung

   • Sie können dieselbe primäre App in mehreren Verpackungs-Projekten verwenden.
   • Wenn der primäre App-Name 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.

3. Wählen Sie die Zielplattform

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

   Anmerkung

   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 Benutzer benötigen.

3. Wählen Sie die Azure Key Vault URI aus der Liste.
   Wenn keine Einträge angezeigt werden, erstellen Sie einen Azure Key Vault.

4. Erstellen Sie ein Azure Blob Storage-Konto und einen Container, falls Sie dies noch nicht getan haben:

   • Weitere Informationen: Ein Azure Storage-Konto erstellen
   • Tutorial-Video: So erstellen Sie ein Speicherkonto

5. Gehen Sie zu Ihrem Schlüsseltresor im Azure-Portal:

   a. Wechseln Sie zu Geheimnisse, um ein Geheimnis für Ihren Azure Blob Storage-Zugriffsschlüssel zu erstellen.

   • Weitere Informationen: Einem Key Vault ein Geheimnis hinzufügen
   • Informationen zum Anzeigen und Kopieren Ihres Zugriffsschlüssels: Kontozugriffsschlüssel anzeigen

   b. Geben Sie den Azure Blob Storage-Zugriffsschlüssel in das Feld Geheimniswert ein.

   

6. Wechseln Sie in Ihrem Schlüsseltresor zu Tags , und erstellen Sie ein neues Tag mit demselben geheimen Wert wie oben.

   

7. Setzen Sie den Schalter Meine App signieren auf Ein oder Aus:

   • Wenn Ein: Führen Sie die Schritte unter Schritte für automatisiertes Signieren von Code aus
   • Wenn Aus: Sie müssen später manuell signieren

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

   • Kein Wiederholen des Signiervorgangs während des erneuten Neuverpackens erforderlich
   • Kein Warten auf App-Entwickler, um den Prozess abzuschließen
   • Keine Android Studio Einrichtung erforderlich oder Merken von Passwörtern
   • Kein Mac-Gerät erforderlich zum iOS-Signieren

   

   Anmerkung

   Optionen für manuelles Signieren:

   • Codezeichen für iOS
   • Codezeichen für Android
   • Code-Zeichen für Google Play Store

   Sie müssen AAB-Dateien unabhängig von der im Assistenten ausgewählten Signaturoption manuell signieren.

8. Wählen Sie Weiter.

4. Registrieren der 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. Bereitstellen:

     • Anwendungsame: Der Name des Kunden, der auf der App angezeigt wird
     • Android Signatur-Hash (falls auf Android abgezielt): Eine 28-stellige alphanumerische Zeichenfolge

  3. Im Microsoft Entra Administrationscenter wechseln Sie zu App-Registrierung und wählen Ihre App aus. Im Essential-Abschnitt suchen Sie unterstützte Kontotypen: Wählen Sie Konten in einem beliebigen Organisationsverzeichnis (Beliebiges Microsoft Entra Mehrinstanzverzeichnis).

  4. Speichern Sie Ihre Änderungen.

     Anmerkung

     Wenn der Signatur-Hash-Schlüssel bereits vorhanden ist, können Sie ihn wiederverwenden.

     

Drittanbieter-Apps als Azure-Mandantenadministrator konfigurieren

Der Wrap-Assistent konfiguriert die erforderlichen API-Berechtigungen automatisch. Um Admin-Zustimmung zu erteilen:

1. Windows PowerShell als Administrator öffnen.
2. Führen Sie den Befehl aus:

   Install-Module -Name Microsoft.PowerApps.Administration.PowerShell -AllowClobber -Force
   Set-ExecutionPolicy -ExecutionPolicy RemoteSigned
   Import-Module -Name Microsoft.PowerApps.Administration.PowerShell
   Add-AdminAllowedThirdPartyApps
   Get-AdminAllowedThirdPartyApps
   

3. Geben Sie die App-ID an, wenn Sie dazu aufgefordert werden.

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

API-Berechtigungen als Azure-Mandantenadministrator erteilen

Azure-Administrator erteilt API-Berechtigungen während der Registrierung. Weitere Informationen finden Sie unter Erteilen Sie mandantenübergreifende Administratoreinwilligung in der Enterprise-Apps.

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 Azure API-Verbindungsberechtigung 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 PowerApps Service Berechtigung 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"
   

Anmerkung

Wenn nur das Feld Anwendungsname angezeigt wird, fahren Sie mit den nächsten Schritten fort und wählen Sie Android als Zielplattform aus, um das Signatur-Hashfeld anzuzeigen.

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

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

5. Branding konfigurieren

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

Anmerkung

Alle Bilder müssen im .png-Format sein. Standardbilder werden verwendet, wenn keine benutzerdefinierten Bilder ausgewählt sind.

Einstellungen	Eigenschaft	Anforderungen
App-Symbole	Symbole für Ihre App	iOS: 1024x1024 px oder größer Android: 432x432 px oder größer
Bild des Begrüßungsbildschirms	Bild, das beim Laden der App angezeigt wird	.png format
Bild des Willkommensbildschirms	Auf dem Anmeldebildschirm angezeigtes Bild	.png format
Hintergrundfüllfarbe	Farbe für den Hintergrund des Begrüßungsbildschirms	Hexadezimal-Farbcode
Schaltflächen-Füllfarbe	Farbe für Schaltflächen	Hexadezimal-Farbcode
Design des Statusleistentexts	Farbe für den Text in der Statusleiste	Hell oder Dunkel

2. Wählen Sie Weiter.

6. Ausgabe verwalten

1. Fügen Sie den Name des Azure Blob Storage-Kontos und des Containers hinzu.
2. Laden Sie nach Abschluss des Builds Ihr APK oder IPA vom Azure-Blobspeicherort herunter.

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-Blobspeicher 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

Anmerkung

Wenn Sie eine iOS-App manuell mit Code signieren möchten, entpacken Sie die IPA-Datei, die nur mit einem Mac-Gerät erstellt wurde.

---

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.

---

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

Anmerkung

Sowohl Kunden mit einzelnen als auch Kunden mit mehreren Mandanten können Verpacken verwenden, um native mobile Apps auf der Grundlage ihrer Power Apps-Canvas-Apps zu erstellen.

Wählen Sie bei der Registrierung einen Kontotyp aus, der beliebiges Verzeichnis – Multitenant Microsoft Entra enthält:

• Konten in einem beliebigen Organisationsverzeichnis (jedes Microsoft Entra-Verzeichnis – Mandantenfähig)
• Konten in jedem Organisationsverzeichnis (Jedes Microsoft Entra-Verzeichnis - Multitenant) und persönliche Microsoft-Konten wie Skype oder Xbox

Wichtig

• Verpacken unterstützt nur mehrinstanzenfähige Kontotypen derzeit. Der Einzelmandant-Kontotyp wird noch nicht unterstützt. Weitere Informationen: Kontotypen in Microsoft Identity Platform.
• Sie müssen eine separate Umleitungs-URI für jede Plattform erstellen (iOS, Android).

---

API-Berechtigungen manuell konfigurieren (optional)

Wenn Fehler auftreten, können Sie API-Berechtigungen manuell konfigurieren. Weitere Informationen: Hinzufügen und konfigurieren

Erforderliche API-Berechtigungen

API-Typ	Spezifische API	Ursache
Microsoft APIs	Dynamics CRM	user_impersonation ist erforderlich, damit die Anwendung Dataverse im Namen des Benutzers aufrufen kann.
APIs, die meine Organisation verwendet	Azure-API-Verbindungen	Runtime.All ist erforderlich, um einen Konnekto aus der Power Platform aufzurufen.
APIs, die meine Organisation verwendet	PowerApps-Dienst	User Berechtigung ist erforderlich, um Power Apps Back-End-Dienste von Power Platform zu kontaktieren.
APIs, die meine Organisation verwendet	Power BI	Power BI Berechtigungen sind erforderlich, wenn Ihre App auf Power BI Inhalte zugreift oder diese einbettet.
APIs, die meine Organisation verwendet	Microsoft Verwaltung mobiler Anwendungen	Erforderlich, da Power Apps das Intune SDK intern verwendet wird

Detaillierte Schritte finden Sie unter Berechtigungen im App-Registrierungsportal anfordern.

---

Signieren Sie Ihr Mobile-App Paket manuell (optional)

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

Plattform	Signaturmethode
iOS	Manuelle Codesignierung für iOS
Android	Manuelle Codesignierung für Android
Google Play Store	Codesignierung für den Google Play Store

---

Siehe auch

• Probleme mit der Wrap-Funktion in Power Apps beheben
• Verpacken-Überblick
• Manuelle Codesignierung für iOS
• Manuelle Codesignierung für Android
• Azure Key Vault für die automatische Code-Signierung erstellen
• Häufig gestellte Fragen zum Verpacken