Các tệp dự án NetBeans nào nên đi vào kiểm soát nguồn?

Question

Chúng ta thường sử dụng Eclipse cho một dự án Java cụ thể, nhưng gần đây tôi đã nhập dự án vào NetBeans để sử dụng các tính năng xây dựng hộp thoại của nó.

Vì tôi có thể sẽ quay lại điều này, tôi muốn lưu trữ các tệp dự án NetBeans vào kiểm soát phiên bản. Tuy nhiên, tôi không muốn cam kết các tệp là "của tôi" so với "dự án", tức là các tệp có cài đặt của riêng tôi sẽ xung đột với người dùng khác.

NetBeans tạo cấu trúc sau đây trong vùng dự án cấp cao nhất:.

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

Rõ ràng nbbuild là xây dựng sản lượng, do đó sẽ không đi trong File nb-build.xml dường như có khả năng, cũng như hầu hết nbproject. Tuy nhiên, nbproject/private cho thấy đó là "của tôi". Nhìn trộm "configs", nó không rõ ràng với tôi nếu đó là của tôi hoặc dự án ...

Bất cứ ai cũng có một số hướng dẫn?

Answer 1

NetBeans knowledge base article on project files & version control thảo luận về tệp dự án NetBeans, với tư vấn lỏng lẻo về tệp nào là dự án cụ thể (tức là có thể được chia sẻ thông qua kiểm soát phiên bản) và người dùng cụ thể.

Đây là phần nói về kiểm soát phiên bản:

Nếu dự án được kiểm tra ra một hệ thống kiểm soát phiên bản, build (hoặc nbbuild), dist (hoặc nbdist), và nbproject/private thư mục không nên kiểm tra vào hệ thống điều khiển phiên bản đó.

Nếu dự án nằm trong hệ thống kiểm soát phiên bản CVS, Subversion hoặc Mercurial, các tệp "bỏ qua" thích hợp được tạo hoặc cập nhật cho các thư mục này khi dự án được nhập.

Mặc dù nbproject/private cần được bỏ qua, nbproject phải được kiểm tra trong hệ thống kiểm soát phiên bản. nbproject chứa siêu dữ liệu dự án cho phép người dùng khác mở dự án trong NetBeans mà không phải nhập dự án trước.

Answer 2

Không có.

Chỉ tệp nguồn, tập lệnh xây dựng và tài liệu không được tạo tự động (ví dụ: - đầu ra của các công cụ như JavaDoc và Doxygen) phải được kiểm tra vào kho lưu trữ. Không nên kiểm tra các tệp như dự án, tệp nhị phân và tài liệu đã tạo.

Lý do là hai lần. Trước tiên, bạn không muốn ghi đè cài đặt dự án của nhà phát triển khác bằng cài đặt của riêng bạn. Thứ hai, các nhà phát triển khác có thể không sử dụng cùng IDE như bạn (hoặc thậm chí là một IDE), vì vậy đừng cho họ nhiều hơn những gì họ cần để xây dựng (dự án hoặc tài liệu liên quan của nó) hoặc chạy dự án.

Answer 3

Nó chỉ ra rằng cả hai Thomas & Petercardona là chính xác, theo một cách. NetBeans khuyên bạn chỉ nên nhập mã nguồn và/hoặc tài liệu. Oh và thư mục nbproject nhưng không phải là thư mục * nbproject/private **.

Từ NetBeans Knowledge Base article on importing Eclipse projects:

cân nhắc điều khiển phiên bản

Nếu dự án được kiểm tra ra một hệ thống kiểm soát phiên bản , xây dựng (hoặc nbbuild), dist (hoặc nbdist), và không nên kiểm tra các thư mục nbproject/private vào hệ thống kiểm soát phiên bản đó.

Nếu dự án là thuộc CVS, Subversion, hoặc Mercurial hệ thống kiểm soát phiên bản , thích hợp "bỏ qua" các tập tin được tạo ra hoặc cập nhật cho các thư mục khi dự án được nhập khẩu.

Mặc dù nbproject/tin nên bỏ qua, nbproject nên được kiểm tra vào hệ thống kiểm soát phiên bản. nbproject chứa siêu dữ liệu dự án cho phép người dùng khác mở dự án trong NetBeans mà không cần phải nhập dự án trước.

Answer 4

Như thử nghiệm với Netbeans 6.8, chỉ project.xml, configurations.xml và makefile chính (một trong những tùy biến trong dir mẹ của 'nbproject' dir, với các định nghĩa trước/sau mục tiêu) phải được phân phối thông qua kho. Tất cả các tệp khác sẽ được tự động tạo lại bởi Netbeans (Makefile-impl.ml, Makefile-variables.ml, tất cả các Makefile-$CONF, Package-$CONF.bash). Các 'tư nhân' dir cũng nên được bỏ qua, rõ ràng.