래핑 마법사를 사용하여 모바일 앱 빌드

  • 아티클

단계별 마법사를 통해 하나 이상의 캔버스 앱을 단일 기본 모바일 앱 패키지로 패키징하려면 래핑 기능을 사용하세요.

Power Apps의 래핑 기능을 사용하면 캔버스 앱의 기본 모바일 버전을 맞춤형 브랜드 Android 및 iOS 모바일 앱으로 만들 수 있습니다. 이러한 래핑된 기본 모바일 앱을 Microsoft Intune, Microsoft App Center, Google Play, Apple Business Manager 또는 기타 기본 배포 방법을 통해 최종 사용자에게 배포할 수 있습니다.

래핑 기능을 사용하면 iOS, Android 또는 Google Play 스토어용 모바일 앱을 만들 수 있습니다.

  • iOS(IPA 패키지)
  • Android(APK 패키지)
  • Google Play 스토어(AAB 패키지)

래핑 기능은 디지털 서명 및 배포가 가능한 기본 모바일 앱 셸에서 캔버스 앱을 래핑합니다. 앱을 업데이트하고 다시 게시하면 앱이 자동으로 업데이트됩니다.

전제 조건

다음에 대한 액세스 권한이 필요합니다.

Android 플랫폼용 모바일 앱 패키지를 만들고 수동으로 코드 서명할 계획이라면 시작 전에 키를 생성한 다음 서명 해시를 생성 해야 합니다.  리디렉션 URI를 구성하려면 생성된 서명 해시가 필요합니다.

솔루션에 캔버스 앱 추가

Power Apps용 래핑에는 앱이 솔루션의 일부가 되어야 합니다. 캔버스 앱이 이미 솔루션의 일부가 아닌 경우 기존 솔루션이나 새 솔루션에 추가합니다. 왼쪽 탐색 창에서 솔루션을 선택합니다. 항목이 측면 패널 창을 경우 ...자세히를 선택한 다음 원하는 항목을 선택하세요. 솔루션을 선택한 다음 편집을 선택합니다.

솔루션을 선택합니다.

상단 메뉴에서 + 기존 추가 옵션을 선택하고 드롭다운 목록에서 앱 > 캔버스 앱을 선택합니다.

메뉴에서 기존 항목 추가를 선택합니다.

Dataverse 외부 탭을 선택하고 목록에서 앱을 선택합니다. 이 앱을 솔루션에 추가하려면 추가 버튼을 누릅니다.

솔루션에 앱 추가를 선택합니다.

추가 정보: 솔루션에 앱 추가

마법사를 사용하여 iOS 및 Android용 기본 모바일 앱 생성

  1. Power Apps에 로그인합니다.

  2. 왼쪽 탐색 창에서 래핑을 선택합니다. 항목이 측면 패널 창을 경우 ...자세히를 선택한 다음 원하는 항목을 선택하세요.

  3. 래핑할 앱을 선택한 다음 명령 모음에서 래핑을 선택합니다.

1단계: 앱 선택

  1. 래핑할 앱 선택 화면에서 기본 및 보조 앱을 선택합니다.

    • 기본 앱: 모바일 앱이 실행될 때 최종 사용자에게 표시되는 앱을 선택합니다.

    • 보조 앱: 기본 앱과 함께 동일한 모바일 앱 패키지용 빌드를 번들로 묶을 수 있는 선택적 기타 앱입니다.

      래핑할 앱을 선택합니다.

      참고

      여러 래핑 프로젝트에서 동일한 기본 앱을 사용할 수 있습니다.

  2. 다음을 선택합니다.

2단계: 대상 플랫폼

  1. 타겟팅할 모바일 플랫폼 선택 화면에서 선택한 번들 ID를 입력합니다.

    참고

    번들 ID는 앱에 대해 생성하는 고유 식별자입니다. 번들 ID에는 공백 없이 하나의 마침표(.)만 포함되어야 합니다.

  2. 대상 플랫폼에서 최종 사용자가 모바일 디바이스에서 사용하는 모든 모바일 플랫폼을 선택합니다.

  3. 내 앱 서명 토글을 켜짐으로 설정하여 모바일 앱을 자동으로 코드 서명한 다음 목록에서 Azure Key Vault URI를 선택하고 다음을 클릭합니다. Azure Key Vault URI 목록에 항목이 없으면 먼저 Azure Key Vault를 만들어야 합니다. 추가 정보: Power Apps용 래핑을 위한 Azure Key Vault 만들기.

    래핑할 앱을 선택합니다.

