Pour cibler un dossier d'un pack d'éléments ou d'un module de lot en fonction de plusieurs dimensions (format de compression des textures, niveau d'appareil, ensemble de pays), vous pouvez utiliser le ciblage imbriqué.
Le ciblage imbriqué permet de définir des critères de ciblage qui combinent jusqu'à deux dimensions de ciblage.
Format
Pour cibler un dossier en fonction de plusieurs dimensions, spécifiez la liste des dimensions dans une série de suffixes de hashtag au nom du dossier.
Par exemple, pour cibler un dossier d'éléments en fonction du format de compression des textures ASTC et du niveau d'appareil 2, le ciblage se présente comme suit :
...
.../level1/src/main/assets/character-textures#tcf_astc#tier_2/
...
Si vous utilisez Gradle pour compiler votre application, les suffixes de ciblage sont supprimés du nom du répertoire dans les packs d'éléments ou APK finaux fournis aux appareils des utilisateurs.
Si vous utilisez directement bundletool, indiquez si vous souhaitez que le suffixe soit supprimé individuellement pour chacune des dimensions dans BundleConfig.json. Exemple pour le ciblage en fonction du niveau d'appareil :
{
...
"optimizations": {
"splitsConfig": {
"splitDimension": [
...
{
"value": "DEVICE_TIER",
"negate": false,
"suffixStripping": {
"enabled": true,
}],
}
}
}
Le ciblage imbriqué est compatible avec bundletool 1.14.1 ou version ultérieure, ainsi qu'avec le plug-in Android Gradle 8.2.0-alpha01 ou version ultérieure, qui nécessite Gradle 8.1 ou version ultérieure.
Pour en savoir plus sur la personnalisation de votre configuration pour des dimensions spécifiques, consultez la documentation sur chaque dimension de ciblage.
Limites
Vous ne pouvez pas utiliser plus de deux dimensions imbriquées. En d'autres termes, vous ne pouvez pas cibler simultanément un dossier par niveau d'appareil, format de compression de texture et pays : vous devez choisir deux critères.
Vous devez spécifier les deux dimensions imbriquées au même niveau du chemin d'accès au dossier. Par exemple, le ciblage par dossier suivant est interdit, car #tcf_astc et #tier_2 apparaissent dans des segments de chemin différents :
.../level1/src/main/assets/character-textures#tcf_astc/level1#tier_2/
Vos dimensions imbriquées doivent être identiques dans l'ensemble de votre lot. Par exemple, vous ne pouvez pas avoir un pack d'éléments dans lequel vous imbriquez des niveaux d'appareil et un ensemble de pays, et un autre pack d'éléments où vous imbriquez un ensemble de pays et des formats de compression de texture.
Les valeurs que vous utilisez pour les deux dimensions doivent être identiques dans l'ensemble du lot et vous devez spécifier la combinaison complète de valeurs. Par exemple, si vous souhaitez imbriquer le format de compression de texture et l'ensemble de pays, et que vous avez quatre formats de compression de texture (ASTC, ETC2, PVRTC, valeur par défaut) et trois ensembles de pays (Amérique latine, Asie du sud-est, valeur par défaut), vous devez spécifier un dossier pour les 12 combinaisons :
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/…
- Vous êtes autorisé à utiliser le ciblage imbriqué et le ciblage à dimension unique sur des dossiers de contenu distincts dans le même pack d'éléments ou module de lot. Si vous utilisez une dimension dans le ciblage à dimension unique et le ciblage imbriqué, l'ensemble de valeurs que vous utilisez doit toujours être identique. Par exemple, vous ne pouvez pas cibler quatre niveaux dans le ciblage par niveau d'appareil à dimension unique, puis n'utiliser que trois niveaux lorsqu'il est imbriqué avec des ensembles de pays ou des formats de compression de texture.