لماذا Ubuntu وPyCharm
- جهاز التطوير يعمل مثل خادم الإنتاج، فتقل المفاجآت عند النشر.
- بيئات Python الافتراضية وPostgreSQL ومكتبات النظام تُثبَّت كلها عبر مدير الحزم.
- يضيف PyCharm الإكمال التلقائي للكود في ORM أودو، وأداة حقيقية لتصحيح الأخطاء، والتكامل مع Git.
الخطوة 1: تثبيت PyCharm
sudo apt update && sudo apt upgrade -y
sudo snap install pycharm --classicأصبح PyCharm الآن منتجًا واحدًا يتضمن خطة مجانية: بعد انتهاء فترة تجربة Pro لمدة 30 يومًا، تكفي الميزات الأساسية المجانية للعمل على أودو.
الخطوة 2: تثبيت Python 3.12 ومكتبات البناء
يأتي Ubuntu 24.04 مع Python 3.12. أما على Ubuntu 22.04 فأضف مستودع deadsnakes أولًا:
sudo add-apt-repository ppa:deadsnakes/ppa
sudo apt update
sudo apt install python3.12 python3.12-dev python3.12-venv -yثم ثبّت المكتبات التي تُبنى عليها حزم Python الخاصة بأودو:
sudo apt install build-essential libpq-dev libxml2-dev libxslt1-dev \
zlib1g-dev libffi-dev libssl-dev libjpeg-dev libldap2-dev libsasl2-dev -yالخطوة 3: تثبيت Node.js وrtlcss
يُجمّع أودو ملفات التنسيق الخاصة به بنفسه، لكن اللغات التي تُكتب من اليمين إلى اليسار، مثل العربية، تحتاج إلى أداة rtlcss:
sudo apt install -y nodejs npm
sudo npm install -g rtlcssالخطوة 4: تثبيت wkhtmltopdf لتقارير PDF
يحوّل أودو الفواتير والتقارير إلى PDF باستخدام wkhtmltopdf. استخدم النسخة المبنية على Qt المعدّلة (patched Qt) من الإصدار 0.12.6.1، وإلا فستُطبع الترويسات والتذييلات وفواصل الصفحات بشكل غير صحيح. لنظامي Ubuntu 22.04 و24.04:
wget https://github.com/wkhtmltopdf/packaging/releases/download/0.12.6.1-3/wkhtmltox_0.12.6.1-3.jammy_amd64.deb
sudo apt install ./wkhtmltox_0.12.6.1-3.jammy_amd64.deb -yالخطوة 5: تثبيت PostgreSQL وإنشاء مستخدم أودو
sudo apt install postgresql postgresql-client -y
sudo -u postgres createuser --createdb --no-createrole --no-superuser --pwprompt odoo19على جهازك المحلي يمكنك منح الدور صلاحيات superuser لتجنّب مشكلات الصلاحيات عند استعادة قواعد البيانات. لا تفعل ذلك أبدًا على خادم.
sudo -u postgres psql -c "ALTER USER odoo19 WITH SUPERUSER;"الخطوة 6: الحصول على الكود المصدري لأودو 19
sudo apt install git -y
git clone https://github.com/odoo/odoo.git --branch 19.0 --depth 1 odoo19الخطوة 7: إنشاء بيئة افتراضية وتثبيت المتطلبات
افتح مجلد odoo19 في PyCharm، ونفّذ في الطرفية (Terminal) الخاصة به:
python3.12 -m venv venv
source venv/bin/activate
pip install --upgrade pip
pip install -r requirements.txtإذا فشل بناء psycopg2، فثبّت الحزمة الجاهزة (binary) بالأمر pip install psycopg2-binary.
الخطوة 8: كتابة ملف odoo.conf
[options]
admin_passwd = admin
db_host = localhost
db_port = 5432
db_user = odoo19
db_password = your_password
addons_path = /home/you/odoo19/addons
logfile = /home/you/odoo19/odoo.log
http_port = 8069الخطوة 9: إضافة إعداد تشغيل
اختر Run → Edit Configurations → + → Python:
- Script path:
odoo-bin - Parameters:
-c odoo.conf - Working directory: مجلد
odoo19 - Interpreter: بيئة
venvالتي أنشأتها
اضغط Run أو Debug، ثم افتح http://localhost:8069. وظهور مدير قواعد البيانات (database manager) يؤكد أن البيئة تعمل.
نصائح من مطوّرينا
- احفظ وحداتك الخاصة في مجلد منفصل وأضفه إلى
addons_path، ولا تعدّل وحدات أودو الأساسية أبدًا. - استخدم Git من أول سطر كود، بمستودع واحد لكل عميل أو خط منتجات.
- احتفظ بملفات إعداد منفصلة للتطوير والاختبار والإنتاج.
- شغّل أودو مع
--dev=allأثناء العمل، فيُعاد تحميل تغييرات Python والواجهات (views) دون إعادة تشغيل. - شغّل اختبارات وحدتك باستخدام
--test-enable -i your_module --stop-after-initقبل كل commit.