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

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

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

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

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

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

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

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

الشكل 1. مربع الحوار إنشاء صف جديد.

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

لعرض القوالب والبحث عن التخصيصات وتعديل القوالب، اتبع الخطوات التالية:

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

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

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

  2. خصِّص نماذج الملفات حسب الحاجة.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    4. ينشئ "استوديو Android" ملف Java يحتوي على رمز هيكل يمكنك تعديله. يفتح الملف في محرر التعليمات البرمجية.

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

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

يسرد هذا القسم رمز نموذج ملف Android Studio المكتوب بلغة البرمجة النصية 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.