Как создать пользовательский javadoc для пакета совместимости для Android версии 2.5?
Справочные документы доступны в Интернете (пример), но есть ли какое-то место, где я могу получить zip с javadoc, доступным в автономном режиме?
Я полагаю, что использование javadoc было бы довольно простым, просто вопрос настройки местоположения javadoc для баннера совместимости.
Вы можете самостоятельно создать свой javadoc автономно из исходного кода. Просто перейдите в свой каталог sdk android и выполните следующие действия
cd <path_to_android_sdk>/extras/android/compatibility/v4/
mkdir docs
Для Windows:
javadoc -d docs -sourcepath src\java -subpackages android.support.v4
Для Linux/Mac:
javadoc -d docs -sourcepath src/java -subpackages android.support.v4
Это создаст ваши javadocs для вас локально в каталоге docs, который вы только что создали.
Затем в проекте eclipse android перейдите к своим свойствам проекта, где вы добавили свой android-support-v4.jar, отредактировали его свойства и добавили путь к только что созданному javadocs.
Это должно сработать!
Проблемы с ADT 17+:
Как некоторые из вас указали. Были проблемы с Eclipse, чтобы увидеть прикрепленный javadoc для ADT 17+. Это известная проблема, и ошибка была подана. Это не связано с тем, как вы создаете javadoc (как я описал выше), скорее это проблема с интеграцией ADT 17+ с Eclipse. Кто-то описал обходное решение, и здесь можно следовать:
Проблема: Если android-support-v4.jar находится в папке /libs (как требуется ADT 17+), javadoc недоступен.
Изменить. Я решил проблему, связав автономную версию андроида javadoc с андроид-поддержкой-v4.jar. Насколько мне известно, по-прежнему невозможно связать онлайн-версию (http://developer.android.com/reference). Шаги:
MKLINK /J {PROJECT_PATH}\android_docs {SDK_PATH}\docs\referenceСоздайте файл libs/android-support-v4.jar.properties с этим контентом:
src=android-support-v4.jar
doc=../android_docs
Закройте проект и откройте его снова. При необходимости очистите.
Благодаря этому ответу fooobar.com/questions/27625/...
Ответ от @wnafee на месте, но если вы используете Linux, не забудьте использовать символ косой черты в этом месте, например src/java.
ЕСЛИ ВЫ НА WINDOWS и застряли на века, как я, убедитесь, что вы избегаете своих задворков в файле свойств, или все будет терпеть неудачу. (тем не менее, кто делает молчащих неудачных погрузчиков...)
Это мой файл свойств:
src=android-support-v4.jar
doc=doc\\android-support-v4_doc
и мой каталог выглядит следующим образом:
android-support-v4.docs.zip
android-support-v4.jar
android-support-v4.jar.properties
doc
закрыть проект и открыть, и все это работает для меня.
Я создал этот, основанный на ответе wnafee: https://dl.dropboxusercontent.com/u/31272696/android-support-v4.zip
Я прошел все эти решения, и никто из них не работал. Вот что я сделал, чтобы заставить его работать:
Перейдите к следующей папке: D:\\Android-SDK\андроид-СДК-окна\Extras\Android\поддержка\v4
Запустите команду: javadoc -d docs -sourcepath src\java -subpackages android.support.v4
В каталоге проекта libs создайте файл под названием android-support-v4.jar.properties
В файле свойств добавьте следующие строки (измените путь в соответствии с вашим):
doc = D:\Program Files\Android-SDK\android-sdk-windows\extras\android\support\v4\docs src= D:\Program Files\Android-SDK\android-sdk-windows\extras\android\support\v4\src
В Eclipse вызовите диалоговое окно свойств для сборки, затем перейдите к пути сборки Java и выберите вкладку "Библиотеки".
Разверните библиотеку поддержки. В моем случае путь: D:\Program Files\Android-SDK\android-sdk-windows\extras\android\support\v4
Выберите местоположение Javadoc. Нажмите кнопку "Изменить", а затем выберите путь к документам. В моем случае это было: file:/D:/Program Files/Android-SDK/android-sdk-windows/extras/android/support/v4/docs/
Закройте все, включая Eclipse и перезапустите. Теперь вы сможете просматривать документы в своем коде.