هدف‌یابی دارایی براساس چند بعد (هدف‌یابی تودرتو)

برای هدف‌یابی پوشه‌ای در بسته دارایی یا واحد دسته براساس چند بُعد (قالب فشرده‌سازی بافت، سطح دستگاه، مجموعه کشور)، می‌توانید از هدف‌یابی تودرتو استفاده کنید.

هدف‌یابی تودرتو امکان تعریف معیارهای هدف‌یابی را فراهم می‌کند که تا ۲ بعد هدف‌یابی را ترکیب می‌کند.

قالب

برای هدف‌یابی پوشه براساس چند بُعد، فهرست ابعاد را در مجموعه‌ای از پسوندهای هشتگ به نام پوشه مشخص کنید.

برای مثال، برای هدف‌یابی پوشه دارایی براساس قالب فشرده‌سازی بافت ASTC و سطح دستگاه ۲، هدف‌یابی به‌صورت زیر خواهد بود:

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

اگر از Gradle برای ساختن برنامه‌تان استفاده می‌کنید، پسوندهای هدف‌یابی از نام دایرکتوری در فایل‌های APK نهایی یا بسته‌های دارایی که به دستگاه‌های کاربر ارسال می‌شوند حذف می‌شوند.

اگر مستقیماً از بسته‌ابزار استفاده می‌کنید، مشخص کنید که آیا می‌خواهید پسوند برای هریک از ابعاد به‌طور جداگانه در BundleConfig.json حذف شود یا نه. با نمونه‌ای برای هدف‌گیری براساس رده دستگاه:

{
  ...
  "optimizations": {
    "splitsConfig": {
      "splitDimension": [
      ...
      {
        "value": "DEVICE_TIER",
        "negate": false,
        "suffixStripping": {
          "enabled": true,
      }],
    }
  }
}

هدف‌یابی تودرتو در bundletool نسخه ۱.۱۴.۱ یا بالاتر و افزایه Android Gradle نسخه 8.2.0-alpha01 یا بالاتر پشتیبانی می‌شود که به Gradle نسخه ۸.۱ یا بالاتر نیاز دارد.

برای کسب اطلاعات بیشتر درباره نحوه سفارشی‌سازی پیکربندی برای ابعاد فردی، به اسناد مربوط به هر بُعد هدف‌یابی مراجعه کنید.

محدودیت‌ها

  • می‌توانید حداکثر از ۲ بُعد تودرتو استفاده کنید. به‌عبارت دیگر، نمی‌توانید پوشه‌ای داشته باشید که هم‌زمان براساس سطح دستگاه، قالب فشرده‌سازی بافت، و مجموعه کشور هدف‌یابی شده باشد: باید ۲ مورد را انتخاب کنید.

  • باید ۲ بُعد تودرتو را در همان سطح مسیر پوشه مشخص کنید. برای مثال، هدف‌یابی پوشه زیر ممنوع است، زیرا #tcf_astc و #tier_2 در بخش‌های مسیر متفاوتی ظاهر می‌شوند:

.../level1/src/main/assets/character-textures#tcf_astc/level1#tier_2/
  • ابعاد تودرتو باید در کل بسته یکسان باشد. برای مثال، نمی‌توانید بسته دارایی‌ای داشته باشید که در آن ردیف‌های دستگاه و مجموعه کشور را آشیانه کنید و بسته دارایی دیگری داشته باشید که در آن مجموعه کشور و قالب فشرده‌سازی بافت را آشیانه کنید.

  • مقادیری که برای ۲ بُعد استفاده می‌کنید باید در کل دسته یکسان باشد و باید ترکیب کامل مقادیر را مشخص کنید. برای مثال، اگر می‌خواهید قالب فشرده‌سازی بافت و مجموعه کشور را تودرتو کنید و ۴ قالب فشرده‌سازی بافت (ASTC،‏ ETC2،‏ PVRTC، بازگشت پیش‌فرض) و ۳ مجموعه کشور (آمریکای لاتین، آسیای جنوب شرقی، بازگشت پیش‌فرض) دارید، باید برای هر ۱۲ ترکیب یک پوشه مشخص کنید:

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/…
  • می‌توانید هم از هدف‌یابی تودرتو و هم از هدف‌یابی تک‌بعدی در پوشه‌های محتوای متمایز در همان بسته دارایی یا واحد بسته استفاده کنید. اگر از یک بُعد هم در هدف‌یابی تک‌بعدی و هم در هدف‌یابی تودرتو استفاده می‌کنید، مجموعه مقادیری که استفاده می‌کنید باید همیشه یکسان باشد. برای مثال، نمی‌توانید براساس ۴ سطح در هدف‌یابی براساس رده دستگاه تک‌بعدی هدف‌یابی کنید و سپس فقط از ۳ سطح هنگام تودرتو کردن با مجموعه‌های کشور یا فیلترهای سازگاری با چارچوب شفافیت و رضایت استفاده کنید.