المشكلات الشائعة
- أخطاء البيئة المحلية، تحقّق من
twenty local statusوtwenty local logs --no-follow. يجب تثبيت Docker وتشغيله باستخدام سياق مقبس محلي. أضف--testلمثيل الاختبار. يؤدي فشل البدء إلى الاحتفاظ بالحاوية وبياناتها للتشخيص. - إصدار Node غير صحيح — تحتاج إلى 24.5+ أو 26.5+ (
engines.node: ^24.5.0 || ^26.5.1). تحقّق باستخدامnode -v. - Yarn 4 غير موجود — شغّل
corepack enable(على Node 26، نفّذ أولاًnpm install -g corepack). - تبعيات تالفة —
rm -rf node_modules && yarn install. - ملف
yarn.lockفارغ — يفشل البناء مع ظهور “yarn.lock is empty” عندما يكون ملف القفل موجودًا ولكنه لا يحتوي على أي محتوى؛ شغّلyarn installلإعادة إنشائه. - أخطاء
twenty-sdkبعد الترقية إلى v2.8.0 — تم نقله منdependenciesإلىdevDependenciesفي الإصدار v2.8.0. انظر إلى بنية المشروع → التبعيات. - يُصدر
twenty app buildتحذيرًا بشأنtwenty-client-sdkضمنdependencies— يتم توفيره في وقت التشغيل بواسطة Twenty، لذا يجب نقله إلىdevDependenciesإلى جانبtwenty-sdk. انظر إلى بنية المشروع → التبعيات.