래핑 마법사에서 사용할 수 있는 자동 코드 서명을 사용하는 대신 모바일 앱 패키지를 수동으로 코드 서명할 수도 있습니다. 앱을 수동으로 코드 서명하는 방법에 대한 자세한 내용은 다음을 참조하세요.

  1. 다음을 선택합니다.

3단계: 브랜딩 구성

  1. 브랜딩 구성 단계에서 앱에 대해 다음 모양과 느낌 옵션을 설정합니다.

    참고

    모든 이미지는 .png 형식이어야 합니다. 사용자 지정 이미지를 선택하지 않으면 기본 이미지가 사용됩니다.

    • 앱 아이콘: 앱에 사용할 아이콘을 업로드합니다. iOS의 권장 크기: 1024px x 1024px .png 이미지 이상. Android의 이미지 권장 크기: 432px x 432px .png 이미지 이상.
    • 시작 화면 이미지: 모바일 앱이 로드되는 동안 시작 화면에 사용될 이미지입니다. 제공되지 않을 때 사용되는 기본 이미지.
    • 환영 화면 이미지: 모바일 앱이 로드되는 동안 환영(로그인) 화면에 사용될 이미지입니다. 제공되지 않을 때 사용되는 기본 이미지.
    • 배경 채우기 색상: 시작 화면의 배경에 사용되는 16진수 색상 코드입니다.
    • 버튼 채우기 색상: 버튼 색상을 채우는 데 사용되는 16진수 색상 코드입니다.
    • 상태 표시줄 텍스트 테마: 앱 상단의 상태 표시줄 텍스트 색상입니다.

  2. 다음을 선택합니다.

4단계: 앱 등록

앱 등록 화면에서 Azure에 애플리케이션을 등록하여 앱과 Microsoft ID 플랫폼 간의 신뢰 관계를 설정합니다. 앱 사용자가 로그인할 수 있도록 앱이 Microsoft Entra에 등록되어야 합니다.

새 앱 등록

앱에 대한 새 등록을 자동으로 생성하려면 새 앱 등록을 선택합니다.

새 앱 등록 만들기.

수동으로 새 앱 등록을 생성할 수도 있습니다. 추가 정보: Azure Portal에 수동으로 앱 등록.

래핑 마법사는 앱에 필요한 모든 API 권한을 자동으로 구성합니다. 이 단계를 해결해야 하는 경우 API 권한을 수동으로 구성할 수도 있습니다. 추가 정보: 앱에 대한 API 권한을 수동으로 구성.

5단계: 출력 관리

빌드가 완료되면 출력 관리 화면에서 기존 앱 센터 위치를 만들거나 선택하여 모바일 앱을 보낼 수 있습니다. 래핑 마법사에서 새 위치를 자동으로 생성하려면 화면 상단에서 새 위치를 선택한 다음 Android 또는 iOS를 선택합니다.

새 App Center 위치

  • Android: 기존 위치를 선택하거나 새 위치를 만듭니다.

  • iOS: 기존 위치를 선택하거나 새 위치를 만듭니다.

App Center에서 수동으로 앱 센터 위치를 생성하도록 선택할 수도 있습니다. 추가 정보: 모바일 앱의 앱 센터 위치를 수동으로 만들기.

6단계: 마무리

마무리 화면에서 앱 세부 정보를 검토한 다음 빌드를 선택합니다. 빌드가 성공적으로 완료되면 이전 단계에서 선택한 App Center 위치에 모바일 앱이 표시됩니다.

모바일 앱 패키지 테스트 및 배포

테스트와 배포에 관해서는 App Center 테스트 및 배포를 참조하세요.

Azure Portal에 수동으로 앱 등록(선택 사항)

4단계에서 설명한 대로 래핑 마법사에서 앱 등록을 자동으로 생성할 수 있습니다. 또는 Azure Portal에서 앱에 대한 새 등록을 수동으로 만들 수 있습니다. 추가 정보: 빠른 시작: Microsoft ID 플랫폼에 애플리케이션 등록.

참고

단일 테넌트 및 다중 테넌트 고객 모두 래핑을 사용하여 Power Apps 캔버스 앱을 기반으로 기본 모바일 앱을 만들 수 있습니다.

