Eclipse làm thế nào để liên kết một jar chứa javadocs / source với tệp nhị phân của nó?

80

Tôi muốn nhận xét javadoc có trong tệp jar hiển thị trong nhật thực khi tôi di chuột qua một lớp.

Ví dụ: sau khi tải xuống JODA-2.0, bạn nhận được ba lọ:

joda-time-2.0
joda-time-2.0-javadoc
joda-time-2.0-sources ( http://sourceforge.net/projects/joda-time/files/joda-time/2.0/joda-time-2.0-dist.zip/download )

Trong eclipse, [nhấp chuột phải vào dự án -> Thuộc tính -> Đường dẫn xây dựng Java -> Thư viện -> THÊM JAR ...] bao gồm tệp nhị phân trong dự án (có thể tham chiếu các lớp đó) cho joda-time-2.0.jar.

Nhưng làm cách nào tôi có thể liên kết trong các nguồn / nhận xét javadoc có trong hai tệp jar khác để khi tôi di chuột qua các lớp đó, tôi thấy javadocs?

Việc thêm hai lọ khác (joda-time-2.0-javadoc.jar và joda-time-2.0-sources.jar) vào đường dẫn xây dựng không liên kết javadocs hoặc nguồn.

— trái đất
nguồn

67

Bạn có thể thử CTRL + nhấp vào một lớp không có nguồn đính kèm (làm điều đó trong trình chỉnh sửa). Khi nó hiển thị cho bạn một số thông tin về lớp, bạn sẽ thấy nút hướng dẫn đính kèm hộp thoại nguồn. Nhấp vào nó và trong hộp thoại bật lên, hãy chọn vị trí nguồn / javadoc cho lớp của bạn.

Bạn cũng có thể làm điều đó từ cài đặt đường dẫn xây dựng dự án mà bạn đang đề cập: chọn tab thư viện, mở rộng thư viện (jar) bạn muốn và bạn sẽ được cung cấp để chọn: tệp đính kèm nguồn, tệp đính kèm javadoc, vị trí thư viện gốc, v.v. Bạn chỉ cần chọn bất cứ điều gì bạn muốn và chỉnh sửa cài đặt hiện tại của nó.

Hoặc bạn có thể làm như @JB Nizet đã nói ...

— draganstankovic
nguồn

8

Sự khác biệt giữa đính kèm nguồn và đính kèm javadoc là gì?

— Pacerier

Nguồn @Pacerier chứa mã nguồn chương trình, trong đó javadoc chứa tài liệu và nhận xét giải thích chức năng của chương trình.

— Stevoisiak

1

Tôi nhận được thông báo "The JAR file lớp này thuộc về thùng chứa 'thư viện Android Private' Mà không cho phép sửa đổi file đính kèm nguồn trên mục của nó

— Radon8472

70

Nhấp chuột phải vào dự án -> Đường dẫn xây dựng -> Định cấu hình đường dẫn xây dựng
Trong cửa sổ mới, chuyển đến tab "Thư viện".
Chọn thư viện và mở rộng nó.
Có 4 lựa chọn trẻ em. Chọn "Vị trí Javadoc" và nhấp vào nút "Chỉnh sửa" ở bên phải.
Bây giờ bạn có thể thêm một tệp jar chứa các tài liệu. Đây sẽ chỉ là một tệp zip với phần mở rộng được thay đổi thành jar. Đảm bảo rằng bên trong jar, index.html nằm trong thư mục gốc. Bạn có thể nhấn nút "Xác thực" để kiểm tra mọi thứ đều ổn.

— Mister Smith
nguồn

đến 3. Chọn trực tiếp thư viện, không phải thư được liệt kê trong Thư viện riêng của Android (không có chức năng chỉnh sửa). Điều 4: Sử dụng Javadoc trong Lưu trữ, không phải URL

— Gunnar Bernstein

Chỉ cần nói thêm rằng nếu bạn đang sử dụng một thư viện thông thường, bạn có thể đính kèm một liên kết đến API trực tuyến thay vì một đường dẫn cục bộ được mã hóa cứng đến tệp JAR.

— Sina Madani

11

Nhấp chuột phải vào jar (cái có các tệp lớp), chọn "Thuộc tính", "Vị trí Javadoc" và chọn tệp jar có javadoc. Thực hiện tương tự đối với nguồn jar, bằng cách sử dụng "tệp đính kèm nguồn Java".

— JB Nizet
nguồn

4

Có thể chỉ là tôi nhưng điều này chỉ hoạt động nếu Eclipse "nhận ra" tệp là một cái lọ. Đó là nó có một biểu tượng cái lọ nhỏ bên cạnh nó. Khi tôi nhập các lọ của bên thứ ba, chúng sẽ hiển thị với những gì dường như là biểu tượng tài liệu. Họ chỉ hoạt động tốt mã khôn ngoan nhưng các thuộc tính nhấp chuột phải, tôi không nhận được "vị trí javadoc".

— Miguel Moll

Nếu các lọ của bạn nằm trong WEB-INF / lib, bạn không nên nhấp chuột phải vào chúng (như bạn đã nói, chúng hiển thị dưới dạng tài liệu) mà từ tương đương bên trong "Thư viện ứng dụng web"

— xtian 30/07/15

9

Bạn cũng có thể chỉnh sửa classpathentry trong tệp ".classpath" trong dự án eclipse của bạn. Điều này có thể hữu ích nếu bạn muốn sửa đổi nhiều mục nhập cùng một lúc hoặc nếu bạn muốn tạo đường dẫn. ví dụ:

<classpathentry kind="var" path="HOME/3rdparty/junit.jar" sourcepath="/SOURCE/junit_src.zip"/>

— Michael_S
nguồn

+1 câu trả lời! Tôi đã nghĩ đến một phương pháp như vậy để thêm nhiều lọ khác nhau cùng một lúc.

— Vikas Raturi

-1 Bạn không muốn chỉnh sửa trực tiếp tệp .classpath. Nó dự định chỉ được sử dụng bởi nhật thực, không được chỉnh sửa thủ công. @Mister Smith thực sự đưa ra câu trả lời chính xác thực sự ở đây. Mặc dù draganstankovic giải thích một phương pháp ít nhất sẽ hoàn thành công việc ...

— aaiezza

@scribeaniwannabe: Tôi biết rằng đây không phải là cách dự định, được hỗ trợ và cũng không phải là cách dễ dàng nhất, nhưng đối với các trường hợp sử dụng mà tôi đã đề cập, nó hoạt động nhanh hơn nhiều và không gặp sự cố. Tuy nhiên, bạn phải cẩn thận để sử dụng cú pháp XML hợp lệ.

— Michael_S

0

Cách dễ nhất là:

Nhấn control + (Từ mà bạn muốn xem tài liệu Java)
Một trang sẽ xuất hiện có nút để đính kèm nguồn. Nhấp vào Đây
Chọn Vị trí bên ngoài.
Duyệt Vị trí đến thư mục Java hơn là của bạn jdk .Than chọn src .zip.
nhấn OK.

Vấn đề đã được giải quyết.

— raj
nguồn