Sorunuzu cevaplamanın en iyi yolu Xavier , plastiv , VinceFR ve Christopher'ın cevaplarını özetlemektir .
Adım adım rehber
Bağlamak amacıyla kaynaklarını ve javadoc otomatik Eclipse ile bağlanmış bir .jar kütüphaneye aşağıdakileri yapmanız gerekir:
- Kitaplık .jar dosyasını libs klasörüne ve ilişkili kaynak .jar ve doc .jar dosyalarını libs / src ve libs / docs gibi ayrı alt klasörlere yerleştirin . İsterseniz src ve docs dışında bir ad kullanabilirsiniz , ancak .jar dosyalarının doğrudan libs klasöründe olmaması önemlidir .
- Libs klasöründe, gerçek kitaplık .jar
.properties
dosyasının tam adıyla bir dosya oluşturun (örneğe bakın). .Jar kısmını sakladığınızdan emin olun .
- Kaynaklardaki göreli yolları ve
.properties
dosyadaki javadoc .jar dosyasını belirtin .
- Eclipse projesini kapatıp yeniden açın! İsteğe bağlı olarak, düğmesine basarak projeyi yenileyin F5.
- Kaynak kodda bağlı kütüphanenin bir nesnesini seçin.
- Belgeleri kontrol etmek için Eclipse'de Javadoc görünümünü açın (ekran görüntüsüne bakın).
- F3Seçili nesnenin kaynak kodu bildirimini (varsayılan kısayol:) açın .
Misal
Örnekte Gson kütüphanesi kullanılmıştır .
Libs klasörünün dizin yapısı:
libs
├── docs
│ └── gson-2.2.2-javadoc.jar
├── gson-2.2.2.jar
├── gson-2.2.2.jar.properties
└── src
└── gson-2.2.2-sources.jar
Gson-2.2.2.jar.properties içeriği
src=src/gson-2.2.2-sources.jar
doc=docs/gson-2.2.2-javadoc.jar
Ek bilgi
Elbette javadoc ve sources .jar dosyalarını diğer klasörlere taşıyabilir ve göreli yolları belirleyebilirsiniz. Bu size kalmış. Kaynak ve javadoc kavanozlarını doğrudan lib klasörüne yerleştirmek mümkündür ancak önerilmez , çünkü belgelerin ve kaynak kodunun uygulamanıza dahil edilmesine neden olur .
Eclipse JavaDoc panelinin ekran görüntüsü:
Android 4.2.2 ile Gson kullanan bir Eclipse projesinin ekran görüntüsü:
Ambalajsız javadoklara referans verme
Paketlenmiş olarak .jar
değil , yorumlarda android geliştiricisinin istediği gibi dosya ve klasörler olarak sunulan javadoc'lara başvurmak istiyorsanız aşağıdakileri yapın:
- Kütüphane yerleştirin
.jar
içinde libs/
klasörün
Aşağıdaki içeriğe sahip bir yourlibraryname.jar.properties
dosya oluşturun ( unutmayın.jar
):
doc=docs
Javadocs klasörlerini libs/
klasöre ekleyin .
Aşağıdaki klasör yapısını bulmalısınız:
├── docs
│ ├── allclasses-frame.html
│ ├── allclasses-noframe.html
│ ├── com
│ │ └── google
│ │ └── ads
│ │ ├── Ad.html
│ │ │ ....
│ │ └── package-tree.html
│ │ ...
│ └── stylesheet.css
├── GoogleAdMobAdsSdk-6.4.1.jar
└── GoogleAdMobAdsSdk-6.4.1.jar.properties
Eclipse projesini yukarıda belirtildiği gibi kapatıp yeniden açmayı unutmayın ! GoogleAdMobAds Android kütüphanesine referans veren çalışan bir örnek projenin ekran görüntüsü .