Какие файлы проектов NetBeans должны войти в исходный контроль?

Question

Обычно мы используем Eclipse для конкретного Java-проекта, но недавно я импортировал проект в NetBeans, чтобы использовать его функции построения диалога.

Поскольку я, вероятно, вернусь к этому, я хотел сохранить файлы проекта NetBeans в контроле версий. Однако я не хочу фиксировать файлы, которые являются «моими» или «проектами», то есть файлы с моими собственными настройками, которые конфликтуют с другим пользователем.

NetBeans создали следующую структуру в проектной зоне верхнего уровня:.

nbbuild 
nb-build.xml 
nbproject 
    <various files> 
    configs 
    private 

Ясно nbbuild является построить выход, так что не будет идти в файл nb-build.xml кажется вероятным, как это делает большинство nbproject. Однако nbproject/private предполагает, что это «мое». Подглядывание в «configs», мне непонятно, если это мой или проект ...

У кого-нибудь есть рекомендации?

Answer 1

NetBeans knowledge base article on project files & version control обсуждает файлы проекта NetBeans, без лишних советов о том, какие файлы имеют конкретный проект (т. Е. Можно использовать с помощью контроля версий) и которые являются специфичными для пользователя.

Вот раздел о системе управления версиями:

Если проект извлечен из системы контроля версий, то build (или nbbuild), dist (или nbdist), а nbproject/private папки не должно быть проверяется в этой системе контроля версий.

Если проект находится под системами контроля версий CVS, Subversion или Mercurial, соответствующие файлы «игнорировать» создаются или обновляются для этих каталогов при импорте проекта.

Хотя nbproject/private следует игнорировать, nbproject следует проверить в системе контроля версий. nbproject содержит метаданные проекта, которые позволяют другим пользователям открывать проект в NetBeans без необходимости импорта проекта в первую очередь.

Answer 2

Отсутствует.

Исходные файлы, скрипты сборки и документация, которые не генерируются автоматически (например, - вывод таких инструментов, как JavaDoc и Doxygen), должны быть проверены в репозитории. Такие вещи, как файлы проекта, двоичные файлы и сгенерированная документация, не должны быть проверены.

Причина в двух вариантах. Во-первых, вы не хотите перезаписывать настройки проекта другого разработчика самостоятельно. Во-вторых, другие разработчики могут не использовать те же IDE, что и вы (или даже IDE вообще), поэтому не давайте им больше, чем нужно для их создания (проект или связанная с ним документация) или запускать проект.

Answer 3

Оказалось, что оба Томаса & Petercardona являются правильными, в некотором роде. NetBeans рекомендует импортировать только исходный код и/или документацию. Ох и папка nbproject, но не папки * nbproject/private **.

От NetBeans Knowledge Base article on importing Eclipse projects:

Вопросы контроля версий

Если проект извлечен из системы управления версии, сборки (или nbbuild), расстояние (или nbdist), и nbproject/private папки не должны быть проверены в этой системе управления версиями .

Если проект находится под CVS, Subversion или Mercurial системы контроля версий , соответствующие файлы «игнорирующие» созданы или обновлены для этих каталогов, когда проект импортируется.

Хотя nbproject/частные должны быть игнорироваться, nbproject должны быть проверены в систему управления версиями. nbproject содержит метаданные проекта, которые позволяют другим пользователям открывать проект в NetBeans без необходимости импортировать проект в первую очередь.

Answer 4

В протестирована с Netbeans 6.8, только project.xml, configurations.xml и основной Makefile (настраиваемый один в родительской директории в 'nbproject' директории, с определениями до/после целевых) должны быть распределены через хранилище. Все остальные файлы будут автоматически (повторно) созданы Netbeans (Makefile-impl.ml, Makefile-variables.ml, все Makefile-$CONF, Package-$CONF.bash). Очевидно, что «частный» дир должен быть проигнорирован.