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

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

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

פורמט

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

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

מגבלות

• אפשר להשתמש בשני מאפיינים מקוננים לכל היותר. במילים אחרות, לא יכול להיות תיקייה שמטרגטת לפי רמת מכשיר, פורמט דחיסת נתוני טקסטורה והמדינה שמוגדרת באותה שעה: עליכם לבחור ב-2.

• צריך לציין את שני המאפיינים שהוצבו באותה רמה של התיקייה נתיב. לדוגמה, המיקוד הבא לתיקייה אסור, שכן #tcf_astc ו- #tier_2 מופיעים במקטעי נתיב שונים:

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

• המאפיינים המקוננים חייבים להיות זהים בכל החבילה. עבור למשל, לא יכולה להיות חבילת נכסים שבה מקוננים רמות ומדינה במכשירים וחבילת נכסים נוספת שבה מקוננים הגדרות מדינה ודחיסת טקסטורה הפורמט.

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

• מותר לך להשתמש גם בטירגוט מקונן וגם בטירגוט לפי מאפיין יחיד תיקיות תוכן נפרדות באותה חבילת נכסים או באותו מודול חבילה. אם משתמשים גם בטירגוט לפי מאפיין יחיד וגם בטירגוט מקונן, הקבוצה של הערכים שבהם אתם משתמשים חייבים להיות תמיד זהים. לדוגמה, לא ניתן לטרגט לפי 4 רמות בטירגוט ברמת המכשיר עם מאפיין יחיד, ולאחר מכן משתמשים ב-3 רמות בלבד כשהערך הוא מקונן עם קבוצות מדינות או TCF.