Freigeben über


Verwenden Sie den Wrap-Assistenten, um Ihre Mobile-App auszuführen

Verwenden Sie die Verpacken-Funktion, um eine oder mehrere Canvas-Apps mithilfe des Schritt-für-Schritt-Assistenten als einzelnes natives mobiles App-Paket zu verpacken.

Die Verpacken-Funktion in Power Apps ermöglicht Ihnen das erstellen einer nativen mobilen Version Ihrer Canvas-Apps mit benutzerdefiniertem Branding für Android- und iOS mobilen Apps. Sie können solche verpackten nativen mobilen Apps über Microsoft App Center, Google Play Store und Apple Business Manager an die Endbenutzer verteilen.

Mit der Verpackungs-Funktion können Sie mobile Apps für iOS, Android oder den Google Play Store erstellen:

  • iOS (IPA-Paket)
  • Android (APK-Paket)
  • Für Google Play Store-Verteilung (ABB-Paket)

Die Wrap-Funktion verpackt Ihre Canvas-Apps in eine native Mobile-App-Hülle, die Sie digital signieren und distribuieren können. Wenn Sie Ihre App aktualisieren und erneut veröffentlichen, wird die App automatisch aktualisiert.

Erstellen Sie mithilfe des Assistenten native mobile Apps für iOS und Android

  1. Melden Sie sich bei Power Apps 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 dazu die App aus, die Sie verpacken möchten, und wählen Sie auf der Befehlsleiste Verpacken aus.

Schritt 1: Apps auswählen

  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.

    • Primäre App: Wählen Sie die App, die Ihre Anwender sehen, wenn die Mobile-App gestartet wird.

    • Sekundär-App(s): Optionale andere Apps, die Sie zusammen mit der primären App im gleichen Build für Mobile-App-Paket bündeln können.

      Wählen Sie die Anwendungen aus, die Sie einpacken möchten.

      Anmerkung

      • Sie können dieselbe primäre App in mehreren Verpackungs-Projekten verwenden.
      • Wenn der Name der primären App im Verpacken-Assistenten falsch angezeigt wird, fahren Sie mit dem nächsten Schritt fort, und kehren Sie dann zurück, um sich den richtigen Namen anzeigen zu lassen.
  2. Wählen Sie Weiter.

Schritt 2: 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. Weitere Informationen: Manuelle Registrierung Ihrer App auf dem Azure-Portal.

Ihre App muss in Microsoft Entra registriert sein, damit sich die Benutzer Ihrer App anmelden können. Wenn Sie sich bereits registriert haben, finden Sie Ihre Registrierung im Feld „Eigene Registrierungen“.

Erstellen Sie eine neue App-Registrierung.

Wenn der Name Ihrer registrierten App nicht in der Dropdownliste Eigene Registrierungen angezeigt wird, gehen Sie folgendermaßen vor.

  • Wählen Sie Neue App Registrierung, um eine neue Registrierung für Ihre App automatisch zu erstellen.

  • Sie müssen den Anwendungsnamen und den Android-Signatur-Hash angeben, da es sich um Pflichtfelder handelt. Der Anwendungsname ist erforderlich, da es sich um den für die Kunden sichtbaren Namen der Anwendung handelt. Der Android-Signatur-Hash ist notwendig, wenn Sie Android als eine der Plattformen beim Erstellen und Entwickeln Ihres Verpacken-Projekts ausgewählt haben.

    Anmerkung

    Das Format des Android-Hash-Schlüssels ist eine 28-stellige alphanumerische Hash-Nummer, z. B. –ga0RGNYHvNM5d0SLGQfpQWAPGJ8=. Wenn der Signatur-Hash-Schlüssel bereits vorhanden ist, muss kein neuer erstellt werden. Sie können den zuvor generierten Signatur-Hashschlüssel wiederverwenden, wenn Sie eine neue App-Registrierung erstellen.

    Fügen Sie App-Registrierungsdetails hinzu.

