Как посмотреть javadoc для аннотаций в Android SDK? - PullRequest
0 голосов
/ 19 августа 2010

В «Документации для Android SDK, API 8» в javadoc для класса android.test.InstrumentationTestRunner упоминаются параметры командной строки для «маленьких», «средних» и «больших» тестов без объяснения того, как можно определить тесты как быть тех размеров. Подсказка прибывает позже в описании в виде ссылки на аннотацию android.test.suitebuilder.annotation.LargeTest.

С тех пор я заметил, что Android определяет аннотации, которые Javadoc SDK скрывает от глаз. Например, страница javadoc android.test.suitebuilder вообще не упоминает пакет adroid.test.suitebuilder.annotation.

Мне не хватает базового предположения о том, как следует использовать SDK? Например, вопрос на Как получить затмение для отображения javadoc для аннотаций javax предлагает загрузить исходный код и позволить затмению генерировать (предположительно более полный) из него javadoc. Разве разработчики Android просматривали Javadoc из источника так долго, что не заметили неполный Javadoc в SDK?

И да, я заметил, что некоторые из исходных кодов javadoc содержат тег @hide, который, вероятно, заставляет генератор игнорировать его. Это кажется преднамеренным, который просил мой вопрос.

1 Ответ

0 голосов
/ 01 июля 2011
  1. Android SDK находится в стадии разработки с JavaDoc, который иногда бывает неполным.К счастью, мы можем смотреть прямо на открытый исходный код, когда это необходимо.
  2. Stackoverflow часто имеет ответы, которые заполняют пробелы в JavaDoc.

Это выглядит так же хорошо, как и получается.1007 *

...