Бөлісу құралы:

Устранение неполадок с функцией оболочки в Power Apps

  • Мақала

Эта статья поможет устранить наиболее распространенные проблемы с функцией переноса в Microsoft Power Apps.

Проблема 1. Сбой сборки оболочки

Если сборка оболочки завершается сбоем, для решения проблемы можно выполнить следующие действия.

Шаг 1. Убедитесь, что изображения имеют формат PNG

Убедитесь, что изображения, используемые в оболочке, имеют формат PNG. Использование изображений в любом формате, отличном от PNG в оболочке, приведет к сбою сборки. Используйте преобразователь изображений, чтобы сохранить изображения в виде.png файлов или убедиться, что исходные файлы изображений имеют формат PNG.

Важно!

Если вручную изменить расширение файла изображения с .jpeg или любого другого формата на .png не будет автоматически переформатировать изображение в формат PNG.

Шаг 2. Проверка правильности настройки Центра приложений

Ссылка на Центр приложений должна быть создана как приложение в организации, а не как автономное приложение. На следующем снимке экрана показано, как создать новую организацию в мастере переноса.

Снимок экрана, на котором показано, как создать новое расположение центра приложений в мастере переноса.

Дополнительные сведения об автоматическом создании нового расположения в мастере оболочки см. в разделе Шаг 5. Управление выходными данными раздела "Create собственных мобильных приложений для iOS и Android с помощью мастера".

Шаг 3. Проверка правильности конфигурации хранилища ключей

Убедитесь, что субъект-служба Azure создан и роль субъекта-службы добавлена правильно. Дополнительные сведения см. в шагах 1 и 2 в статье Create собственных мобильных приложений для iOS и Android с помощью мастера.

Убедитесь, что хранилище ключей содержит все необходимые сертификаты, секреты и теги для iOS, Android или обоих:

  • iOS: два тега, один сертификат и один секрет
  • Android: один тег и один сертификат

Дополнительные сведения см. в статье Create Azure Key Vault для оболочки в Power Apps.

Шаг 4. Повторите попытку, если у вас есть все необходимые конфигурации

Если сборка оболочки по-прежнему завершается сбоем после проверки того, что проект оболочки имеет все необходимые конфигурации, см. раздел Другие проблемы в оболочке этой статьи.

Проблема 2. Кнопка "Оболочка" отключена для моего приложения

Вы можете обертывать приложения только с разрешениями на изменение. Убедитесь, что у вас есть разрешения на изменение приложения, которое вы хотите упаковать, и повторите попытку.

Проблема 3. Не удается сохранить проект или запустить сборку оболочки

Чтобы устранить эту проблему, можно:

  • Обновите до последней версии решения оболочки и повторите попытку.
  • Убедитесь, что никакие ошибки проверки пользовательского интерфейса не блокируют отправку сохранения или сборки .

Проблема 4. Не удается установить упаковаемое мобильное приложение на устройство

Убедитесь, что вы подписали выходное приложение. Его можно подписать, настроив хранилище ключей и предоставив его во время сборки триггера или подписав вручную. Дополнительные сведения о подписи кода см. в разделе:

Убедитесь, что ваше мобильное устройство соответствует этим минимальным требованиям.

Проблема 5. Не удается войти в упаковаемое мобильное приложение или не удается просмотреть данные

Если не удается войти в упаковаемое мобильное приложение, убедитесь, что:

  • Приложение Microsoft Entra настроено правильно.

  • Все разрешения API для приложения добавлены правильно. Дополнительные сведения о просмотре и настройке разрешений API для приложения см. на следующем снимке экрана и в разделе Настройка разрешений API.

    Снимок экрана: разрешения API для приложения.

  • Скрипт Add-AdminAllowedThirdPartyApps успешно запущен. Дополнительные сведения см . в разделе Разрешение зарегистрированных приложений в вашей среде.

  • Тип приложения Microsoft Entra — Multitenant. На вкладке Проверка подлинности приложения Microsoft Entra поддерживаемый тип учетной записи должен иметь значение Accounts in any организационный каталог (Any Microsoft Entra directory — Multitenant).

  • Для iOS и Android созданы правильные URI перенаправления. Для Android убедитесь, что хэш указан правильно. Дополнительные сведения о настройке URI перенаправления см. в разделе Настройка параметров платформы.

