Устранение неполадок с функцией оболочки в 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.
Скрипт
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 г.
Убедитесь, что хранилище ключей Azure находится в подписке клиента по умолчанию.
Выполните следующие команды в PowerShell от имени администратора:
Connect-AzureAD -TenantId <your tenant ID>New-AzureADServicePrincipal -AppId 4e1f8dc5-5a42-45ce-a096-700fa485ba20 -DisplayName "Wrap KeyVault Access App"В портал Azure перейдите к подписке по умолчанию. На странице контроль доступа (IAM) добавьте назначение роли Читательдля субъекта-службы, представляющего ваше приложение, например Приложение для управления доступом к ключу. Убедитесь, что он находится в IAM подписки и IAM Keyvault. Эти этапы описаны ниже.
Перейдите на вкладку Управление доступом (IAM) и выберите параметр Добавить назначение ролей под кнопкой меню Добавить .
Перейдите на вкладку Роли функции задания и убедитесь, что выбрана роль Читатель . Затем выберите вкладку Участники в верхнем меню.
Поиск для приложения wrap KeyVault Access на вкладке Участники.
Выберите Команду Обертать приложение для доступа к keyVault , а затем нажмите кнопку Проверить и назначить в нижней части вкладки, чтобы назначить ему роль читателя .
Код ошибки 1000119
| Код ошибки | Описание |
|---|---|
| 1000119 | Keyvault не существует, или Keyvault не имеет прав доступа |
Убедитесь, что хранилище ключей Azure находится в подписке клиента по умолчанию.
Убедитесь, что при создании хранилища ключей выбран параметр Политика доступа к хранилищу .
Выполните следующие команды в PowerShell от имени администратора:
Connect-AzureAD -TenantId <your tenant ID>New-AzureADServicePrincipal -AppId 4e1f8dc5-5a42-45ce-a096-700fa485ba20 -DisplayName "Wrap KeyVault Access App"В портал Azure перейдите к подписке по умолчанию. На странице контроль доступа (IAM) добавьте назначение роли Читательдля субъекта-службы, представляющего ваше приложение, например Приложение для управления доступом к ключу. Убедитесь, что он находится в IAM подписки и IAM Keyvault. Эти этапы описаны ниже.
Перейдите на вкладку Управление доступом (IAM) и выберите параметр Добавить назначение ролей под кнопкой меню Добавить .
Перейдите на вкладку Роли функции задания и убедитесь, что выбрана роль Читатель . Затем выберите вкладку Участники в верхнем меню.
Поиск для приложения wrap KeyVault Access на вкладке Участники.
Выберите Команду Обертать приложение для доступа к keyVault , а затем нажмите кнопку Проверить и назначить в нижней части вкладки, чтобы назначить ему роль читателя .
Добавьте политики доступа в хранилище ключей Azure.
Код ошибки 1000120
| Код ошибки | Описание |
|---|---|
| 1000120 | Теги идентификаторов организации не найдены в хранилище ключей |
Перейдите в Центр администрирования Power Platform, выберите Среды , а затем выберите среду, в которой находится проект оболочки.
Скопируйте идентификатор организации.
В хранилище ключей в портал Azure перейдите в раздел Теги, создайте новый тег с именем organization-id и добавьте в этот тег свой идентификатор организации.
Код ошибки 1000121
| Код ошибки | Описание |
|---|---|
| 1000121 | Хранилище ключей Android недопустимо. Отсутствуют тег и (или) сертификат |
Импортируйте сертификат Android.
Добавьте новый тег для сертификата.
Имя тега должно основываться на идентификаторе пакета, который использовался в проекте оболочки. Например, если идентификатор пакета для упаковаемого приложения — com.testApp.wrap, то новое имя тега должно быть com.testApp.wrap.keystore.
Значение тега должно соответствовать имени, выбранному для сертификата при отправке файла сертификата на предыдущем шаге. Например, если сертификат называется AndroidWrapCertificate, значением тега также должно быть AndroidWrapCertificate.
Код ошибки 1000122
| Код ошибки | Описание |
|---|---|
| 1000122 | Недопустимый сертификат iOS |
Импортируйте сертификат iOS.
Добавьте новый тег для сертификата.
Имя тега должно основываться на идентификаторе пакета, который использовался в проекте оболочки. Например, если идентификатор пакета для упаковаемого приложения — com.testApp.wrap, то новое имя тега должно быть com.testApp.wrap.cert.
Значение тега должно соответствовать имени, выбранному для сертификата при отправке файла сертификата на предыдущем шаге. Например, если сертификат называется iOSCertificate1, то значением тега также должно быть iOSCertificate1.
Код ошибки 1000123
| Код ошибки | Описание |
|---|---|
| 1000123 | Недопустимый профиль iOS |
Импортируйте профиль подготовки в виде секрета.
Добавьте новый тег для профиля подготовки.
Имя тега должно основываться на идентификаторе пакета, который использовался в проекте оболочки. Например, если идентификатор пакета для упаковаемого приложения — com.testApp.wrap, то новое имя тега должно быть com.testApp.wrap.profile.
Значение тега должно соответствовать имени, выбранному для секрета при отправке профиля подготовки на предыдущем шаге. Например, если секрет называется iOSProvisioningProfileSecret, то значением тега также должно быть iOSProvisioningProfileSecret.
Другие проблемы в оболочке для Power Apps
Сведения обо всех других проблемах или проблемах, которые сохраняются после выполнения этих действий, см. в разделе Дальнейшие действия далее в этой статье, чтобы сообщить о проблеме через запрос в службу поддержки. Необходимо предоставить видео для воспроизведения, снимки экрана или и то, и другое, а также идентификатор сеанса, который можно получить следующими способами:
- На экране входа перейдите в правый нижний угол, чтобы выбрать значок шестеренки, а затем выберите Сведения о сеансе.
- После открытия приложения коснитесь экрана и удерживайте его, а затем выберите Сведения о сеансе.
Дальнейшие действия
Если ваша проблема не указана в этой статье, вы можете найти дополнительные ресурсы поддержки или обратиться в службу поддержки Майкрософт. Дополнительные сведения см. в разделе Получение справки и поддержки.