Яка мета анотацій @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());
}

Що робить ця анотація?

Як доповнення до відповіді Давідана і головним чином до запитання ОП у коментарі:

У контексті наведеного вище коду, це на самому справі DO нічого , крім залишити записку для інших розробників? Чи це щось застосовує? Чи існують інструменти, які використовують цю анотацію? Яка це мета у розробці Android?

Ви можете запустити групу тестів, анотованих конкретною анотацією.

З документації AndroidJUnitRunner :

Запуск певного розміру тесту, тобто анотований за допомогою SmallTest або MediumTest або LargeTest :

adb shell am instrument -w -e розмір [малий | середній | великий] com.android.foo/android.support.test.runner.AndroidJUnitRunner

Ви також можете налаштувати ці параметри за допомогою gradle:

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

Через gradle:

-Pandroid.testInstrumentationRunnerArguments.size=small

Щоб дізнатися більше, перегляньте допис у блозі Дуга Стівенсона , а також цю публікацію .

Це повідомлення в блозі це найкраще пояснює. В основному це наступне:

1. Невеликий: цей тест не взаємодіє з жодною файловою системою чи мережею.
2. Середній: отримує доступ до файлових систем на коробці, в якій запущені тести.
3. Великий: доступ до зовнішніх файлових систем, мереж тощо.

Згідно з блогом розробників Android , невеликий тест повинен тривати <100 мс, середній - <2 с, великий - <120 с.

Перегляньте цю сторінку (шукайте "@SmallTest") про те, як вказати, які тести запускатимуться.

Ви також можете коментувати модульні тести POJO за допомогою @Category(MediumTest.class)або @Category(LargeTest.class)тощо, визначаючи власні категорії - див. Репо тестових категорій для прикладу