ตั้งแต่วันที่ 27 มีนาคม 2025 เป็นต้นไป เราขอแนะนำให้ใช้ android-latest-release แทน aosp-main เพื่อสร้างและมีส่วนร่วมใน AOSP โปรดดูข้อมูลเพิ่มเติมที่หัวข้อการเปลี่ยนแปลงใน AOSP
เทมเพลตและรวมอยู่ในการกำหนดค่า 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 ได้สะดวกกว่า
Absolute Path จะใช้ไม่ได้หากย้าย Tradefed ไปยังเครื่องอื่น
การกําหนดค่าที่ไม่ถูกต้อง
ในกรณีที่มีการกําหนดค่าไม่ถูกต้อง เช่น เมื่อไม่พบ XML เปลี่ยนทดแทน Tradefed จะแสดง ConfigurationException พร้อมคําอธิบายสิ่งที่ดูเหมือนจะขาดหายไปหรือกําหนดค่าไม่ถูกต้อง
ตัวอย่างเนื้อหาและโค้ดในหน้าเว็บนี้ขึ้นอยู่กับใบอนุญาตที่อธิบายไว้ในใบอนุญาตการใช้เนื้อหา Java และ OpenJDK เป็นเครื่องหมายการค้าหรือเครื่องหมายการค้าจดทะเบียนของ Oracle และ/หรือบริษัทในเครือ
อัปเดตล่าสุด 2025-07-27 UTC
[[["เข้าใจง่าย","easyToUnderstand","thumb-up"],["แก้ปัญหาของฉันได้","solvedMyProblem","thumb-up"],["อื่นๆ","otherUp","thumb-up"]],[["ไม่มีข้อมูลที่ฉันต้องการ","missingTheInformationINeed","thumb-down"],["ซับซ้อนเกินไป/มีหลายขั้นตอนมากเกินไป","tooComplicatedTooManySteps","thumb-down"],["ล้าสมัย","outOfDate","thumb-down"],["ปัญหาเกี่ยวกับการแปล","translationIssue","thumb-down"],["ตัวอย่าง/ปัญหาเกี่ยวกับโค้ด","samplesCodeIssue","thumb-down"],["อื่นๆ","otherDown","thumb-down"]],["อัปเดตล่าสุด 2025-07-27 UTC"],[],[],null,["# Templates and includes in Tradefed XML configuration\n\nCreating one monolithic XML configuration to define a test is not always\npractical. If you want to re-use part of the setup to run similar tests, you\nwould be forced to copy and maintain two giant XML files.\n\nThis is where `template` and `include` tags in Tradefed XML Configuration\ndefinition come in handy. They allow you to set placeholders in some XML\nconfiguration to add part of another XML configuration.\n\nExample definition for templates\n--------------------------------\n\n \u003cconfiguration description=\"Common base configuration for local runs with minimum overhead\"\u003e\n \u003cbuild_provider class=\"com.android.tradefed.build.BootstrapBuildProvider\" /\u003e\n\n \u003ctemplate-include name=\"preparers\" default=\"empty\" /\u003e\n\n \u003ctemplate-include name=\"test\" default=\"empty\" /\u003e\n\n \u003ctemplate-include name=\"reporters\" default=\"empty\" /\u003e\n \u003c/configuration\u003e\n\nTemplates are placeholders with a `name` to reference them, and an optional\n`default` field. The default field defines the default replacement XML that\nshould be used.\n\nIn order to replace a template for a given configuration, the following command\nparameter needs to be added to the command line: \n\n --template:map \u003cname of template\u003e=\u003creplacement XML config path\u003e\n\n --template:map preparers=empty\n\nFor example: \n\n \u003ctemplate-include name=\"preparers\" default=\"empty\" /\u003e\n\nThe `empty` reference in this case refers to the `empty.xml` configuration that\ncontains nothing; we use it as our reference to *replace with nothing*.\n\nThe path of XML configs can be absolute or relative to the `res/config` folder\ninside Tradefed's JAR resources. Here are a few of their locations:\n\n- tools/tradefederation/core/res/config\n- tools/tradefederation/core/tests/res/config\n- tools/tradedeferation/contrib/res/config\n\nExample definition of includes\n------------------------------\n\n \u003cconfiguration description=\"Common base configuration for local runs with minimum overhead\"\u003e\n \u003cbuild_provider class=\"com.android.tradefed.build.BootstrapBuildProvider\" /\u003e\n\n \u003cinclude name=\"empty\"/\u003e\n \u003c/configuration\u003e\n\nIncludes are simpler than Templates as they require no command line arguments;\nthey directly expand the referenced XML in the `name` tag. Similar to templates,\nthe path to the config can be absolute or relative. Still, for `includes` we\nrecommend using only relative paths as they are more portable in Tradefed.\nAbsolute paths would not be valid if Tradefed is moved to another machine.\n\nMisconfiguration\n----------------\n\nIn case of misconfiguration, such as when the replacement XML cannot be found,\nTradefed will throw a `ConfigurationException` with description of what seems to\nbe missing or misconfigured."]]