단일 또는 다중 테넌트 제조업체인지 여부에 관계없이 앱에 대해 지원되는 계정 유형을 선택할 때 임의의 Microsoft Entra 디렉터리 - 다중 테넌트를 포함하는 옵션 중 하나를 선택하여 래핑을 활성화해야 합니다. 다음 계정 유형 중 하나를 선택하세요.

  • 모든 조직 디렉터리의 계정(모든 Microsoft Entra 디렉터리 - 다중 테넌트)
  • 모든 조직 디렉터리(모든 Microsoft Entra 디렉터리 - 다중 테넌트)의 계정 및 Skype 또는 Xbox와 같은 개인 Microsoft 계정.

앱 등록 - 래핑을 지원하는 계정 유형입니다.

중요

  • 래핑은 현재 다중 테넌트 계정 유형을 지원합니다. 단일 테넌트 계정 유형은 아직 지원되지 않습니다. 계정 유형에 대한 추가 정보: Microsoft ID 플랫폼의 계정 유형
  • 대상으로 지정하려는 각 플랫폼(iOS, Android)에 대해 별도의 리디렉션 URI를 만들어야 합니다.

앱에 대한 API 권한을 수동으로 구성(선택 사항)

4단계를 완료하면 래핑 마법사가 앱에 필요한 모든 API 권한을 자동으로 구성합니다.

래핑 마법사에서 오류가 발생하면 API 권한을 수동으로 구성할 수 있습니다. 추가 정보: 추가 및 구성

API 권한을 수동으로 구성할 때 다음 API 권한이 필요합니다.

  • Microsoft API
    • Dynamics CRM
  • 조직에서 사용하는 API
    • Azure API 연결
    • PowerApps 서비스
    • Power BI(캔버스 앱이 Power BI 데이터를 사용하는 경우에만 필요)
    • Microsoft 모바일 애플리케이션 관리(모바일 앱 배포에 Microsoft Intune을 사용하려는 경우에만 필요)

참고

내 조직에서 사용하는 API에서 권한을 찾을 수 없으면 다음 PowerShell 명령을 적절하게 실행하고 다시 시도하세요.

  • 누락된 Azure API 연결 권한: 
    Connect-AzureAD -TenantId <your tenant ID>
New-AzureADServicePrincipal -AppId fe053c5f-3692-4f14-aef2-ee34fc081cae -DisplayName "Azure API Connections"
  • PowerApps 서비스 권한 누락: 
    Connect-AzureAD -TenantId <your tenant ID>
New-AzureADServicePrincipal -AppId 475226c6-020e-4fb2-8a90-7a972cbfc1d4 -DisplayName "PowerApps Service"

자세한 단계는 앱 등록 포털에서 권한 요청을 참조하세요.

모바일 앱의 앱 센터 위치를 수동으로 만들기(선택 사항)

래핑 마법사의 5단계에서 언급한 대로 모바일 앱을 저장하기 위해 새로운 App Center 위치를 자동으로 생성하는 옵션이 있지만 앱 센터에서 직접 수동으로 생성할 수도 있습니다. 추가 정보: App Center 위치

팁

App Center에 대한 자세한 내용은 Visual Studio App Center 설명서를 참고하세요.

  1. App Center로 이동합니다.

  2. 회사 또는 학교 계정으로 로그인합니다.

  3. 기존 조직이 없는 경우 새로 추가 > 새 조직 추가를 선택하여 새 조직을 만듭니다.

  4. 왼쪽 창의 목록에서 조직을 선택합니다.

  5. 앱 > 앱 추가를 선택합니다.

  6. 앱 이름을 입력합니다.

  7. 앱 릴리스 유형을 선택합니다.

  8. iOS 앱에는 맞춤형 OS를 선택하고 Android 앱에는 Android OS를 선택합니다.

    참고

    플랫폼별로 별도의 App Center 컨테이너를 만들어야 합니다.

  9. Android OS의 경우 플랫폼을 React Native로 선택합니다.

    참고

    App Center에서 모든 앱의 플랫폼은 React Native여야 합니다.

    App Center 앱 구성.

  10. 새 앱 추가를 선택합니다.

  11. 앱의 앱 센터 URL을 복사하세요. 나중에 Power Apps에서 랩 프로젝트를 구성하는 데 필요합니다.

    https://appcenter.ms/orgs/Contoso-sales/apps/Sample-canvas-app-for-Android-OS/를 예로 들 수 있습니다.

    App Center URL.

모바일 앱 패키지에 수동으로 서명(선택 사항)

2단계의 래핑 프로세스 중에 모바일 앱 패키지에 자동으로 서명할 수 있지만 모바일 앱 패키지가 빌드된 후 수동으로 서명할 수도 있습니다. 코드 서명 프로세스는 Android 및 iOS 디바이스에 따라 다릅니다.

참조 항목