โครงสร้าง AndroidTest.xml

จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ

โครงสร้างโดยรวมของการกำหนดค่าโมดูลเป็นไปตามรูปแบบที่คล้ายกัน เข้ากับการกำหนดค่า Tradefed XML ปกติ แต่มีข้อจำกัดบางประการเนื่องจาก การทำงานเป็นส่วนหนึ่งของห้องสวีท

รายการแท็กที่อนุญาต

AndroidTest.xml หรือการกําหนดค่าโมดูลแบบกว้างจะมีได้เฉพาะแท็ก XML ต่อไปนี้เท่านั้น target_preparer, multi_target_preparer, test และ metrics_collector

แม้ว่ารายการดังกล่าวจะดูจำกัด แต่จะช่วยให้คุณกำหนด ความต้องการตั้งค่าโมดูลการทดสอบและการทดสอบเพื่อเรียกใช้

หมายเหตุ: โปรดดูการกำหนดค่า XML ที่เทรด หากต้องการทบทวนข้อมูลเกี่ยวกับแท็กต่างๆ

ออบเจ็กต์ เช่น build_provider หรือ result_reporter จะแสดงConfigurationExceptionหากมีการพยายามเรียกใช้จากภายในการกำหนดค่าโมดูล การดำเนินการนี้เพื่อหลีกเลี่ยงความคาดหวังที่ว่าออบเจ็กต์เหล่านี้จะทํางานบางอย่างจากภายในโมดูล

ตัวอย่างการกำหนดค่าโมดูล

<configuration description="Config for CTS Gesture test cases">
    <option name="test-suite-tag" value="cts" />
    <target_preparer class="com.android.tradefed.targetprep.suite.SuiteApkInstaller">
        <option name="cleanup-apks" value="true" />
        <option name="test-file-name" value="CtsGestureTestCases.apk" />
    </target_preparer>
    <test class="com.android.tradefed.testtype.AndroidJUnitTest" >
        <option name="package" value="android.gesture.cts" />
        <option name="runtime-hint" value="10m50s" />
    </test>
</configuration>

การกําหนดค่านี้อธิบายการทดสอบที่จําเป็นต้องติดตั้ง CtsGestureTestCases.apk และจะเรียกใช้เครื่องมือวัดผลกับแพ็กเกจ android.gesture.cts

แท็กการรวม <include> และ <template-include>

การใช้ <include> และ <template-include> ในการกำหนดค่าโมดูลคือ ให้กับเรา เราไม่รับประกันว่าผลการค้นหาเหล่านั้นจะทำงานตามที่คาดไว้

กรณีพิเศษสําหรับแท็ก metrics_collector

metrics_collector ได้รับอนุญาต แต่ถูกจำกัดตาม FilePullerLogCollector เพื่อระบุไฟล์หรือไดเรกทอรีที่จะดึงและบันทึกไว้ โมดูล ซึ่งจะเป็นประโยชน์ในกรณีที่คุณเก็บบันทึกไว้ในตำแหน่งที่เฉพาะเจาะจงและต้องการกู้คืนบันทึกโดยอัตโนมัติ

ตัวอย่างการกำหนดค่า

<configuration description="Config for CTS UI Rendering test cases">
    <target_preparer class="com.android.tradefed.targetprep.suite.SuiteApkInstaller">
        <option name="cleanup-apks" value="true" />
        <option name="test-file-name" value="CtsUiRenderingTestCases.apk" />
    </target_preparer>
    <test class="com.android.tradefed.testtype.AndroidJUnitTest" >
        <option name="package" value="android.uirendering.cts" />
        <option name="runtime-hint" value="11m55s" />
        <option name="runner" value="android.uirendering.cts.runner.UiRenderingRunner" />
        <option name="isolated-storage" value="false" />
    </test>

    <!-- Collect the files in the dump directory for debugging -->
    <metrics_collector class="com.android.tradefed.device.metric.FilePullerLogCollector">
        <option name="directory-keys" value="/sdcard/UiRenderingCaptures" />
        <option name="collect-on-run-ended-only" value="true" />
    </metrics_collector>
</configuration>

แล้วข้อมูลบิลด์หรือการดาวน์โหลดล่ะ

คําจํากัดความของแท็กที่อนุญาตอาจทําให้เข้าใจผิดว่าข้อบังคับจะไม่รับข้อมูลการสร้าง ไม่จริง

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

ตัวอย่างเช่น แทนที่แต่ละแท็ก ชุดเครื่องมือทดสอบความเข้ากันได้ (CTS) แต่ละโมดูลในการค้นหาข้อมูลอุปกรณ์ ประเภท และอื่นๆ CTS การตั้งค่าระดับชุดโปรแกรม (cts.xml) จะทำครั้งเดียวและแต่ละโมดูลจะได้รับ ข้อมูลหากพวกเขาร้องขอ

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

