Freigeben über

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

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.

    Screenshot, der den ersten Schritt zur Auswahl der App zeigt

    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. Weitere Informationen finden Sie unter Azure Key Vault erstellen. Fügen Sie die erforderlichen Tags, Geheimnisse und Zertifikate hinzu. Fügen Sie die Umgebungsvariable hinzu, falls sie noch nicht erstellt wurde.

    a. 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. Screenshot des Bildschirms zum Hinzufügen einer neuen Umgebungsvariable. 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 ". Bildschirmfoto, das den Bildschirm mit dem Präfix als neu anzeigt b. 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. Screenshot, der die zu kopierende Ressourcen-ID zeigt.

    c. 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.

    d. 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.

    e. 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. Sie benötigen ein Azure Blob Storage-Konto und einen Container, um Ihren Build in Azure Blob Storage hochzuladen. Wenn Sie noch keine erstellt haben, erstellen Sie eine.

    1. Wechseln Sie in Ihrem Schlüsseltresor im Azure-Portal zu Geheimnis, um ein Geheimnis für Ihren Azure Blob Storage-Zugriffsschlüssel zu erstellen. Weitere Informationen: Einem Schlüsseltresor ein Geheimnis hinzufügen. Screenshot, der zeigt, wie Azure-Geheimnisse erstellt werden

    2. Informationen zum Anzeigen und Kopieren Ihres Zugriffsschlüssels: Kontozugriffsschlüssel anzeigenScreenshot, der den Zugriffsschlüssel zeigt

    3. Geben Sie den Azure Blob Storage-Zugriffsschlüssel in das Feld Geheimniswert ein. Screenshot, der die Azure-Geheimnisse zeigt

    4. Wechseln Sie in Ihrem Schlüsseltresor zu Tags , und erstellen Sie ein neues Tag mit demselben geheimen Wert wie oben. Screenshot, der die Azure-Tags zeigt

  5. Aktivieren Sie die automatische App-Signatur (optional). Screenshot, der den zweiten Schritt zur Auswahl der Zielplattform zeigt

    Notiz

    Optionen für manuelles Signieren:

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

  6. Wählen Sie Weiter aus.

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, bearbeiten Sie es, um das Präfix auf "neu" festzulegen.
  5. Speichern Sie die Änderungen.

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:

      • Anwendungsname: Der Name Ihrer App, der Kunden angezeigt wird
      • Android-Signatur-Hash (wenn für Android): eine 28-Zeichen lange alphanumerische Zeichenfolge Screenshot, der den Bildschirm für die Registrierung einer neuen App zeigt

    3. Wechseln Sie im Microsoft Entra Admin Center zu App-Registrierungen, und wählen Ihre App aus. Suchen Sie im Abschnitt „Grundlagen“ unterstützte Kontotypen: Wählen Sie „Konten” in einem beliebigen Organisationsverzeichnis (Beliebiges Microsoft Entra-Verzeichnis – mehrinstanzenfähig). Screenshot, der den Bildschirm für die mehrinstanzenfähige Registrierung zeigt

    4. Speichern Sie Ihre Änderungen.

      Notiz

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

Drittanbieter-Apps als Azure-Mandantenadministrator konfigurieren

Der Assistent zum Verpacken 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:

Screenshot des Registrierungsbildschirms mit grünen Häkchen für abgeschlossene Schritte

API-Berechtigungen als Azure-Mandantenadmin erteilen

Azure-Administrator erteilt API-Berechtigungen während der Registrierung. Stellen Sie sicher, dass DeviceManagementManagedApplication auf Ja festgelegt ist, wenn Sie die Administratoreinwilligung für Ihre App erteilen. Weitere Informationen finden Sie unter Erteilen Sie mandantenübergreifende Administratoreinwilligung in der Enterprise-Apps. Screenshot, der die API-Berechtigungen für die App zeigt

Erforderliche API-Berechtigungen

API-Typ Spezifische API Ursache
Microsoft-APIs Dynamics CRM Die Anwendung benötigt user_impersonation, um Dataverse für den Benutzer aufzurufen.
APIs, die meine Organisation verwendet Azure-API-Verbindungen Die Anwendung benötigt Runtime.All, um einen beliebigen Konnektor von Power Platform aufzurufen.
APIs, die meine Organisation verwendet PowerApps-Dienst Die Anwendung benötigt die Berechtigung User zum Kontaktieren von Power Apps-Back-End-Diensten von Power Platform.
APIs, die meine Organisation verwendet Power BI Die Anwendung benötigt Power BI-Berechtigungen, um auf Power BI Inhalte zuzugreifen oder diese einzubetten.
APIs, die meine Organisation verwendet Microsoft Verwaltung mobiler Anwendungen Die Anwendung benötigt diese Berechtigung, da Power Apps Intune SDK intern verwendet.

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

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"

Notiz

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-Hash-Feld anzuzeigen.

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. Screenshot, der Umleitungs-URI für die App zeigt.

5. Branding konfigurieren

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

Notiz

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

Einstellungen Beschreibung 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 Begrüßungsbildschirms 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
  1. Wählen Sie Weiter aus.

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 Blob Storage-Speicherort herunter.

Screenshot, der den fünften Schritt zum Verwalten der Ausgabe mithilfe von Azure Blob Storage zeigt

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

Screenshot, der zeigt, wie Builds angezeigt werden.

Notiz

Wenn Sie eine iOS-App manuell mit Code signieren möchten, entpacken Sie die IPA-Datei, die 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 das Verpacken nutzen, 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 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)

App-Registrierung – unterstützte Kontotypen für Verpacken.

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 einen separaten Umleitungs-URI für jede Plattform erstellen (iOS, Android).

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.
Plattform Signaturmethode
iOS Manuelles Code-Signieren für iOS
Android Manuelles Code-Signieren für Android
Google Play Store Code-Signieren für den Google Play Store

Siehe auch

  • Last updated on