Android SDK لا يرى JDK: حل خطوة بخطوة مع أمثلة بلغة Java

«Android SDK installation doesn't find JDK» — ألم مألوف؟

هل تحاول إعداد بيئة التطوير لنظام Android، وتقوم بتشغيل تثبيت SDK، وفي المقابل لا تحصل على رد؟ أو ما هو أسوأ، خطأ أحمر: «Android SDK installation doesn't find JDK». إذا كنت قد بحثت عن هذه العبارة من قبل، فأنت تعلم: على Stack Overflow، هناك آلاف المشاهدات وعشرات الإجابات المخصصة لهذه المشكلة.

لماذا يحدث هذا؟ يبدو أنك قمت بتنزيل JDK وتثبيته، لكن النظام يرفض رؤيته. في هذه المقالة، لن نقوم فقط بتحليل الأسباب، بل سنعرض بأمثلة حقيقية من كود Java كيفية إعداد البيئة بشكل صحيح حتى يتعاون Android SDK أخيرًا مع JDK.

نحن فريق PythonLib، وعلى الرغم من أن اسمنا يحتوي على Python، إلا أننا نعلم أن Java هي أساس تطوير Android. ستكون مادة اليوم مفيدة لكل من يريد حل هذه المشكلة المزعجة مرة واحدة وإلى الأبد.

لماذا لا يرى Android SDK JDK؟ ثلاثة أسباب رئيسية

قبل أن نتعمق في الكود، دعنا نفهم العدو جيدًا. خطأ «Android SDK installation doesn't find JDK» يحدث غالبًا بسبب ثلاثة أشياء:

\n
• المسار إلى JDK غير صحيح — ببساطة، المثبّت لا يعرف أين يبحث عن Java.
\n
• متغير البيئة JAVA_HOME مفقود — يعتمد Android SDK عليه.
\n
• تضارب الإصدارات — قمت بتثبيت JDK 32-bit بينما النظام 64-bit، أو العكس.
\n

الأكثر إزعاجًا هو أنه حتى إذا قمت بتحديد المسار يدويًا في المثبّت، فقد يعود الخطأ. لماذا؟ لأن Android SDK يتحقق ليس فقط من المسار الصريح، ولكن أيضًا من متغيرات البيئة. دعنا نحلل كل حالة مع أمثلة.

الخطوة 1: التحقق من تثبيت JDK من الأساس

قبل إعداد أي شيء، تأكد من وجود JDK بالفعل. افتح الطرفية (سطر الأوامر) ونفّذ أمر Java بسيط:

java -version

إذا رأيت شيئًا مثل:

java version "17.0.2" 2022-01-18 LTS\nJava(TM) SE Runtime Environment (build 17.0.2+8-LTS-86)\nJava HotSpot(TM) 64-Bit Server VM (build 17.0.2+8-LTS-86, mixed mode)

كل شيء على ما يرام — JDK مثبت. إذا لم يتم العثور على الأمر، فهذا يعني أن المشكلة أعمق. تحتاج إلى تنزيل JDK من الموقع الرسمي لـ Oracle أو استخدام OpenJDK. لتطوير Android، يُوصى بالإصدار 11 أو 17.

مثال كود: التحقق من إصدار Java من الداخل

إذا كنت تكتب سكريبتًا بلغة Java للتحقق من البيئة، يمكنك استخدام الفئة المدمجة System:

public class CheckJavaVersion {\n    public static void main(String[] args) {\n        String version = System.getProperty("java.version");\n        String home = System.getProperty("java.home");\n        System.out.println("Java version: " + version);\n        System.out.println("Java home: " + home);\n    }\n}

سيقوم هذا الكود بطباعة الإصدار والمسار إلى Java المثبتة. إذا كان java.home يشير إلى مجلد jre وليس jdk، فقد يكون هذا سبب الخطأ — يتطلب Android SDK JDK وليس JRE.

الخطوة 2: إعداد متغير JAVA_HOME

هذه هي النصيحة الأكثر شيوعًا على Stack Overflow، وهي تعمل. يجب أن يشير المتغير JAVA_HOME إلى المجلد الجذر لـ JDK، وليس إلى مجلد bin أو jre.

كيف تفعل ذلك؟

\n
• Windows: لوحة التحكم ← النظام ← إعدادات النظام المتقدمة ← متغيرات البيئة. أنشئ متغير نظام جديد JAVA_HOME بقيمة مثل: C:\\Program Files\\Java\\jdk-17.
\n
• macOS/Linux: حرّر ملف ~/.bashrc أو ~/.zshrc وأضف السطر: export JAVA_HOME=/usr/lib/jvm/jdk-17.
\n

بعد ذلك، أعد تشغيل الطرفية وتحقق:

echo %JAVA_HOME%   # لنظام Windows\necho $JAVA_HOME    # لنظام macOS/Linux