2 tháng 10, 2010

Create javadoc by using Ant

Ngoài cách tạo trực tiếp javadoc bằng command line, có thể tạo javadoc thông qua Ant tích hợp trong Netbeans.

Trong Netbeans đã cung cấp sẵn chức năng tạo javadocs trong Ant, tuy nhiên chức năng này đối với tôi có khá nhiều bất tiện. Đó là không nén javadocs thành file zip, để chung docs cùng với các file jar (thư mục dist) dẫn đến mỗi lần clean & build là lại phải tạo docs lại. Đoạn code dưới đây có thể khắc phục các nhược điểm đó
Mở file build.xml bằng Netbeans, tìm đến đoạn javadocs và thay bằng đoạn code sau:

<target depends="init,-javadoc-build" description="Build Javadoc." name="javadoc">

<zip destfile="dist/javadoc.zip" basedir="dist/javadoc"/>

<mkdir dir="javadocs"/>

<move todir="javadocs">

<fileset dir="dist">

<filename name="javadoc.zip"/>

</fileset>

</move>

<delete dir="dist/javadoc"/>

</target>

Sau đó mỗi lần muốn tạo javadocs thì trong project window của Netbeans, click chuột phải vào project muốn tạo và chọn Generate Javadocs là được. File docs có tên là javadoc.zip và lưu trong thư mục javadocs/

Không có nhận xét nào:

Đăng nhận xét