Delen via


De verpakkingswizard gebruiken om uw mobiele app te bouwen

Gebruik de verpakkingsfunctie om een of meer canvas-apps te verpakken als één systeemeigen mobiel app-pakket met de stapsgewijze wizard.

Met de verpakkingsfunctie in Power Apps kunt u systeemeigen mobiele versies van uw canvas-apps als op maat gemaakte Android- en iOS mobiele apps maken. U kunt dergelijke ingepakte native mobiele apps distribueren naar eindgebruikers via Microsoft App Center, Google Play of Apple Business Manager of andere native distributiemethoden.

Met de verpakkingsfunctie kunt u mobiele apps maken voor iOS, Android of Google Play Store:

  • iOS (IPA-pakket)
  • Android (APK-pakket)
  • Voor Google Play Store-distributie (AAB-pakket)

Met de verpakkingsfunctie worden uw canvas-apps in een native mobiele app-shell verpakt die u digitaal kunt ondertekenen en distribueren. Wanneer u uw app bijwerkt en opnieuw publiceert, wordt de app automatisch bijgewerkt.

Maak systeemeigen mobiele apps voor iOS en Android met behulp van de wizard

  1. Aanmelden bij Power Apps.

  2. Selecteer Verpakken in het linkernavigatiedeelvenster. Als het item zich niet in het deelvenster van het zijpaneel bevindt, selecteert u …Meer en selecteert u vervolgens het gewenste item.

  3. Selecteer de app die u wilt verpakken en selecteer vervolgens Verwijderen op de opdrachtbalk.

Stap 1: Apps selecteren

  1. Selecteer op het scherm Selecteer de app(s) om te verpakken uw primaire en secundaire app.

    • Primaire app: selecteer de app die uw eindgebruikers zien wanneer de mobiele app wordt gestart.

    • Secundaire app(s): optionele andere apps die u kunt bundelen in dezelfde build voor het mobiele app-pakket samen met de primaire app.

      De apps kiezen die u wilt verpakken.

      Notitie

      • U kunt dezelfde primaire app gebruiken in meerdere verpakkingsprojecten.
      • Als in de verpakkingswizard de naam van de Primaire app onjuist lijkt, ga dan naar de volgende stap en keer terug om de juiste naam te bekijken.
  2. Selecteer Volgende.

Stap 2: Uw app registreren

Registreer uw applicatie handmatig in Azure op het scherm Uw app registreren om een vertrouwensrelatie tot stand te brengen tussen uw app en het Microsoft-identiteitsplatform. Meer informatie: Uw app handmatig registreren in de Azure-portal.

Uw app moet zijn geregistreerd in Microsoft Entra zodat uw app-gebruikers zich kunnen aanmelden. Als u zich al hebt geregistreerd, kunt u uw registratie vinden in het veld Registratie in eigendom.

Een nieuwe app-registratie maken.

Als u de naam van uw geregistreerde app niet ziet in de vervolgkeuzelijst Registraties in eigendom, volgt u deze stappen.

  • Selecteer Nieuwe app-registratie om automatisch een nieuwe registratie voor uw app te maken.

  • U moet de Toepassingsnaam en Android handtekeninghash opgeven, omdat dit verplichte velden zijn. Toepassingsnaam is vereist omdat dit de klantgerichte naam van de toepassing is. Android-handtekeninghash is nodig als u Android als een van uw platforms hebt geselecteerd tijdens het maken en bouwen van uw verpakkingsproject.

    Notitie

    De indeling van de Android-hash-sleutel is een alfanumeriek hashnummer van 28 cijfers, zoals –ga0RGNYHvNM5d0SLGQfpQWAPGJ8=. Als de hashsleutel voor de handtekening al bestaat, hoeft u geen nieuwe te maken. U kunt de eerder gegenereerde hashsleutel voor de handtekening opnieuw gebruiken bij het maken van een nieuwe app-registratie.

    Gegevens voor app-registratie toevoegen