Vom Administrator zugelassene Drittanbieter-Apps konfigurieren

Der Wrap-Assistent konfiguriert alle erforderlichen API-Berechtigungen für Ihre App automatisch. Sie können auch die Berechtigungen für die API manuell konfigurieren, wenn Sie eine Fehlerbehebung für diesen Schritt durchführen möchten. Weitere Informationen: Konfigurieren Sie die API-Berechtigungen für Ihre App manuell.

Wenn Sie die App registrieren, muss der Azure-Administrator Zugriff gewähren, um fortzufahren. So gewähren Sie Zugriff:

  • Öffnen Sie Windows PowerShell und führen Sie es als Fachkraft für die Administration aus.
  • Führen Sie den Befehl Install-Module -Name Microsoft.PowerApps.Administration.PowerShell -AllowClobber -Force aus.
  • Legen Sie die Ausführungsrichtlinie mit Set-ExecutionPolicy -ExecutionPolicy RemoteSigned fest.
  • Importieren Sie das Modul mit Import-Module -Name Microsoft.PowerApps.Administration.PowerShell.
  • Führen Sie Add-AdminAllowedThirdPartyApps aus und geben Sie die App-ID an, für den Administrationszugriff erforderlich ist.
  • Führen Sie Get-AdminAllowedThirdPartyApps aus, um zu überprüfen, ob Ihr App-Name in der Liste angezeigt wird.

Nachdem Sie die vorhergehenden Schritte abgeschlossen haben, sieht der Registrierungsbildschirm wie im folgenden Screenshot aus.

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

API-Berechtigungen

Wenn Sie die App registrieren, muss der Azure-Administrator auch Zugriff auf API-Berechtigungen für die App gewähren. Im folgenden Screenshot finden Sie Anweisungen zum Gewähren des Zugriffs und die Gründe, warum API-Berechtigungen erforderlich sind.

Screenshot, der die API-Berechtigungen für die App zeigt

Anmerkung

In diesem Schritt ist manchmal für die neuen Kunden nur das Feld Anwendungsname sichtbar. Das Feld zum Hinzufügen des Android-Signatur-Hashs wird nicht angezeigt. Um dieses Problem zu beheben, fahren Sie mit den nächsten Schritten fort und wählen Sie die Zielplattformen, z. B. Android, im Schritt Zielplattformen aus.

Schritt 3: Branding konfigurieren

  1. Legen Sie im Schritt „Branding konfigurieren“ die folgenden Look-and-Feel-Optionen für Ihre App fest:

    Anmerkung

    Alle Bilder müssen im PNG-Format vorliegen. Wenn keine benutzerdefinierten Bilder ausgewählt sind, wird ein Standardbild verwendet.

    • App-Symbole: Symbole für Ihre App hochladen. Empfohlene Größe für iOS: PNG-Bild mit 1.024 px x 1.024 px oder mehr. Empfohlene Bildgröße für Android: PNG-Bild mit 432 px x 432 px oder mehr.
    • Bild für den Startbildschirm: Bild, das auf dem Startbildschirm Ihrer Mobile-App verwendet wird, während sie geladen wird. Standardbild, das verwendet wird, wenn nicht bereitgestellt wird.
    • Bild des Willkommensbildschirms: Bild, das auf dem Willkommensbildschirm (Anmeldung) Ihrer Mobile-App verwendet wird, während diese geladen wird. Standardbild, das verwendet wird, wenn nicht bereitgestellt wird.
    • Hintergrund-Füllfarbe: Hexadezimaler Farbcode, der für den Hintergrund des Willkommensbildschirms verwendet wird.
    • Schaltflächen-Füllfarbe: Hexadezimaler Farbcode, der zum Füllen der Schaltflächenfarbe verwendet wird.
    • Statusleistentext-Thema: Farbe für den Statusleistentext oben in der App.
  2. Wählen Sie Weiter.

