إنشاء فئة أو نوع بلغة Java

باستخدام مربّع الحوار إنشاء صف جديد ونماذج الملفات، يمكن لنظام Android تساعدك "استوديو YouTube" في إنشاء الصفوف والأنواع الجديدة التالية بسرعة:

  • صفوف Java
  • فئات التعداد ونمط سينغلتون
  • أنواع الواجهة والتعليقات التوضيحية

بعد ملء حقول مربّع الحوار إنشاء صف جديد والنقر على حسنًا، سينشئ "استوديو Android" ملف .java يحتوي على التعليمات البرمجية الهيكلية، بما في ذلك بيان الحزمة وأي عمليات استيراد ضرورية وعنوان وفئة أو تعريف نوع. بعد ذلك، يمكنك إضافة التعليمة البرمجية إلى هذا الملف.

وتحدد نماذج الملفات كيفية إنشاء "استوديو Android" للرمز الهيكلي. يمكنك استخدام نماذج الملفات المتوفّرة في "استوديو Android" كما هي، أو تخصيصها التي تناسب عملية التطوير لديك.

عرض نماذج الملفات وتخصيصها

يوفر "استوديو Android" نماذج الملفات التي تحدد مدى مساهمة فئات و الأنواع المختلفة باستخدام مربّع الحوار إنشاء صف جديد. يمكنك تخصيص هذه القوالب.

مربّع الحوار "إنشاء صف جديد"

الشكل 1. إنشاء صف جديد .

تتضمن نماذج ملفات "استوديو Android" رمز لغة نموذج السرعة (VTL) والمتغيرات التي تتعامل مع هذه الخيارات الإضافية. يستخدم مربّع الحوار إنشاء صف جديد السمة AnnotationType، الفئة، Enum وواجهة وفرديتون قوالب الملفات.

لعرض النماذج، والعثور على التخصيصات، وتعديل النماذج، اتبع الخطوات التالية:

  1. نفّذ أيًا مما يلي:

    • في نظام التشغيل Windows أو Linux، حدد ملف > الإعدادات > المحرّر > الملف والتعليمات البرمجية القوالب > الملفات.
    • على نظام التشغيل macOS، اختَر استوديو Android > الإعدادات المفضّلة > المحرّر > الملف والتعليمات البرمجية القوالب > الملفات.

    في قائمة النماذج، أسماء القوالب الداخلية بخط غامق. أسماء النماذج المخصصة هي بلون مميز، مثل الأزرق.

  2. قم بتخصيص قوالب الملفات حسب الحاجة.

    إذا كنت تريد استخدام حقول مربّع الحوار إنشاء صف جديد، تأكَّد من أنّ التغييرات مع رمز النموذج الخاص بملف "استوديو Android".

للحصول على مزيد من المعلومات حول نماذج الملفات، بما في ذلك VTL، يُرجى الاطّلاع على ملف وCode Templates وFile ومربّع الحوار "نماذج الرموز".

إنشاء فئة أو نوع من أنواع Java

يساعدك "استوديو Android" على إنشاء فئات Java جديدة، التعداد وسينغلتون وأنواع الواجهات والتعليقات التوضيحية استنادًا إلى نماذج الملفات.

