การกำหนดเป้าหมายเนื้อหาตามมิติข้อมูลหลายรายการ (การกําหนดเป้าหมายที่ซ้อนกัน)

หากต้องการกำหนดเป้าหมายโฟลเดอร์ในโมดูล Asset Pack หรือ Bundle ตามมิติข้อมูลหลายรายการ (รูปแบบการบีบอัดพื้นผิว ระดับอุปกรณ์ ชุดประเทศ) คุณสามารถใช้การกำหนดเป้าหมายที่ฝังอยู่

การกําหนดเป้าหมายที่ฝังไว้ช่วยให้คุณกําหนดเกณฑ์การกําหนดเป้าหมายที่รวมมิติข้อมูลการกําหนดเป้าหมายได้สูงสุด 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 รายการ

  • คุณควรระบุมิติข้อมูลที่ซ้อนกัน 2 รายการที่ระดับเดียวกันของเส้นทางโฟลเดอร์ ตัวอย่างเช่น ระบบไม่อนุญาตให้กําหนดเป้าหมายโฟลเดอร์ต่อไปนี้ เนื่องจาก #tcf_astc และ #tier_2 ปรากฏในส่วนต่างๆ ของเส้นทาง

.../level1/src/main/assets/character-textures#tcf_astc/level1#tier_2/
  • มิติข้อมูลที่ฝังอยู่ต้องเหมือนกันทั้งแพ็กเกจ ตัวอย่างเช่น คุณไม่สามารถมีแพ็กเนื้อหาที่ฝังระดับอุปกรณ์และชุดประเทศ และแพ็กเนื้อหาอื่นที่ฝังชุดประเทศและรูปแบบการบีบอัดพื้นผิว

  • ค่าที่คุณใช้สำหรับมิติข้อมูลทั้ง 2 รายการต้องเหมือนกันทั้งแพ็กเกจ และต้องระบุชุดค่าผสมที่สมบูรณ์ ตัวอย่างเช่น หากต้องการฝังรูปแบบการบีบอัดพื้นผิวและชุดประเทศ และคุณมี TCF 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