จุดประสงค์ของคำอธิบายประกอบ @SmallTest, @MediumTest และ @LargeTest ใน Android คืออะไร

ฉันเพิ่งเคยใช้ Android และเคยเห็นโค้ดตัวอย่างที่ใช้คำอธิบายประกอบเหล่านี้ ตัวอย่างเช่น:

@SmallTest
public void testStuff() {
    TouchUtils.tapView(this, anEditTextView);
    sendKeys("H E L P SPACE M E PERIOD");
    assertEquals("help me.", anEditTextView.getText().toString());
}

คำอธิบายประกอบนั้นทำอะไรได้บ้าง?

นอกเหนือจากคำตอบของ Davidannและคำถามส่วนใหญ่ของ OPในความคิดเห็น:

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

คุณสามารถเรียกใช้กลุ่มการทดสอบที่มีคำอธิบายประกอบเฉพาะ

จากเอกสาร AndroidJUnitRunner :

การรันขนาดการทดสอบเฉพาะเช่นคำอธิบายประกอบด้วยSmallTestหรือMediumTestหรือLargeTest :

adb shell นเครื่องดนตรี -w -e ขนาด [เล็ก | กลาง | ใหญ่] com.android.foo/android.support.test.runner.AndroidJUnitRunner

คุณยังสามารถตั้งค่าพารามิเตอร์เหล่านี้ผ่านการไล่ระดับสี:

    android {
        ...
        defaultConfig {
            ...
            testInstrumentationRunnerArgument 'size', 'Large'
        }
    }

ผ่าน gradle:

-Pandroid.testInstrumentationRunnerArguments.size=small

ดูโพสต์บล็อก Doug Stevensonรวมถึงโพสต์บล็อกนี้สำหรับรายละเอียดเพิ่มเติม

บล็อกโพสต์นี้อธิบายได้ดีที่สุด โดยทั่วไปมีดังต่อไปนี้:

1. เล็ก: การทดสอบนี้ไม่โต้ตอบกับระบบไฟล์หรือเครือข่ายใด ๆ
2. สื่อ: เข้าถึงระบบไฟล์ในกล่องซึ่งกำลังเรียกใช้การทดสอบ
3. ใหญ่: เข้าถึงระบบไฟล์ภายนอกเครือข่าย ฯลฯ

ตามบล็อกนักพัฒนา Androidการทดสอบขนาดเล็กควรใช้เวลา <100ms การทดสอบปานกลาง <2 วินาทีและการทดสอบขนาดใหญ่ <120 วินาที

ดูหน้านี้ (ค้นหา "@SmallTest") เกี่ยวกับวิธีระบุว่าจะเรียกใช้การทดสอบใด

คุณยังสามารถใส่คำอธิบายประกอบการทดสอบหน่วย POJO ด้วย@Category(MediumTest.class)หรือ@Category(LargeTest.class)ฯลฯ โดยการกำหนดหมวดหมู่ของคุณเอง- ดูตัวอย่าง repo หมวดหมู่การทดสอบ