Проблема 6. Ошибки в хранилище ключей Azure в оболочке для Power Apps

Следующие ошибки хранилища ключей Azure могут отображаться в оболочке для Power Apps и могут быть исправлены.

Код ошибки 1000118

Код ошибки Описание
1000118 Подписка по умолчанию не найдена или отсутствуют разрешения доступа

Примечание.

модули PowerShell Azure AD и MSOnline устарели с 30 марта 2024 г. Дополнительные сведения см. в статье Обновление для прекращения поддержки. После этой даты поддержка этих модулей ограничивается поддержкой миграции пакета SDK Для Microsoft Graph PowerShell и исправлениями безопасности. Устаревшие модули будут работать до 30 марта 2025 г.

Мы рекомендуем выполнить миграцию в Microsoft Graph PowerShell для взаимодействия с Microsoft Entra ID (ранее Azure AD). Распространенные вопросы о миграции см. в разделе Вопросы и ответы о миграции. Примечание: В версиях 1.0.x MSOnline может возникнуть сбой после 30 июня 2024 г.

  1. Убедитесь, что хранилище ключей Azure находится в подписке клиента по умолчанию.

  2. Выполните следующие команды в PowerShell от имени администратора:

    Connect-AzureAD -TenantId <your tenant ID>

    New-AzureADServicePrincipal -AppId 4e1f8dc5-5a42-45ce-a096-700fa485ba20 -DisplayName "Wrap KeyVault Access App"

  3. В портал Azure перейдите к подписке по умолчанию. На странице контроль доступа (IAM) добавьте назначение роли Читательдля субъекта-службы, представляющего ваше приложение, например Приложение для управления доступом к ключу. Убедитесь, что он находится в IAM подписки и IAM Keyvault. Эти этапы описаны ниже.

    1. Перейдите на вкладку Управление доступом (IAM) и выберите параметр Добавить назначение ролей под кнопкой меню Добавить .

      Снимок экрана: параметр Добавить назначение ролей на вкладке Управление доступом (IAM).

    2. Перейдите на вкладку Роли функции задания и убедитесь, что выбрана роль Читатель . Затем выберите вкладку Участники в верхнем меню.

      Снимок экрана: вкладка

    3. Поиск для приложения wrap KeyVault Access на вкладке Участники.

      Снимок экрана: поиск по запросу Wrap KeyVault Access App.

    4. Выберите Команду Обертать приложение для доступа к keyVault , а затем нажмите кнопку Проверить и назначить в нижней части вкладки, чтобы назначить ему роль читателя .

      Снимок экрана, на котором показано, как назначить роль читателя для приложения wrap KeyVault Access.

Код ошибки 1000119

Код ошибки Описание
1000119 Keyvault не существует, или Keyvault не имеет прав доступа

  1. Убедитесь, что хранилище ключей Azure находится в подписке клиента по умолчанию.

  2. Убедитесь, что при создании хранилища ключей выбран параметр Политика доступа к хранилищу .

    Выберите параметр Политика доступа к хранилищу на вкладке Конфигурация доступа.

  3. Выполните следующие команды в PowerShell от имени администратора:

     Connect-AzureAD -TenantId <your tenant ID>

    New-AzureADServicePrincipal -AppId 4e1f8dc5-5a42-45ce-a096-700fa485ba20 -DisplayName "Wrap KeyVault Access App"

  4. В портал Azure перейдите к подписке по умолчанию. На странице контроль доступа (IAM) добавьте назначение роли Читательдля субъекта-службы, представляющего ваше приложение, например Приложение для управления доступом к ключу. Убедитесь, что он находится в IAM подписки и IAM Keyvault. Эти этапы описаны ниже.

    1. Перейдите на вкладку Управление доступом (IAM) и выберите параметр Добавить назначение ролей под кнопкой меню Добавить .

      Снимок экрана: параметр Добавить назначение ролей на вкладке Управление доступом (IAM).

    2. Перейдите на вкладку Роли функции задания и убедитесь, что выбрана роль Читатель . Затем выберите вкладку Участники в верхнем меню.

      Снимок экрана: вкладка

    3. Поиск для приложения wrap KeyVault Access на вкладке Участники.

      Снимок экрана: поиск по запросу Wrap KeyVault Access App.

    4. Выберите Команду Обертать приложение для доступа к keyVault , а затем нажмите кнопку Проверить и назначить в нижней части вкладки, чтобы назначить ему роль читателя .

      Снимок экрана, на котором показано, как назначить роль читателя для приложения wrap KeyVault Access.

  5. Добавьте политики доступа в хранилище ключей Azure.

    Снимок экрана: добавление политик доступа для хранилища ключей Azure.

    Снимок экрана: проверка и создание политики доступа к хранилищу.

