Expertul de încapsulare: Ghid pas cu pas pentru construirea aplicației mobile native

Folosește acest ghid pentru a converti una sau mai multe aplicații pe pânză într-un singur pachet de aplicații personalizat, pe care îl poți implementa pe Google Play și în iOS App Store.

Funcția wrap vă permite să creați versiuni mobile native ale aplicațiilor canvas ca aplicații mobile personalizate cu branding (pachete IPA, APK, AAB). Power Apps Android iOS Puteți distribui aceste aplicații mobile native încapsulate utilizatorilor finali prin Google Play, Apple Business Manager sau alte metode de distribuție nativă.

Când actualizați și republicați aplicația, aplicația încapsulată este actualizată automat pentru utilizatori.

Pași pentru a crea o aplicație nativă cu marcă personalizată folosind expertul de încadrare

Urmează acești pași pentru a configura, construi, semna și distribui un pachet de aplicații mobile native personalizate (APK, AAB sau IPA) din aplicațiile tale canvas folosind asistentul wrap din Power Apps.

1. conectați-vă și începeți un proiect wrap

  1. Conectați-vă la Power Apps portalul Maker.
  2. Selectați Încadrare din panoul de navigare din stânga. Dacă articolul nu se află în panoul panoului lateral, selectați …Mai multe și apoi selectați elementul dorit.
  3. Selectați aplicația pe care doriți să o încadrați, apoi selectați Încadrare în bara de comenzi.

2. Selectați aplicațiile

  1. Pe ecranul *Selectați aplicațiile de încadrat*, selectați aplicația principală și secundară.

    • Aplicație principală: Utilizatorii finali ai aplicației principale văd când se lansează aplicația mobilă.
    • Aplicații secundare: Alte aplicații opționale incluse în același pachet de aplicații mobile.

    Notă

    • Puteți utiliza aceeași aplicație principală în mai multe proiecte wrap.
    • Dacă numele aplicației principale pare incorect, treceți la pasul următor și reveniți pentru a actualiza numele.

  2. Selectați Următorul.