Schritt 4: Ziel-Plattform

  1. Geben Sie auf der Anzeige Mobile Plattform für Ziel auswählen ein und geben Sie die Paket-ID Ihrer Wahl ein.

    Anmerkung

    Die Paket-ID ist eine eindeutige Kennung, die Sie für Ihre App erstellen. Eine Paket-ID muss einen Punkt (.) und keine Leerzeichen enthalten.

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

  3. Stellen Sie den Umschalter Meine App signieren auf AN, um automatisch eine Codesignierung für Ihre mobile App durchzuführen, wählen Sie dann die Azure Key Vault-URI aus der Liste und dann Weiter aus. Wenn Sie keine Einträge in der Liste Azure Key Vault URI haben, müssen Sie zuerst Azure Key Vault erstellen. Weitere Informationen: Azure Key Vault zum Verpacken für Power Apps erstellen.

    Wählen Sie die Apps aus, die Sie umhüllen möchten.

Sie können Ihr Mobile-App Paket auch manuell coden, anstatt die automatische Coderegistrierung zu verwenden, die im Wrap Wizard verfügbar ist. Weitere Informationen darüber, wie Sie Ihre App manuell coden können, finden Sie unter:

Anmerkung

Der Verpacken-Assistent stellt einen automatischen Anmeldevorgang bereit. Entwicklungsfachkräfte, die mit mobilen Prozessen vertraut sind, können sich jedoch manuell für ihre Android- oder iOS-Anwendungen anmelden, indem sie für jede Plattform unterschiedliche Mechanismen verwenden. Wenn Sie sich über den manuellen Prozess anmelden, müssen Sie keinen Azure Key Vault erstellen.

  1. Wählen Sie Weiter.

Schritt 5: Azure Blob Storage

  1. Erstellen Sie einen Azure Key Vault, falls Sie dies noch nicht getan haben. Weitere Informationen: Azure Key Vault zum Verpacken mithilfe eines Standardabonnements erstellen
  2. Erstellen Sie ein Azure Blob Storage-Konto und einen Containernamen. Weitere Informationen Azure Speiherkonto erstellen
  3. Fügen Sie die URI des Azure Key Vault hinzu, indem Sie auf die Dropdown-Liste klicken.
  4. Fügen Sie den Namen des Azure Blob Storage-Kontos und den Namen des Containers hinzu, der während des Schritts zur Erstellung des Azure Blob Storage-Kontos erstellt wurde.
  5. Laden Sie das erstellte APK/IPA vom oben erstellten Azure-Blobspeicherort herunter, nachdem die Buildschritte abgeschlossen sind.

Schritt 6: Verpacken

Überprüfen Sie auf der Anzeige Umschließen die App-Details und wählen Sie dann Erstellen aus. Nach einem erfolgreichen Build sehen Sie Ihre mobile App am Azure-Blobspeicherort, den Sie im vorherigen Schritt ausgewählt haben.

Mobile App-Paket testen und verteilen

Ihre Anwendung testen und verteilen. Wenn Sie beim Testen auf Probleme stoßen , überprüfen Sie die Fehlerbehebungsseite.

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

Sie können Ihre App-Registrierung automatisch im Wrap-Assistenten erstellen, wie in Schritt 4 beschrieben. Oder Sie können manuell eine neue Registrierung für Ihre App auf Azure-Portal 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.

Unabhängig davon, ob Sie ein Hersteller einzelner oder mehrerer Mandanten sind, wählen Sie eine der Optionen mit Einem Microsoft Entra-Verzeichnis – mehrinstanzfähig aus, wenn Sie den unterstützten Kontotyp für Ihre App auswählen, um sie für Verpacken zu aktivieren: Wählen Sie eine der folgenden Kontotypen aus.

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

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 zu den Kontotypen: Kontotypen in Microsoft Identity Platform.
  • Sie müssen eine separate Umleitungs-URI für jede Plattform (iOS, Android) erstellen, die Sie erreichen möchten.

Konfigurieren Sie die API-Berechtigungen für Ihre App manuell (optional)