Код ошибки 1000120

Код ошибки Описание
1000120 Теги идентификаторов организации не найдены в хранилище ключей

  1. Перейдите в Центр администрирования Power Platform, выберите Среды , а затем выберите среду, в которой находится проект оболочки.

    Снимок экрана: вкладка

  2. Скопируйте идентификатор организации.

    Снимок экрана: идентификатор организации, который можно найти в своей среде в Центре администрирования Power Platform.

  3. В хранилище ключей в портал Azure перейдите в раздел Теги, создайте новый тег с именем organization-id и добавьте в этот тег свой идентификатор организации.

    Снимок экрана: добавление идентификатора организации в тег в портал Azure.

Код ошибки 1000121

Код ошибки Описание
1000121 Хранилище ключей Android недопустимо. Отсутствуют тег и (или) сертификат

  1. Импортируйте сертификат Android.

    Снимок экрана: импорт сертификата Android.

    Снимок экрана: создание сертификата Android.

  2. Добавьте новый тег для сертификата.

    • Имя тега должно основываться на идентификаторе пакета, который использовался в проекте оболочки. Например, если идентификатор пакета для упаковаемого приложения — com.testApp.wrap, то новое имя тега должно быть com.testApp.wrap.keystore.

    • Значение тега должно соответствовать имени, выбранному для сертификата при отправке файла сертификата на предыдущем шаге. Например, если сертификат называется AndroidWrapCertificate, значением тега также должно быть AndroidWrapCertificate.

    Снимок экрана: создание тега сертификата.

Код ошибки 1000122

Код ошибки Описание
1000122 Недопустимый сертификат iOS

  1. Импортируйте сертификат iOS.

    Снимок экрана: импорт сертификата iOS.

    Снимок экрана: создание сертификата iOS.

  2. Добавьте новый тег для сертификата.

    • Имя тега должно основываться на идентификаторе пакета, который использовался в проекте оболочки. Например, если идентификатор пакета для упаковаемого приложения — com.testApp.wrap, то новое имя тега должно быть com.testApp.wrap.cert.

    • Значение тега должно соответствовать имени, выбранному для сертификата при отправке файла сертификата на предыдущем шаге. Например, если сертификат называется iOSCertificate1, то значением тега также должно быть iOSCertificate1.

    Снимок экрана: создание тега сертификата для iOS.

Код ошибки 1000123

Код ошибки Описание
1000123 Недопустимый профиль iOS

  1. Импортируйте профиль подготовки в виде секрета.

  2. Добавьте новый тег для профиля подготовки.

    • Имя тега должно основываться на идентификаторе пакета, который использовался в проекте оболочки. Например, если идентификатор пакета для упаковаемого приложения — com.testApp.wrap, то новое имя тега должно быть com.testApp.wrap.profile.

    • Значение тега должно соответствовать имени, выбранному для секрета при отправке профиля подготовки на предыдущем шаге. Например, если секрет называется iOSProvisioningProfileSecret, то значением тега также должно быть iOSProvisioningProfileSecret.

    Снимок экрана: создание тега для секрета профиля подготовки iOS.

Другие проблемы в оболочке для Power Apps

Сведения обо всех других проблемах или проблемах, которые сохраняются после выполнения этих действий, см. в разделе Дальнейшие действия далее в этой статье, чтобы сообщить о проблеме через запрос в службу поддержки. Необходимо предоставить видео для воспроизведения, снимки экрана или и то, и другое, а также идентификатор сеанса, который можно получить следующими способами:

  • На экране входа перейдите в правый нижний угол, чтобы выбрать значок шестеренки, а затем выберите Сведения о сеансе.
  • После открытия приложения коснитесь экрана и удерживайте его, а затем выберите Сведения о сеансе.

Дальнейшие действия

Если ваша проблема не указана в этой статье, вы можете найти дополнительные ресурсы поддержки или обратиться в службу поддержки Майкрософт. Дополнительные сведения см. в разделе Получение справки и поддержки.