إصدارات Java في إصدارات Android

سواء كان رمز المصدر مكتوبًا بلغة Java أو Kotlin أو كليهما، هناك عدة مواضع يجب فيها اختيار إصدار JDK أو لغة Java لإنشاء حِزمك.

مسرد المصطلحات

مجموعة تطوير Java ‏ (JDK)

تتضمّن حزمة تطوير Java (JDK) :

• أدوات، مثل المُجمِّع وأدوات تحليل الأداء وأدوات إنشاء الأرشيف ويتم استخدامها في الكواليس أثناء عملية الإنشاء ل إنشاء تطبيقك.
• المكتبات التي تحتوي على واجهات برمجة تطبيقات يمكنك الاتصال بها من رمز المصدر Kotlin أو Java يُرجى العلم أنّ بعض الدوال ليست متاحة على Android.
• ‫Java Virtual Machine ‏ (JVM)، وهو مترجم ينفذ تطبيقات Java يمكنك استخدام JVM لتشغيل بيئة تطوير Android Studio IDE وأداة إنشاء Gradle. لا يتم استخدام "آلة Java الافتراضية" على أجهزة Android أو المحاكيات.

JetBrains Runtime ‏ (JBR)

JetBrains Runtime (JBR) هو إصدار مُحسَّن من حزمة Java Development Kit (JDK) ويتم توزيعه مع Android Studio. يتضمّن العديد من التحسينات لاستخدامها في Studio ومنتجات JetBrains ذات الصلة، ولكن يمكن استخدامه أيضًا لتشغيل تطبيقات Java أخرى.

كيف يمكنني اختيار حزمة تطوير Java (JDK) لتشغيل "استوديو Android"؟

ننصحك باستخدام JBR لتشغيل Android Studio. ويتم نشره مع "استوديو Android" واستخدامه لاختباره، ويتضمن تحسينات لأفضل استخدام لخدمة "استوديو Android". لضمان ذلك، لا تضبط متغيّر البيئة STUDIO_JDK.

تبحث نصوص التشغيل الخاصة بـ "استوديو Android" عن بيئة Java الافتراضية بالترتيب التالي:

1. متغيّر البيئة STUDIO_JDK
2. دليل studio.jdk (في حزمة توزيع "استوديو Android")
3. jbr (JetBrains Runtime)، في الإصدار المُوزَّع من "استوديو Android" يُنصح به.
4. متغيّر البيئة JDK_HOME
5. متغيّر البيئة JAVA_HOME
6. ملف java قابل للتنفيذ في متغيّر البيئة PATH

كيف يمكنني اختيار حزمة JDK التي تشغّل عمليات إنشاء Gradle؟

في حال تشغيل Gradle باستخدام الأزرار في "استوديو Android"، يتم استخدام حزمة JDK التي تم ضبطها في إعدادات "استوديو Android" لتشغيل Gradle. إذا كنت تشغّل Gradle في وحدة طرفية، سواء داخل استوديو Android أو خارجه، يحدِّد متغيّر البيئة JAVA_HOME (في حال ضبطه) حزمة JDK التي تشغّل نصوص Gradle البرمجية. في حال عدم ضبط JAVA_HOME ، يتم استخدام الأمر java في متغيّر PATH للبيئة.

للحصول على أفضل النتائج المتسقة، احرص على ضبط JAVA_HOME متغيّر البيئة، و إعدادات Gradle JDK في Android Studio علىJDK نفسه.

عند تشغيل عملية الإنشاء، تنشئ Gradle عملية تُعرف باسم الخادم الدائم للقيام بعملية الإنشاء الفعلية. يمكن إعادة استخدام هذه العملية، ما دامت عمليات الإنشاء تستخدم إصدار JDK وGradle نفسهما. يؤدي إعادة استخدام الخادم الدائم إلى تقليل وقت بدء تشغيل Java Virtual Machine (JVM) الجديد وإعداد نظام الإنشاء.

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

ضبط JDK في Gradle في "استوديو Android"

لتعديل إعدادات Gradle JDK للمشروع الحالي، افتح إعدادات Gradle من ملف (أو Android Studio على نظام التشغيل macOS) > الإعدادات > الإنشاء والتنفيذ والنشر > أدوات الإنشاء > Gradle. تحتوي القائمة المنسدلة Gradle JDK على الخيارات التالية للاختيار من بينها:

• وحدات الماكرو، مثل JAVA_HOME وGRADLE_LOCAL_JAVA_HOME
• إدخالات جدول JDK بتنسيق vendor-version مثل jbr-17 التي يتم تخزينها في ملفات إعدادات Android
• تنزيل حزمة تطوير Java (JDK)
• إضافة حزمة JDK معيّنة
• حِزم JDK التي تم رصدها محليًا من ملف التثبيت التلقائي لحِزم JDK في نظام التشغيل

