다음을 통해 공유


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

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

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

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

  • iOS(IPA 패키지)
  • Android(APK 패키지)
  • Google Play 스토어 배포(AAB 패키지)의 경우

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

마법사를 사용하여 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 만들기.

  4. 내 앱 서명 토글을 켜기 또는 끄기로 설정합니다.

    대상 플랫폼을 선택하는 두 번째 단계를 보여주는 스크린샷.

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

참고

래핑 마법사는 자동 로그인 프로세스를 제공합니다. 그러나 모바일 프로세스에 익숙한 개발자는 플랫폼마다 다른 메커니즘을 사용하여 Android 또는 iOS 애플리케이션에 수동으로 로그인할 수 있습니다. 수동 프로세스를 통해 로그인하는 경우 Azure 키 자격 증명 모음을 만들 필요가 없습니다.

  1. 다음을 선택합니다.

3단계: 앱 등록

앱 등록 화면에서 Azure에 애플리케이션을 수동으로 등록하여 앱과 Microsoft ID 플랫폼 간에 트러스트 관계를 설정합니다. 추가 정보: Azure Portal에 수동으로 앱 등록.

앱 사용자가 로그인할 수 있도록 앱이 Microsoft Entra에 등록되어야 합니다. 이미 등록한 경우 소유 등록 필드에서 등록을 찾으십시오.

소유한 등록 드롭다운에 등록된 앱 이름이 표시되지 않으면 다음 단계를 따르세요.

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

  • 필수 필드이므로 애플리케이션 이름Android 서명 해시를 제공해야 합니다. 애플리케이션 이름은 고객에게 표시되는 애플리케이션 이름이므로 필수입니다. 래핑 프로젝트를 만들고 빌드하는 동안 플랫폼 중 하나로 Android를 선택한 경우 Android 서명 해시가 필요합니다.

    참고

    Android 해시 키의 형식은 28자리 영숫자 해시 번호(예: –ga0RGNYHvNM5d0SLGQfpQWAPGJ8=)입니다. 서명 해시 키가 이미 있는 경우 새 해시 키를 만들 필요가 없습니다. 새 앱 등록을 만들 때 이전에 생성된 서명 해시 키를 다시 사용할 수 있습니다.

    새 앱 등록 화면을 보여주는 스크린샷

관리자가 허용한 타사 앱 구성

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

앱을 등록할 때 계속하려면 Azure 관리자가 액세스 권한을 제공해야 합니다. 다음 단계에 따라 액세스 권한을 부여하십시오.

  • Windows PowerShell을 열고 관리자 권한으로 실행합니다.
  • 명령 실행- Install-Module -Name Microsoft.PowerApps.Administration.PowerShell -AllowClobber -Force.
  • Set-ExecutionPolicy -ExecutionPolicy RemoteSigned를 사용하여 실행 정책을 설정합니다.
  • Import-Module -Name Microsoft.PowerApps.Administration.PowerShell을 사용하여 모듈을 가져옵니다.
  • Add-AdminAllowedThirdPartyApps를 실행하고 관리자 액세스가 필요한 앱 ID를 제공합니다.
  • Get-AdminAllowedThirdPartyApps를 실행하여 앱 이름이 목록에 나타나는지 확인합니다.

앞의 단계를 완료하면 등록 화면이 다음 스크린샷과 같이 표시됩니다.

완료된 단계에 대해 녹색 눈금이 있는 등록 화면을 보여주는 스크린샷

API 권한

앱을 등록할 때 Azure 관리자는 앱의 API 권한에 대한 액세스 권한도 부여해야 합니다. 액세스 권한 부여에 대한 지침과 API 권한이 필요한 이유는 다음 스크린샷을 참조하세요.

앱에 대한 API 권한을 보여주는 스크린샷.

참고

이 단계에서는 신규 고객의 경우 애플리케이션 이름 필드만 표시되는 경우가 있습니다. Android 서명 해시를 추가하는 필드가 표시되지 않습니다. 이 문제를 해결하려면 다음 단계로 진행하고 대상 플랫폼 단계에서 대상 플랫폼Android로 선택합니다.

4단계: 브랜딩 구성

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

    참고

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

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

5단계: 출력 관리

  1. 아직 만들지 않은 경우 Azure Key Vault를 만듭니다. 추가 정보: 기본 구독을 사용하여 래핑을 위한 Azure Key Vault 만들기
  2. Azure Blob Storage 계정 및 컨테이너 이름을 만듭니다. 추가 정보: Azure Storage 계정 만들기
  3. Azure Blob Storage 계정 이름 및 Azure Blob Storage 계정 생성 단계에서 만든 컨테이너 이름을 추가합니다.
  4. 빌드 단계가 완료된 후 위에서 만든 Azure Blob Storage 위치에서 빌드된 APK/IPA를 다운로드합니다.

Azure Blob Storage를 사용하여 출력을 관리하는 방법에 대한 다섯 번째 단계를 보여 주는 스크린샷입니다.

6단계: 마무리

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

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

응용 프로그램을 테스트하고 배포합니다. 테스트 중 문제가 발생하면, 문제 해결 페이지를 확인하세요.

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

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

참고

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

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

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

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

중요

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

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

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

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

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

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

참고

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

  • 모듈 Microsoft Graph가 사용 가능한지 확인하거나 다음 명령을 사용하여 설치하세요.
    Install-Module -Name Microsoft.Graph
    
  • 누락된 Azure API 연결 권한:
    Connect-MgGraph -TenantId <your tenant ID>
    New-MgServicePrincipal -AppId fe053c5f-3692-4f14-aef2-ee34fc081cae -DisplayName "Azure API Connections"
    
  • PowerApps 서비스 권한 누락:
    Connect-MgGraph -TenantId <your tenant ID>
    New-MgServicePrincipal -AppId 475226c6-020e-4fb2-8a90-7a972cbfc1d4 -DisplayName "PowerApps Service"
    

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

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

App Center에서 직접 모바일 앱에 대한 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 디바이스에 따라 다릅니다.

참조 항목