여러 측정기준별 애셋 타겟팅(중첩 타겟팅)

여러 측정기준(텍스처 압축 형식, 기기 등급, 국가 세트)으로 애셋 팩 또는 번들 모듈의 폴더를 타겟팅하려면 중첩 타겟팅을 사용하면 됩니다.

중첩 타겟팅을 사용하면 타겟팅 측정기준을 최대 2개 결합하는 타겟팅 기준을 정의할 수 있습니다.

형식

여러 측정기준으로 폴더를 타겟팅하려면 폴더 이름에 대한 일련의 해시태그 접미사로 측정기준 목록을 지정하세요.

예를 들어 텍스처 압축 형식 ASTC와 기기 등급 2로 애셋 폴더를 타겟팅하려면 다음과 같이 타겟팅해야 합니다.

...
.../level1/src/main/assets/character-textures#tcf_astc#tier_2/
...

Gradle을 사용하여 앱을 빌드하는 경우 타겟팅 접미사는 사용자 기기에 제공되는 최종 APK 또는 애셋 팩의 디렉터리 이름에서 제거됩니다.

bundletool을 직접 사용하는 경우 BundleConfig.json에서 각 측정기준의 접미사를 개별적으로 제거할지 지정합니다. 기기 등급 타겟팅의 예는 다음과 같습니다.

{
  ...
  "optimizations": {
    "splitsConfig": {
      "splitDimension": [
      ...
      {
        "value": "DEVICE_TIER",
        "negate": false,
        "suffixStripping": {
          "enabled": true,
      }],
    }
  }
}

중첩 타겟팅은 bundletool 1.14.1 이상과 Android Gradle 플러그인 8.2.0-alpha01 이상(Gradle 8.1 이상 필요)에서 지원됩니다.

개별 측정기준의 구성을 맞춤설정하는 방법에 관한 자세한 내용은 각 타겟팅 측정기준의 문서를 참고하세요.

제한사항

  • 중첩 측정기준은 최대 2개까지 사용할 수 있습니다. 즉, 기기 등급, 텍스처 압축 형식, 국가 세트로 동시에 타겟팅되는 폴더는 보유할 수 없습니다. 2개를 선택해야 합니다.

  • 폴더 경로와 동일한 수준에서 중첩 측정기준을 2개 지정해야 합니다. 예를 들어 #tcf_astc 및 #tier_2가 다른 경로 세그먼트에 표시되므로 다음 폴더 타겟팅은 금지됩니다.

.../level1/src/main/assets/character-textures#tcf_astc/level1#tier_2/
  • 중첩 측정기준은 전체 번들에서 동일해야 합니다. 예를 들어 기기 등급과 국가 세트를 중첩하는 애셋 팩과 국가 세트와 텍스처 압축 형식을 중첩하는 다른 애셋 팩은 보유할 수 없습니다.

  • 두 측정기준에 사용하는 값은 전체 번들에서 동일해야 하며 값의 전체 조합을 지정해야 합니다. 예를 들어 텍스처 압축 형식과 국가 세트를 중첩하고 4개의 TCF(ASTC, ETC2, PVRTC, 기본 대체) 및 3개의 국가 세트(latam, sea, 기본 대체)가 있는 경우 12개 조합 모두에 대한 폴더를 지정해야 합니다.

level1/textures#countries_latam#tcf_astc/…
level1/textures#countries_latam#tcf_etc2/…
level1/textures#countries_latam#tcf_pvrtc/…
level1/textures#countries_latam/…
level1/textures#countries_sea#tcf_astc/…
level1/textures#countries_sea#tcf_etc2/…
level1/textures#countries_sea#tcf_pvrtc/…
level1/textures#countries_sea/…
level1/textures#tcf_astc/…
level1/textures#tcf_etc2/…
level1/textures#tcf_pvrtc/…
level1/textures/…
  • 동일한 애셋 팩 또는 번들 모듈의 고유한 콘텐츠 폴더에서 중첩 타겟팅과 단일 측정기준 타겟팅을 모두 사용할 수 있습니다. 단일 측정기준 타겟팅과 중첩 타겟팅에서 모두 측정기준을 사용하면 사용하는 값의 집합은 항상 동일해야 합니다. 예를 들어 단일 측정기준 기기 등급 타겟팅에서 4개 등급으로 타겟팅하고 국가 세트 또는 TCF로 중첩 시 3개 등급만 사용할 수 없습니다.