Google Play의 Internal Testing Track: 트랙 설정

Internal Testing Track이란?

Internal Testing Track은 Google Play Console의 첫 번째 테스트 수준으로, 개발 팀 내에서 빌드를 배포하도록 설계되었습니다. 주요 목표는 Closed 또는 Open 트랙으로 대상을 확장하기 전에 빠른 기능 확인, 통합 테스트 및 중요한 버그 식별입니다.

다른 Google Play 트랙과 달리 Internal Testing은 활성화 전에 Google 검토가 필요하지 않습니다. 콘솔에 업로드한 후 몇 분 내에 테스터가 빌드를 사용할 수 있습니다. 따라서 이 트랙은 일일 빌드(daily builds) 및 CI/CD 파이프라인의 자동 전송에 이상적입니다.

Google Play Console 문서(2024)에 따르면 Internal Testing Track은 두 가지 배포 옵션을 지원합니다: 이메일 목록(최대 100명) 및 Google Groups(수량 제한 없음). 그룹은 멤버가 자주 변경되는 대규모 팀에 적합하며, 이메일은 고정된 개발자 집합에 가장 적합합니다.

Internal Testing Track을 선택해야 하는 경우

Internal 트랙은 앱이 아직 불안정하고 API가 변경될 수 있는 개발 초기 단계에서 선택됩니다. CI/CD 파이프라인이 각 새 빌드를 Internal 트랙에 업로드하고 팀은 즉시 최신 버전을 받습니다. 빌드가 외부 테스터나 사용자에게 도달하기 전에 오류와 충돌 로그가 Play Console을 통해 수집됩니다.

새 개발자 계정의 경우 Internal Testing Track은 게시 준비의 첫 번째 단계입니다. Google은 이 단계에서 빌드를 검토하지 않으므로 팀이 검토를 제출하기 전에 제품 품질을 직접 확인할 수 있습니다.

Google Play Console에서 Internal Testing Track 설정 방법

Internal Testing Track 설정은 Google Play Console의 Release > Testing > Internal Testing 섹션에서 수행합니다. 프로세스에는 트랙 생성, 첫 번째 빌드 업로드 및 테스터 추가가 포함됩니다.

트랙을 만들려면 Internal Testing 섹션으로 이동하여 Create track을 클릭합니다. 트랙을 만든 후 시스템에서 AAB(Android App Bundle) 형식으로 첫 번째 빌드를 업로드하라는 메시지가 표시됩니다. Google은 모든 유형의 테스트에 AAB를 권장합니다. 이 형식은 기기 아키텍처에 따라 앱 크기를 최적화하기 때문입니다.

빌드를 업로드한 후 테스터를 추가하여 트랙에 대한 액세스가 열립니다. 테스터가 한 명 이상 없으면 트랙이 활성화된 것으로 간주되지 않습니다. Google Play Console은 트랙 상태, 업로드된 빌드 목록 및 각 참가자의 설치 통계를 표시합니다.

// build.gradle - Internal Testing Track으로 자동 업로드
android {
    def versionCode = System.env.GIT_COMMIT_COUNT ?: "1"
    def versionName = "1.0." + versionCode

    defaultConfig {
        versionCode versionCode.toInteger()
        versionName versionName
    }
}

// Gradle Play Publisher 플러그인으로 배포
plugins {
    id 'com.github.triplet.play' version '3.9.0'
}

play {
    track = "internal"
    serviceAccountCredentials = file("play-account.json")
}

Internal 트랙에 테스터 추가

Internal Testing Track에 테스터를 추가하는 방법은 두 가지입니다: 이메일 또는 Google Groups를 통해. 이메일 목록은 고정 구성의 소규모 팀에 적합합니다. 각 테스터는 콘솔에서 수동으로 추가되며 지정된 주소로 초대장을 받습니다.

Google Groups는 구성이 변경되거나 액세스 관리가 자동화된 팀에 선호됩니다. 그룹을 트랙에 추가하기만 하면 모든 구성원이 빌드에 액세스할 수 있습니다. 그룹 구성 변경은 Play Console에서 설정을 업데이트하지 않고 이루어집니다.

테스터는 기기에서 Google Play를 통해 앱을 설치합니다. 트랙에 추가된 후 이전에 다른 트랙에서 설치한 경우 업데이트 가능한 앱으로, 그렇지 않은 경우 설치할 새 앱으로 표시됩니다. Internal 트랙의 빌드는 공개적으로 게시되지 않으며 트랙 참가자만 볼 수 있습니다.

Internal 트랙에서 메트릭 수집

Google Play는 Internal Testing Track의 모든 빌드에 대해 Android Vitals를 자동으로 수집합니다: 충돌률, ANR 및 시작 시간. 첫 번째 테스터가 빌드를 설치한 직후 개발자는 Play Console에서 메트릭을 볼 수 있습니다. 데이터는 집계 지연 없이 실시간으로 제공됩니다.

Internal Testing과 Closed/Open 트랙의 차이점

Internal Testing Track은 액세스 속도, 검토 요구 사항 및 대상 규모에서 Closed 및 Open 트랙과 다릅니다. Internal은 검토가 필요하지 않으며, Closed는 Google Groups 설정 및 검토가 필요하고, Open은 전체 Google 검토를 거칩니다.

Internal 트랙은 대기 없이 빌드를 사용할 수 있는 유일한 트랙입니다. Closed와 Open은 Google 검토가 필요하며 몇 시간에서 2일까지 소요됩니다. 새 개발자 계정의 경우 Open Testing Track이 필수입니다: 앱은 프로덕션에 게시되기 전에 14일의 공개 테스트를 거쳐야 합니다.

CI/CD를 통한 Internal Testing 자동화

Internal Testing Track으로의 업로드 자동화는 Android 프로젝트의 CI/CD 파이프라인에서 표준 관행입니다. Gradle Play Publisher는 자동 빌드 게시를 위한 가장 인기 있는 플러그인입니다. AAB에 서명하고 Google Play에 업로드한 후 트랙을 지정합니다.

Fastlane은 Play Console에 빌드를 업로드하기 위한 supply 액션을 제공합니다. 트랙 매개변수는 대상 트랙(internal, closedalpha, openbeta, production)을 지정합니다. 버전 관리 및 서비스 계정은 Fastfile에서 한 번만 구성됩니다.

# Fastfile - Internal Testing Track으로 자동 업로드
platform :android do
    desc "Build and deploy to Internal Testing"
    lane :internal do
        gradle(task: "bundleRelease")
        supply(
            track: "internal",
            aab: "app/build/outputs/bundle/release/app-release.aab",
            skip_upload_metadata: true,
            skip_upload_images: true
        )
    end
end

Google Play 서비스 계정은 Google Cloud Console에서 Publisher 역할로 생성되어 Play Console의 개발자 계정에 연결됩니다. 서비스 계정의 JSON 키는 CI/CD 저장소에서 보호 변수(GitHub Secrets, GitLab CI Variables, Jenkins Credentials)로 저장됩니다.