Поділитися через


Майстер обгортання: Покрокова інструкція зі створення рідного мобільного додатку

Скористайтеся цим посібником, щоб перетворити одну або кілька програм на полотні в один пакет програм із власним брендом, який можна розгорнути в Google Play та iOS App Store.

Функція wrap in Power Apps дозволяє створювати власні мобільні версії ваших додатків canvas як під Android власним брендом, так і iOS для мобільних додатків (пакети IPA, APK, AAB). Ви можете розповсюджувати ці обгорнуті власні мобільні додатки серед кінцевих користувачів через Google Play, Apple Business Manager або інші власні методи розповсюдження.

Коли ви оновлюєте та повторно публікуєте додаток, обгорнутий додаток автоматично оновлюється для користувачів.

Кроки для створення нативного застосунку під власним брендом за допомогою майстра обгортання

1. log та запустіть проект обгортання

  1. Перейдіть на Power Apps портал виробника.
  2. Виберіть Обтікання на лівій панелі навігації. Якщо елемента немає на бічній панелі, виберіть ... Більше , а потім виберіть потрібний елемент.
  3. Виберіть програму, яку потрібно обняти, а потім натисніть «Обтікання » на панелі команд.

2. Виберіть програми

  1. На екрані Виберіть програми для перенесення виберіть свою основну програму (основні користувачі бачать під час запуску) і всі додаткові додатки, які потрібно об’єднати.

    • Основний додаток: основні користувачі бачать під час запуску мобільного додатка.
    • Додаткові додатки: необов’язкові додаткові додатки, що входять до одного пакету мобільних додатків.

    Знімок екрана, на якому показано перший крок для вибору програми.

    Нотатка

    • Ви можете використовувати одну й ту саму основну програму в кількох проектах обтікання.
    • Якщо основна назва програми відображається неправильно, перейдіть до наступного кроку та поверніться, щоб оновити назву.
  2. Виберіть Далі.

3. Виберіть цільову платформу

  1. На екрані Вибрати мобільну платформу для націлювання введіть ідентифікатор пакета.

    Нотатка

    Ідентифікатор пакета – це унікальний ідентифікатор вашого додатка. Він повинен містити одну крапку (.) і не містити пробілів. Використовуйте цей самий ідентифікатор пакета під час створення сховища ключів Azure після створення та завантаження ваших iOS сертифікатів або Android сертифікатів. Якщо ви вже створили Сховище ключів Azure, перевірте ідентифікатор пакета в розділі «Теги » порталу Azure.

  2. У розділі Цільові платформи виберіть усі мобільні платформи, які потрібні вашим користувачам.

  3. Виберіть URI Azure Key Vault зі списку.
    Якщо ви не бачите жодних записів, створіть сховище ключів Azure.

  4. Створіть обліковий запис і контейнер сховища BLOB-об’єктів Azure, якщо ви ще не впровадили такі дії:

  5. У сховищі ключів на порталі Azure:

    a. Перейдіть до розділу «Секрети », щоб створити секрет для ключа доступу до сховища BLOB-об’єктів Azure.

    б. Введіть ключ доступу до сховища BLOB-об’єктів Azure у поле Секретне значення .

    Скріншот, на якому видно секрети Azure

  6. У сховищі ключів перейдіть до розділу Теги та створіть новий тег із таким самим секретним значенням, як описано вище.

    Знімок екрана з тегами Azure

  7. Встановіть перемикач Підписати мою програму в положення Увімкнено або Вимкнено:

    Скріншот, який показує другий крок для вибору цільової платформи.

    Нотатка

    Варіанти підписання вручну:

    Підписувати AAB-файли потрібно вручну незалежно від вибраного в майстрі параметра підписування.

  8. Виберіть Далі.

4. Зареєструйте свій додаток

