인스턴트 전송 구성

Google Play 인스턴트를 사용하면 사용자가 기기에 APK를 설치하지 않고도 앱과 상호작용할 수 있습니다. 그 대신 사용자는 Google Play 스토어의 '사용해 보기' 버튼이나 개발자가 만든 URL을 통해 앱을 경험해 볼 수 있습니다. 이런 형식으로 콘텐츠를 제공하면 더 쉽게 앱 참여도를 높일 수 있습니다.

앱 기본 모듈의 인스턴트 지원을 사용 설정하는 경우에만 기능의 인스턴트 지원을 사용 설정할 수 있습니다. 그 이유는 사용자가 앱의 인스턴트 지원 기능 모듈 중 한 가지를 경험해 보려는 경우 사용자의 기기에서 앱의 공통 코드 및 리소스용 기본 모듈도 다운로드해야 하기 때문입니다. Google Play 인스턴트를 지원하려면 기본 모듈 및 기능 다운로드 시 다음과 같은 몇 가지 기준을 충족해야 합니다.

이 섹션에 설명된 대로 Android 스튜디오 3.5 이상을 사용해 인스턴트 지원 기능 모듈을 생성하면 IDE는 각 모듈의 매니페스트에 다음 코드를 포함함으로써 자동으로 기본 모듈과 기능 모듈의 인스턴트 지원을 모두 사용 설정합니다.

<manifest xmlns:dist="http://schemas.android.com/apk/distribution"
    ... >
    <dist:module dist:instant="true" />
    ...

또한 앱을 다운로드하여 설치할 때 인스턴트 지원 기능 모듈은 앱의 기본 APK와 함께 자동으로 다운로드되고 설치됩니다. 따라서 IDE는 인스턴트 지원 기능 모듈에 다음 코드도 포함합니다.

    <dist:module ...>
        <dist:delivery>
            <dist:install-time />
        </dist:delivery>
    </dist:module>

이 동작은 dist:instant="true"를 설정한 경우 <dist:on-demand />를 포함할 수 없음을 의미합니다. 그러나 Play Feature Delivery 라이브러리를 사용하여 인스턴트 환경 내에서 주문형으로 인스턴트 지원 모듈을 요청할 수 있습니다.

인스턴트 제공을 위한 새 모듈 구성

Android 스튜디오를 사용하여 앱 프로젝트에 인스턴트 지원 기능 모듈을 추가하려면 다음 단계를 따르세요.

  1. 아직 추가하지 않았다면 IDE에서 앱 프로젝트를 엽니다.
  2. 메뉴 바에서 File > New > New Module을 선택합니다.
  3. Create New Module 대화상자에서 Instant Dynamic Feature Module을 선택하고 Next를 클릭합니다.
  4. Configure your new module 섹션에서 다음을 완료합니다.

    1. 드롭다운 메뉴에서 앱 프로젝트의 Base application module을 선택합니다.
    2. Module name을 지정합니다. IDE는 이 이름을 사용하여 Gradle 설정 파일에서 모듈을 Gradle 하위 프로젝트로 식별합니다. App Bundle을 빌드할 때 Gradle은 하위 프로젝트 이름의 마지막 요소를 사용하여 기능 모듈의 매니페스트<manifest split> 속성을 삽입합니다.
    3. 모듈의 package name을 지정합니다. 기본적으로 Android 스튜디오는 기본 모듈의 루트 패키지 이름과 이전 단계에서 지정한 모듈 이름을 결합한 패키지 이름을 제안합니다.
    4. 모듈에서 지원할 Minimum API level을 선택합니다. 이 값은 기본 모듈의 값과 일치해야 합니다.
    5. 최대 50자를 사용하여 Module title을 지정합니다. 플랫폼에서는 이 제목으로 사용자에게 모듈을 알립니다. 이런 이유로 앱의 기본 모듈은 번역이 가능한 문자열 리소스로 된 모듈 제목을 포함해야 합니다. Android 스튜디오를 사용하여 모듈을 만들 때 IDE는 문자열 리소스를 기본 모듈에 추가하고 다음 항목을 기능 모듈의 매니페스트에 삽입합니다.

      <dist:module
          ...
          dist:title="@string/feature_title">
      </dist:module>
      
    6. 이 모듈을 Android 4.4(API 수준 20) 이하를 실행하는 기기에서 사용하고 다중 APK에 포함하려면 Fusing 옆에 있는 체크박스를 선택합니다. Android 스튜디오는 모듈의 매니페스트에 다음을 삽입하여 선택사항을 반영합니다.

      <dist:module>
          <dist:fusing dist:include="true" />
      </dist:module>
      
  5. Finish를 클릭합니다.

Android 스튜디오에서 모듈 생성을 완료한 후에는 Project 창에서 직접 콘텐츠를 검사합니다(메뉴 바에서 View > Tool Windows > Project 선택). 기본 코드, 리소스, 구성은 표준 앱 모듈과 비슷해야 합니다.

주문형으로 다운로드할 기능을 구현한 후에는 Play Feature Delivery 라이브러리를 이용하여 요청하는 방법을 알아보세요.

앱 배포

기능 모듈을 지원하는 앱을 개발하는 동안 일반적인 방식과 마찬가지로 메뉴 바에서 Run > Run을 선택(또는 툴바에서 Run 을 클릭)하여 연결된 기기에 앱을 배포할 수 있습니다.

앱 프로젝트에 하나 이상의 기능 모듈이 포함된 경우 다음과 같이 기존 실행/디버그 구성을 수정하여 앱을 배포할 때 포함할 기능을 선택할 수 있습니다.

  1. 메뉴 바에서 Run > Edit Configurations를 선택합니다.
  2. Run/Debug Configurations 대화상자의 왼쪽 패널에서 원하는 Android App 구성을 선택합니다.
  3. General 탭의 Dynamic features to deploy에서 앱을 배포할 때 포함할 각 기능 모듈 옆의 체크박스를 선택합니다.
  4. OK를 클릭합니다.

기본적으로 Android 스튜디오에서는 인스턴트 지원 모듈을 인스턴트 환경으로 배포하거나 App Bundle을 사용해 앱을 배포하지 않습니다. 대신, IDE는 APK 크기보다 배포 속도에 최적화된 APK를 기기에 빌드하여 설치합니다. App Bundle에서 APK와 인스턴트 환경을 대신 빌드하고 배포하도록 Android 스튜디오를 구성하려면 실행/디버그 구성을 수정해야 합니다.