استهداف مواد العرض حسب أبعاد متعددة (الاستهداف المتداخل)

لاستهداف مجلد في حزمة مواد عرض أو وحدة حزمة حسب عدة أبعاد (تنسيق ضغط الطبقة، وفئة الجهاز، ومجموعة البلدان)، يمكنك استخدام استهداف العملاء.

يسمح الاستهداف المتداخل بتحديد معايير استهداف تجمع بين معيارين كحد أقصى. أبعاد الاستهداف.

التنسيق

لاستهداف مجلد حسب أبعاد متعددة، حدد قائمة الأبعاد في سلسلة من لاحقات علامات التصنيف إلى اسم المجلد.

فعلى سبيل المثال، لاستهداف مجلد أصول من خلال تنسيق ضغط البنية 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,
      }],
    }
  }
}

يتوفّر الاستهداف المتداخل في packagetool 1.14.1 أو الإصدارات الأحدث والإصدار 1.14.1 من نظام Gradle المتوافق مع Android المكون الإضافي 8.2.0-alpha01 أو أعلى، الأمر الذي يتطلب Gradle 8.1 أو إصدارًا أعلى.

يمكنك العثور على مزيد من المعلومات حول كيفية تخصيص الإعدادات من أجل أبعاد فردية في المستندات لكل بُعد استهداف.

القيود

  • لا يمكنك استخدام أكثر من سمتَين مدمجتَين. أو بعبارةٍ أخرى، لا يمكنك تستهدفه فئة الجهاز، وتنسيق ضغط الطبقة، والبلد المحدّد نفس الوقت: عليك اختيار 2.

  • عليك تحديد السمتَين المدمجتَين على مستوى المجلد نفسه. . على سبيل المثال، يُحظر استهداف المجلدات التالية، نظرًا لأن #tcf_astc و #tier_2 في شرائح مسار مختلفة:

.../level1/src/main/assets/character-textures#tcf_astc/level1#tier_2/
  • يجب أن تكون الأبعاد المدمجة متطابقة على مستوى الحزمة بالكامل. بالنسبة على سبيل المثال، لا يمكنك الحصول على حزمة مواد عرض حيث يمكنك دمج فئات الأجهزة والبلد وحزمة مواد عرض أخرى حيث يمكنك دمج ضبط البلد وضغط البنية .

  • يجب أن تكون القيم التي تستخدمها للسمتَين متطابقة على مستوى العنصر بالكامل. يجب تحديد مجموعة القيم الكاملة. على سبيل المثال، إذا لنفترض أنك تريد دمج تنسيق ضغط البنية ومجموعة البلد، ولديك 4 إطارات الشفافية والموافقة (ASTC، ETC2، PVRTC، الاحتياطي التلقائي) و3 مجموعات بلدان (أمريكا اللاتينية، البحر، احتياطي تلقائي)، فيجب تحديد مجلد لجميع المجموعات الاثني عشر:

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 مستويات فقط عند دمجها مع مجموعات البلدان أو إطارات الشفافية والموافقة.