3. Alegeți platforma țintă

  1. Pe ecranul *Alegeți platforma mobilă de vizat*, introduceți un *ID de pachet*.

    Notă

    ID-ul pachetului este un identificator unic pentru aplicația dvs. Trebuie să conțină un punct (.) și niciun spațiu. Folosiți același ID de pachet atunci când creați seiful de chei Azure după generarea și încărcarea certificatelor iOS sau Android. Dacă ați creat deja Azure Key Vault, verificați ID-ul pachetului în secțiunea Etichete din portalul Azure.

  2. Sub Platforme țintă, selectați toate platformele mobile pe care utilizatorii finali le utilizează pe dispozitivele lor mobile.

  3. Trebuie să aveți Azure key vault pentru a încărca compilarea în spațiul de stocare Azure blob. Dacă nu ai creat deja, creează unul. Creează un seif Azure Key direct în wizard-ul Wrap sau urmează instrucțiunile manual.

  4. Activează comutatorul de semnare automată pentru a automatiza procesul de semnare.

    Notă

    Opțiuni de semnare manuală:

  5. Configurează semnarea automată prin vrăjitor.

    1. În pasul platformei țintă, activează Autosignarea. Serviciul verifică dacă seiful de chei și certificatul sunt deja atașate.

      Notă

      Azure Key Vault este folosit pentru a stoca și gestiona în siguranță secretele și certificatele aplicațiilor, cu acces centralizat și înregistrare completă a auditului.

    2. Dacă nu ai Key Vault și certificat sau vrei să le schimbi, selectează Configure.

      Notă

      Doar administratorii Azure pot crea un vault de chei din wizard-ul de înfășurare. Alți utilizatori trebuie să urmeze procesul manual de creare a seifurii de chei.

      Captură de ecran care arată opțiunea de semnare automată în pasul platformei țintă.

    3. Pe panoul lateral, selectează grupul de abonament și resurse și selectează seiful cheilor. Pentru a crea un nou seif de chei, selectează Creează un nou seif de chei. După ce selectezi seiful cheilor, selectează Următorul.

      Captură de ecran care arată keyvault-ul selectat pentru semnarea automată în pasul platformei țintă

    4. Serviciul verifică dacă principalul serviciului, rolul cititorului, politicile de acces și variabilele de mediu corespunzătoare sunt configurate pentru seiful cheilor. Dacă apar erori, corectează-le. După ce toate verificările trec, selectează Următorul.

    5. Pe următorul ecran, introduceți numele certificatului în seiful cheilor.

    6. Dacă nu există niciun certificat sau doriți să schimbați certificatul, consultați Generarea hash-ului cheie și semnătură pentru a crea un certificat nou. Apoi selectează Creează un certificat pe acest ecran. Această acțiune te duce la locația seifului de chei al portalului Azure. Încarcă certificatul generat în seiful de chei configurat.

      Notă

      Utilizatorii sunt responsabili pentru crearea certificatului.

      Captură de ecran care arată crearea sau introducerea unui certificat pentru semnarea automată în pasul platformei țintă

    7. Selectați Terminare.

    8. Pe ecranul principal, Azure Key Vault și certificatul apar așa cum au fost confirmate.

    9. Pe ecranul principal, selectează Următorul.

  6. Configurează semnarea automată din portalul Azure.

    1. Consultați instrucțiunile din crearea unui seif cu chei Azure pentru a crea un seif cu chei Azure. Odată ce seiful este creat, trebuie să adaugi etichetele, secretele și certificatele necesare. Adăugați variabila de mediu dacă nu a fost deja creată.
    2. Pentru a crea variabila de mediu, accesați Power Apps>Soluții>Soluție implicită. Apoi selectați Variabilă de mediu nouă>mai multe> și adăugați numele afișat ca „PA_Wrap_KV_ResourceID”. Captură de ecran care arată ecranul pentru adăugarea unei noi variabile de mediu. Numele noii variabile de mediu trebuie să aibă prefixul "nou". Dacă nu, consultați Setarea prefixului variabilei de mediu pentru pași detaliați. Captură de ecran care arată ecranul cu prefix ca nou
    3. Pentru a adăuga informații despre seif la variabilele de mediu, accesați portalul Azure ca administrator. Navigați la Toate resursele>Seiful de chei>Proprietăți, apoi copiați ID-ul resursei. Captură de ecran care arată ID-ul resursei care va fi copiată.
    4. Pentru a adăuga intrarea la variabila de mediu, accesați Power Apps>ApplicationName>All>variabilele de mediu. Faceți clic pe cele trei puncte, selectați Editare, adăugați valoarea copiată la Valoare implicită și salvați.
    5. Pentru a verifica dacă valoarea tabelului a fost actualizată, accesați Power Apps>Tabele>Definiția variabilei de mediu>new_PA_Wrap_KV_ResourceID . Valoarea din Valoare implicită trebuie să fie aceeași cu cea a ID-ului de resursă pentru care doriți să adăugați seiful.

      Notă

      Instrucțiuni pentru adăugarea intrării în spatele variabilelor de mediu pentru informațiile din seiful de chei:

      • Variabilele de mediu nu trebuie să fie goale sau pot conține mai multe intrări.
      • Asigurați-vă că ID-ul resursă adăugat este corect (verificați ortografia).
      • Asigurați-vă că ID-ul resursă adăugat are etichete care nu sunt goale și include toate etichetele așteptate cu ID-ul pachetului utilizat în expertul de încapsulare.
    6. Urmați pașii din Pași pentru semnarea automată a codului pentru a crea etichetele, secretele și certificatele necesare în timpul procesului de semnare automată.

4. Gestionarea producției

Pentru a-ți încărca build-ul în Azure Blob Storage, ai nevoie de un cont Azure Blob Storage și un container. Dacă nu ai unul, creează unul.

  1. La Gestionează ieșirea, selectează Configurează pentru a adăuga informațiile despre seiful de chei, contul de stocare și containerul.
  2. În panoul lateral Configurează keyvault , selectează seiful de chei care stochează datele de acces la stocarea ta de blob Azure, apoi selectează Următorul. Captură de ecran care arată keyvault selectat în pasul de gestionare a ieșirii
  3. În ecranul Configurează stocarea , selectați numele stocării și numele containerului, apoi introduceți numele secretului care conține accesul la stocare. Pentru a crea un nou secret, urmează instrucțiunile din secțiunea "Cum să creezi un secret" de pe același ecran. Captură de ecran care arată opțiuni pentru configurarea stocării în pasul de gestionare a ieșirii
  4. Selectați Terminare.

5. Înregistrează-ți aplicația