لإنشاء فئة أو نوع Java جديد، اتبع الخطوات التالية:

  1. في نافذة المشروع، انقر بزر الماوس الأيمن على ملف أو مجلد Java. واختر جديد > فئة Java:

    2. بدلاً من ذلك، يمكنك اختيار ملف أو مجلد Java في المشروع أو النقر فوق ملف Java في محرِّر التعليمات البرمجية. بعد ذلك، اختَر ملف > جديد > فئة Java:

    يُحدِّد العنصر الذي تختاره الحزمة التلقائية للفئة أو النوع الجديد.

  2. في مربّع الحوار إنشاء صف جديد، املأ الحقول:
    • الاسم - اسم الفئة أو النوع الجديد. يجب أن يلتزم مع متطلبات اسم Java. لا تكتب امتداد اسم ملف.
    • النوع - اختَر فئة الفئة أو النوع.
    • Superclass - الفئة التي ترث منها الفئة الجديدة. يمكنك كتابة اسم الحزمة واسم الفئة أو اسم الفئة فقط ثم النقر المزدوج على عنصر في القائمة المنسدلة لإكماله تلقائيًا.
    • الواجهات - واجهة واحدة أو أكثر تستخدمها الفئة الجديدة أو ينفذها النوع. يجب فصل الواجهات المتعددة بفاصلة متبوعة مساحة اختيارية. يمكنك كتابة اسم الحزمة والواجهة أو المستخدم ثم النقر نقرًا مزدوجًا على عنصر في القائمة المنسدلة إكماله تلقائيًا.

      • تعمل ميزة الإكمال التلقائي مع اسم الواجهة الأولى فقط. لاحظ أنه في حين أن الفاصلة واسم الواجهة التالي إلى إظهار خطأ في التلميح، يمكنك تجاهل الخطأ لأنه لا يؤثر في التعليمة البرمجية التي تم إنشاؤها.

    • الحزمة - الحزمة التي ستقيمها الفئة أو النوع بوصة تظهر القيمة التلقائية في الحقل تلقائيًا. في حال كتابة اسم حزمة في الحقل، أي أجزاء غير موجودة من معرف الحزمة أحمر مظلل وهو في هذه الحالة، ينشئ "استوديو Android" الحزمة بعد انقر على حسنًا. يجب أن يحتوي هذا الحقل على قيمة. وإلا فإن لغة Java لن يحتوي الملف على عبارة package، ولن يتم تضم��ن الفئة أو النوع داخل حزمة في المشروع.

      • يع��مد ال��عدا�� الافتراضي على كيفية تم إطلاق مربّع الحوار إنشاء صف جديد. إذا حددت لأول مرة ملف أو مجلد Java في نافذة المشروع، الإعداد التلقائي هو الحزمة للعنصر الذي حددته. إذا نقرت لأول مرة على ملف Java في محرر التعليمات البرمجية، الافتراضية هي الحزمة التي تحتوي على هذا الملف.

    • مستوى الرؤية: اختَر ما إذا كان الصف أو النوع مرئيًا للمستخدمين. أو لجميع الصفوف، أو فقط للدروس التي تحتوي على حزمة خاصة به.
    • المعدِّلات - اختر الخلاصة أو تمثّل هذه الخاصية المعدّل النهائي لفئة أو لا.
    • إظهار مربع حوار إلغاء التحديد - لنوع من الصف، ضَع علامة في هذا الخيار لفتح مربّع اختيار طرق إلغاء مربع الحوار/تنفيذه بعد النقر على حسنًا. ضِمن مربع الحوار هذا، يمكنك تحديد الطرق التي تريد إلغاءها أو وستنشئ Android Studio رمزًا أساسيًا لهذه الطرق.

    يتم إخفاء أي حقول لا تنطبق على النوع.

  3. انقر على موافق.

    4. ينشئ "استوديو Android" ملف Java باستخدام رمز برمجي يمكنك تعديله. أُنشأها جون هنتر، الذي كان متخصصًا الملف في أداة تعديل الرموز.

ملاحظة: يمكنك إنشاء فئة فردية من خلال اختيار ملف > جديد > سينغلتون أو ملف > جديد > فئة Java: الـ يقدم الأسلوب الأخير مزيدًا من الخيارات.

نماذج الملفات في "استوديو Android"

يسرد هذا القسم رمز نموذج ملف "استوديو Android" المكتوب بلغة البرمجة النصية VTL، متبوعًا من خلال تعريفات المتغيرات. تستند القيم التي تقدمها في يصبح مربّع الحوار إنشاء صف جديد قيم المتغيّر في النموذج. لاحظ أن السطور التي تبدأ بـ #if (${VISIBILITY} يمتد وصولاً إلى القوس المفتوح ( { ).

نموذج ملف AnnotationType

#if (${PACKAGE_NAME} != "")package ${PACKAGE_NAME};#end

#if (${IMPORT_BLOCK} != "")${IMPORT_BLOCK}
#end
#parse("File Header.java")

#if (${VISIBILITY} == "PUBLIC")public #end @interface ${NAME} #if (${INTERFACES} != "")extends ${INTERFACES} #end {
}