يتم تخزين الخيار المحدّد في الخيار gradleJvm في ملف .idea/gradle.xml المشروع، ويتم استخدام عملية تحديد مسار JDK لتشغيل IDE IDE عند تشغيله من خلال "استوديو Android".

تتيح الوحدات النمطية اختيار مسار JDK الديناميكي للمشروع:

• JAVA_HOME: يستخدم متغيّر البيئة بالاسم نفسه
• GRADLE_LOCAL_JAVA_HOME: يستخدم الخاصية java.home فيملف .gradle/config.properties الذي يُستخدَم تلقائيًا مع JetBrains Runtime.

يتم استخدام حزمة JDK المحدّدة لتشغيل عملية إنشاء Gradle وحلّ مراجع JDK API عند تعديل نصوص إنشاء البرامج والرموز المصدرية. يُرجى العِلم أنّ الcompileSdk المحدّد سيفرض قيودًا إضافية على رموز Java التي ستكون متوفرة عند تعديل رمز المصدر وإنشاءه.

احرص على اختيار إصدار JDK أعلى من أو يساوي إصدارات JDK التي تستخدمها المكوّنات الإضافية في عملية إنشاء Gradle. لتحديد الحد الأدنى من إصدار JDK المطلوب لمكوّن Android Gradle الإضافي (AGP)، اطّلِع على جدول التوافق في ملاحظات الإصدار.

على سبيل المثال، يتطلّب الإصدار 8.x من المكوّن الإضافي لنظام Gradle المتوافق مع Android استخدام JDK 17. إذا حاولت تشغيل إصدار Gradle يستخدم هذا الإصدار مع إصدار سابق منJDK، سيُرسِل رسالة مثل:

An exception occurred applying plugin request [id: 'com.android.application']
> Failed to apply plugin 'com.android.internal.application'.
   > Android Gradle plugin requires Java 17 to run. You are currently using Java 11.
      Your current JDK is located in /usr/local/buildtools/java/jdk
      You can try some of the following options:
       - changing the IDE settings.
       - changing the JAVA_HOME environment variable.
       - changing `org.gradle.java.home` in `gradle.properties`.

ما هي واجهات برمجة تطبيقات Java التي يمكنني استخدامها في رمز المصدر Java أو Kotlin؟

يمكن لتطبيق Android استخدام بعض واجهات برمجة التطبيقات المحدّدة في حزمة JDK، ولكن ليس كلّها. تحدِّد حزمة تطوير البرامج (SDK) لنظام التشغيل Android عمليات تنفيذ العديد من وظائف مكتبة Java كجزء من واجهات برمجة التطبيقات المتاحة. تحدِّد السمة compileSdk إصدار حزمة تطوير البرامج (SDK) لنظام التشغيل Android المطلوب استخدامه عند تجميع رمز المصدر Kotlin أو Java.

android {
    ...
    compileSdk = 33
}

android {
    ...
    compileSdk 33
}

يتوافق كل إصدار من Android مع إصدار محدّد من حزمة تطوير البرامج (JDK) ومجموعة فرعية من واجهات برمجة تطبيقات Java المتاحة. إذا كنت تستخدم واجهة برمجة تطبيقات Java متاحة في compileSdk غير متوفّرة في minSdk المحدّد، قد تتمكّن من استخدام واجهة برمجة التطبيقات في الإصدار الأقدم من Android من خلال عملية تُعرف باسم إزالة السكر. اطّلِع على واجهات برمجة تطبيقات Java 11 والإصدارات الأحدث المتاحة من خلال إزالة رمز الترميز البرمجي للاطّلاع على واجهات برمجة التطبيقات المتوافقة.

استخدِم هذا الجدول لتحديد إصدار Java المتوافق مع كل واجهة برمجة تطبيقات Android، ومكان العثور على تفاصيل حول واجهات برمجة تطبيقات Java المتاحة.

ما هو إصدار JDK الذي يُجمِّع رمز مصدر Java الخاص بي؟

يحتوي JDK في مجموعة أدوات Java على مُجمِّع Java المستخدَم لتجميع أي رمز برمجي مصدر لـ Java. ويعمل هذا الإصدار من حزمة تطوير البرامج (JDK) أيضًا على تشغيل javadoc واختبارات الوحدة أثناء عملية الإنشاء.

تكون سلسلة الأدوات تلقائيًا هي JDK المستخدَمة لتشغيل Gradle. في حال استخدام الإصدار التلقائي وتشغيل عملية إنشاء على أجهزة مختلفة (على سبيل المثال، جهازك المحلي وخادم منفصل لدمج مستمر)، يمكن أن تختلف نتائج عملية الإنشاء في حال استخدام إصدارات مختلفة من JDK.

