Чтобы настроить таргетинг на папку в пакете объектов или модуле набора по нескольким параметрам (формат сжатия текстур, уровень устройства, набор стран), можно использовать вложенный таргетинг.
Вложенный таргетинг позволяет задавать критерии таргетинга, которые объединяют до двух параметров таргетинга.
Формат
Чтобы настроить таргетинг на папку по нескольким параметрам, укажите их список в виде серии суффиксов с хештегом в названии папки.
Например, чтобы настроить таргетинг папки объектов на формат сжатия текстур 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 или более поздней версии.
Дополнительную информацию о том, как настроить конфигурацию для отдельных параметров, можно найти в документации по каждому параметру таргетинга.
Ограничения
Можно использовать не более двух вложенных параметров. Другими словами, нельзя одновременно настроить таргетинг папки по уровню устройства, формату сжатия текстур и стране. Нужно выбрать два критерия.
Вам нужно указать два вложенных параметра на одном уровне пути к папке. Например, нельзя настроить таргетинг на следующую папку, поскольку #tcf_astc и #tier_2 находятся в разных сегментах пути:
.../level1/src/main/assets/character-textures#tcf_astc/level1#tier_2/
Вложенные параметры должны быть одинаковыми для всего пакета. Например, нельзя создать один пакет объектов, в котором вложены уровни устройств и набор стран, и другой пакет объектов, в котором вложены набор стран и формат сжатия текстур.
Значения, которые вы используете для двух параметров, должны быть одинаковыми для всего пакета, и вы должны указать полную комбинацию значений. Например, если вы хотите вложить формат сжатия текстур и набор стран, и у вас есть 4 формата сжатия текстур (ASTC, ETC2, PVRTC, резервный по умолчанию) и 3 набора стран (Латинская Америка, Юго-Восточная Азия, резервный по умолчанию), вам нужно указать папку для всех 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/…
- Вы можете использовать как вложенный таргетинг, так и таргетинг по одному параметру для разных папок с контентом в одном и том же пакете объектов или модуле набора. Если вы используете параметр как в таргетинге по одному параметру, так и во вложенном таргетинге, набор значений должен быть одинаковым. Например, нельзя настроить таргетинг на четыре уровня устройств в рамках таргетинга на уровень устройств с одним параметром, а затем использовать только три уровня при вложении наборов стран или TCF.