نموذج ملف الصف

#if (${PACKAGE_NAME} != "")package ${PACKAGE_NAME};#end

#if (${IMPORT_BLOCK} != "")${IMPORT_BLOCK}
#end
#parse("File Header.java")

#if (${VISIBILITY} == "PUBLIC")public #end #if (${ABSTRACT} == "TRUE")abstract #end #if (${FINAL} == "TRUE")final #end class ${NAME} #if (${SUPERCLASS} != "")extends ${SUPERCLASS} #end #if (${INTERFACES} != "")implements ${INTERFACES} #end {
}

نموذج ملف التعداد

#if (${PACKAGE_NAME} != "")package ${PACKAGE_NAME};#end

#if (${IMPORT_BLOCK} != "")${IMPORT_BLOCK}
#end
#parse("File Header.java")

#if (${VISIBILITY} == "PUBLIC")public #end enum ${NAME} #if (${INTERFACES} != "")implements ${INTERFACES} #end {
}

نموذج ملف الواجهة

#if (${PACKAGE_NAME} != "")package ${PACKAGE_NAME};#end

#if (${IMPORT_BLOCK} != "")${IMPORT_BLOCK}
#end
#parse("File Header.java")

#if (${VISIBILITY} == "PUBLIC")public #end enum ${NAME} #if (${INTERFACES} != "")implements ${INTERFACES} #end {
#end {
}

نموذج ملف سينغلتون

#if (${PACKAGE_NAME} != "")package ${PACKAGE_NAME};#end

#if (${IMPORT_BLOCK} != "")${IMPORT_BLOCK}
#end
#parse("File Header.java")

#if (${VISIBILITY} == "PUBLIC")public #end class ${NAME} #if (${SUPERCLASS} != "")extends ${SUPERCLASS} #end #if (${INTERFACES} != "")implements ${INTERFACES} #end {
    private static final ${NAME} ourInstance = new ${NAME}();

    #if (${VISIBILITY} == "PUBLIC")public #end static ${NAME} getInstance() {
        return ourInstance;
    }

    private ${NAME}() {
    }
}

متغيّرات نماذج الملفات

يستبدل "استوديو Android" متغيّرات نماذج الملفات بقيم في العنصر الذي تم إنشاؤه. ملف Java. يمكنك إدخال القيم في مربّع الحوار إنشاء صف جديد. ويحتوي النموذج على المتغيّرات التالية التي يمكنك استخدامها:

  • IMPORT_BLOCK: قائمة بلغة Java يتم الفصل بينها بأسطر جديدة عبارات import الضرورية لدعم أي فئة فائقة أو أو واجهات فارغة أو سلسلة فارغة (""). على سبيل المثال، إذا كنت فقط تنفيذ الواجهة Runnable وعدم تمديد أي شيء، فإن هذا المتغير سيكون "import java.lang.Runnable;\n". إذا قمت بتنفيذ Runnable وتوسيع الفئة Activity، فستكون "import android.app.Activity;\nimportjava.lang.Runnable;\n"
  • VISIBILITY - ما إذا كان سيتم منح الصف إمكانية الوصول العام أم لا. ويمكن أن تكون القيمة PUBLIC أو PACKAGE_PRIVATE.
  • SUPERCLASS - اسم صف واحد أو فارغ. في حال وجودها، فهناك ستكون عبارة عن extends ${SUPERCLASS} بعد اسم الفئة الجديدة.
  • INTERFACES - قائمة بالواجهات مفصولة بفواصل أو فارغة. في حال حذف ستكون هناك عبارة implements ${INTERFACES} بعد أو بعد اسم الفصل إذا لم يكن هناك فئة متميزة. بالنسبة إلى الواجهات أنواع التعليقات التوضيحية، تتضمّن الواجهات الكلمة الرئيسية extends.
  • ABSTRACT - ما إذا كان يجب أن يكون الصف مجردًا أم لا. مُمْكِنْ لها القيمة TRUE أو FALSE.
  • FINAL - ما إذا كان يجب أن يكون الصف نهائيًا أم لا. يمكن أن تحتوي على بقيمة TRUE أو FALSE.