Power Apps의 래핑 기능 문제 해결

이 문서는 Microsoft Power Apps의 래핑 기능과 관련된 가장 일반적인 문제를 resolve 데 도움이 됩니다.

문제 1 - 빌드 래핑 실패

래핑 빌드가 실패하는 경우 다음 단계를 수행하여 문제를 해결할 수 있습니다.

1단계: 이미지가 PNG 형식인지 확인

래핑에서 사용하는 이미지가 PNG 형식인지 확인합니다. 래핑에서 PNG 이외의 형식으로 이미지를 사용하면 빌드가 실패합니다. 이미지 변환기를 사용하여 이미지를 .png 파일로 저장하거나 원본 이미지 파일이 PNG 형식인지 확인합니다.

2단계: App Center가 올바르게 구성되었는지 확인

App Center 링크는 독립 실행형 앱이 아닌 organization 내에서 앱으로 만들어야 합니다. 다음 스크린샷은 래핑 마법사에서 새 organization 만드는 방법을 보여줍니다.

래핑 마법사에서 새 위치를 자동으로 만드는 방법에 대한 자세한 내용은 5단계: "마법사를 사용하여 iOS 및 Android용 네이티브 모바일 앱 Create" 섹션에서 출력 관리를 참조하세요.

3단계: 키 자격 증명 모음 구성이 올바른지 확인

Azure 서비스 주체가 생성되고 서비스 주체 역할이 올바르게 추가되었는지 확인합니다. 자세한 내용은 마법사를 사용하여 iOS 및 Android용 네이티브 모바일 앱 Create 1단계와 2단계를 참조하세요.

키 자격 증명 모음에 iOS, Android 또는 둘 다에 필요한 모든 인증서, 비밀 및 태그가 포함되어 있는지 확인합니다.

• iOS: 태그 2개, 인증서 1개, 비밀 1개
• Android: 태그 1개와 인증서 1개

자세한 내용은 Power Apps에서 래핑을 위한 Azure 키 자격 증명 모음 Create 참조하세요.

4단계: 모든 적절한 구성이 있는 경우 다시 시도

래핑 프로젝트에 적절한 구성이 모두 있는지 확인한 후에도 래핑 빌드가 여전히 실패하는 경우 이 문서의 랩에 있는 기타 문제 섹션을 참조하세요.

문제 2 - 내 앱에 대해 래핑 단추가 비활성화됨

편집 권한이 있는 앱만 래핑할 수 있습니다. 래핑하려는 앱에 대한 편집 권한이 있는지 확인하고 다시 시도합니다.

문제 3 - 내 프로젝트를 저장하거나 래핑 빌드를 트리거할 수 없음

이 문제를 resolve 위해 다음을 수행할 수 있습니다.

• 최신 랩 솔루션 버전으로 업데이트하고 다시 시도합니다.
• 저장 또는 빌드 제출을 차단하는 UI 유효성 검사 오류가 없는지 확인합니다.

문제 4 - 디바이스에 래핑된 모바일 앱을 설치할 수 없습니다.

출력된 애플리케이션에 서명했는지 확인합니다. 키 자격 증명 모음을 구성하고 빌드 트리거 시간에 제공하거나 수동으로 서명하여 서명할 수 있습니다. 코드 서명에 대한 자세한 내용은 다음을 참조하세요.

• 자동화된 서명을 위한 키 자격 증명 모음 설정
• iOS용 코드 기호
• Android용 코드 기호

모바일 디바이스가 이러한 최소 요구 사항을 충족하는지 확인합니다.

문제 5 - 래핑된 모바일 앱에 로그인할 수 없거나 데이터를 볼 수 없습니다.

래핑된 모바일 앱에 로그인할 수 없는 경우 다음을 확인합니다.

• Microsoft Entra 앱이 제대로 구성되었습니다.

• 앱에 대한 모든 API 권한이 올바르게 추가되었습니다. 앱에 대한 API 권한을 보고 구성하는 방법에 대한 자세한 내용은 다음 스크린샷 및 API 권한 구성을 참조하세요.

  

• 스크립트가 Add-AdminAllowedThirdPartyApps 성공적으로 실행되었습니다. 자세한 내용은 사용자 환경에서 등록된 앱 허용을 참조하세요.

• Microsoft Entra 앱 유형이 다중 테넌트입니다. Microsoft Entra 앱의 인증 탭에서 지원되는 계정 유형은 모든 조직 디렉터리의 계정이어야 합니다(모든 Microsoft Entra 디렉터리 - 다중 테넌트).

• iOS 및 Android용으로 적절한 리디렉션 URI가 만들어졌습니다. Android의 경우 해시가 올바르게 제공되었는지 확인합니다. 리디렉션 URI 구성에 대한 자세한 내용은 플랫폼 설정 구성을 참조하세요.

문제 6 - Power Apps에 대한 래핑의 Azure Key Vault 오류

다음 Azure Key Vault 오류는 Power Apps에 대한 래핑에 표시될 수 있으며 수정할 수 있습니다.

오류 코드 1000118

1. Azure Key Vault가 테넌트의 기본 구독에 있는지 확인합니다.

2. 관리자 권한으로 PowerShell에서 다음 명령을 실행합니다.

   Connect-AzureAD -TenantId <your tenant ID>
   

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

