영어로 읽기

다음을 통해 공유


Android용 Java 앱 빌드

중요

Visual Studio App Center는 2025년 3월 31일에 사용 중지될 예정입니다. 완전히 사용 중지될 때까지 Visual Studio App Center를 계속 사용할 수 있지만 마이그레이션을 고려할 수 있는 몇 가지 권장 대안이 있습니다.

지원 타임라인 및 대안에 대해 자세히 알아봅니다.

첫 번째 Android 앱을 빌드하려면 다음 단계를 수행합니다.

  1. 리포지토리 서비스 계정(GitHub, Bitbucket, VSTS, Azure DevOps)에 연결합니다.
  2. 앱이 있는 리포지토리 및 분기를 선택합니다.
  3. 빌드하려는 Android 프로젝트를 선택합니다.
  4. 첫 번째 빌드를 설정합니다.

참고

실제 디바이스에서 앱을 실행하려면 빌드가 유효한 인증서로 서명된 코드여야 합니다.

참고

App Center는 Android 프로젝트의 gradle(및 gradlew) 디렉터리 파일을 검색하여 프로젝트를 추적합니다. App Center Build에서 찾을 수 없도록 .gitignore 프로젝트에 이러한 파일을 포함하지 마세요.

경고

최근 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 정보