javadoc को jar

Question

में एम्बेड करने का कोई तरीका है क्या मेरे लाइब्रेरी जार में जावाडॉक एंटी टास्क द्वारा उत्पादित जावाडोक (/ डॉक फ़ोल्डर) को एम्बेड करने का कोई तरीका है जिसमें मेरी .class फ़ाइलें शामिल हैं?

मैं स्रोत को शिप नहीं करना चाहूंगा और चाहूंगा कि उपयोगकर्ता संदर्भित पुस्तकालय टैब के माध्यम से बिना जावास्क्रिप्ट में जावाडॉक टिप्पणियों को देख सकें और जावाडोक ज़िप को मेरे तृतीय-पक्ष lib में जोड़ सकें।

Answer 1

सुनिश्चित करें कि आप update इस तरह एक जार फ़ाइल कर सकते हैं।

jar uf <your_jar> doc/<your doc file>

Answer 2

सुनिश्चित करें कि आप अपने द्विआधारी JAR फ़ाइल में जावाडोक डाल सकते हैं ... लेकिन यह वास्तव में मतलब होता है?

javadocs पढ़ने के लिए, उपयोगकर्ता को JAR फ़ाइल से HTML फ़ाइलों को एंड्रॉइड के फाइल सिस्टम में अनपैक करना होगा, और फिर एंड्रॉइड ब्राउज़र को index.html फ़ाइल (या जो कुछ भी) पर इंगित करना होगा। लेकिन आपके कोड को चलाने के लिए जेएआर फ़ाइल का उपयोग करने के लिए सबसे अच्छा मॉडल इसे अनपैक नहीं करना है। और यदि आप उम्मीद नहीं करते हैं कि आपके उपयोगकर्ता अपने फोन पर जावाडोक को देखने का प्रयास करें (!?!) ... तो javadocs को JAR फ़ाइल में डालने से "मृत वजन" होता है।

यह एक अलग ज़िप या टैर फ़ाइल में जावाडोक पेड़ को वितरित करने के लिए और अधिक समझ में आता है।

अंत में, यदि आप उपयोगकर्ताओं को अपने उत्पाद में एपीआई के खिलाफ कोड विकसित करने की उम्मीद करते हैं, तो यदि आप उन्हें स्रोत कोड प्रदान करते हैं तो यह उनके लिए बहुत आसान होगा। आपको बेहतर ग्राहक संतुष्टि मिलेगी, उनके कोड को डीबग करने में मदद करने के लिए कम समर्थन अनुरोध, और आपके कोड के बारे में कम अनुचित शिकायतें काम नहीं कर रही हैं।