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

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

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

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

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

หมายเหตุ: ดู การกำหนดค่า Tradefed 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 เนื่องจากจำเป็นต่อการทดสอบประสิทธิภาพ ตัวรวบรวมเมตริกระดับโมดูลและตัวประมวลผลหลังสามารถเป็นแบบเฉพาะของโมดูลได้ ไม่แนะนำให้ระบุ post-processor ทั้งในระดับบนสุดและระดับโมดูล

การกำหนดค่าโมดูลการทดสอบประสิทธิภาพจะต้องมีข้อมูลเมตา test-type ที่มีค่า performance เช่น: xml <option name="config-descriptor:metadata" key="test-type" value="performance" /> หากไม่มีสิ่งนี้ หากการทดสอบ config รวม 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>