Google은 흑인 공동체를 위한 인종 간 평등을 진전시키기 위해 노력하고 있습니다. Google에서 어떤 노력을 하고 있는지 확인하세요.

일반 시스템 이미지

일반 시스템 이미지(GSI)는 다양한 Android 기기에서 실행할 수 있는 수정되지 않은 Android 오픈소스 프로젝트(AOSP) 코드를 사용한 순수 Android 구현입니다.

여러 기기에서 지원되는 GSI

그림 1. 여러 기기에서 지원되는 GSI

Android 9(API 수준 28)부터 일반 시스템 이미지(GSI)를 전체 Android 출시 주기에 걸쳐 앱 개발자가 사용할 수 있습니다. 앱 개발자는 다양한 기존 Android 기기에, 그리고 미리보기 및 베타 단계를 포함하는 다양한 Android OS 출시 단계에서 최신 Android GSI를 설치 및 실행하여 앱을 테스트할 수 있습니다. 이런 방법으로 앱은 이전보다 훨씬 빠른 시기에 시작하여 테스트 범위가 더 넓어집니다.

  • 실제 기기에 더 많은 테스트를 실행할 수 있습니다.
  • 앱 호환성 문제를 해결할 충분한 시간이 있습니다.
  • 앱 개발자가 신고한 Android OS에서 호환되지 않는 문제를 해결할 기회가 많습니다.

참고: 현재 기기에 설치된 Android 버전보다 최신 GSI 버전을 설치할 수 있습니다.

GSI 프로젝트는 다음 OS 출시 전에 앱 및 OS 품질을 개선할 여러 방법을 제공하여 Android 생태계를 개선하는 데 도움을 줍니다. GSI 프로젝트도 오픈소스로 제공됩니다.

GSI에는 Android 9 이상을 실행하는 모든 기기의 핵심 시스템 기능이 포함되어 있습니다. 즉, GSI에는 기기 제조업체의 맞춤설정이 포함되어 있지 않습니다. 다음 상황에서 동작 차이가 발생할 수 있습니다.

  • UI와 관련된 상호작용
  • 최신 하드웨어 기능을 요청하는 워크플로

기기 규정 준수 확인

GSI는 다음 특성을 가진 기기에서만 작동합니다.

  • 부트로더가 잠금 해제되었습니다.
  • Treble과 완전히 호환됩니다.
  • Android 9(API 수준 28) 이상으로 출시되었습니다. 이전 버전에서 Android 9로 업그레이드된 기기는 GSI를 지원할 수도 있고 그렇지 않을 수도 있습니다.

기기에서 GSI를 사용할 수 있는지, 어떤 GSI OS 버전을 설치해야 하는지 확인하려면 다음을 따르세요.

  1. 다음 명령어를 실행하여 트레블 지원을 확인합니다.

    adb shell getprop ro.treble.enabled

    응답이 false인 경우 기기가 GSI와 호환되지 않으므로 계속하면 안 됩니다. 응답이 true인 경우 다음 단계를 진행합니다.

  2. 다음 명령어를 실행하여 버전 간 지원을 확인합니다.

    adb shell cat /system/etc/ld.config.version_identifier.txt \
    | grep -A 20 "\[vendor\]"

    출력에서 [vendor] 섹션의 namespace.default.isolated를 확인합니다.

    이 속성의 값이 true이면 기기가 공급업체 네이티브 개발 키트(VNDK)를 완전히 지원하고 기기 OS 버전보다 최신인 모든 GSI 운영체제(OS) 버전을 사용할 수 있습니다. 사용 가능한 최신 GSI OS 버전을 선택하세요.

    속성 값이 false이면 기기는 VNDK와 완전히 호환되지 않으며 동일한 기기 내 OS 버전의 GSI만 사용할 수 있습니다. 예를 들어 VNDK와 호환되지 않는 Android 9(API 버전 28)에서는 Android 9 GSI 이미지만 로드할 수 있습니다.

  3. GSI CPU 아키텍처 유형과 기기의 CPU 아키텍처가 일치해야 합니다. GSI 이미지에 맞는 CPU 아키텍처를 찾으려면 다음 명령을 실행하세요.

    adb shell getprop ro.product.cpu.abi

    출력된 값을 사용하여 기기를 플래시할 때 사용할 GSI 이미지를 확인합니다. 예를 들어 Pixel 3의 경우 출력된 값을 통해 CPU 아키텍처가 arm64-v8a라는 것을 알 수 있으므로 arm64 유형의 GSI를 사용할 수 있습니다.

GSI 이미지 다운로드

이 버전의 GSI는 OEM에서 규정 준수 테스트를 실행하고 제출하는 데 사용되어서는 안 됩니다. OEM은 규정 준수 테스트 관련 활동에 관한 테크니컬 어카운트 매니저와 같은 기존 통신 채널을 계속 참조해야 합니다.

개발 요구에 따라 GSI를 얻는 몇 가지 방법이 있습니다.

  • Android 11 미리보기 GSI 및 Android 10 GSI(GMS 포함)의 경우 GSI 출시 페이지에서 다운로드합니다.
  • GMS 애플리케이션 없이 사전 빌드된 GSI 이미지의 경우 AOSP CI 사이트에서 다운로드합니다.
  • Android 10 및 Android 9 GSI(GMS 미포함)를 빌드하려면 AOSP에서 소스 코드를 다운로드하고 GSI를 빌드합니다.

GSI 이미지 설치

참고: 기기에서 Android 자체 검사 부팅(AVB)을 채택했다면 GSI를 플래시하기 전에 이미지 vbmeta.img를 다운로드하고 플래시하여 AVB를 사용 중지합니다.

GSI 설치는 기기에 따라 달라집니다. 정확한 도구와 절차는 기기 제조업체에 문의하세요. Pixel 3과 최신 기기의 경우 다음과 같은 여러 설치 방법이 있습니다.

  • 수동으로 GSI 이미지 플래싱 — GSI 플래싱을 참조하세요.
  • Android 10을 이미 실행하는 기기의 경우 동적 시스템 업데이트(DSU) 사용 — 동적 시스템 업데이트 사이트를 참조하세요.
  • Google에 의견 보내기

    GSI 이미지는 Android에서 앱의 유효성을 검사하는 데 도움을 줍니다. 이미지, 도구 및 기기에서 GSI를 사용하는 프로세스에 관한 의견을 보내주시기 바랍니다.

    버그를 신고하거나 기능을 요청하려면 전용 Issue Tracker 구성요소를 사용하세요.

    추가 리소스