- أخطاء Docker — تأكّد من أن Docker Desktop (أو الـ daemon) قيد التشغيل قبل
yarn twenty docker:start. ستعرض رسالة الخطأ أمر البدء المناسب لنظام التشغيل لديك. - إصدار Node غير صحيح — نحتاج 24 أو أحدث. تحقّق باستخدام
node -v. - Yarn 4 غير موجود — شغّل
corepack enable. - تبعيات تالفة —
rm -rf node_modules && yarn install. - أخطاء
twenty-sdkبعد الترقية إلى v2.8.0 — تم نقله منdependenciesإلىdevDependenciesفي الإصدار v2.8.0. انظر إلى بنية المشروع → التبعيات. twenty buildيُصدر تحذيرًا بشأنtwenty-client-sdkتحتdependencies— يتم توفيره في وقت التشغيل بواسطة Twenty، لذلك يجب نقله إلىdevDependenciesجنبًا إلى جنب معtwenty-sdk. انظر إلى بنية المشروع → التبعيات.
استكشاف الأخطاء وإصلاحها
مشكلات التشغيل الأول الشائعة — Docker، إصدار Node، Yarn، والتبعيات.