Netbeans 11.3 "Невозможно выполнить шоу Javado c здесь" - PullRequest
1 голос
/ 13 апреля 2020

Отображение Javado c для стандартных библиотек (java .base, ...) в моей установке работает нормально.

Но включение Javado c для дополнительных библиотек не всегда выполняется. Я ищу подсказку, что можно сделать, чтобы решить эту проблему или получить дополнительные выходные данные для root причины этой проблемы.

У меня есть следующий исходный код:

import com.fazecast.jSerialComm.SerialPort;

public class JavaTestAoolication {
    public static void main(String[] args) {
        SerialPort.getCommPorts();
    }
}

Я пытаюсь добавить javado c путь к этой библиотеке через меню Инструменты -> Java Платформы и вкладка javado c.

Это приводит к в следующих записях в файле конфигурации netbeans ~/.netbeans/11.3/config/Services/Platforms/org-netbeans-api-java-Platform/default_platform.xml

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE platform PUBLIC "-//NetBeans//DTD Java PlatformDefinition 1.0//EN" "http://www.netbeans.org/dtds/java-platformdefinition-1_0.dtd">
<platform default="yes" name="JDK 11 (Default)">
    <properties>
        <property name="platform.ant.name" value="default_platform"/>
    </properties>
    <javadoc>
...
        <resource>https://fazecast.github.io/jSerialComm/javadoc/</resource>
        <resource>file:/usr/share/htl-libjserialcomm-java/2.6.1/javadoc/api/</resource>
...
   </javadoc>
</platform>

Выбор контекстного меню -> Показать Javado c on SerialPort.getCommPorts() всегда приводит к сообщению:
Невозможно выполнить шоу Javado c здесь .

Но ссылка существует:
https://fazecast.github.io/jSerialComm/javadoc/com/fazecast/jSerialComm/SerialPort.html

А также существует локальная папка (без символов c ссылки):

$ ls -la /usr/share/htl-libjserialcomm-java/2.6.1/javadoc/api/com/fazecast/jSerialComm/SerialPort.html 
-rw-r--r-- 1 user user 115981 Apr  9 17:02 /usr/share/htl-libjserialcomm-java/2.6.1/javadoc/api/com/fazecast/jSerialComm/SerialPort.html

Я также пытаюсь использовать file:// вместо file:/. Безуспешно.

Есть идеи, как решить эту проблему?

Ответы [ 2 ]

1 голос
/ 13 апреля 2020

TLDR: у меня были похожие проблемы с вами, но есть довольно простой обходной путь:

  • Загрузите и распакуйте исходный код кода Fazecast.
  • В NetBeans Используйте Инструменты> Диспетчер библиотек для ссылки на локально разархивированный источник.

Вот подробности:

  • Go до https://fazecast.github.io/jSerialComm/ и выберите вариант загрузки zip-файла, как показано в правом верхнем углу экрана.
  • Загруженный файл называется Fazecast-jSerialComm-v2.6.1-0-gf3d1e89.zip . Распакуйте это. Исходные файлы *.java для проекта будут находиться в разархивированном каталоге ...\Fazecast-jSerialComm-v2.6.1-0-gf3d1e89\Fazecast-jSerialComm-f3d1e89\src\main\java\com\fazecast\jSerialComm.
  • . В NetBeans выберите Инструменты> Диспетчер библиотек , затем нажмите Новая библиотека ... создать запись для Fazecast . Затем для этой новой записи:
    • Перейдите на вкладку Classpath и нажмите кнопку Добавить JAR / папку ... и перейдите к загрузке jSerialComm-2.6.1.jar .
    • Перейдите на вкладку Sources и перейдите к родительскому каталогу пакета com.fazecast в разархивированном исходном каталоге. В моем случае это было D:\Downloads\FazecastJSerialComm\Fazecast-jSerialComm-v2.6.1-0-gf3d1e89\Fazecast-jSerialComm-f3d1e89\src\main\java
    • Это нелогично, но вам не нужно ничего вводить на вкладке Javado c!

Как только вы это сделаете, закройте и снова откройте исходный файл, который вызывает методы Fazecast, и javado c должен работать. Вот пример для SerialPort.getCommPorts(), где я вставил HELLO WORLD!!! в javado c этого метода, чтобы продемонстрировать, что к локальному источнику обращались:

FazecastJavadoc

Примечания:

  • Моя среда была Windows 10, NetBeans 11.3 и JDK 14, и я создал простой проект Ant.
  • Вы можете открыть отчет о проблеме с Fazecast по вопросу невозможности доступа к онлайн-документам Javadocs из NetBeans, поскольку я не думаю, что это проблема NetBeans. Вы также можете попросить их предоставить загружаемый файл javado c для jSerialComm.
  • Дополнительным преимуществом связи с источником Fazecast в NetBeans является то, что вы можете открыть их код, щелкнув значок Открыть исходный код в редакторе в окне javado c, как показано в снимок экрана выше. Перемещение> Go к источнику или CTRL + Shift + B также работают, если курсор находится на методе Fazecast.
0 голосов
/ 13 апреля 2020

Если вы используете проект Maven, то есть действительно хорошая функция. После добавления библиотеки в pom. xml, go дерево проекта найдите свою библиотеку, щелкните правой кнопкой мыши -> Загрузить Javado c.

enter image description here

И это все! Больше никаких хлопот.

enter image description here

...