Configureer door beheerders toegestane apps van derden

Met de verpakkingswizard worden automatisch alle vereiste API-machtigingen voor uw app geconfigureerd. U kunt de API-machtigingen ook handmatig configureren als u deze stap moet oplossen. Meer informatie: De API-machtigingen voor uw app handmatig configureren.

Wanneer u de app registreert, moet de beheerder van Azure toegang verlenen om door te kunnen gaan. Volg deze stappen om de toegang te verlenen:

  • Windows PowerShell openen en als beheerder uitvoeren.
  • Voer de opdracht Install-Module -Name Microsoft.PowerApps.Administration.PowerShell -AllowClobber -Force uit.
  • Stel het uitvoeringsbeleid in met: Set-ExecutionPolicy -ExecutionPolicy RemoteSigned.
  • Importeer de module met: Import-Module -Name Microsoft.PowerApps.Administration.PowerShell.
  • Voer Add-AdminAllowedThirdPartyApps uit en geef de app-id op waarvoor beheerdersrechten nodig zijn.
  • Voer Get-AdminAllowedThirdPartyApps uit om te controleren of de naam van uw app in de lijst voorkomt.

Zodra u de voorgaande stappen hebt voltooid, ziet het registratiescherm eruit zoals in de onderstaande schermafbeelding.

Schermafbeelding die het registratiescherm toont met groene vinkjes voor voltooide stappen

API-machtigingen

Wanneer u de app registreert, moet de beheerder van Azure ook toegang verlenen tot API-machtigingen voor de app. Raadpleeg de volgende schermafbeelding voor instructies over het verlenen van toegang en de redenen waarom API-machtigingen vereist zijn.

Schermafbeelding die de API-machtigingen voor de app toont.

Notitie

In deze stap is voor nieuwe klanten soms alleen het veld Applicatienaam zichtbaar. Het veld dat aan de Android-handtekeninghash moet worden toegevoegd, wordt niet weergegeven. Om dit op te lossen, gaat u verder met de volgende stappen en selecteert u de Doelplatforms als Android in de Stap Doelplatforms.

Stap 3: Huisstijl configureren

  1. Stel in de stap voor huisstijl configureren de volgende opties voor het uiterlijk in voor uw app:

    Notitie

    Alle afbeeldingen moeten de .png-indeling hebben. Er wordt een standaardafbeelding gebruikt als er geen aangepaste afbeeldingen zijn geselecteerd.

    • App-pictogrammen: Upload pictogrammen die u wilt gebruiken voor uw app. Aanbevolen formaat voor iOS: 1024 px bij 1024 px .png-afbeelding of groter. Aanbevolen afbeeldingsformaat voor Android: 432 px bij 432 px .png-afbeelding of groter.
    • Startschermopname: afbeelding die wordt gebruikt in het startscherm van uw mobiele app terwijl deze wordt geladen. Standaardafbeelding die wordt gebruikt wanneer deze niet wordt opgegeven.
    • Welkomstschermopname: afbeelding die wordt gebruikt op het welkomstscherm (aanmelding) van uw mobiele app terwijl deze wordt geladen. Standaardafbeelding die wordt gebruikt wanneer deze niet wordt opgegeven.
    • Opvulkleur voor achtergrond: Hexadecimale kleurcode die wordt gebruikt voor de achtergrond van het welkomstscherm.
    • Vulkleur van knop: Hexadecimale kleurcode die wordt gebruikt om de knopkleur te vullen.
    • Tekstthema van statusbalk: Kleur voor de statusbalktekst boven aan de app.
  2. Selecteer Volgende.

