Как встроить Javadoc в банку для Netbeans

Можно ли автоматически вставлять javadoc в банку из NetBeans? В программе есть возможность генерировать javadoc. Это создает готовый веб-сайт, созданный из существующего javadoc в вашем проекте. Существует также возможность присоединить javadoc к проекту или банке, чтобы он отображался в предложениях. Прямо сейчас, когда я нажимаю build, а затем беру банку и добавляю ее в проект на другом компьютере, javadoc для jar не появляется. Я должен вручную скопировать его на компьютер и прикрепить его, что кажется излишним, когда я просто должен быть подключен автоматически.Как встроить Javadoc в банку для Netbeans

Что я пробовал:

Использование «Очистить и построить» и просто «Построить»
Экспорт всю DIST папку, а не только банки.
Ввод javadoc внутри банки.

источник

2015-11-05 Dan

Вы должны были бы изменить build.xml, чтобы обеспечить эту функциональность. Существует файл [javadoc'] (https://ant.apache.org/manual/Tasks/javadoc.html), который можно использовать для создания документов. – MadProgrammer

@MadProgrammer. Как мне это сделать? Я просматриваю вкладку сборки в свойствах проекта, и я не вижу ничего, связанного с javadoc. У меня также есть файл build.xml, но я не знаю, что положить в javadoc. – Dan

Нет, вам нужно зайти на вкладку «Файлы» (рядом со вкладкой «Проекты»), расходуйте узел проекта, и вы увидите файл 'build.xml', вы можете открыть его (в Netbeans), и вы необходимо добавить к нему свои изменения. Это немного информации, доступной там с некоторыми идеями о том, как изменить процесс сборки. – MadProgrammer

Предполагая, что вы используете на основе Ant по умолчанию Netbeans проект на, вам нужно будет изменить проектов, build.xml файл включает генерацию JavaDocs и скопировать полученные файлы в build.classes.dir, чтобы они могли быть Jar'ed

Start, нажав на вкладке Files, рядом с вкладкой Projects разверните узел проекта и вы увидите файл build.xml в корневом каталоге

Далее вам нужно добавить некоторые функции в процесс сборки, между обработкой компиляции и jar. Чтение информации внутри build.xml, цель -post-compile, вероятно, является местом, которое мы хотим начать.

После чтения из the javadoc ant task documentation, я добавил это к моему build.xml

<target name="-post-compile"> 
     <javadoc 
      sourcepath="src" 
      defaultexcludes="yes" 
      destdir="javadocs" 
      author="true" 
      version="true" 
      use="true" 
      windowtitle="The name of your API" 
     > 
      <doctitle><![CDATA[<h1>My API</h1>]]></doctitle> 
      <bottom><![CDATA[<i>Copyright &#169; 2000 Dummy Corp. All Rights Reserved.</i>]]></bottom> 
      <tag name="todo" scope="all" description="To do:"/> 
      <link offline="true" href="http://docs.oracle.com/javase/8/docs/api/" packagelistLoc="C:\tmp"/> 
      <link href="http://docs.oracle.com/javase/8/docs/api/"/>     
     </javadoc> 
     <copydir src="javadocs" dest="${build.classes.dir}/javadocs"/> 
    </target>

Итак, я поместил это непосредственно под <import file="nbproject/build-impl.xml"/> в файле build.xml, но это размещение должно иметь значения.

Это вызвало банку файл с javadocs директории (и Javadocs), включенных в это

источник

2015-11-05 23:25:48 MadProgrammer

Извините, я немного смущен. Должно ли это быть в 'build-impl.xml' в' nbproject' или 'build.xml' в папке проекта? – Dan

Как я уже сказал, * «Я добавил это в свой' build.xml' * *, build-impl.xml автоматически генерируется netbeans, и вы не должны его изменять – MadProgrammer

К сожалению, изображение вводит в заблуждение, я буду стараться обновить его – MadProgrammer

Как встроить Javadoc в банку для Netbeans

ответ

Смежные вопросы