Android 앱을 사용자에게 배포하는 가장 일반적인 방법은 Google Play를 사용하는 것입니다. 앱이 Google Play에 처음 제출되면 Google Play 콘솔을 통해 제출해야 합니다. 앱의 후속 버전은 Visual Studio를 통해 제출할 수 있습니다. 두 경우 모두 Google Play 개발자 계정이 필요합니다. Google Play에 제출된 앱은 Google의 승인이 필요합니다.
.NET 다중 플랫폼 앱 UI(.NET MAUI) Android 앱을 배포하려면 Google Play에 업로드하기 전에 키 저장소의 키로 서명해야 합니다. 키 저장소는 인증서 및 프라이빗 키의 리포지토리 역할을 하는 이진 파일입니다.
Google Play를 사용하려면 앱을 AAB(Android 앱 번들)로 제출해야 합니다. Google Play는 앱 번들을 사용하여 각 디바이스 구성에 최적화된 APK(Android 패키지)를 생성하고 제공하므로 특정 디바이스에 필요한 코드 및 리소스만 다운로드하여 앱을 실행합니다. Android 앱 번들에 대한 자세한 내용은 developer.android.com Android 앱 번들 정보 참조하세요.
Google Play를 통해 .NET MAUI Android 앱을 배포하는 프로세스는 다음과 같습니다.
- Google Play 개발자 계정을 만듭니다. 자세한 내용은 Google Play 개발자 계정만들기를 참조하세요.
- Google Play 콘솔에서 앱을 만듭니다. 자세한 내용은 Google Play 콘솔앱 만들기를 참조하세요.
- Google Play 콘솔에서 앱을 설정합니다. 자세한 내용은 Google Play 콘솔앱 설정을 참조하세요.
- 앱이 올바른 패키지 형식을 사용하는지 확인합니다. 자세한 내용은 올바른 패키지 형식확인하세요.
- Visual Studio에서 앱을 빌드하고 서명한 다음 Google Play 콘솔을 통해 배포합니다. 자세한 내용은 Google Play 콘솔 통해 앱 배포참조하세요.
그런 다음, Visual Studio를 통해 앱의 후속 버전을 게시할 수 있습니다. 자세한 내용은 Visual Studio 통해 앱 배포참조하세요.
Google Play 개발자 계정 만들기
Google Play에 Android 앱을 게시하려면 Google Play 개발자 계정을 만들어야 합니다.
- Google 계정을 사용하여 Google Play 개발자 계정등록합니다.
- 개발자 ID에 대한 정보를 입력합니다.
- 등록 프로세스 중에 Google Play 개발자 배포 계약 검토하고 동의해야 합니다.
- 일회성 $25 등록 요금을 지불합니다.
- 확인 전자 메일의 지침에 따라 ID를 확인합니다.
중요하다
Google Play를 통해 앱을 게시하려면 먼저 ID 확인을 완료해야 합니다. 또한 새 개인 계정 보유자는 실제 Android 디바이스에 액세스할 수 있는지 확인해야 합니다. 자세한 내용은 support.google.com 새 개발자 계정에 대한 디바이스 확인 요구 사항을 참조하세요.
Google Play 개발자 계정이 만들어지면 Google Play에 앱을 게시하는 프로세스를 시작할 수 있습니다.
자세한 내용은 support.google.com에서 Google Play 개발자 계정 등록을 참조하세요.
Google Play 콘솔에서 앱 만들기
Google Play 개발자 계정을 만든 후에는 Google Play 콘솔에서 앱을 만들어야 합니다.
Google Play 개발자 계정로그인합니다.
Google Play 콘솔 모든 앱 탭에서 앱 만들기 단추를 선택합니다.
앱 만들기 페이지에서 앱 세부 정보를 입력하고 앱 만들기 단추를 선택합니다.
Google Play 콘솔에서 앱을 만들고 설정하는 방법에 대한 자세한 내용은 support.google.com의 앱 만들기 및 설정을 참조하세요.
Google Play 콘솔에서 앱 설정
앱을 만든 후에는 앱을 설정해야 합니다. 앱의 대시보드는 가장 중요한 모든 단계를 안내합니다.
앱 설정을 시작하려면 왼쪽 메뉴에서 대시보드 선택합니다. 페이지 맨 위에 있는 앱의 세부 정보 아래에서 앱 설정 및 릴리스와 관련된 다양한 범주 및 작업을 찾을 수 있습니다. Google Play에서 앱을 시작하려면 먼저 필수 작업을 완료해야 합니다. 작업을 완료하면 녹색 눈금 표시와 취소선 텍스트가 표시됩니다. 섹션 맨 위에 있는 진행률 표시줄도 업데이트됩니다. 자세한 내용은 support.google.com 앱 대시보드 앱 설정을 참조하세요.
올바른 패키지 형식 확인
Google Play 배포용 .NET MAUI Android 앱을 게시하려면 앱 패키지 형식이 릴리스 빌드의 기본 패키지 형식인 AAB가 있어야 합니다. 앱의 패키지 형식이 올바르게 설정되었는지 확인하려면 다음을 수행합니다.
Visual Studio의 솔루션 탐색기에서 .NET MAUI 앱 프로젝트를 마우스 오른쪽 단추로 클릭하고 속성선택합니다. 그런 다음, Android > 옵션 탭으로 이동하여 릴리스 필드의 값이 번들설정되었는지 확인합니다.
게시
Google Play 콘솔을 통해 앱 배포
AAB가 Google Play에 처음 제출되면 Google Play 콘솔을 통해 수동으로 업로드해야 합니다. 이렇게 하면 Google Play에서 이후의 모든 번들에 있는 키의 서명을 앱의 첫 번째 버전에 사용되는 원래 키와 일치시킬 수 있습니다. Google Play 콘솔을 통해 앱을 업로드하려면 먼저 Visual Studio에서 빌드하고 로그인해야 합니다.
Visual Studio에서 앱을 빌드하고 서명하려면 다음을 수행합니다.
Visual Studio 도구 모음에서 디버그 대상 드롭다운을 사용하여 Android 에뮬레이터를 선택한 다음 원하는 에뮬레이터를 선택합니다.
Visual Studio 도구 모음에서 솔루션 구성 드롭다운을 사용하여 디버그 구성에서 릴리스 구성으로 변경합니다.
솔루션 탐색기.NET MAUI 앱 프로젝트를 마우스 오른쪽 단추로 클릭하고 게시...선택합니다.
보관 관리자 열리고 Visual Studio에서 앱 번들을 보관하기 시작합니다.
보관 관리자보관이 성공적으로 완료되면 보관이 선택되었는지 확인하고 배포 ... 단추를 선택하여 앱 배포 프로세스를 시작합니다.
배포 - 채널 선택 대화 상자가 나타납니다.
배포 - 채널 선택 대화 상자에서 임시 단추를 선택합니다.
배포 - 서명 ID 대화 상자에서 + 단추를 선택하여 새 서명 ID를 만듭니다.
Android Keystore 만들기 대화 상자가 나타납니다.
메모
또는 가져오기 단추를 선택하여 기존 서명 ID를 사용할 수 있습니다.
Android Keystore 만들기 대화 상자에서 키 저장소알려진 새 서명 ID를 만드는 데 필요한 정보를 입력한 다음 만들기 단추를 선택합니다.
- 별명. 키의 식별 이름을 입력합니다.
- 암호. 키에 대한 보안 암호를 만들고 확인합니다.
- 유효성. 키가 유효한 기간(년)을 설정합니다.
- 전체 이름, 조직 구성 단위, 조직, 도시 또는 지방, 주 또는 지방 및 국가 코드입니다. 이 정보는 앱에 표시되지 않지만 인증서에 포함됩니다.
새 인증서를 포함하는 새 키 저장소는 Android\Keystore{Alias}{Alias}.keystore C:\Users{Username}\AppData\Local\Xamarin\Mono에 저장됩니다.
중요하다
키 저장소 및 암호는 Visual Studio 솔루션에 저장되지 않습니다. 따라서 이 데이터를 백업해야 합니다. 손실된 경우 동일한 서명 ID로 앱에 서명할 수 없습니다.
배포 - 서명 ID 대화 상자에서 새로 만든 서명 ID를 선택하고 다른 이름으로 저장 단추를 선택합니다.
보관 관리자 게시 프로세스를 표시합니다.
다른 이름으로 저장 대화 상자에서 패키지의 위치와 파일 이름이 올바른지 확인하고 저장 단추를 선택합니다.
서명 암호 대화 상자에서 서명 ID 암호를 입력하고 확인 단추를 선택합니다.
보관 관리자에서 게시 프로세스가 완료되면 배포 열기 단추를 선택합니다.
Visual Studio에서 게시된 앱이 포함된 폴더를 엽니다.
그런 다음, 게시된 앱을 Google Play 콘솔을 통해 Google Play에 릴리스할 수 있습니다. 이렇게 하려면 먼저 Google Play 콘솔에서 릴리스를 만들어야 합니다. 릴리스는 앱을 시작하거나 업데이트를 배포하기 위해 준비할 하나 이상의 앱 버전의 조합입니다. 다음 트랙에서 릴리스를 만들 수 있습니다.
- 내부 테스트. 내부 테스트 릴리스는 선택할 수 있는 최대 100명의 테스터에게 제공됩니다.
- 닫힌 테스트입니다. 닫힌 테스트 릴리스는 앱의 시험판 버전을 테스트하고 피드백을 제출할 수 있는 제한된 수의 테스터에서 사용할 수 있습니다.
- 테스트를 엽니다. 오픈 테스트 릴리스는 Google Play의 테스터가 사용할 수 있습니다. 사용자는 스토어 목록에서 테스트에 참가할 수 있습니다.
- 생산. 프로덕션 릴리스는 선택한 국가의 모든 Google Play 사용자가 사용할 수 있습니다.
Google Play 콘솔에서 릴리스를 만드는 방법에 대한 자세한 내용은 support.google.com의 릴리스 준비 및 롤아웃을 참조하세요.
중요하다
앱이 Google Play에 제출되는 경우 일반적으로 검토 프로세스가 진행됩니다. 자세한 내용은 support.google.com의 '앱 검토 준비' 및 '앱 게시'를 참조하세요.
Visual Studio를 통해 앱 배포
Visual Studio에서 배포하기 전에 AAB가 이미 Google Play에 제출되어 검토를 통과해야 합니다. Play 콘솔에서 처음 업로드되지 않은 Visual Studio에서 AAB를 배포하려고 하면 다음 오류가 발생합니다.
Google Play를 사용하려면 이 앱에 대한 첫 번째 패키지(APK/AAB)를 수동으로 업로드해야 합니다. 임시 패키지를 사용할 수 있습니다.
이 오류가 발생하면 Google Play 콘솔을 통해 AAB를 수동으로 업로드합니다. 그런 다음, Visual Studio를 통해 앱의 후속 릴리스를 게시할 수 있습니다. 그러나 각 업로드에 대한 앱의 버전 코드를 변경해야 합니다. 그렇지 않으면 다음 오류가 발생합니다.
버전 코드(1)가 있는 AAB가 이미 업로드되었습니다.
이 오류를 해결하려면 다른 버전 번호로 앱을 다시 빌드한 다음 Visual Studio를 통해 Google Play에 다시 제출합니다.
메모
앱의 프로젝트 파일에서 ApplicationVersion
정수 속성의 값을 늘려 앱의 버전 번호를 업데이트할 수 있습니다.
Visual Studio에서 Google Play로 앱을 업로드하려면 먼저 Google Play 콘솔에서 API 액세스를 설정해야 합니다.
Google API 액세스 사용
Google Play 개발자 게시 API를 사용하면 Visual Studio에서 새 버전의 앱을 Google Play에 업로드할 수 있습니다. Visual Studio에서 API 호출을 시작하려면 먼저 Google Play 개발자 계정에서 API 액세스를 설정해야 합니다. 여기에는 Google Play 개발자 계정을 Google Cloud 프로젝트에 연결하고 OAuth 클라이언트를 사용하여 Google Play 개발자 게시 API에 대한 액세스를 구성하는 작업이 포함됩니다.
Google API 액세스를 사용하도록 설정하려면 다음을 수행합니다.
Google Play 개발자 계정로그인하세요.
Google Play Console 에서 설정 항목을 확장하고 API 액세스를 선택합니다. 그런 다음 API 액세스 페이지에서 연결할 프로젝트 선택 단추를 선택합니다.
Google Play 개발자 API를 사용하려면 Google Play 개발자 계정에 연결해야 하는 Google Cloud 프로젝트가 필요합니다.
메모
Google Play 개발자 계정은 단일 Google Cloud 프로젝트에만 연결할 수 있습니다. 따라서 하나의 Google Play 개발자 계정에서 여러 앱을 게시하는 경우 모두 동일한 Google Cloud 프로젝트를 공유해야 합니다.
API 액세스 페이지에서 새 Google Cloud 프로젝트 만들기 라디오 단추와 저장 단추를 선택합니다.
새 Google Cloud 프로젝트가 만들어지고 Google Play 개발자 계정에 연결됩니다.
API 액세스 페이지의 OAuth 클라이언트 섹션에서 OAuth 동의 구성 화면 선택합니다.
OAuth 동의 화면 페이지에서 필요한 사용자 유형 라디오 단추를 선택한 다음 만들기 단추를 선택합니다.
사용자 유형에 대한 자세한 내용은 support.google.com 사용자 유형 참조하세요.
앱 등록 편집 페이지에서 필수로 표시된 필드를 완료한 다음 저장하고 계속 단추를 선택합니다.
앱 등록을 편집하는 페이지에서 범위 추가 또는 제거 버튼을 선택합니다.
업데이트 선택한 범위 플라이아웃에서, 테이블의
./auth/androidpublisher
범위를 선택한 후, UPDATE 버튼을 선택합니다.메모
테이블의 다른 범위는 표준 범위이므로 선택적으로 선택할 수 있습니다.
앱 등록 편집 페이지에서 자격 증명 탭을 선택합니다.
자격 증명 페이지에서 + CREATE CREDENTIALS 단추를 선택한 다음, OAuth 클라이언트 ID 항목을 선택합니다.
OAuth 클라이언트 ID 만들기 페이지에서 애플리케이션 유형 드롭다운에서 Desktop 앱 선택하고 이름 필드에 Visual Studio 입력한 다음 만들기 단추를 선택합니다.
OAuth 클라이언트를 만든 대화 상자에서 JSON 데이터 다운로드 버튼을 선택하여 클라이언트 ID와 클라이언트 암호를 다운로드합니다. 이 작업은 나중에 필요합니다. 그런 다음 확인 단추를 클릭하여 대화 상자를 해제합니다.
Google Play 개발자 계정에 Google API 액세스를 사용하도록 설정하는 방법에 대한 자세한 내용은 developers.google.com 시작 참조하세요. OAuth 동의 화면 설정에 대한 자세한 내용은 support.google.com OAuth 동의 화면 설정 참조하세요.
Visual Studio를 통해 앱 업로드
Visual Studio에서 앱을 빌드하고 서명하려면 다음을 수행합니다.
Visual Studio 도구 모음에서 디버그 대상 드롭다운을 사용하여 Android 에뮬레이터를 선택한 후 원하는 에뮬레이터를 선택합니다.
Visual Studio 도구 모음에서 솔루션 구성 드롭다운을 사용하여 디버그 구성에서 릴리스 구성으로 변경합니다.
솔루션 탐색기.NET MAUI 앱 프로젝트를 마우스 오른쪽 단추로 클릭하고 게시...선택합니다.
보관 관리자 열리고 Visual Studio에서 앱 번들을 보관하기 시작합니다.
보관 관리자보관이 성공적으로 완료되면 보관이 선택되었는지 확인하고 배포 ... 단추를 선택하여 앱 배포 프로세스를 시작합니다.
배포 - 채널 선택 대화 상자가 나타납니다.
배포 - 채널 선택 대화 상자에서 Google Play 단추를 선택합니다.
배포 - 서명 ID 대화 상자에서 Google Play 콘솔을 통해 배포용 앱을 빌드할 때 만든 서명 ID를 선택한 다음 계속 단추를 선택합니다.
Google Play 개발자 계정 세부 정보 추가
Visual Studio에 Google Play 개발자 계정을 추가하려면 다음을 수행합니다.
배포 - Google Play 계정 대화 상자에서 + 단추를 선택하여 Google Play 개발자 계정 세부 정보를 추가합니다.
Google API Access 등록 대화 상자에서 설명과 OAuth 클라이언트 ID 및 클라이언트 암호를 입력한 다음 등록 단추를 클릭합니다.
메모
계정 설명을 사용하면 둘 이상의 Google Play 개발자 계정을 등록하고 다른 Google Play 개발자 계정에 앱을 업로드할 수 있습니다.
웹 브라우저가 열립니다.
웹 브라우저에서 Google Play 개발자 계정에 로그인합니다. 로그인한 후 Google에서 앱을 확인하지 않았다는 메시지가 표시될 수 있습니다. 이 경우 계속 단추를 선택합니다.
웹 브라우저에서 계속 단추를 선택하여 앱에 권한을 부여합니다.
웹 브라우저는 확인 코드를 받습니다.
중요하다
웹 브라우저를 닫지 마세요.
Visual Studio의 배포 - Google Play 계정 대화 상자에서 계속선택합니다.
앱을 업로드할 트랙 선택
앱을 업로드할 Google Play 트랙을 선택하려면 다음을 수행합니다.
배포 - Google Play 트랙 대화 상자에서 앱을 업로드할 트랙을 선택합니다. Google Play는 앱을 업로드하기 위한 5개의 트랙을 제공합니다.
- 앱을 내부 테스트 및 품질 보증 검사를 위해 신속하게 배포하려면 'Internal'을 사용해야 합니다.
- 알파는 작은 테스터 그룹에 앱의 초기 버전을 업로드하는 데 사용해야 합니다.
- 베타는 더 큰 테스터 그룹에 앱의 초기 버전을 업로드하는 데 사용해야 합니다.
- Google Play 스토어에 전체 배포를 위해 프로덕션 환경을 사용해야 합니다.
- 사용자 지정은 이메일 주소로 테스터 목록을 만들어 특정 사용자와 함께 앱의 시험판 버전을 테스트하는 데 사용해야 합니다.
중요하다
사용자 지정 트랙이 표시되지 않으면 Google Play 콘솔에서 해당 트랙에 대한 릴리스를 만들었는지 확인합니다. 자세한 내용은 support.google.com의 릴리스 준비 및 배포를 참조하세요.
앱을 업로드할 트랙을 선택한 다음 업로드 단추를 선택합니다.
Google Play 테스트에 대한 자세한 내용은 support.google.com에서 열린 테스트, 폐쇄 또는 내부 테스트 설정을 참조하세요.
Visual Studio는 Google Play에 앱을 게시하기 시작합니다. 서명 암호 대화 상자에서 서명 ID에 대해 만든 암호를 입력하고 확인 단추를 선택합니다.
Visual Studio는 앱 번들에 서명하고 Google Play에 업로드합니다.
.NET MAUI