Pe ecranul *Înregistrați aplicația*, înregistrați aplicația în Azure pentru a stabili încrederea cu platforma de identitate Microsoft.

  • Dacă ați înregistrat deja o aplicație:

    • Găsiți înregistrarea dvs. în câmpul de înregistrare deținută.

  • Dacă nu vedeți aplicația înregistrată:

    1. Selectați Înregistrare aplicație nouă pentru a crea o înregistrare nouă.
    2. Oferă:
      • Numele aplicației: Numele aplicației dvs. orientat către client
      • Android hash-ul semnăturii (dacă se vizează Android): Un șir alfanumeric de 28 de caractere Captură de ecran care afișează ecranul de înregistrare a noii aplicații
    3. Salvați modificările.

Configurați aplicațiile terțe permise de administrator ca administrator de chiriaș Azure

Aplicația înregistrată trebuie configurată ca o aplicație terță. Pentru a configura aplicația, administratorul chiriașului Azure urmează acești pași.

  1. Deschideți Windows PowerShell ca administrator.
  2. Executați aceste comenzi:
    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. Furnizați ID-ul aplicației când vi se solicită.

După parcurgerea acestor pași, ecranul de înregistrare va arăta astfel:

Captură de ecran care afișează ecranul de înregistrare cu bife verzi pentru pașii finalizați

Acordarea permisiunilor API ca administrator de entitate găzduită Azure

Aplicația necesită următoarele permisiuni API pentru a funcționa corect.

Permisiuni API necesare
Tip API API specific Motiv
API-uri Microsoft Dynamics CRM Aplicația trebuie să apeleze pentru utilizator. user_impersonation Dataverse
API-urile pe care le folosește organizația mea Conexiuni API Azure Aplicația trebuie Runtime.All să apeleze orice conector din Power Platform.
API-urile pe care le folosește organizația mea Serviciul PowerApps Aplicația necesită permisiunea de a contacta serviciile backend din User . Power Apps Power Platform
API-urile pe care le folosește organizația mea Power BI Aplicația necesită permisiuni pentru a accesa sau încorpora conținut. Power BI Power BI
API-urile pe care le folosește organizația mea Gestionarea aplicațiilor mobile Microsoft Aplicația are nevoie de această permisiune deoarece folosește intern SDK-ul Intune. Power Apps
Configurarea permisiunilor din Wrap wizard

Wizard-ul de înfășurare verifică și marchează permisiunile care nu sunt disponibile cu aplicația. Ca administrator Azure, selectează acces cu un click în vrăjitorul de înfășurare pentru a acorda permisiunile în așteptare. Alternativ, poți configura permisiuni prin comenzile Powershell de mai jos.

Captură de ecran care arată opțiunea de reparare a permisiunilor aplicației cu un singur click

Configurează permisiunile prin comenzi Powershell:

Asigurați-vă că DeviceManagementManagedApplication este setat la Yes atunci când acordați consimțământul administratorului pentru aplicația dvs. Captură de ecran care arată permisiunile API pentru aplicație.

Executați aceste comenzi PowerShell ca administrator Azure dacă nu vedeți permisiuni sub API-urile pe care le folosește organizația mea:

  1. Asigurați-vă că modulul Microsoft Graph este disponibil sau instalați-l:

    Install-Module -Name Microsoft.Graph

  2. Acordați permisiunea Conexiuni API Azure pentru AppId-ul static fe053c5f-3692-4f14-aef2-ee34fc081cae:

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

  3. Acordați permisiunea PowerApps Service pentru AppId-ul static 475226c6-020e-4fb2-8a90-7a972cbfc1d4:

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

Notă

Dacă este vizibil doar câmpul *Nume aplicație*, continuați cu pașii următori și selectați *ca platformă țintă* pentru a afișa câmpul hash al semnăturii. Android

Configurați manual permisiunile API (opțional)

Dacă primiți erori, configurați manual permisiunile API. Pentru mai multe informații, consultați Adăugați și configurați.

Adăugați URI-uri de redirecționare ca administrator de aplicație

  1. În Azure Portal, accesați înregistrarea aplicației >Autentificare.
  2. Selectați Adăugați o platformă și alegeți iOS sau Android.
  3. Pentru iOS, introduceți ID-ul pachetului . Pentru Android, introduceți atât ID-ul pachetului , cât și Cheia hash a semnăturii. Captură de ecran care afișează URI-urile de redirecționare pentru aplicație.

