Ответ 1
Javadocs действительно должен распространяться с клиентскими библиотеками. У нас есть открытая проблема в Google, но у меня нет временных рамок, когда будет доступно соответствующее решение. Однако я могу дать вам обходное решение, которое вы можете применить к своему проекту. Это не отличное решение, но это что-то.
На моей операционной системе OSX установлен Android SDK:
/Users/[myusername]/Library/Android/sdk
И локальная копия для Play Services и javaad firebase здесь (ваша может отличаться):
/Users/[myusername]/Library/Android/sdk/extras/google/google_play_services/docs/reference/
Фактически вы можете подключить этот путь к клиентским библиотекам Firebase в Android Studio с помощью этой процедуры:
- Найдите библиотеки клиентов Firebase/Play в представлении проекта в разделе "Внешние библиотеки".
- Щелкните правой кнопкой мыши тот, который вас больше всего интересует, увидев javadoc. Например, для базы данных Firebase Realtime вы можете использовать "firebase-database-9.2.0".
- В контекстном меню щелкните Свойства библиотеки внизу.
- В окне "Свойства библиотеки" есть кнопка со знаком+. Нажмите на нее. Это позволяет подключить путь javadoc к классам в этой библиотеке.
- Переместите/Вставьте свой путь javadoc сверху в диалог.
- В следующем диалоговом окне скажите "JavaDocs".
Теперь, когда вы вызываете javadoc для классов в этой библиотеке, вы увидите это. Однако вам нужно будет сделать это для каждой библиотеки, где вы хотите javadoc.
Если у вас нет локальных javadocs, установленных по какой-либо причине, вы можете прикрепить удаленный url для javadoc. Для этого используйте кнопку "плюс" с маленькой землей под ней и вставьте URL-адрес javadoc. Для Firebase, https://firebase.google.com/docs/reference/android и для Служб Службы, https://developers.google.com/android/reference/
Не стоит делать всю эту ручную работу, но, по крайней мере, вы получаете javadoc в своей среде разработки.
Если вы хотите написать script, чтобы прикрепить это для всего, что используете, знайте, что эта процедура существенно изменяет файлы в .idea/libraries. Вы можете довольно легко наблюдать XML-элемент javadoc, который изменяется, когда вы вносите изменения в среду IDE, и вы можете script/редактировать изменения там сами, если хотите.