🔝 الدليل الرئيسي للسلسلة: 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 المُخصَّصة.