Plugin ADT r17 versi baru untuk fitur yang ditambahkan Eclipse untuk secara otomatis mengatur dependensi JAR. File .jar apa pun di folder / libs ditambahkan ke konfigurasi build sekarang. Sayangnya wadah classpath Dependensi Android tidak dapat dimodifikasi.
Bagaimana saya bisa melampirkan javadoc dan sumber ke .jar (dari / libs folder) yang dimasukkan secara otomatis?
Jawaban:
Cara terbaik untuk menjawab pertanyaan Anda adalah dengan merangkum jawaban dari Xavier , plastiv , VinceFR dan Christopher .
Panduan langkah demi langkah
Untuk menautkan sumber dan javadoc ke pustaka .jar yang secara otomatis ditautkan oleh Eclipse Anda harus melakukan hal berikut:
.properties
file di folder libs dengan nama persis pustaka aktual .jar (lihat contoh). Pastikan Anda menyimpan bagian .jar ..properties
file.Contoh
Contohnya menggunakan perpustakaan Gson .
Struktur direktori folder libs:
Isi dari gson-2.2.2.jar.properties
Informasi tambahan
Tentu saja Anda dapat memindahkan javadoc dan sumber .jar ke folder lain dan menentukan jalur relatif. Terserah kamu. Menempatkan sumber dan toples javadoc langsung ke folder lib dimungkinkan tetapi tidak disarankan , karena hal itu menyebabkan dokumentasi dan kode sumber dimasukkan dalam aplikasi Anda .
Cuplikan layar panel Eclipse JavaDoc:
Cuplikan layar proyek Eclipse menggunakan Gson dengan Android 4.2.2 .:
Referensi javadocs yang belum dibongkar
Jika Anda ingin referensi javadocs yang tidak disediakan sebagai paket
.jar
tetapi hanya sebagai file dan folder seperti yang diminta oleh pengembang android di komentar lakukan hal berikut:.jar
dilibs/
folderBuat
yourlibraryname.jar.properties
file ( jangan lupa.jar
) dengan konten berikut:Tambahkan folder javadocs ke
libs/
folder.Anda harus membuat struktur folder berikut:
Jangan lupa untuk menutup dan membuka kembali proyek Eclipse seperti yang disebutkan di atas! Berikut ini adalah tangkapan layar dari proyek contoh yang berfungsi yang mereferensikan perpustakaan GoogleAdMobAds Android .
sumber
Pada windows Anda harus menghindari backslash untuk referensi ke jalur doc dan src di file properti. Contoh, untuk android-support-v4.jar konten file properti adalah sesuatu seperti:
sumber
Jawaban datang dari http://code.google.com/p/android/issues/detail?id=27490#c21
Di folder libs Anda, Anda harus memiliki:
Dan di dalam Anda
foo.jar.properties
, cukup cantumkandoc=./doc/foo_doc
Mungkin Anda harus menyegarkan proyek Anda, untuk membersihkannya, untuk menutupnya dan untuk membukanya kembali.
Ini bekerja untuk saya!
sumber
Saya mencoba semua hal di atas dan tidak ada yang bekerja untuk saya. Saya menemukan metode yang akan selalu berhasil. Pada dasarnya, pelakunya adalah cara ADT memperlakukan folder "libs" jadi saya berhenti menggunakan folder "libs". Sebaliknya saya membuat folder "libraries" dan menggunakannya.
Anda dapat melakukan hal berikut ini dan itu akan selalu berhasil - bahkan jika ADT harus mengubah cara itu mengubah cara berurusan dengan folder "libs" di masa depan:
Dengan mengikuti prosedur di atas proyek Anda akan memiliki folder yang terlihat seperti ini:
Java Build Path Anda akan terlihat seperti ini:
Dalam Urutan dan Ekspor perpustakaan dicentang:
sumber
Untuk saat ini, pindahkan perpustakaan yang Anda inginkan Javadoc
lib
. Mereka menambahkan perpustakaan itu keBuild Path
dan menambahkan Javadoc.Periksa komentar ini di masalah android.
sumber
Build Path
.Pada ADT 22 saya tidak bisa mengakses Javadoc untuk commons-io-2.4.jar dan android-support-v4.jar
Inilah cara saya memperbaikinya:
Prasyarat: kedua perpustakaan terdaftar di bawah "Perpustakaan yang Dirujuk".
Klik kanan pada commons-io-2.4.jar dan pilih Properties. Jendela ini muncul:
commons-io-2.4.jar dibundel dengan commons-io-2.4-javadoc.jar, jadi saya menentukan Javadoc dalam arsip External file path.
Saya melakukan hal yang sama untuk perpustakaan dukungan: klik kanan pada android-support-v4.jar dan pilih Properties. Layar ini muncul:
Kali ini saya menetapkan jalur ke direktori sumber.
sumber
Referensi perpustakaan ke commons-io-2.0.1.jar rusak ketika saya memutakhirkan ke SDK Tools dan revisi ADT 17.
Untuk mengatasi masalah saya menggunakan Project -> Properties -> Java Build Path dan saya memilih tab Libraries. Saya menghapus referensi apa pun ke commons-io-2.0.1.jar dan kemudian menggunakan Add Jar untuk menambahkan kembali commons-io-2.0.1.jar ke proyek. Lalu saya klik panah '>' di sebelah nama perpustakaan untuk memperluas referensi perpustakaan dan saya menggunakan tombol edit untuk mengatur lampiran Sumber dan lokasi Javadoc.
Maaf saya tidak dapat memposting gambar karena saya tidak punya cukup rep (tolong ...).
sumber
Tampaknya menjadi target yang bergerak tetapi, setelah mengumpulkan potongan-potongan dari banyak tempat (termasuk jawaban untuk pertanyaan yang sangat membantu tetapi gagal menggambarkan semua detail yang diperlukan, atau mungkin sistem telah berubah sedikit sementara), ini tampaknya menjadi solusinya, setidaknya pada saat ini (28 Agustus 2013).
lib
folder Anda , tambahkanxxx.jar.properties
file untuk setiap lib yang ingin Anda kaitkan dengan javadoc.doc=d:\\Android\\javadoc\\libGoogleAnalyticsServices
Gagal mematuhi langkah-langkah ini (tidak membuka ritsleting javadoc, merujuk file alih-alih folder, dll) tampaknya mematahkannya.
sumber
Saya tahu pertanyaan ini agak lama, tetapi ketika saya menghadapi masalah yang sama kemarin dan solusi yang diposting di atas terlalu mengganggu bagi saya, saya menemukan bahwa orang dapat dengan mudah menambahkan definisi jalur sumber ke file .classpath proyek. Eclipse kemudian akan menyesuaikannya dan Anda dapat menelusuri sumbernya.
entri classpath sebelumnya:
Setelah menambahkan path ke sumbernya
Semoga ini membantu
sumber
perbarui saja plugin ADT. Itu berhasil bagi saya !!
Semoga itu bisa membantu!
sumber
Untuk setiap stoples yang diberikan, jika Anda ingin melihat bantuan Javadoc pada tooltip saat coding, lakukan hal berikut: Klik kanan proyek Anda> Properties> Java Build Path> Libraries Tab. Klik panah di sebelah toples Anda untuk mengembang.
Lampiran sumber harus menunjuk ke lokasi tabung yang sebenarnya (mungkin tepat di folder java Anda).
Lokasi Javadoc : Anda punya dua pilihan di sini: URL dan arsip. Jika javadocs Anda untuk toples ini berada dalam bentuk folder yang berisi index.html file di tingkat pertama, pilih 'Javadoc URL' dan arahkan ke folder itu. Jika javadocs Anda ada dalam toples, pilih 'Javadoc in archive' dan arahkan ke toples. Jangan lupa untuk me-restart ruang kerja Anda / tutup dan buka kembali proyek Anda untuk memperbarui tooltip dengan info Javadoc.
Saya harap ini membantu memberikan jawaban sederhana untuk apa yang saya yakini sebagai tugas yang sangat sederhana.
sumber
Solusi saya:
Unduh plugin gerhana bernama: "Fitur Java Source Attacher".
Kemudian, pilih toples dan lampirkan kode sumber menggunakan plugin ini. Klik di file jar untuk memilihnya, buttom kanan pada mouse, dan kemudian pilih "lampirkan sumber java".
Ketika Anda memiliki kode sumber, Anda memiliki javadoc secara otomatis.
Sekarang Anda dapat menggunakan F2 di atas kelas untuk melihat javadoc yang terkait.
Nikmati
sumber