دليل إعداد النظام

ثبّت الأدوات التي تحتاجها لهذا المشروع. اختر نظام التشغيل الخاص بك من الأقسام أدناه.

Python 3.10+

Windows

الخيار أ — المثبّت (مستحسن): 1. انتقل إلى https://www.python.org/downloads/ 2. نزّل Python 3.12.x 3. شغّل المثبّت، وحدّد "Add Python to PATH" في أسفل النافذة 4. افتح موجه الأوامر (Command Prompt) أو PowerShell وتحقق:

python --version
pip --version

الخيار ب — winget (إذا كان نظامك Windows 10 إصدار 1709 أو أحدث):

winget install Python.Python.3.12

الخيار ج — WSL2 (الأفضل لهذا المشروع): راجع قسم WSL2 أدناه للحصول على بيئة Linux كاملة داخل Windows.

macOS

الخيار أ — Homebrew (مستحسن):

# ثبّت Homebrew أولًا (إن لم يكن مثبتًا لديك)
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# ثبّت Python
brew install python@3.12

# تحقق
python3 --version
pip3 --version

الخيار ب — المثبّت: 1. انتقل إلى https://www.python.org/downloads/ 2. نزّل Python 3.12.x لنظام macOS 3. شغّل المثبّت

Linux (Ubuntu/Debian)

sudo apt update
sudo apt install python3.12 python3.12-venv python3-pip
python3.12 --version

Node.js 18+

Windows

winget install OpenJS.NodeJS.LTS

أو نزّله من https://nodejs.org/ (إصدار LTS)

macOS

brew install node

Linux

# باستخدام مدير إصدارات Node (مستحسن)
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
# أعد تشغيل الطرفية، ثم:
nvm install 18
nvm use 18

تحقق:

node --version
npm --version

Git

Windows

winget install Git.Git

أو نزّله من https://git-scm.com/download/win

macOS

# الخيار أ: أدوات سطر أوامر Xcode (تتضمن git)
xcode-select --install

# الخيار ب: Homebrew
brew install git

Linux

sudo apt install git

تحقق:

git --version

VS Code (محرر الأكواد)

Windows

winget install Microsoft.VisualStudioCode

macOS

brew install --cask visual-studio-code

Linux

sudo snap install code --classic

بعد التثبيت، افتح VS Code وثبّت هذه الإضافات (اضغط أيقونة الإضافات على اليسار، ثم ابحث عن كل إضافة وثبّتها): - Python (ms-python.python) — تلوين الصياغة وفحص الكود - ES7+ React/Redux (dsznajder.es7-react-js-snippets) — مقتطفات React - Prettier (esbenp.prettier-vscode) — تنسيق تلقائي

Expo Go (اختبار الجوال)

• iOS: ثبّت "Expo Go" من App Store
• Android: ثبّت "Expo Go" من Google Play Store

يجب أن يكون هاتفك وحاسوبك على شبكة WiFi نفسها.

النظام الفرعي لـ Linux في Windows (WSL2) — على Windows فقط

يمنحك WSL2 طرفية Linux كاملة داخل Windows، ويجنّبك كثيرًا من مشكلات Python الخاصة بـ Windows.

الخطوة 1: تثبيت WSL2

افتح PowerShell كمسؤول ونفّذ:

wsl --install

أعد تشغيل حاسوبك عند ظهور الطلب.

الخطوة 2: تشغيل Ubuntu

بعد إعادة التشغيل، سيعمل Ubuntu ويطلب منك إنشاء اسم مستخدم وكلمة مرور في Linux.

الخطوة 3: تثبيت Python وNode داخل WSL2

sudo apt update && sudo apt upgrade -y
sudo apt install python3.12 python3.12-venv python3-pip -y
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
# أعد تشغيل الطرفية، ثم:
nvm install 18

الخطوة 4: الوصول إلى ملفاتك

توجد ملفات Windows الخاصة بك في المسار /mnt/c/. انتقل إلى مشروعك:

cd /mnt/c/Users/YourName/path/to/aiproject

الخطوة 5: VS Code مع WSL2

في طرفية WSL2، انتقل إلى المشروع ونفّذ:

code .

سيفتح هذا VS Code متصلًا بـ WSL2 — يمكنك تحرير الملفات من Windows بينما تنفّذ الأوامر في طرفية Linux.

لماذا WSL2؟ معظم الدروس وإجابات Stack Overflow تفترض Linux. ولهذا يقضي WSL2 على مشكلات «يعمل على جهازي».

Docker (اختياري — بديل عن تثبيت Python مباشرة)

بدلًا من تثبيت Python على جهازك، يمكنك استخدام Docker لتشغيل الواجهة الخلفية داخل حاوية معزولة. وستظل بحاجة إلى Node.js لتطبيق الجوال.

Windows

winget install Docker.DockerDesktop

macOS

brew install --cask docker

Linux (Ubuntu/Debian)

sudo apt install docker.io docker-compose-v2
sudo systemctl enable --now docker
sudo usermod -aG docker $USER
# سجّل الخروج ثم الدخول من جديد كي يسري تغيير المجموعة

تحقق:

docker --version
docker compose version

التحقق من كل شيء

نفّذ هذه الأوامر وتأكد من أن كل أمر منها يعيد رقم إصدار:

python3 --version       # → Python 3.10+
pip3 --version          # → pip 23+
node --version          # → v18+
npm --version           # → 9+
git --version           # → 2.x+
code --version          # → 1.x+
docker --version        # → 24+ (إذا ثبّت Docker)
docker compose version  # → 2.x+ (إذا ثبّت Docker)

الخطوة التالية: إدخال العربية (مستحسن)

إذا كنت تخطط لكتابة العربية في التعليقات أو التوثيق أو نصوص التطبيق، فاضبط تخطيط لوحة مفاتيح عربية الآن. يغطي 06-arabic-keyboard.md أنظمة Windows وmacOS وLinux وAndroid وiOS، بما في ذلك اختصارات تبديل اللغة أثناء الكتابة.

يبقى الكود والأوامر وأسماء الملفات في هذا الدرس بالإنجليزية، وتُستخدم العربية في التعليقات والنصوص الموجّهة إلى المستخدم.