🔝 الدليل الرئيسي للسلسلة: Kotlin وJetpack Compose في 2026: أندرويد الأصلية الحديثة

تثبيت سلسلة أدوات Android حديثة في 2026 يتطلّب أكثر قليلًا من النقر على « Next, Next, Finish ». بين Android Studio Otter 3 Feature Drop، وJDK 17 المُضمَّن، واختيار SDK، وتفعيل KSP، وإعداد ذاكرة IDE، وربط جهاز، كل ضبط يؤثّر على راحة وسرعة التطوير. يستعرض هذا الدرس التثبيت خطوة بخطوة.

المتطلبات

OS: Windows 10/11، macOS 13+، أو Linux Ubuntu 22.04+
RAM: 16 GB موصى به
قرص: 30 GB حرة على SSD
الوقت المُقدَّر: 60-90 دقيقة

الخطوة 1 — تحميل Android Studio Otter 3

الإصدار المستقر في 17 مايو 2026 هو Otter 3 Feature Drop، الإصدار 2025.2.3، الصادر في 15 يناير 2026. توجّه إلى developer.android.com/studio.

# macOS via Homebrew
brew install --cask android-studio

# Linux Ubuntu
wget https://redirector.gvt1.com/edgedl/android/studio/ide-zips/2025.2.3.X/android-studio-2025.2.3.X-linux.tar.gz
tar -xzf android-studio-2025.2.3.X-linux.tar.gz -C ~/
~/android-studio/bin/studio.sh

الخطوة 2 — أول إطلاق وتثبيت SDK

عند أول إطلاق، اقبل الافتراضات. اختيارات مهمة: API 36 (Android 16) كهدف 2026، API 24 كـ minSdk لتغطية 98% من الأجهزة. SDK يُثبَّت في ~/Library/Android/sdk (macOS)، %LOCALAPPDATA%\Android\Sdk (Windows)، أو ~/Android/Sdk (Linux).

sdkmanager --list_installed
# يجب أن ترى platform-tools, platforms;android-36, build-tools;36.0.0

الخطوة 3 — إنشاء مشروع Compose

انقر New Project → Empty Activity (تبويب Phone and Tablet). املأ: Name، Package name (مثل io.itskillscenter.hellokotlin)، Language Kotlin، Build configuration Kotlin DSL (build.gradle.kts)، Minimum SDK API 24. Finish.

الخطوة 4 — التحقق من إصدارات Kotlin وAGP وCompose BOM

افتح libs.versions.toml في gradle/:

[versions]
agp = "9.1.1"
kotlin = "2.3.21"
ksp = "2.3.8"
composeBom = "2026.05.00"
coreKtx = "1.17.0"
lifecycleRuntimeKtx = "2.10.0"
activityCompose = "1.13.0"
navigationCompose = "2.9.7"

AGP 9.1.1 يعمل مع Gradle 9.1 وJDK 17. Kotlin 2.3.21 ضروري لـ K2 المستقر وKSP2. Compose BOM 2026.05.00 يُحاذي compose-ui وcompose-material3 على 1.11.1.

الخطوة 5 — تفعيل KSP لـ Room وHilt

Room 3.0 لا يدعم سوى KSP، Hilt محاذى. أضف KSP الآن:

plugins {
    alias(libs.plugins.android.application) apply false
    alias(libs.plugins.kotlin.android) apply false
    alias(libs.plugins.kotlin.compose) apply false
    alias(libs.plugins.ksp) apply false
}

في app/build.gradle.kts، أضف id("com.google.devtools.ksp"). وجود KSP يُؤكَّد بظهور kspDebugKotlin في لوحة Gradle.

الخطوة 6 — إعداد محاكي أو جهاز فعلي

المحاكي AVD: Tools → Device Manager → Create Virtual Device. اختر Pixel 8، صورة نظام Android 16 (API 36) — Google APIs. حمّل (1.5 GB)، Finish. يبدأ في 30-60 ثانية.

جهاز فعلي: فعّل خيارات المطوّر (الإعدادات → حول الهاتف → نقر 7 مرات على رقم البناء). فعّل تصحيح USB. اربط الهاتف، اقبل الثقة، adb devices لتأكيد الاتصال.

الخطوة 7 — إطلاق المشروع لأول مرة

انقر Run الأخضر (Shift+F10 / Ctrl+R). Gradle يُطلق بناءً كاملًا. أول بناء بطيء (2-5 دقائق)، اللاحقات 10-30 ثانية بفضل التجميع التزايدي. التطبيق يفتح بشاشة « Hello Android! ». لقد صادقت السلسلة الكاملة: مُجمِّع Kotlin، Gradle، Compose، Android runtime.

للتأكد من Compose، افتح MainActivity.kt. التعليق @Preview فوق Greeting(...) + رمز العين في الميزاب يفتح معاينة تفاعلية.

أخطاء شائعة

العَرَض	السبب	الحل
Sync Gradle عالق	اتصال بطيء/جدار حماية	الصبر أو إعداد proxy
HAXM لا يُثبَّت Windows	Virtualization مُعطَّلة	تفعيل VT-x/AMD-V في BIOS
`JAVA_HOME not set`	JDK 17 غير موجود	File → Project Structure → SDK Location
محاكي متقطّع	لا تسريع عتادي	Use Hardware-Accelerated GPU في AVD
الجهاز غير مُكتشَف USB	Driver مفقود	تثبيت OEM driver، تجربة كابل آخر
`Cannot find @Preview`	Import مفقود	Alt+Enter ثم Import

تكييف الإعداد مع جهازك

على 8 GB RAM، عطّل المحاكي واستخدم هاتفًا فعليًا. زد heap الـ IDE: Help → Edit Custom VM Options، استبدل -Xmx2048m بـ -Xmx3072m (16 GB) أو -Xmx4096m (32 GB). للاتصالات المحدودة، gradle.properties: org.gradle.caching=true وorg.gradle.parallel=true. على Mac Apple Silicon، استخدم فقط صور ARM64.

الأسئلة الشائعة

IntelliJ IDEA Ultimate؟
لا. Android Studio مجاني وكافٍ.

أي JDK؟
JDK 17 مُضمَّن في Otter 3 وهو المُوصى به. JDK 21 يعمل أيضًا.

Git مُثبَّت منفصلًا؟
نعم. ثبّت من git-scm.com.

كم مساحة قرص؟
Studio + SDK + AVD + Gradle: 12-15 GB. كل مشروع: 1-3 GB. اعتمد 30-50 GB.

KMP من البداية؟
لا. ابدأ بمنصة أحادية ثم استكشف KMP لاحقًا.

بنائي يستغرق 5 دقائق؟
أول بناء طبيعي. إذا التالي بطيء، تحقّق من gradle.properties (parallel، caching، daemon) وRAM المُخصَّصة.

تثبيت Android Studio Otter 3 وإعداد Kotlin خطوة بخطوة