Android용 Java 앱 빌드
Important
Visual Studio App Center는 2025년 3월 31일에 사용 중지될 예정입니다. 완전히 사용 중지될 때까지 Visual Studio App Center를 계속 사용할 수 있지만 마이그레이션을 고려할 수 있는 몇 가지 권장 대안이 있습니다.
첫 번째 Android 앱을 빌드하려면 다음 단계를 수행합니다.
- 리포지토리 서비스 계정(GitHub, Bitbucket, VSTS, Azure DevOps)에 연결합니다.
- 앱이 있는 리포지토리 및 분기를 선택합니다.
- 빌드하려는 Android 프로젝트를 선택합니다.
- 첫 번째 빌드를 설정합니다.
참고 항목
실제 디바이스에서 앱을 실행하려면 빌드가 유효한 인증서로 서명된 코드여야 합니다.
참고 항목
App Center는 Android 프로젝트의 gradle(및 gradlew) 디렉터리 파일을 검색하여 프로젝트를 추적합니다. App Center Build에서 찾을 수 없도록 .gitignore 프로젝트에 이러한 파일을 포함하지 마세요.
Warning
최근 JCenter가 종료되었으므로 App Center를 사용하여 빌드할 때 특정 앱에서 Gradle 작업 오류가 발생할 수 있습니다. Gradle에서 제공하는 마이그레이션 가이드를 확인하세요. 해결 방법으로 파일에서 build.gradle 모든 인스턴스를 jcenter() 제거하고 .로 jcenter { url "http://jcenter.bintray.com/"}바꿀 수 있습니다. 여기에서 JCenter 종료에 대해 자세히 알아보세요.
1. 리포지토리 연결
아직 연결하지 않은 경우 리포지토리 서비스 계정에 연결해야 합니다. 계정이 연결되면 Android 프로젝트가 있는 리포지토리를 선택합니다. 리포지토리에 대한 빌드를 설정하려면 관리자 및 끌어오기 권한이 필요합니다.
2. 분기 선택
리포지토리를 선택한 후 빌드할 분기를 선택합니다. 기본적으로 모든 활성 분기가 나열됩니다.
3. 첫 번째 빌드 설정
첫 번째 빌드 전에 Android 프로젝트를 구성해야 합니다.
3.1. 빌드 트리거
기본적으로 개발자가 구성된 분기에 푸시할 때마다 새 빌드가 트리거됩니다. 이를 "연속 통합"이라고 합니다. 새 빌드를 수동으로 트리거하려는 경우 구성 창에서 이 설정을 변경할 수 있습니다.
3.2. 빌드 변형
사용 가능한 빌드 변형은 build.gradle(앱 수준) 파일에 지정된 빌드 유형 및 제품 버전에서 채워집니다. 빌드할 빌드 변형을 선택합니다.
참고 항목
App Center Build는 빌드 유형(디버그, 릴리스 또는 사용자 지정 정의)과 그라데이션으로 선언된 제품 버전 중 하나의 조합으로 빌드 변형을 찾을 수 있습니다. 현재는 Flavor 차원(여러 제품 맛의 조합)을 검색할 수 없습니다.
3.3. Android 앱 번들 빌드(.aab)
Android 앱 번들은 Play 스토어에 업로드되고 특정 디바이스에 최적화된 APK를 생성하는 데 사용되는 배포 형식입니다. Android 앱 번들에 대한 자세한 내용은 공식 Android 설명서에서 확인할 수 있습니다.
Android 앱 번들에 대한 옵션을 설정/해제하여 .aab .apk. build.gradle (앱 수준) 파일에 블록이 android.bundle 포함된 경우 이 옵션은 이미 설정됩니다.
3.4. 증분 버전 번호
사용하도록 설정하면 앱 AndroidManifest.xml 버전 코드가 각 빌드에 대해 자동으로 증가합니다. 변경 내용은 실제 빌드 중에 발생하며 리포지토리에 커밋되지 않습니다.
3.5. 코드 서명
빌드가 성공하면 파일과 추가 .aab 파일이 생성 .apk 됩니다(활성화된 경우). 빌드를 Play 스토어에 릴리스하려면 키 저장소에 저장된 유효한 인증서로 서명해야 합니다. 분기에서 생성된 빌드에 서명하려면 구성 창에서 코드 서명을 사용하도록 설정하고, 키 저장소를 리포지토리에 업로드하고, 구성 창에서 관련 자격 증명을 제공합니다. App Center의 Android 코드 서명 설명서에서 코드 서명에 대해 자세히 읽을 수 있습니다. 와 .aab 동일한 자격 증명 .apk을 사용하여 서명됩니다.
3.6. 실제 디바이스에서 성공적인 빌드 시작
새로 생성된 APK 파일을 사용하여 앱이 실제 디바이스에서 시작되는지 테스트합니다. 이렇게 하면 총 빌드 시간에 약 10분이 더 추가됩니다. 시작 테스트를 구성하는 방법에 대해 자세히 알아보세요.
3.7. build.gradle (앱 수준) 파일에서 구성
빌드에 대한 특정 정보는 종속성, 빌드 도구 버전, 빌드 유형 및 제품 버전을 포함하여 Gradle 파일에서 수집됩니다.
3.8. 빌드 배포
이전에 만든 배포 그룹 또는 저장소 대상으로 배포되도록 분기에서 성공한 각 빌드를 구성할 수 있습니다. 새 메일 그룹을 추가하거나 배포 서비스 내에서 저장소 연결을 구성할 수 있습니다. 앱에 액세스할 수 있는 모든 사용자를 포함하는 "협력자"라는 기본 메일 그룹이 항상 있습니다.
참고 항목
Google Play 스토어에 배포하는 경우 Android 앱 번들(.aab)이 선호되며 사용하도록 설정된 경우 배포됩니다. App Center 배포 그룹 및 Intune 저장소 대상의 경우 일반 .apk 배포 그룹도 생성되더라도 .aab 사용됩니다.
4. 결과 빌드
빌드가 트리거되면 다음과 같은 상태에 있을 수 있습니다.
- queued - 빌드가 리소스가 해제되기를 기다리는 큐에 있습니다.
- building - 앱이 관련 작업을 빌드하고 실행합니다.
- 성공 - 빌드가 성공적으로 완료되었습니다.
- 실패했습니다 . 빌드가 완료되었지만 실패했습니다. 빌드 로그를 다운로드하고 검사하여 문제 해결을 수행할 수 있습니다.
- 취소됨 - 사용자 작업으로 인해 빌드가 취소되었거나 시간이 초과되었습니다.
4.1. 빌드 로그
완료된 빌드(성공 또는 실패)의 경우 로그를 다운로드하여 빌드가 어떻게 진행되었는지 자세히 알아보세요. App Center는 다음 파일이 포함된 보관 파일을 제공합니다.
|-- 1_build.txt (this is the general build log)
|-- build (this folder contains a separate log file for each build step)
|-- <build-step-1>
|-- <build-step-2>
|--
|-- <build-step-n> (e.g. n_Post Job Cleanup.txt)
빌드 단계별 로그(보관 파일의 빌드/디렉터리에 있음)는 문제 해결 및 빌드 실패 이유를 파악하는 데 유용합니다.
4.2. 앱 패키지(APK)
APK는 Android 앱 및 자산을 포함하는 패키지입니다. 빌드가 올바르게 서명된 경우 APK를 실제 디바이스에 설치하고 Play 스토어에 배포할 수 있습니다. 빌드에 서명되지 않은 경우 APK를 에뮬레이터에서 실행하거나 다른 용도로 사용할 수 있습니다.
4.3. 여러 APK 빌드
앱 구성이 여러 APK를 빌드하는 경우 유니버설 APK도 빌드해야 합니다. 빌드 시스템은 하나의 기본 APK 파일에서 작동하며 특정 CPU ABI 또는 화면 밀도와 관련된 모든 APK를 무시합니다. APK 분할 및 유니버설 APK 빌드에 대한 자세한 내용은 ABI 분할 가이드를 참조하세요.
4.4. 난독 처리 매핑 파일(mapping.txt)
이 파일에는 mapping.txt 앱의 난독 제거된 스택 추적을 원래 클래스 및 메서드 이름으로 다시 매핑하는 방법에 대한 정보가 포함되어 있습니다.
- 이전에 앱에서 App Center SDK를 사용하도록 설정된 크래시 보고 모듈과 통합하고 Proguard 또는 R8을 사용하여 앱 이진 파일을 축소 및 난독 처리한 경우, 크래시 보고 서비스는 빌드에 사람이 읽을 수 있는(난독 처리된) 충돌 보고서를 표시하기 위해 이
mapping.txt파일이 필요합니다. - 이전에 앱에서 크래시 보고를 위해 다른 SDK를 통합한 경우(예: HockeyApp SDK) 해당 서비스는 파일이 읽을 수 있는 충돌 보고서를 표시해야 합니다
mapping.txt.
5. 지원되는 버전 및 요구 사항
Android 앱을 빌드하는 데 지원되는 최소 버전은 7.0(API 수준 24)입니다. Android 앱은 실행하는 데 필요한 최소 API 수준이 낮을 수 있지만 적어도 API 수준 24를 대상으로 해야 합니다.
앱이 올바르게 구성되려면 Gradle 및 Android Gradle 플러그 인을 사용하여 빌드해야 합니다. 리포지토리에 Gradle 래퍼가 포함되어야 합니다.
참고 항목: Cloud Build Machine 정보