Stap 4: Doelplatform

  1. Voer op het scherm Kies mobiele platforms om u op te richten een bundel-ID van onze keuze in.

    Notitie

    De Bundel-ID is een unieke ID die u maakt voor uw app. Een bundel-ID moet één punt (.) en geen spaties bevatten.

  2. Selecteer onder Doelplatform(s) alle mobiele platforms die uw eindgebruikers gebruiken op hun mobiele apparaten.

  3. Zet de schakeloptie Mijn app ondertekenen op AAN om uw mobiele app automatisch te ondertekenen. Selecteer vervolgens Azure Key Vault URI in de lijst en selecteer Volgende. Als er geen invoer staat in de lijst URI van Azure Key Vault moet u eerst een Azure Key Vault maken. Meer informatie: Een Azure Key Vault maken voor verpakking in Power Apps.

    De apps kiezen die u wilt verpakken.

U kunt uw mobiele app-pakket ook handmatig met code ondertekenen in plaats van automatische codeondertekening te gebruiken die beschikbaar is in de verpakkingswizard. Zie voor meer informatie over hoe u handmatig codeondertekening kunt uitvoeren:

Notitie

De wizard Verpakken zorgt voor een automatisch aanmeldproces. Ontwikkelaars die bekend zijn met mobiele processen, kunnen zich echter handmatig aanmelden voor hun Android- of iOS-applicaties met behulp van verschillende mechanismen voor elk platform. Als u zich via het handmatige proces aanmeldt, hoeft u geen Azure sleutelkluis aan te maken.

  1. Selecteer Volgende.

Stap 5: Azure-blobopslag

  1. Maak een Azure sleutelkluis aan als u dat nog niet gedaan hebt. Meer informatie: Azure Key Vault maken voor verpakking met behulp van standaardabonnement
  2. Een Azure-blobopslagaccount en een containernaam maken. Meer informatie: Een Azure-opslagaccount maken
  3. Voeg de Azure sleutelkluis-URI toe door op de vervolgkeuzelijst te klikken.
  4. Voeg de Azure blob-opslagaccountnaam en de containernaam toe die u tijdens de stap voor het maken van het Azure blob-opslagaccount hebt gemaakt.
  5. Download de gebouwde APK/IPA van de hierboven gemaakte Azure blob-opslaglocatie nadat de buildstappen zijn voltooid.

Stap 6: Verpakken

Bekijk op het scherm Verpakken de details van de app en selecteer vervolgens Bouwen. Nadat de build succesvol is uitgevoerd, ziet u uw mobiele app in de Azure-blobopslaglocatie die u in de vorige stap hebt geselecteerd.

Het mobiele app-pakket testen en distribueren

Test en verspreid uw applicatie. Als u tijdens het testen problemen ondervindt, raadpleegt u de pagina over probleemoplossing.

Registreer uw app handmatig op de Azure-portal (optioneel).

U kunt uw app-registratie automatisch maken in de verpakkingswizard zoals vermeld in stap 4. Of u kunt handmatig een nieuwe registratie voor uw app maken in de Azure-portal. Meer informatie: Snelstartgids: een toepassing registreren bij het Microsoft-identiteitsplatform.

Notitie

Zowel klanten met één tenant als klanten met meerdere tenants kunnen de verpakkingsfunctie gebruiken om native mobiele apps te maken op basis van hun Power Apps-canvas-apps.

