เทมเพลตและรวมอยู่ในการกำหนดค่า XML ของ Tradefed

การสร้างการกําหนดค่า XML แบบโมโนลิธิกรายการเดียวเพื่อกําหนดการทดสอบนั้นไม่เหมาะสําหรับการใช้งานจริงเสมอไป หากต้องการใช้การตั้งค่าบางส่วนซ้ำเพื่อทำการทดสอบที่คล้ายกัน คุณจะต้องคัดลอกและดูแลรักษาไฟล์ XML ขนาดใหญ่ 2 ไฟล์

แท็ก template และ include ในคำจำกัดความการกําหนดค่า XML ของ Tradefed จะมีประโยชน์ในกรณีนี้ ซึ่งช่วยให้คุณตั้งค่าตัวยึดตำแหน่งใน XML บางรายการได้ เพื่อเพิ่มบางส่วนของการกำหนดค่า XML อื่น

ตัวอย่างคำจำกัดความสำหรับเทมเพลต

<configuration description="Common base configuration for local runs with minimum overhead">
    <build_provider class="com.android.tradefed.build.BootstrapBuildProvider" />

    <template-include name="preparers" default="empty" />

    <template-include name="test" default="empty" />

    <template-include name="reporters" default="empty" />
</configuration>

เทมเพลตคือตัวยึดตำแหน่งที่มี name สำหรับใช้อ้างอิง และ default ฟิลด์เริ่มต้นจะกำหนด XML การแทนที่เริ่มต้นที่ ที่ควรทราบ

หากต้องการแทนที่เทมเพลตสําหรับการกําหนดค่าหนึ่งๆ คุณต้องเพิ่มพารามิเตอร์คําสั่งต่อไปนี้ลงในบรรทัดคําสั่ง

--template:map <name of template>=<replacement XML config path>

--template:map preparers=empty

เช่น

<template-include name="preparers" default="empty" />

การอ้างอิง empty ในกรณีนี้จะอ้างถึงการกำหนดค่า empty.xml ที่ ไม่มี เราจะใช้เป็นการอ้างอิงเพื่อแทนที่โดยไม่มีสิ่งใดเลย

เส้นทางของการกำหนดค่า XML อาจเป็นแบบสัมบูรณ์หรือสัมพัทธ์กับโฟลเดอร์ res/config ภายในทรัพยากร JAR ของ Tradefed ตัวอย่างสถานที่ตั้งมีดังนี้

  • tools/tradefederation/core/res/config
  • tools/tradefederation/core/tests/res/config
  • tools/tradedeferation/contrib/res/config

ตัวอย่างคำจำกัดความของคำว่า "ประกอบด้วย"

<configuration description="Common base configuration for local runs with minimum overhead">
    <build_provider class="com.android.tradefed.build.BootstrapBuildProvider" />

    <include name="empty"/>
</configuration>

การรวมจะง่ายกว่าเทมเพลตเนื่องจากไม่ต้องใช้อาร์กิวเมนต์บรรทัดคำสั่ง ขยาย XML ที่อ้างอิงในแท็ก name โดยตรง เส้นทางไปยังการกําหนดค่าอาจเป็นแบบสัมบูรณ์หรือสัมพัทธ์ได้ เช่นเดียวกับเทมเพลต อย่างไรก็ตาม สำหรับ includes เราขอแนะนำให้ใช้เฉพาะเส้นทางสัมพัทธ์เนื่องจากนำไปใช้ใน Tradefed ได้สะดวกกว่า เส้นทางแบบสัมบูรณ์จะใช้ไม่ได้หากย้าย Tradefed ไปยังเครื่องอื่น

การกำหนดค่าที่ไม่ถูกต้อง

ในกรณีของการกำหนดค่าที่ไม่ถูกต้อง เช่น เมื่อไม่พบ XML ที่จะแทนที่ การแลกเปลี่ยนจะมี ConfigurationException พร้อมคำอธิบายสิ่งที่ดูเหมือนจะ หายไปหรือกำหนดค่าไม่ถูกต้อง