Как установить пакет совместимости javadoc для Android? - PullRequest
17 голосов
/ 20 декабря 2011

Как сгенерировать пользовательский пакет совместимости для Javadoc для Android 1.4?

Справочные документы доступны в Интернете ( пример ), но есть ли место, где я могу получить почтовый индекс с Javadoc, доступным в автономном режиме?

Полагаю, использовать javadoc было бы довольно просто, просто установить местоположение javadoc для jar совместимости.

Ответы [ 6 ]

28 голосов
/ 23 декабря 2011

Вы можете создать свой Javadoc в автономном режиме самостоятельно из исходного кода. Просто перейдите в каталог Android SDK и выполните следующие действия

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

Это сгенерирует ваши javadoc для вас локально в каталоге docs, который вы только что создали.

Затем в своем проекте eclipse android перейдите в свойства своего проекта, где вы добавили android-support-v4.jar, отредактируйте его свойства и добавьте путь к только что созданному javadoc.

Это должно сработать!

ADT 17+ выпусков:

Как указали некоторые из вас. Возникли проблемы с получением Eclipse для просмотра прилагаемого javadoc для ADT 17+. Это известная проблема, и ошибка была подана. Это не связано с тем, как вы генерируете Javadoc (как я описал выше), скорее это проблема интеграции ADT 17+ с Eclipse. Кто-то описал обходной путь, и его можно использовать здесь:

http://code.google.com/p/android/issues/detail?id=28801

12 голосов
/ 29 мая 2012

Проблема: Если android-support-v4.jar находится в папке /libs (в соответствии с требованиями ADT 17+), Javadoc недоступен.


Редактировать : я решил эту проблему, связав автономную версию Android Javadoc с android-support-v4.jar.Насколько я знаю, до сих пор невозможно связать онлайн-версию (http://developer.android.com/reference). Шаги:

  1. Скачать документацию для Android SDK из SDK Manager. Вы можете найти ее подпоследняя версия Android (4.1)
  2. Свяжите папку javadoc с папкой вашего проекта, в Windows откройте консоль и введите: MKLINK /J {PROJECT_PATH}\android_docs {SDK_PATH}\docs\reference
  3. Создайте файл libs/android-support-v4.jar.properties с этим содержимым:

    src=android-support-v4.jar
    doc=../android_docs
    
  4. Закройте проект и снова откройте его. Очистите при необходимости.

  5. Javadoc связан. Проверьте его, перейдя в любой класс библиотеки поддержки., как android.support.v4.app.FragmentActivity

Благодаря этому ответу https://stackoverflow.com/a/11579339/933261

2 голосов
/ 12 ноября 2012

Если вы находитесь в 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

закройте проект и откройте, и у меня все работает.

2 голосов
/ 25 декабря 2011

Ответ @wnafee точен, но если вы используете Linux, не забудьте использовать символ прямой косой черты в этом месте, например src/java.

1 голос
/ 03 июля 2013

Я создал это на основе ответа wnafee: https://dl.dropboxusercontent.com/u/31272696/android-support-v4.zip

0 голосов
/ 04 января 2013

Я прошел через все эти решения, и ни одно из них не сработало. Вот что я сделал, чтобы заставить его работать:

  1. Перейдите в следующую папку: D: \\ Android-SDK \ андроид-СДК-окна \ Extras \ Android \ поддержка \ v4

  2. Запустите команду: javadoc -d docs -sourcepath src \ java -subpackages android.support.v4

  3. В каталоге libs вашего проекта создайте файл с именем android-support-v4.jar.properties

  4. В файле свойств добавьте следующие строки (измените путь в соответствии с вашим):

    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

  5. В Eclipse откройте диалоговое окно свойств для сборки, затем перейдите к пути сборки Java и выберите вкладку Библиотеки.

  6. Расширить библиотеку поддержки. В моем случае путь таков: D: \ Program Files \ Android-SDK \ android-sdk-windows \ extras \ android \ support \ v4

  7. Выберите местоположение Javadoc. Нажмите на кнопку «Редактировать» и затем выберите путь к документам. В моем случае это было: file: / D: / Program Files / Android-SDK / android-sdk-windows / extras / android / support / v4 / docs /

  8. Закройте все, включая Eclipse и перезапустите. Теперь вы можете просматривать документы в своем коде.

...