6. Configurarea brandingului

  1. În pasul *Configurare branding*, setați următoarele opțiuni pentru aplicația dvs.:

Notă

Toate imaginile trebuie să fie în format .png. Imaginile implicite vor fi utilizate dacă nu sunt selectate imagini personalizate.

Setare Descriere Cerințe
Pictograme de aplicații Pictograme pentru aplicația dvs. iOS1024x1024 px sau mai mare
Android432x432 px sau mai mare
Imaginea ecranului de pornire Imagine afișată în timp ce se încarcă aplicația Format .png
Imaginea ecranului de bun venit Imaginea afișată pe ecranul de conectare Format .png
Culoare de umplere a fundalului Culoare pentru fundalul ecranului de bun venit Cod de culoare hexazecimal
Culoarea de umplere a butonului Culoare pentru butoane Cod de culoare hexazecimal
Temă text bara de stare Culoare pentru textul din bara de stare Lumină sau Întuneric
  1. Selectați Următorul.

7. Încheierea și construirea

  1. Pe ecranul *Încheiere*, verificați detaliile aplicației și selectați *Construire*.
  2. După o compilare reușită, pachetul aplicației va fi disponibil în spațiul de stocare Azure blob specificat.

Vizualizați versiunea dvs.

Puteți vizualiza construcția în mai multe moduri:

  • După construire, selectați Vizualizare construcții
  • Accesați Încadrarea proiectelor în panoul lateral, treceți cu mouse-ul peste proiectul dorit și selectați-l
  • Selectați opțiunea Vizualizare construcții din antetul superior

Captură de ecran care arată cum se vizualizează build-urile.

Notă

Pentru a semna manual codul unei aplicații, dezarhivați fișierul IPA utilizând un dispozitiv Mac. iOS

Testează și distribuie aplicația ta

Testează-ți aplicația și distribuie-o după cum este necesar. Dacă întâmpinați probleme, consultați pagina de depanare.

Setați prefixul variabilei de mediu

Numele noii variabile de mediu trebuie să aibă prefixul "nou". Dacă nu, urmați acești pași:

  1. Accesați Soluții>Soluție nouă.
  2. Selectați un editor sau creați unul.
  3. Selectați pictograma de editare de lângă Publisher pentru a vizualiza sau modifica prefixul.
  4. Dacă prefixul nu este "nou", schimbă-l în "nou".
  5. Salvați modificările.

Înregistrați manual aplicația pe portalul Azure (opțional)

Puteți crea înregistrarea aplicației automat în expert sau manual în Azure. Mai multe informații: Ghid de pornire rapidă: Înregistrați o aplicație cu platforma de identitate Microsoft.

Notă

Atât clienții cu o singură entitate găzduită, cât și clienții cu mai multe entități găzduite pot folosi încapsularea pentru a crea aplicații mobile native pe baza aplicațiilor lor create pe planșă Power Apps.

La înregistrare, selectați un tip de cont care conține Orice Microsoft Entra director - Multitenant:

  • Conturi în orice director organizațional (Orice director - Multitenant) Microsoft Entra
  • Conturi din orice director organizațional (Orice director - Multitenant) și conturi Microsoft personale, cum ar fi Skype sau Microsoft Entra Xbox

Înregistrare aplicație - tipuri de cont acceptate pentru wrap.

Important

  • Wrap acceptă în prezent doar tipuri de conturi **Multitenant**. Tipul de cont cu un singur chiriaș nu este încă acceptat. Mai multe informații: Tipuri de conturi în platforma de identitate Microsoft.
  • Trebuie să creați un URI de redirecționare separat pentru fiecare platformă (iOS, Android).

Semnați manual pachetul aplicației mobile (opțional)

Puteți semna aplicația automat în Pasul 2 sau manual după compilare. Semnarea codului este diferită pentru Android și iOS.

Avantajele semnării automate pentru iOS și Android (APK):

  • Nu este nevoie să repetați procesul de semnare în timpul reîmpachetării.
  • Nu trebuie să așteptați ca dezvoltatorii aplicației să finalizeze procesul.
  • Nu trebuie să configurați sau să vă amintiți parole. Android Studio
  • Nu aveți nevoie de un dispozitiv Mac pentru semnare. iOS
Platformă Metodă de semnare
iOS Semn de cod manual pentru iOS
Android Semn de cod manual pentru Android
Magazin Google Play Semnarea codului pentru Magazinul Google Play

Vedeți și

  • Last updated on