На екрані Реєстрація програми зареєструйте свою програму в Azure, щоб встановити довіру до платформи ідентифікації Microsoft.

  • Якщо ви вже зареєстрували додаток:

    • Знайдіть свою реєстрацію в полі «Власна реєстрація».
  • Якщо ви не бачите зареєстрованого додатка:

    1. Виберіть Нова реєстрація в додатку, щоб створити нову реєстрацію.

    2. Постачати:

      • Назва програми: назва вашого додатка, орієнтована на клієнта.
      • Android Хеш підпису (якщо націлено Android): 28-символьний буквено-цифровий рядок Знімок екрана, на якому видно екран реєстрації нового додатка
    3. У Microsoft Entra центрі адміністрування перейдіть до розділу Реєстрація додатків і виберіть свій додаток. У розділі «Основи» знайдіть «Підтримувані типи облікових записів», встановіть для нього значення «Облікові записи в будь-якому каталозі організації» (Будь-який Microsoft Entra каталог - Мультитенант). Знімок екрана з екраном реєстрації кількох користувачів

    4. Зберегти зміни.

      Нотатка

      Якщо хеш-ключ підпису вже існує, ви можете використовувати його повторно.

Налаштування сторонніх програм, дозволених адміністратором, як адміністратор клієнта Azure

Майстер обгортання автоматично налаштовує необхідні дозволи API. Щоб надати доступ адміністратора:

  1. Відкрийте Windows PowerShell від імені адміністратора.
  2. Виконайте такі команди:
    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. Надайте ідентифікатор програми, коли з’явиться відповідний запит.

Після виконання цих дій екран реєстрації буде виглядати наступним чином:

Скріншот, на якому видно екран реєстрації із зеленими галочками для виконаних кроків

Надавайте дозволи API як адміністратор клієнта Azure

Адміністратор Azure надає дозволи API під час реєстрації. Переконайтеся, що для параметра DeviceManagementManagedApplication установлено значення Так, коли ви надаєте згоду адміністратора для своєї програми. Щоб отримати додаткові відомості, перегляньте статтю Надання згоди адміністратора для всього клієнта на панелі корпоративних програм. Знімок екрана, на якому видно дозволи API для додатка.

Запустіть ці команди PowerShell від імені адміністратора Azure Якщо ви не бачите дозволів у розділі API, які використовує моя організація.

  1. Переконайтеся, що модуль Microsoft Graph доступний, або встановіть його:

    Install-Module -Name Microsoft.Graph
    
  2. Надання дозволу Azure API Connections для статичного 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. Надання PowerApps дозволу служби для статичного AppId 475226c6-020e-4fb2-8a90-7a972cbfc1d4

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

Нотатка

Якщо видно лише поле «Назва програми», перейдіть до наступних кроків і виберіть Android як цільову платформу для відображення поля хешу підпису.

Налаштування дозволів API вручну (необов’язково)

Якщо ви отримуєте повідомлення про помилки, вручну налаштуйте дозволи API. Щоб отримати докладнішу інформацію, перегляньте статтю Додавання та налаштування.

Необхідні дозволи API

API-тип Специфічний API Причина
API Microsoft Dynamics CRM Додатку потрібно user_impersonation викликати Dataverse за користувача.
API, які використовує моя організація Підключення API Azure Додатку потрібно Runtime.All викликати будь-який коннектор з Power Platform.
API, які використовує моя організація PowerApps Служба Програмі потрібен User дозвіл на звернення Power Apps до серверних служб з Power Platform.
API, які використовує моя організація Power BI Програмі потрібні Power BI дозволи на доступ до контенту або його вбудовування Power BI .
API, які використовує моя організація Управління мобільними додатками Microsoft Програмі потрібен цей дозвіл, оскільки Power Apps він використовує Intune SDK на внутрішньому ринку.

Докладні кроки наведено в статті Запит дозволів на порталі реєстрації програм.

Додавання URI переспрямування як адміністратор додатка

  1. На порталі Azure перейдіть до розділу Автентифікація > реєстраціїв програмі.
  2. Виберіть Додати платформу та виберіть iOS або Android.
  3. Для iOS цього введіть ідентифікатор пакета.
    Для Android цього введіть ідентифікатор пакета та хеш-ключ підпису. Знімок екрана, на якому видно URI переспрямування для програми.

5. Налаштуйте брендинг

  1. На кроці Налаштування бренду встановіть такі параметри для своєї програми:

