טירגוט נכסים לפי כמה מאפיינים (טירגוט מקונן)

כדי לטרגט תיקייה בחבילת נכסים או במודול של חבילת נכסים לפי כמה מאפיינים (פורמט דחיסת טקסטורה, רמת מכשיר, קבוצת מדינות), אפשר להשתמש בטירגוט בתצוגת עץ.

טירגוט מקונן מאפשר להגדיר קריטריונים לטירגוט שמשלבים עד שני מאפייני טירגוט.

פורמט

כדי לטרגט תיקייה לפי כמה מאפיינים, צריך לציין את רשימת המאפיינים בסדרה של סיומות hashtag לשם התיקייה.

לדוגמה, כדי לטרגט תיקיית נכסים לפי פורמט דחיסת נתוני הטקסט 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 Plugin 8.2.0-alpha01 ואילך, שדורש Gradle 8.1 ואילך.

מידע נוסף על התאמה אישית של ההגדרות למאפיינים ספציפיים זמין במסמכים של כל מאפיין טירגוט.

מגבלות

• אפשר להשתמש בשני מאפיינים מקוננים לכל היותר. במילים אחרות, אי אפשר ליצור תיקייה שתוגדר לטרגוט לפי רמת מכשיר, פורמט דחיסת טקסטורה וקבוצת מדינות בו-זמנית: צריך לבחור 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 רמות בטירגוט של רמת מכשיר עם מאפיין יחיד, ואז להשתמש רק ב-3 רמות כשמשתמשים בהטמעה בתוך קבוצות של מדינות או ב-TCF.