Cách tạo gói tùy chỉnh javadoc tùy chỉnh cho gói Android 1.4?Làm thế nào để cài đặt javadoc cho Gói Tương thích với Android?
Tài liệu tham chiếu có sẵn trực tuyến (example), nhưng có một số nơi tôi có thể nhận zip với javadoc khả dụng ngoại tuyến không?
Tôi cho rằng việc sử dụng javadoc sẽ khá đơn giản, chỉ cần thiết lập vị trí javadoc cho jar tương thích.
Bạn có thể tự tạo javadoc ngoại tuyến của mình từ mã nguồn. Chỉ cần điều hướng đến thư mục sdk android của bạn sau đó làm như sau
cd <path_to_android_sdk>/extras/android/compatibility/v4/
mkdir docs
Đối với Windows:
javadoc -d docs -sourcepath src\java -subpackages android.support.v4
Đối với Linux/Mac:
javadoc -d docs -sourcepath src/java -subpackages android.support.v4
này sẽ tạo ra javadocs cho bạn tại địa phương trong docs thư mục mà bạn vừa tạo.
Sau đó, trong dự án android eclipse của bạn, hãy truy cập thuộc tính dự án của bạn nơi bạn đã thêm android-support-v4.jar, chỉnh sửa thuộc tính và thêm đường dẫn đến javadocs bạn vừa tạo.
Điều đó sẽ hiệu quả!
ADT 17+ vấn đề:
Như một số bạn đã chỉ ra. Đã có vấn đề với việc Eclipse xem javadoc đính kèm cho ADT 17+. Đây là một vấn đề đã biết và một lỗi đã được đệ trình. Điều này không liên quan đến cách bạn tạo javadoc (như tôi đã mô tả ở trên), thay vì đây là một vấn đề với ADT 17+ tích hợp với Eclipse. Có người đã mô tả một cách giải quyết và nó có thể được theo sau đây:
Câu trả lời bởi @wnafee là tại chỗ trên, nhưng nếu bạn đang sử dụng Linux đừng quên sử dụng ký tự dấu gạch chéo ở vị trí này như src/java.
Vấn đề: Nếu android-support-v4.jar là trong thư mục /libs (như ADT 17+ yêu cầu) javadoc là không có.
Sửa: Tôi đã workarounded vấn đề bằng cách liên kết các phiên bản offline của javadoc android cho android-hỗ trợ-v4.jar. Theo tôi biết vẫn không thể liên kết phiên bản trực tuyến (http://developer.android.com/reference). Các bước:
MKLINK /J {PROJECT_PATH}\android_docs {SDK_PATH}\docs\referenceTạo file libs/android-support-v4.jar.properties với nội dung này:
src=android-support-v4.jar
doc=../android_docs
Đóng dự án và mở lại nó. Làm sạch nếu cần.
Nhờ câu trả lời này https://stackoverflow.com/a/11579339/933261
Bạn vẫn có thể tạo javadoc offline để xem nó trong trình duyệt hoặc thủ công. Bạn đang mô tả một vấn đề với việc gắn nó vào IDE của bạn để làm cho trải nghiệm mã hóa dễ dàng hơn. – wnafee
Điều này là cố định/sai: http://stackoverflow.com/questions/9873152/how-to-attach-javadoc-or-sources-to-jars-in-libs-folder (đối với tôi, tôi cũng phải khởi động lại nhật thực sau, VÀ giữ tài liệu trên cùng một ổ đĩa) – pjco
Được bỏ phiếu, để chỉnh sửa hữu ích – pjco
NẾU BẠN ĐANG SỬ WINDOWS và gặp khó khăn cho các lứa tuổi như tôi, làm cho chắc chắn bạn thoát khỏi backsmashes của bạn trong tập tin thuộc tính, hoặc những điều sẽ âm thầm thất bại. (Người làm cho bộ tải không im lặng anyway ...)
này đây là tài sản của tôi file:
src=android-support-v4.jar
doc=doc\\android-support-v4_doc
và dir của tôi trông như thế này:
android-support-v4.docs.zip
android-support-v4.jar
android-support-v4.jar.properties
doc
dự án gần gũi và cởi mở, và nó tất cả đều hiệu quả với tôi.
Tôi đã thực hiện tất cả các giải pháp này và không có giải pháp nào trong số chúng hoạt động. Dưới đây là những gì tôi đã làm cho nó làm việc:
Điều hướng đến thư mục sau: D: \\ Android-SDK \ android-sdk-windows \ extras \ \ hỗ trợ android \ v4
Chạy lệnh: javadoc -d docs sourcepath src \ java -subpackages android.support.v4
Trong thư mục libs của dự án của bạn, tạo ra một tập tin gọi là android-support-v4.jar.properties
Trong tệp thuộc tính, hãy thêm các dòng sau (thay đổi đường dẫn để khớp với đường dẫn của bạn):
doc = D: \ Program Files \ Android-SDK \ android-sdk-windows \ extras \ android \ support \ v4 \ docs src = D: \ Program Files \ Android-SDK \ android-sdk-windows \ extras \ android \ support \ v4 \ src
Trong Eclipse, hãy mở hộp thoại thuộc tính cho Bản dựng, sau đó điều hướng đến Java Build Đường dẫn và chọn tab Thư viện.
Mở rộng thư viện hỗ trợ. Trong trường hợp của tôi, đường dẫn là: D: \ Program Files \ Android-SDK \ android-sdk-windows \ extras \ android \ support \ v4
Chọn vị trí Javadoc. Nhấp vào nút Chỉnh sửa và sau đó chọn đường dẫn đến tài liệu. Trong trường hợp của tôi là: tệp:/D:/Tệp Chương trình/Android-SDK/android-sdk-windows/extras/android/support/v4/docs/
Đóng mọi thứ, bao gồm Eclipse và khởi động lại. Bây giờ bạn có thể duyệt tài liệu trong mã của mình.
tôi tạo này dựa trên câu trả lời của wnafee: https://dl.dropboxusercontent.com/u/31272696/android-support-v4.zip
của nó 'src/java' trên mac. w00p w00p ty – Blundell
** LƯU Ý: ** vì ADT 17 giải pháp này không còn hoạt động nữa. [Nguồn] (http://code.google.com/p/android/issues/detail?id=28801) –
Bạn vẫn có thể tạo tiền phạt javadoc bằng cách sử dụng những gì tôi đã viết ở trên (đó là mục đích của câu hỏi). Nếu có vấn đề với Eclipse và ADT bây giờ cho phép bạn nhìn thấy nó trong IDE đó là một vấn đề khác cần được giải quyết. Cảm ơn bạn đã chỉ ra nó! tốt để biết – wnafee