سواء كان الرمز المصدر مكتوبًا بلغة Java أو Kotlin أو كليهما، هناك عدة أماكن يجب فيها اختيار إصدار JDK أو لغة Java لإصدارك.
مسرد المصطلحات
- حزمة تطوير برامج Java (JDK)
-
تحتوي حزمة تطوير Java (JDK)
على:
- أدوات، مثل برنامج تجميع، وأداة تحليل الأداء، وأداة إنشاء الأرشيف تُستخدَم هذه المعلومات وراء الكواليس أثناء عملية الإنشاء لإنشاء تطبيقك.
- المكتبات التي تحتوي على واجهات برمجة التطبيقات التي يمكنك طلبها من رمز المصدر Kotlin أو Java. يُرجى العِلم أنّ بعض الوظائف غير متاحة على أجهزة Android.
- آلة Java الافتراضية (JVM)، وهي مترجم ينفّذ تطبيقات Java يمكنك استخدام جهاز Java الافتراضي لتشغيل بيئة التطوير المتكاملة (IDE) في "استوديو Android" وأداة إصدار Gradle. لا يتم استخدام جهاز JVM على أجهزة Android أو المحاكيات.
- JetBrains Runtime (JBR)
- JetBrains Runtime (JBR) هي حزمة JDK محسّنة يتم توزيعها مع "استوديو Android". ويتضمّن العديد من التحسينات للاستخدام في "استوديو Android" ومنتجات JetBrains ذات الصلة، ولكن يمكن استخدامه أيضًا لتشغيل تطبيقات Java الأخرى.
كيف يمكنني اختيار حزمة تطوير برامج Java (JDK) لتشغيل استوديو Android؟
ننصحك باستخدام JBR لتشغيل استوديو Android. ويتم نشره مع "استوديو Android" ويُستخدم لاختباره، ويتضمّن تحسينات للاستخدام الأمثل لـ "استوديو Android". لضمان ذلك، لا تضبط متغيّر البيئة STUDIO_JDK.
تبحث النصوص البرمجية للتشغيل في "استوديو Android" عن جهاز JVM بالترتيب التالي:
- متغيّر البيئة
STUDIO_JDK - دليل
studio.jdk(في توزيعة "استوديو Android") - دليل
jbr(JetBrains Runtime) في توزيعة "استوديو Android". حقل يُنصح به. - متغيّر البيئة
JDK_HOME - متغيّر البيئة
JAVA_HOME - ملف
javaالتنفيذي في متغيّر البيئةPATH
كيف يمكنني اختيار حزمة JDK التي تشغّل إصدارات Gradle؟
إذا شغّلت Gradle باستخدام الأزرار في "استوديو Android"، يتم استخدام حزمة JDK المحدّدة في إعدادات "استوديو Android" لتشغيل Gradle. إذا كنت تشغّل Gradle في وحدة طرفية، سواء داخل "استوديو Android" أو خارجه، يحدّد متغيّر البيئة JAVA_HOME (في حال ضبطه) حزمة JDK التي تشغّل نصوص Gradle البرمجية. في حال عدم ضبط JAVA_HOME، يتم استخدام الأمر java في متغيّر بيئة PATH.
للحصول على نتائج أكثر اتساقًا، تأكَّد من ضبط متغيّر بيئة JAVA_HOME وإعدادات Gradle JDK في "استوديو Android" على JDK نفسه.
عند تشغيل الإصدار، ينشئ Gradle عملية تُسمى برنامج خفي لتنفيذ الإصدار الفعلي. ويمكن إعادة استخدام هذه العملية، طالما أنّ الإصدارات تستخدم إصدار JDK وGradle نفسه. تؤدي إعادة استخدام برنامج daemon إلى تقليل الوقت اللازم لبدء جهاز JVM جديد وإعداد نظام الإصدار.
إذا بدأت عمليات الإنشاء باستخدام إصدارات مختلفة من JDK أو Gradle، يتم إنشاء برامج خفية إضافية، ما يستهلك المزيد من وحدة المعالجة المركزية والذاكرة.
إعداد Gradle JDK في "استوديو Android"
لتعديل إعدادات Gradle JDK للمشروع الحالي، افتح إعدادات Gradle من ملف (أو استوديو Android على نظام التشغيل macOS) > الإعدادات > الإنشاء والتنفيذ والنشر > أدوات الإنشاء > Gradle. تحتوي القائمة المنسدلة Gradle JDK على الخيارات التالية للاختيار من بينها:
- وحدات ماكرو مثل
JAVA_HOMEوGRADLE_LOCAL_JAVA_HOME - إدخالات جدول JDK بتنسيق
vendor-versionمثلjbr-17المخزَّنة في ملفات إعدادات Android - تنزيل حزمة تطوير برامج Java (JDK)
- إضافة حزمة تطوير برامج Java (JDK) محدّدة
- مجموعات JDK التي تم رصدها محليًا من دليل تثبيت JDK التلقائي لنظام التشغيل
يتم تخزين الخيار المحدّد في الخيار gradleJvm في ملف .idea/gradle.xml الخاص بالمشروع، ويتم استخدام دقة مسار JDK لتشغيل Gradle عند بدء تشغيله من خلال "استوديو Android".
تتيح وحدات الماكرو اختيار مسار JDK الديناميكي للمشروع:
-
JAVA_HOME: يستخدم متغيّر البيئة الذي يحمل الاسم نفسه GRADLE_LOCAL_JAVA_HOME: يستخدم السمةjava.homeفي ملف.gradle/config.propertiesالذي يتم ضبطه تلقائيًا على JetBrains Runtime.
يتم استخدام حزمة JDK المحدّدة لتشغيل إصدار Gradle وحلّ مراجع واجهة برمجة تطبيقات JDK عند تعديل النصوص البرمجية للإصدار والرمز المصدر. يُرجى العِلم أنّ السمة compileSdk المحدّدة ستفرض قيودًا إضافية على رموز Java التي ستكون متاحة عند تعديل الرمز المصدر وإنشائه.
احرص على اختيار إصدار JDK أعلى من أو يساوي إصدارات JDK المستخدَمة في المكوّنات الإضافية التي تستخدمها في إصدار Gradle. لتحديد الحد الأدنى المطلوب لإصدار JDK في "المكوّن الإضافي لنظام Gradle المتوافق مع Android" (AGP)، يُرجى الاطّلاع على جدول التوافق في ملاحظات الإصدار.
على سبيل المثال، يتطلّب الإصدار 8.x من المكوّن الإضافي لنظام Gradle المتوافق مع Android الإصدار 17 من حزمة تطوير البرامج في Java (JDK). إذا حاولت تشغيل إصدار 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.
Kotlin
android {
...
compileSdk = 36
}
أنيق
android {
...
compileSdk 36
}
يتوافق كل إصدار من Android مع إصدار معيّن من حزمة تطوير البرامج في Java ومجموعة فرعية من واجهات برمجة تطبيقات Java المتاحة. إذا كنت تستخدم واجهة برمجة تطبيقات Java متاحة في compileSdk وغير متاحة في minSdk المحدّد، قد تتمكّن من استخدام واجهة برمجة التطبيقات في الإصدار الأقدم من Android من خلال عملية تُعرف باسم إزالة التجميل اللغوي. يمكنك الاطّلاع على واجهات برمجة تطبيقات Java 11 والإصدارات الأحدث المتاحة من خلال عملية إزالة التجميل اللغوي لمعرفة واجهات برمجة التطبيقات المتوافقة.
استخدِم هذا الجدول لتحديد إصدار Java المتوافق مع كل واجهة برمجة تطبيقات Android، ومكان العثور على تفاصيل حول واجهات برمجة تطبيقات Java المتاحة.
| Android | Java | ميزات واجهة برمجة التطبيقات واللغة المتوافقة |
|---|---|---|
| 14 (المستوى 34 لواجهة برمجة التطبيقات) | 17 | المكتبات الأساسية |
| 13 (المستوى 33 لواجهة برمجة التطبيقات) | 11 | المكتبات الأساسية |
| 12 (المستوى 32 لواجهة برمجة التطبيقات) | 11 | Java API |
| الإصدار 11 أو الأقدم | إصدارات Android |
ما هي حزمة 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 على النحو التالي:
Kotlin
java {
toolchain {
languageVersion = JavaLanguageVersion.of(17)
}
}
أنيق
java {
toolchain {
languageVersion = JavaLanguageVersion.of(17)
}
}
يعمل هذا الإجراء إذا كان المصدر هو Kotlin أو Java أو مزيجًا من الاثنين.
يمكن أن يكون إصدار حزمة تطوير البرامج (JDK) لسلسلة الأدوات هو نفسه إصدار حزمة تطوير البرامج (JDK) المستخدَم لتشغيل Gradle، ولكن تذكَّر أنّهما يخدمان أغراضًا مختلفة.
ما هي ميزات مصدر لغة Java التي يمكنني استخدامها في رمز المصدر الخاص بي؟
تحدّد السمة sourceCompatibility ميزات لغة Java المتاحة أثناء تجميع مصدر Java.
ولا يؤثر ذلك في مصدر Kotlin.
حدِّد sourceCompatibility في ملف build.gradle(.kts) الخاص بالوحدة على النحو التالي:
Kotlin
android {
compileOptions {
sourceCompatibility = JavaVersion.VERSION_17
}
}
أنيق
android {
compileOptions {
sourceCompatibility JavaVersion.VERSION_17
}
}
إذا لم يتم تحديد هذه السمة، يتم ضبطها تلقائيًا على إصدار سلسلة أدوات Java. إذا لم تكن تستخدم سلسلة أدوات Java، سيتم تلقائيًا استخدام إصدار يختاره المكوّن الإضافي لنظام Gradle المتوافق مع Android (على سبيل المثال، Java 8 أو إصدار أحدث).
ما هي ميزات Java الثنائية التي يمكن استخدامها عند تجميع مصدر Kotlin أو Java؟
تحدّد السمة targetCompatibility إصدار تنسيق فئة Java المستخدَم عند إنشاء رمز بايت لمصدر Java وKotlin المجمَّعَين على التوالي.
كانت بعض ميزات Kotlin موجودة قبل إضافة ميزات Java المكافئة.
كان على برامج تجميع Kotlin القديمة إنشاء طريقتها الخاصة لتمثيل ميزات Kotlin هذه. تمت إضافة بعض هذه الميزات لاحقًا إلى Java.
ومع مستويات targetCompatibility الأحدث، قد يستخدم برنامج تجميع Kotlin ميزة Java مباشرةً، ما قد يؤدي إلى تحسين الأداء.
تتوافق الإصدارات المختلفة من Android مع إصدارات مختلفة من Java. يمكنك الاستفادة من ميزات Java الإضافية من خلال زيادة targetCompatibility، ولكن قد يفرض عليك ذلك أيضًا زيادة الحد الأدنى لإصدار حزمة تطوير البرامج (SDK) لنظام التشغيل Android لضمان توفّر الميزة.
يُرجى العِلم أنّ قيمة targetCompatibility يجب أن تكون أكبر من أو تساوي
sourceCompatibility. من الناحية العملية، يجب أن تستخدم السمتان sourceCompatibility وtargetCompatibility القيمة نفسها بشكل عام. ويمكنك ضبطها على النحو التالي:
Kotlin
android {
compileOptions {
sourceCompatibility = JavaVersion.VERSION_17
targetCompatibility = JavaVersion.VERSION_17
}
}
أنيق
android {
compileOptions {
sourceCompatibility JavaVersion.VERSION_17
targetCompatibility JavaVersion.VERSION_17
}
}
إذا كنت تستخدم إصدارًا من Kotlin أقدم من 2.2، عليك أيضًا ضبط
kotlinOptions:
Kotlin
android {
kotlinOptions {
jvmTarget = "17"
}
}
أنيق
android {
kotlinOptions {
jvmTarget = "17"
}
}
وفي حال عدم تحديدها، يتم ضبط هذه السمات تلقائيًا على إصدار سلسلة أدوات Java. إذا لم تكن تستخدم سلسلة أدوات Java، قد تختلف القيم التلقائية وتؤدي إلى حدوث مشاكل في عملية الإنشاء. لذلك، ننصحك دائمًا بتحديد هذه القيم بشكل صريح أو استخدام سلسلة أدوات Java.