Of u nu een of meer tenants maakt, selecteer een van de opties met Alle Microsoft Entra-directory's - meerdere tenants bij het kiezen van het ondersteunde accounttype voor uw app om de verpakkingsfunctie in te schakelen. Kies een van de volgende accounttypen:

  • Accounts in een organisatiedirectory (alle Microsoft Entra-directory's - meerdere tenants)
  • Accounts in een organisatiedirectory (alle Microsoft Entra-directory's - meerdere tenants) en persoonlijke Microsoft-accounts (zoals Skype of Xbox).

App-registratie - ondersteunde accounttypen voor verpakken.

Belangrijk

  • Verpakken ondersteunt momenteel alleen accounts van het type Multitenant. Het accounttype Eén tenant wordt nog niet ondersteund. Meer informatie over de accounttypen: Accounttypen in het Microsoft-identiteitsplatform.
  • U moet een aparte omleidings-URI maken voor elk platform (iOS, Android) waarop u zich wilt richten.

De API-machtigingen voor uw app handmatig configureren (optioneel)

Wanneer u stap 4 voltooit, worden alle vereiste API-machtigingen voor uw app automatisch geconfigureerd met de verpakkingswizard.

Als u fouten krijgt in de verpakkingswizard, kunt u API-machtigingen handmatig configureren. Meer informatie: Toevoegen en configureren

De volgende API-machtigingen zijn vereist bij het handmatig configureren van API-machtigingen:

  • Microsoft-API's
    • Dynamics CRM
  • API's die mijn organisatie gebruikt
    • Azure API-verbindingen
    • PowerApps-service
    • Power BI (alleen vereist als uw canvas-app(s) Power BI-gegevens gebruikt/gebruiken)
    • Microsoft Mobile Application Management (alleen vereist als u Microsoft Intune wilt gebruiken voor distributie van mobiele apps)

Notitie

Als u de machtigingen niet vindt onder API's die mijn organisatie gebruikt, voer dan indien van toepassing de volgende PowerShell-opdrachten uit en probeer het opnieuw:

  • Zorg ervoor dat de module Microsoft Graph beschikbaar is of installeer deze met behulp van de volgende opdracht:
    Install-Module -Name Microsoft.Graph
    
  • Ontbrekende machtijging voor Azure API-verbindingen:
    Connect-MgGraph -TenantId <your tenant ID>
    New-MgServicePrincipal -AppId fe053c5f-3692-4f14-aef2-ee34fc081cae -DisplayName "Azure API Connections"
    
  • Ontbrekende machtiging voor PowerApps Service:
    Connect-MgGraph -TenantId <your tenant ID>
    New-MgServicePrincipal -AppId 475226c6-020e-4fb2-8a90-7a972cbfc1d4 -DisplayName "PowerApps Service"
    

Raadpleeg voor gedetailleerde stappen De machtigingen aanvragen in de app-registratieportal.

Een App Center-locatie handmatig voor uw mobiele app maken (optioneel)

U kunt handmatig een App Center-locatie voor uw mobiele app maken, rechtstreeks in het App Center. Meer informatie: App Center-locatie

Tip

Ga voor meer informatie over App Center naar Visual Studio App Center-documentatie.

  1. Ga naar App Center.

  2. Meld u aan met uw werk- of schoolaccount.

  3. Als u geen bestaande organisatie hebt, selecteert u Nieuwe toevoegen>Nieuwe organisatie toevoegen om een nieuwe organisatie op te richten.

  4. Selecteer de organisatie in de lijst in het linkerdeelvenster.

  5. Selecteer Apps>App toevoegen.

  6. Voer de appnaam in.

  7. Selecteer het type app-release.

  8. Selecteer Aangepast besturingssysteem voor iOS apps, of Android besturingssysteem voor Android apps.

    Notitie

    U moet voor elk platform afzonderlijke App Center-containers maken.

  9. Voor Android selecteert u Platform als React Native.

    Notitie

    Als Platform moet React Native zijn ingesteld voor alle apps in App Center.

    Configuratie van App Center-app.

  10. Selecteer Nieuwe app toevoegen.

  11. Kopieer de App Center-URL van de app. U hebt deze later nodig om het verpakkingsproject in Power Apps te configureren.

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

    App Center-URL.

Uw mobiele app-pakket handmatig ondertekenen (optioneel)

U kunt uw mobiele app-pakket automatisch ondertekenen tijdens het verpakkingsproces in Stap 2, maar u kunt dit ook handmatig doen nadat het mobiele app-pakket is samengesteld. Het proces voor het ondertekenen van code is anders voor Android en iOS apparaten.

Zie ook