طريقة إعداد أودو 19 في PyCharm على Windows

تشغيل الفيديو: Odoo 19 development setup: PyCharm on Windows

لماذا تطوير أودو على Windows

تعمل خوادم أودو في بيئات الإنتاج على Linux في كل الحالات تقريبًا. أما للتطوير المحلي فيؤدي Windows المهمة جيدًا إذا كان هو الجهاز الذي تستخدمه كل يوم: تحصل على أداة تصحيح الأخطاء في PyCharm، وعلى PostgreSQL وGit، دون جهاز افتراضي أو نظام تشغيل ثانٍ.

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

يعمل أودو 19 على Python 3.10 أو أحدث، ويستخدم هذا الدليل الإصدار 3.12. تحقّق من الإصدار المثبّت لديك بالأمر python --version في موجّه الأوامر (Command Prompt). إذا لم يكن Python مثبّتًا أو كان أقدم من 3.12، فنزّل المثبّت من python.org.

• شغّل المثبّت واختر Customize installation.
• حدّد خيار Add python.exe to PATH.
• في شاشة Optional Features أبقِ كل الخيارات محددة.
• في شاشة Advanced Options حدّد الإعدادات الخمسة الأولى، ثم اضغط Install.

الخطوة 2: تثبيت PostgreSQL

نزّل PostgreSQL 16 أو أحدث لنظام Windows x86-64 من postgresql.org، وشغّل المثبّت.

• في شاشة Select Components أبقِ كل المكونات محددة، ومنها pgAdmin 4 وStack Builder.
• عيّن كلمة مرور للمستخدم postgres، وهو المستخدم ذو الصلاحيات الكاملة (superuser)، واحفظها في مكان آمن.
• اترك المنفذ على 5432 وباقي الإعدادات على قيمها الافتراضية.
• عندما تظهر نافذة Stack Builder في نهاية التثبيت، اختر نسخة PostgreSQL المثبّتة لديك، وثبّت المكونات الموجودة تحت Database Drivers.

الخطوة 3: إنشاء مستخدم قاعدة البيانات لأودو في pgAdmin

1. افتح pgAdmin 4 وعيّن كلمة مرور رئيسية (master password) عندما يُطلب منك ذلك.
2. وسّع Servers، ثم نسخة PostgreSQL المثبّتة لديك، ثم Login/Group Roles.
3. انقر بزر الفأرة الأيمن على Login/Group Roles → Create → Login/Group Role.
4. في تبويب General، سمِّ الدور odoo19.
5. في تبويب Definition، عيّن كلمة مرور.
6. في تبويب Privileges، فعّل كل الخيارات، ثم احفظ.

الخطوة 4: تثبيت أدوات بناء C++‎

تُجمّع عدة حزم Python يعتمد عليها أودو كودًا أصليًا (native) أثناء تثبيتها. نزّل Build Tools for Visual Studio من Microsoft، واختر حزمة العمل Desktop development with C++‎، ثم ثبّتها وأعد تشغيل Windows.

الخطوة 5: تنزيل الكود المصدري لأودو 19

افتح المستودع الرسمي على github.com/odoo/odoo، وبدّل الفرع إلى 19.0، ثم اختر Code → Download ZIP. استخرج الملف إلى مجلد داخل مجلدك الشخصي، مثل C:\Users\you\odoo-19.0. وإذا كنت تستخدم Git، فاستنسخ المستودع بدلًا من ذلك:

git clone https://github.com/odoo/odoo.git --branch 19.0 --depth 1 odoo-19.0

الخطوة 6: تثبيت PyCharm

نزّل PyCharm من jetbrains.com وثبّته بالخيارات الافتراضية. أصبح PyCharm الآن منتجًا واحدًا يتضمن خطة مجانية: بعد انتهاء فترة تجربة Pro لمدة 30 يومًا، تكفي الميزات الأساسية المجانية لتطوير أودو.

الخطوة 7: إعداد المشروع في PyCharm

افتح PyCharm، واختر Open، وحدّد مجلد أودو. ثم أنشئ في جذر المشروع ملفًا باسم odoo.conf:

[options]
; master password for database operations
admin_passwd = admin
db_host = localhost
db_port = 5432
db_user = odoo19
db_password = your_password
addons_path = C:\Users\you\odoo-19.0\addons
http_port = 8019

استخدم اسم الدور وكلمة المرور اللذين أنشأتهما في pgAdmin، واجعل addons_path يشير إلى مجلد addons داخل مجلد أودو.

بعد ذلك، حدّد المفسّر من Settings → Project → Python Interpreter → Add Interpreter. البيئة الافتراضية (virtual environment) هي الخيار الأنظف، ومفسّر النظام يعمل أيضًا. ثم ثبّت المتطلبات من الطرفية (Terminal) في PyCharm:

pip install -r requirements.txt

وأخيرًا، أنشئ إعداد تشغيل (run configuration) من Run → Edit Configurations → + → Python، واملأ الحقول التالية:

• Name: Odoo 19
• Script path: ملف odoo-bin في مجلد أودو
• Parameters: -c odoo.conf
• Working directory: مجلد أودو
• Interpreter: المفسّر الذي حدّدته أعلاه

الخطوة 8: تشغيل أودو وإنشاء قاعدة بيانات

اضغط Run. عندما يُظهر السجل أن الخادم يستمع للاتصالات، افتح http://localhost:8019. في شاشة قاعدة البيانات أدخل كلمة المرور الرئيسية من admin_passwd، واسم قاعدة البيانات، والبريد الإلكتروني للمدير وكلمة مروره، واللغة والدولة إن أردت. ألغِ تحديد البيانات التجريبية (demo data) إذا أردت قاعدة بيانات نظيفة، ثم اضغط Create database.

من هنا يمكنك تثبيت التطبيقات، وإضافة مجلد وحداتك الخاصة إلى addons_path، ووضع نقاط توقف (breakpoints) في وحداتك بأداة تصحيح الأخطاء في PyCharm.