3. Azure Portal 기본 구독으로 이동합니다. Access Control(IAM) 페이지에서 앱을 나타내는 서비스 주체(예: KeyVault 액세스 앱 래핑)에 읽기 권한자 역할 할당을 추가합니다. 구독의 IAM 및 Keyvault의 IAM에 있는지 확인합니다. 그 단계는 다음과 같습니다.

   1. 액세스 제어(IAM) 탭으로 이동하고 추가 메뉴 단추에서 역할 할당 추가 옵션을 선택합니다.

      

   2. 작업 함수 역할 탭을 선택하고 읽기 권한자 역할이 선택되어 있는지 확인합니다. 그런 다음, 위쪽 메뉴에서 멤버 탭을 선택합니다.

      

   3. 멤버 탭에서 KeyVault 액세스 앱 래핑에 대한 Search.

      

   4. KeyVault 액세스 앱 래핑을 선택한 다음 탭 아래쪽에 있는 검토 + 할당 단추를 선택하여 읽기 권한자 역할을 할당합니다.

      

오류 코드 1000119

1. Azure Key Vault가 테넌트의 기본 구독에 있는지 확인합니다.

2. 키 자격 증명 모음을 만들 때 자격 증명 모음 액세스 정책 옵션이 선택되어 있는지 확인합니다.

   

3. 관리자 권한으로 PowerShell에서 다음 명령을 실행합니다.

    Connect-AzureAD -TenantId <your tenant ID>
   

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

4. Azure Portal 기본 구독으로 이동합니다. Access Control(IAM) 페이지에서 앱을 나타내는 서비스 주체(예: KeyVault 액세스 앱 래핑)에 읽기 권한자 역할 할당을 추가합니다. 구독의 IAM 및 Keyvault의 IAM에 있는지 확인합니다. 그 단계는 다음과 같습니다.

   1. 액세스 제어(IAM) 탭으로 이동하고 추가 메뉴 단추에서 역할 할당 추가 옵션을 선택합니다.

      

   2. 작업 함수 역할 탭을 선택하고 읽기 권한자 역할이 선택되어 있는지 확인합니다. 그런 다음, 위쪽 메뉴에서 멤버 탭을 선택합니다.

      

   3. 멤버 탭에서 KeyVault 액세스 앱 래핑에 대한 Search.

      

   4. KeyVault 액세스 앱 래핑을 선택한 다음 탭 아래쪽에 있는 검토 + 할당 단추를 선택하여 읽기 권한자 역할을 할당합니다.

      

5. Azure Key Vault에 액세스 정책을 추가합니다.

   

   

오류 코드 1000120

1. Power Platform 관리 센터로 이동하여 환경을 선택한 다음 래핑 프로젝트가 있는 환경을 선택합니다.

   

2. 조직 ID를 복사합니다.

   

3. Azure Portal 키 자격 증명 모음에서 태그로 이동하여 organization id라는 새 태그를 만들고 이 태그에 organization ID를 추가합니다.

   

오류 코드 1000121

1. Android 인증서를 가져옵니다.

   

   

2. 인증서에 대한 새 태그를 추가합니다.

   • 태그 이름은 래핑 프로젝트에서 사용한 번들 ID를 기반으로 해야 합니다. 예를 들어 래핑된 앱의 번들 ID 가 com.testApp.wrap인 경우 새 태그 이름은com.testApp.wrap.keystore여야 합니다.

   • 태그 값은 이전 단계에서 인증서 파일을 업로드할 때 인증서에 대해 선택한 이름과 일치해야 합니다. 예를 들어 인증서 이름이 AndroidWrapCertificate이면 Tag 값 의 값도 AndroidWrapCertificate여야 합니다.

   

오류 코드 1000122

1. iOS 인증서를 가져옵니다.

   

   

2. 인증서에 대한 새 태그를 추가합니다.

   • 태그 이름은 래핑 프로젝트에서 사용한 번들 ID를 기반으로 해야 합니다. 예를 들어 래핑된 앱의 번들 ID 가 com.testApp.wrap인 경우 새 태그 이름은com.testApp.wrap.cert여야 합니다.

   • 태그 값은 이전 단계에서 인증서 파일을 업로드할 때 인증서에 대해 선택한 이름과 일치해야 합니다. 예를 들어 인증서 이름이 iOSCertificate1인 경우 태그 값 도 iOSCertificate1이어야 합니다.

   

오류 코드 1000123

1. 프로비저닝 프로필을비밀로 가져옵니다.

2. 프로비저닝 프로필에 대한 새 태그를 추가합니다.

   • 태그 이름은 래핑 프로젝트에서 사용한 번들 ID를 기반으로 해야 합니다. 예를 들어 래핑된 앱의 번들 ID 가 com.testApp.wrap인 경우 새 태그 이름은com.testApp.wrap.profile이어야 합니다.

   • 태그 값은 이전 단계에서 povisioning 프로필을 업로드할 때 비밀에 대해 선택한 이름과 일치해야 합니다. 예를 들어 비밀 이름이 iOSProvisioningProfileSecret인 경우 Tag 값 도 iOSProvisioningProfileSecret이어야 합니다.

   

Power Apps에 대한 래핑의 기타 문제

다른 모든 문제 또는 이러한 단계를 수행한 후 문제가 지속되는 경우 지원 요청을 통해 문제를 보고하려면 이 문서의 뒷부분에 있는 다음 단계를 참조하세요. 재현 비디오, 스크린샷 또는 둘 다 및 다음과 같은 방법으로 가져올 수 있는 세션 ID를 제공해야 합니다.

• 로그인 화면에서 오른쪽 아래 모서리로 이동하여 기어 아이콘을 선택한 다음 세션 세부 정보를 선택합니다.
• 앱을 연 후 화면을 길게 누른 다음 세션 세부 정보를 선택합니다.

다음 단계

이 문서에 문제가 나열되지 않은 경우 더 많은 지원 리소스를 검색하거나 Microsoft 지원에 문의할 수 있습니다. 자세한 내용은 도움말 + 지원 받기를 참조하세요.