Нотатка

Всі зображення повинні бути в форматі .png. Зображення за замовчуванням використовуватимуться, якщо не вибрано користувацькі зображення.

Налаштування Опис Вимоги
Піктограми додатків Значки для вашого додатка iOS: 1024x1024 px або більше
Android: 432x432 px або більше
Зображення заставки Зображення відображається під час завантаження програми .png формат
Зображення на екрані привітання Зображення відображається на екрані входу .png формат
Колір фонової заливки Колір для фону екрана привітання Шістнадцятковий код кольору
Колір заливки кнопок Колір для гудзиків Шістнадцятковий код кольору
Текстова тема в рядку стану Колір для тексту в рядку стану Світлий або темний
  1. Виберіть Далі.

6. Керуйте виробом

  1. Введіть ім’я облікового запису сховища BLOB-об’єктів Azure та ім’я контейнера.
  2. Після завершення збірки завантажте файл APK або IPA з місця зберігання BLOB-оба Azure.

Знімок екрана, який показує п’ятий крок щодо керування виводом за допомогою сховища BLOB-об’єктів Azure.

7. Підбиваємо підсумки і будуємо

  1. На екрані "Підсумок " перегляньте відомості про програму та виберіть Збірка.
  2. Після успішної збірки ваш пакет програм буде доступний у вказаному вами сховищі BLOB-об’єктів Azure.

Переглянути свою збірку

Ви можете переглянути свою збірку кількома способами:

  • Після збірки виберіть Переглянути збірки
  • Перейдіть до Обтікання проектів на бічній панелі, наведіть курсор на потрібний проект і виберіть його
  • Виберіть опцію Переглянути збірки у верхньому заголовку

Скріншот, на якому показано, як переглядати збірки.

Нотатка

Щоб вручну підписати програму iOS , розархівуйте IPA-файл за допомогою пристрою Mac.

Тестуйте та розповсюджуйте свій додаток

Протестуйте свій додаток і розповсюджуйте його за потреби. Якщо у вас виникнуть проблеми, перегляньте сторінку їх усунення.

Зареєструйте програму на порталі Azure вручну (необов’язково)

Реєстрацію в програмі можна створити автоматично в майстрі або вручну в Azure. Додаткові відомості: Швидкий старт: Зареєструйте програму на платформі ідентифікації Microsoft.

Нотатка

Окремі клієнти та клієнти з підтримкою багатоклієнтської структури можуть використовувати упакування для створення програм для мобільних пристроїв у своїх компонованих програмах Power Apps.

При реєстрації виберіть тип облікового запису, що містить Будь-який Microsoft Entra каталог - Мультитенант:

  • Облікові записи в будь-якому організаційному каталозі (Any Microsoft Entra directory - Multitenant)
  • Облікові записи в будь-якому каталозі організації (Any Microsoft Entra directory - Multitenant) і особисті облікові записи Microsoft, наприклад Skype або Xbox

Реєстрація додатків - підтримуються типи облікових записів для wrap.

Важливо

  • Наразі Wrap підтримує лише типи облікових записів із кількома користувачами . Тип облікового запису єдиного клієнта поки що не підтримується. Додаткові відомості: Типи облікових записів на платформі ідентифікації Microsoft.
  • Ви повинні створити окремий URI перенаправлення для кожної платформи (iOS, Android).

Підпишіть пакет мобільного додатка вручну (необов’язково)

Ви можете підписати програму автоматично на кроці 2 або вручну після створення. Підпис коду різний для Android і iOS.

Переваги автоматичного підпису для iOS та( Android APK):

  • Вам не потрібно повторювати процес підписання під час повторного обгортання.
  • Вам не потрібно чекати, поки розробники додатків закінчать процес.
  • Вам не потрібно встановлювати Android Studio або запам’ятовувати паролі.
  • Для iOS підписання не потрібен пристрій Mac.
Платформа Спосіб підписання
iOS Ручний підпис коду для iOS
Android Ручний підпис коду для Android
Магазин Google Play Підписування коду для Google Play Маркет

Див. також