يصف المثال الموجود في هذه المقالة طريقة إنشاء مستندات javadoc تلقائيًا في Eclipse. شاركها مع الجميع لتكون مرجعا لك. الطريقة المحددة هي كما يلي:
هناك ثلاث طرق رئيسية لاستخدام Eclipse لإنشاء الوثائق (javadoc):
1. انقر بزر الماوس الأيمن في قائمة المشاريع، وحدد تصدير، ثم حدد javadoc ضمن Java في مربع حوار التصدير، ثم أرسل إلى الخطوة التالية.
هناك مكانان يجب الانتباه إليهما في مربع الحوار Javadoc Generation:
أمر javadoc: يجب تحديد bin/javadoc.exe الخاص بـ jdk
الوجهة: هو مسار حفظ المستند الذي تم إنشاؤه، والذي يمكن تحديده بحرية.
اضغط على "إنهاء" للإرسال لبدء إنشاء المستند.
2. استخدم القائمة لتحديد: ملف->تصدير (ملف->تصدير)،
الخطوات المتبقية هي نفس الطريقة الأولى.
3. حدد المشروع الذي تريد إنشاء وثائق له، ثم استخدم القائمة لتحديد،
المشروع->إنشاء Javadoc يدخل مباشرةً إلى مربع حوار إنشاء Javadoc. الخطوات المتبقية هي نفس الطريقة الأولى التي تبدأ من مربع حوار إنشاء Javadoc.
يمكنك استخدام أي طريقة، ولكن يجب الانتباه إلى بعض الأمور:
1. لا يمكن إنشاء Eclipse والإبلاغ عن خطأ:
java.lang.IllegalArgumentException على sun.net.www.ParseUtil.decode
، والذي يحدث بسبب تعيين متغيرات بيئة جافا. على سبيل المثال، مسار الفصل هو
.;%JAVA_HOME/lib/dt.jar;%JAVA_HOME%/lib/tool.jar الحل هو حذف مسار الفصل أو الرجوع إلى المستند الرسمي http://maven.apache.org/plugins/maven-javadoc-. البرنامج المساعد/faq.html.
2. المستند الذي تم إنشاؤه مشوه. تحسين api-doc. عند استخدام Eclipse لإنشاء javadoc، يحدث "ترميز أحرف GBK" وهو في الواقع مشكلة في ترميز الأحرف. افتح Eclipse، project -> أنشئ javadoc وحدد المشروع الذي تريد إخراج javadoc واحدًا تلو الآخر، في الخطوة الأخيرة، أضف الكود التالي إلى سطر إعدادات VM. انسخ الكود كما يلي: -encoding utf-8 -charset utf -8
آمل أن تكون هذه المقالة مفيدة لبرمجة جافا للجميع.