Как генерировать ссылки на ссылку android Classes в javadoc?
Когда я генерирую javadoc для своего проекта Android в Eclipse, существует много предупреждений как
cannot find symbol
symbol : class TextView
и
warning - Tag @see: reference not found: android.app.Dialog
Я также попробовал
-link http://developer.android.com/reference/
-link http://java.sun.com/j2se/1.4.2/docs/api/
в Extra javadoc options (path names with white spaces must be enclosed in quotes) вкладка в Configure Javadoc Arguments (3-е диалоговое окно затмения-> проект-> Генерирует Javadoc).
Но только -link http://java.sun.com/j2se/1.4.2/docs/api/ работает т.е. на ссылку Строкового класса http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html?is-external=true сгенерирован. но для android.app.Dialog , никакая ссылка не сгенерирована.
Править
Я также пытался выбрать android.jar в Select referenced archives and projects to which links should be generated вкладка в Configure Javadoc arguments for standard doclet (2-е диалоговое окно затмения-> проект-> Генерирует Javadoc), но это создает локальные ссылки на документы в локальном каталоге андроида-sdk, НЕ, ссылки Android онлайн как он делают для API Java.
1 ответ
Javadoc полагается на файл с именем package-list , чтобы определить, какие пакеты Java задокументированы под данным каталогом. По какой-то причине такой файл отсутствует для http://d.android.com/reference/ , поэтому "наивный" подход с
-link http://d.android.com/reference/
не работает - вы получите предупреждение о том, что список пакетов не может быть получен и ссылки на ваши документы не создаются. (Примечание: флажки в этом диалоговом окне 2-го затмения просто собирают для вас параметры -ссылка , так что на самом деле это не имеет никакого значения)
Однако Javadoc предлагает -linkoffline параметр, чтобы иметь возможность точно настроить эту ситуацию: вы хотите сделать ссылку на какую-либо другую документацию Javadoc в Интернете, но вы не можете получить к ней доступ во время создания ваших собственных документов. Вот как это работает: в то время как -link принимает только один параметр (URL-адрес документов JavaDoc, на которые вы хотите создать ссылку), -linkoffline принимает второй параметр.Это расположение файла списка пакетов !
Таким образом, чтобы создать ссылку на интерактивную справочную документацию Android, вы должны не устанавливать какие-либо флажки во втором диалоговом окне затмения, а вместо этого добавить
-linkoffline http://d.android.com/reference file:/C:/pathtoyour/android-sdk-windows/docs/reference
в Дополнительные параметры Javadoc в 3-й диалог. Таким образом, вы используете список пакетов ваших локально установленных документов Android, но ссылки в созданном вами документе Javadoc все равно будут указывать на онлайн-версию.
Надеюсь, это поможет!