لإنشاء إصدار أكثر اتساقًا، يمكنك تحديد إصدار مجموعة أدوات Java صراحةً. عند تحديد ذلك:

• يحدِّد هذا الخيار موقع حزمة JDK متوافقة على النظام الذي يشغِّل عملية الإنشاء.
  • إذا لم يتوفّر JDK متوافق (وإذا تمّ تحديد أداة حلّ سلسلة الأدوات)، يتم تنزيل أداة.
• تعرِض واجهات برمجة تطبيقات Java لسلسلة الأدوات طلبات البيانات من رمز المصدر.
• تُجمِّع مصدر Java باستخدام إصدار لغة Java.
• الإعدادات التلقائية للمواد المستهلكة في sourceCompatibility و targetCompatibility

ننصحك دائمًا بتحديد سلسلة أدوات Java، وضمان تثبيتJDK المحدّد أو إضافة أداة حلّ سلسلة أدوات إلى عملية الإنشاء.

يمكنك تحديد سلسلة الأدوات سواء كان رمز المصدر مكتوبًا بلغة Java أو Kotlin أو كليهما. حدِّد سلسلة الأدوات في أعلى مستوى من ملف build.gradle(.kts) الخاص بالوحدة.

حدِّد إصدار سلسلة أدوات Java على النحو التالي:

java {
    toolchain {
        languageVersion = JavaLanguageVersion.of(17)
    }
}

java {
    toolchain {
        languageVersion = JavaLanguageVersion.of(17)
    }
}

ويعمل هذا الإجراء إذا كان المصدر هو Kotlin أو Java أو مزيجًا من كليهما.

يمكن أن يكون إصدار JDK الخاص بسلسلة الأدوات هو نفسه إصدار JDK المستخدَم لتشغيل Gradle، ولكن تجدر الإشارة إلى أنّهما يخدمان أغراضًا مختلفة.

ما هي ميزات لغة Java المصدر التي يمكنني استخدامها في رمز Java المصدر؟

يحدِّد المَعلمة sourceCompatibility ميزات لغة Java التي تكون متاحة أثناء تجميع مصدر Java. ولا يؤثّر ذلك في مصدر Kotlin.

حدِّد sourceCompatibility في ملف build.gradle(.kts) الخاص بالوحدة على النحو التالي:

android {
    compileOptions {
        sourceCompatibility = JavaVersion.VERSION_17
    }
}

android {
    compileOptions {
        sourceCompatibility JavaVersion.VERSION_17
    }
}

في حال عدم تحديد هذه السمة، يتم ضبطها تلقائيًا على إصدار مجموعة أدوات Java. إذا كنت لا تستخدم مجموعة أدوات Java، سيتم استخدام إصدار تلقائيًا يختاره المكوّن الإضافي Android Gradle (مثل Java 8 أو إصدار أحدث).

ما هي ميزات Java الثنائية التي يمكن استخدامها عند تجميع مصدر Kotlin أو Java؟

تحدّد السمتَان targetCompatibility وjvmTarget إصدار تنسيق فئة Java المستخدَم عند إنشاء رمز برمجي ثنائي لملف برمجي Java وملف Kotlin المجمَّعَين على التوالي.

كانت بعض ميزات Kotlin متوفّرة قبل إضافة ميزات Java المماثلة لها. كان على مجمعات Kotlin الأولى إنشاء طريقتها الخاصة لتمثيل ميزات Kotlin هذه. وتمّت إضافة بعض هذه الميزات لاحقًا إلى Java. في الإصدارات الأحدث من jvmTarget، قد يستخدم مُجمِّع Kotlin ميزة Java مباشرةً، ما قد يؤدي إلى تحسين الأداء.

تتوافق إصدارات Android المختلفة مع إصدارات Java المختلفة. يمكنك الاستفادة من ميزات Java الإضافية من خلال زيادة targetCompatibility وjvmTarget، ولكن قد يفرض عليك ذلك أيضًا زيادة الحد الأدنى لإصدار حزمة تطوير البرامج (SDK) لنظام التشغيل Android لضمان توفّر الميزة.

يُرجى العلم أنّه يجب أن تكون قيمة targetCompatibility أكبر من أو تساوي sourceCompatibility. من الناحية العملية، يجب أن تستخدم القيم sourceCompatibility targetCompatibility وjvmTarget بشكل عام القيمة نفسها. ويمكنك ضبطها على النحو التالي:

android {
    compileOptions {
        sourceCompatibility = JavaVersion.VERSION_17
        targetCompatibility = JavaVersion.VERSION_17
    }
    kotlinOptions {
        jvmTarget = "17"
    }
}

android {
    compileOptions {
        sourceCompatibility JavaVersion.VERSION_17
        targetCompatibility JavaVersion.VERSION_17
    }
    kotlinOptions {
        jvmTarget '17'
    }
}

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