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

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

טירגוט בתצוגת עץ מאפשר להגדיר קריטריונים לטירגוט שמשלבים עד 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 מתוך 3.

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