ช่องข้อมูลเมตา

โมดูลทดสอบจำนวนมากมีข้อกำหนดบางอย่างของ metadata โดยแต่ละประเภทมีเป้าหมายที่แตกต่างกัน

ตัวอย่าง

  <option name="config-descriptor:metadata" key="component" value="framework" />
  <option name="config-descriptor:metadata" key="parameter" value="instant_app" />
  <option name="config-descriptor:metadata" key="parameter" value="multi_abi" />
  <option name="config-descriptor:metadata" key="parameter" value="secondary_user" />

ส่วนประกอบ

ข้อมูลเมตา component อธิบายคอมโพเนนต์ Android ทั่วไปที่โมดูลนี้ใช้ ต้องการทดสอบ ไม่มีผลกระทบโดยตรงต่อการดำเนินการทดสอบ คือ ใช้สำหรับองค์กรเป็นหลัก

รายการคอมโพเนนต์ที่อนุญาตล่าสุดสำหรับ CTS มีอยู่ใน CtsConfigLoadingTest การทดสอบนี้จะดำเนินการไม่สำเร็จในขั้นตอนการส่งก่อน หากมีการเพิ่มคอมโพเนนต์ที่ไม่มีอยู่ในข้อบังคับของ CTS

คุณกรองการเรียกใช้ชุดทดสอบตามคอมโพเนนต์ได้โดยใช้ module-metadata-include-filter และ module-metadata-exclude-filter

ตัวอย่าง

  --module-metadata-include-filter component framework

ตัวอย่างนี้เรียกใช้เฉพาะโมดูลการทดสอบที่มีคำอธิบายประกอบ framework คอมโพเนนต์

พารามิเตอร์

ข้อมูลเมตา parameter มีไว้เพื่อแจ้งข้อมูลและส่งผลต่อการดำเนินการทดสอบ ซึ่งจะระบุโหมด Android ที่โมดูลทดสอบใช้ได้ ในกรณีนี้ โหมดจะจํากัดไว้เฉพาะโหมด Android ระดับสูง เช่น instant apps, secondary users หรือ different abis

ระหว่างการทำงานโปรแกรม หากโหมดที่ใช้กับการทดสอบ จะมีหลายรูปแบบ ของโมดูลทดสอบจะสร้างขึ้นตามโหมด แต่ละรูปแบบจะทำงาน การทดสอบที่คล้ายกันแต่อยู่ในโหมดที่ต่างกัน

• instant_app: สร้างการทดสอบรูปแบบหนึ่งที่ติดตั้ง APK เป็น Instant App
• multi_abi: สร้างตัวแปรการทดสอบสำหรับ ABI แต่ละรายการที่อุปกรณ์รองรับ
• secondary_user: สร้างการทดสอบรูปแบบหนึ่งที่ติดตั้ง APK และ ทำการทดสอบในฐานะผู้ใช้รอง

การเก็บรวบรวมเมตริกและการประมวลผลข้อมูลหลังการทดสอบประสิทธิภาพ

สำหรับโมดูลทดสอบประสิทธิภาพ metrics_collector ระดับโมดูลและ metric_post_processor ได้ เนื่องจากมีความสำคัญต่อการทดสอบประสิทธิภาพ เครื่องมือรวบรวมเมตริกระดับโมดูลและผู้ประมวลผลหลังประมวลผลอาจเจาะจงโมดูลได้ ไม่แนะนําให้ระบุโปรแกรมประมวลผลผลลัพธ์ทั้งในระดับบนสุดและระดับโมดูล

การกําหนดค่าโมดูลการทดสอบประสิทธิภาพต้องมีข้อมูลเมตา test-type ที่มีค่า performance เช่น xml <option name="config-descriptor:metadata" key="test-type" value="performance" /> หากไม่มีข้อมูลนี้ หากการกําหนดค่าการทดสอบมี metric_collector นอกเหนือจาก FilePullerLogCollector หรือ metric_post_processor ใดๆ การทดสอบจะดำเนินการไม่สำเร็จในขั้นตอนการส่งก่อน

ตัวอย่างการกําหนดค่าข้อบังคับการทดสอบประสิทธิภาพ

<configuration description="Runs sample performance test.">
    <!-- Declare as a performance test module -->
    <option name="config-descriptor:metadata" key="test-type" value="performance" />
    <option name="test-tag" value="hello-world-performance-test" />
    <test class="com.android.tradefed.testtype.HostTest" >
        <option name="class" value="android.test.example.helloworldperformance.HelloWorldPerformanceTest" />
    </test>
    <!-- Add module-level post processor MetricFilePostProcessor -->
    <metric_post_processor class="com.android.tradefed.postprocessor.MetricFilePostProcessor">
        <option name="aggregate-similar-tests" value="true" />
        <option name="enable-per-test-log" value="false" />
    </metric_post_processor>
</configuration>