Wenn Sie Schritt 4 abschließen, konfiguriert der Wrap-Assistent automatisch alle erforderlichen API Berechtigungen für Ihre App.

Wenn Sie im Wrap-Assistenten Fehler erhalten, können Sie die API-Berechtigungen manuell konfigurieren. Weitere Informationen: Hinzufügen und konfigurieren

Bei der manuellen Konfiguration von API-Berechtigungen sind die folgenden Berechtigungen erforderlich:

  • Microsoft APIs
    • Dynamics CRM
  • APIs, die meine Organisation verwendet
    • Azure-API-Verbindungen
    • PowerApps Service
    • Power BI (nur erforderlich, wenn Ihre Canvas-Apps Power BI-Daten verwenden)
    • Microsoft Verwaltung mobiler Anwendungen (nur erforderlich, wenn Sie Microsoft Intune für die Verteilung mobiler Apps verwenden möchten)

Anmerkung

Wenn Sie die Berechtigungen nicht unter APIs, die meine Organisation verwendet finden, führen Sie die folgenden PowerShell-Befehle nach Bedarf aus und versuchen Sie es erneut:

  • Stellen Sie sicher, dass das Modul Microsoft Graph verfügbar ist, oder installieren Sie es mit dem folgenden Befehl:
    Install-Module -Name Microsoft.Graph
    
  • Fehlende Berechtigung für Azure-API-Verbindungen:
    Connect-MgGraph -TenantId <your tenant ID>
    New-MgServicePrincipal -AppId fe053c5f-3692-4f14-aef2-ee34fc081cae -DisplayName "Azure API Connections"
    
  • Fehlende Berechtigung für PowerApps Service:
    Connect-MgGraph -TenantId <your tenant ID>
    New-MgServicePrincipal -AppId 475226c6-020e-4fb2-8a90-7a972cbfc1d4 -DisplayName "PowerApps Service"
    

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

Erzeugen Sie manuell einen App-Center-Standort für Ihre Mobile-App (optional)

Sie können einen App Center-Standort für Ihre mobile App direkt im App Center manuell erstellen. Weitere Informationen: App-Center lokalisieren

Tipp

Weitere Informationen über das App Center finden Sie in der Visual Studio App Center Dokumentation.

  1. Gehen Sie zum App-Center.

  2. Melden Sie sich mit Ihrem Geschäfts-, Schul- oder Unikonto an.

  3. Wenn Sie keine bestehende Organisation haben, wählen Sie Neue hinzufügen>Neue Organisation hinzufügen aus, um eine neue Organisation zu erstellen.

  4. Wählen Sie die Organisation aus der Liste im linken Bereich aus.

  5. Wählen Sie Apps>App hinzufügen aus.

  6. App-Namen eingeben.

  7. Wählen Sie den App-Release-Typ aus.

  8. Wählen Sie Benutzerdefiniertes Betriebssystem für iOS-Apps oder Android-Betriebssystem für Android-Apps aus.

    Anmerkung

    Sie müssen für jede Plattform einen eigenen App Center Container erstellen.

  9. Für das Android-Betriebssystem wählen Sie Plattform als React Native aus.

    Anmerkung

    Plattform muss React Native für alle Apps im App Center sein.

    Konfiguration der App Center-App.

  10. Wählen Sie Neue App hinzufügen aus.

  11. Kopieren Sie die App Center-URL der App. Sie benötigen sie später, um das Verpacken-Projekt in Power Apps zu konfigurieren.

    Zum Beispiel https://appcenter.ms/orgs/Contoso-sales/apps/Sample-canvas-app-for-Android-OS/

    App Center-URL.

Signieren Sie Ihr Mobile-App Paket manuell (optional)

Sie können Ihr Mobile-App Paket während des Wrap-Prozesses in Schritt 2 automatisch signieren, aber Sie können dies auch manuell tun, nachdem das Mobile-App Paket ausgeführt wurde. Der Codesignierungsprozess für Android und iOS Geräte ist anders.

Siehe auch