เขียนการทดสอบที่ขับเคลื่อนด้วยโฮสต์ใน Trade Federation

หน้านี้อธิบายวิธีเขียนการทดสอบอุปกรณ์สไตล์ JUnit4 ที่ขับเคลื่อนโดยโฮสต์ ซึ่งหมายความว่าด้านโฮสต์ของสายรัดจะเรียกใช้การดำเนินการกับอุปกรณ์

โปรดทราบว่าเราถือว่าการทดสอบ "ฝั่งโฮสต์" และการทดสอบ "โฮสต์ขับเคลื่อน" แตกต่างกันเล็กน้อย:

  • การทดสอบที่ขับเคลื่อนด้วยโฮสต์: เป็นการทดสอบที่ทำงานบนโฮสต์ที่โต้ตอบกับอุปกรณ์ตั้งแต่หนึ่งเครื่องขึ้นไป ระบบภายใต้การทดสอบ (SUT) ไม่ได้อยู่บนโฮสต์เอง แต่กำลังถูกทดสอบจากโฮสต์
  • การทดสอบฝั่งโฮสต์: เป็นการทดสอบที่ทำงานบนโฮสต์เท่านั้นและทดสอบบางอย่างบนโฮสต์เท่านั้น เช่น การทดสอบหน่วย

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

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

การทดสอบที่ขับเคลื่อนด้วยโฮสต์ยังสามารถขับเคลื่อนขั้นตอนการตั้งค่าเพิ่มเติมที่ต้องมีการโต้ตอบกับอุปกรณ์ภายนอกซึ่งขึ้นอยู่กับการทดสอบ

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

การทดสอบที่ขับเคลื่อนด้วยโฮสต์เขียนใน TF อย่างไร

นี่คือตัวอย่าง:

@RunWith(DeviceJUnit4ClassRunner.class)
public class SampleHostJUnit4DeviceTest extends BaseHostJUnit4Test {
    @Before
    public void setUp() throws Exception {
       // Some setup
    }

    @Test
    public void testCheckWeHaveDevice() throws Exception {
        Assert.assertNotNull(getDevice());
    }
}

การทดสอบที่ขับเคลื่อนด้วยโฮสต์ใน Trade Federation นั้นขับเคลื่อนโดยตัวรันทดสอบ DeviceJUnit4ClassRunner JUnit4 โครงสร้างโดยรวมของคลาสทดสอบเหมือนกับการทดสอบ JUnit4 ปกติ:

  • @BeforeClass
  • @Before
  • @Test
  • @After
  • @AfterClass
  • Assume Assert

การขยาย BaseHostJunit4Test เป็นวิธีการสืบทอด API ยูทิลิตี้การทดสอบที่มีประโยชน์ เช่น:

  • installPackage : อนุญาตให้ติดตั้ง APK บนอุปกรณ์เป้าหมาย
  • installPackageAsUser : อนุญาตให้ติดตั้ง APK ในฐานะผู้ใช้บนอุปกรณ์เป้าหมาย
  • uninstallPackage : อนุญาตให้ถอนการติดตั้ง APK
  • isPackageInstalled : ตรวจสอบว่ามีการติดตั้งแพ็คเกจหรือไม่
  • hasDeviceFeature : ตรวจสอบว่าอุปกรณ์รองรับคุณสมบัติหรือไม่ ( pm list features )
  • runDeviceTests(DeviceTestRunOptions options) : เรียกใช้การทดสอบเครื่องมือกับอุปกรณ์เป้าหมายโดยใช้ DeviceTestRunOptions เพื่อจัดการกับตัวเลือกที่เป็นไปได้ทั้งหมด

ให้การเข้าถึงวัตถุอุปกรณ์ Tradefed ด้วย:

  • getDevice() : ส่งคืนวัตถุอุปกรณ์ TF เพื่อจัดการอุปกรณ์
  • getBuild() : ส่งคืนวัตถุ TF ข้อมูลการสร้างเพื่อรับข้อมูลเกี่ยวกับการสร้าง
  • getAbi() : ส่งคืน ABI ที่การทดสอบกำลังทำงานอยู่

การสนับสนุนการแลกเปลี่ยน: การเตรียมอุปกรณ์ต่อคลาสและการทำความสะอาด

JUnit4 @BeforeClass และ @AfterClass ใช้ได้กับเมธอดแบบสแตติกเท่านั้น ซึ่งทำให้ไม่สามารถใช้ตัวจัดการ #getDevice() เพื่อตั้งค่าเฉพาะอุปกรณ์ ครั้งเดียว ต่อคลาส หรือล้างข้อมูล เพื่อแก้ปัญหานี้ ให้ใช้หมายเหตุประกอบ Tradefed

  • @BeforeClassWithInfo: ทำงานก่อนคำอธิบายประกอบ @BeforeClass
  • @AfterClassWithInfo: ทำงานหลังจากคำอธิบายประกอบ @AfterClass
   @BeforeClassWithInfo
   public static void beforeClassWithDevice(TestInformation testInfo) {
       assertNotNull(testInfo.getDevice());
       testInfo.properties().put("mytest:test-prop", "test");
   }

   @AfterClassWithInfo
   public static void afterClassWithDevice(TestInformation testInfo) {
       assertNotNull(testInfo.getDevice());
       testInfo.properties().put("mytest:test-prop", "test");
   }

TestInformation อนุญาตให้คุณใช้คุณสมบัติอุปกรณ์และร้านค้าที่สามารถใช้ได้ทั้งในขอบเขตแบบคงที่หรือไม่คงที่ BaseHostJUnit4Test รองรับการรับ TestInformation ในขอบเขตที่ไม่คงที่ผ่าน #getTestInformation()

หากคุณไม่ได้ขยาย BaseHostJUnit4Test คุณสามารถใช้ ITestInformationReceiver เพื่อรับวัตถุ TestInformation

จะกำหนดค่าการทดสอบที่ขับเคลื่อนด้วยโฮสต์ใน Tradefed ได้อย่างไร

ในไฟล์คอนฟิกูเรชัน Tradefed XML การทดสอบที่ขับเคลื่อนโดยโฮสต์จะดำเนินการผ่านตัวเรียกใช้ HostTest

<test class="com.android.tradefed.testtype.HostTest" >
    <option name="class" value="android.sample.cts.SampleHostJUnit4DeviceTest" />
</test>