النشر

​

نظرة عامة

• نشر أرشيف tar — ارفع تطبيقك مباشرةً إلى خادم Twenty محدد للاستخدام الداخلي أو الخاص.
• النشر على npm — أدرج تطبيقك في سوق Twenty ليتسنى لأي مساحة عمل اكتشافه وتثبيته.

​

بناء تطبيقك

yarn twenty dev:build

​

النشر إلى خادم (tarball)

​

المتطلبات الأساسية

yarn twenty remote:add --url https://your-twenty-server.com --as production

​

النشر

yarn twenty app:publish --private
# To deploy to a specific remote:
# yarn twenty app:publish --private --remote production

​

مشاركة تطبيق منشور

1. اذهب إلى الإعدادات > التطبيقات > التسجيلات وافتح تطبيقك
2. في علامة التبويب التوزيع، انقر نسخ رابط المشاركة
3. شارك هذا الرابط مع المستخدمين في مساحات عمل أخرى — سيأخذهم مباشرةً إلى صفحة تثبيت التطبيق

​

إدارة الإصدارات

1. قم بزيادة الحقل version في ملف package.json (مثلًا: 1.2.3 → 1.2.4، 1.3.0، أو 2.0.0)
2. شغّل yarn twenty app:publish --private (أو yarn twenty app:publish --private --remote production)
3. مساحات العمل التي تم تثبيت التطبيق فيها وتم تفعيل الترقية التلقائية له (في علامة تبويب الإعدادات الخاصة بالتطبيق) سيتم ترقيتها تلقائيًا في الخلفية؛ أما المساحات الأخرى فسترى أن الترقية متاحة في إعداداتها

​

توافق إصدار الخادم

{
  "name": "twenty-my-app",
  "version": "1.0.0",
  "engines": {
    "node": "^24.5.0",
    "twenty": ">=2.3.0"
  }
}

• إذا تم تعيين engines.twenty ولم يستوفِ إصدار الخادم الهدف النطاق، فسيتم رفض النشر (tarball upload) أو التثبيت بخطأ SERVER_VERSION_INCOMPATIBLE ورسالة تُشير إلى كلٍ من النطاق المطلوب وإصدار الخادم الفعلي.
• إذا كان engines.twenty غير مُعين، فسيُقبل التطبيق على أي إصدار من الخادم (متوافق مع الإصدارات السابقة للتطبيقات الحالية).
• إذا لم يكن لدى الخادم قيمة APP_VERSION مُكوَّنة، فسيتم تخطي الفحص.

​

CI/CD المؤتمتة (مهام سير عمل مُولَّدة بالقوالب)

​

CI — ci.yml

1. يجلب مصدر تطبيقك.
2. ينشئ مثيلاً اختبارياً معزولاً من Twenty باستخدام الإجراء المركّب twentyhq/twenty/.github/actions/spawn-twenty-app-dev-test@main (المكافئ في CI للأمر yarn twenty docker:start --test).
3. يُفعِّل Corepack، ويُعدّ Node.js من ملف .nvmrc لديك، ويثبّت التبعيات بواسطة yarn install --immutable.
4. يشغّل yarn test، ويمرّر TWENTY_API_URL وTWENTY_API_KEY من المثيل الذي تم إنشاؤه بحيث تتمكّن اختباراتك من التواصل مع خادم حقيقي.

• TWENTY_VERSION (متغيّر بيئة، القيمة الافتراضية latest) — ثبّت نسخة خادم Twenty المستخدمة في CI عبر تعديل هذا في ci.yml.
• يتم تجميع التشغيل المتزامن حسب github.ref ويلغي التشغيلات قيد التقدّم عند أي دفع جديد.

​

CD — cd.yml

1. يجلب رأس طلب السحب (للطلبات الموسومة) أو الالتزام المدفوع.
2. يشغّل twentyhq/twenty/.github/actions/deploy-twenty-app@main — وهو المكافئ في CI للأمر yarn twenty app:publish --private.
3. يشغّل twentyhq/twenty/.github/actions/install-twenty-app@main بحيث تُثبَّت النسخة المُنشَرة حديثًا في مساحة العمل المستهدفة.

​

النشر — publish.yml

1. يجلب شيفرة تطبيقك، ويُعد Node.js، ويُحدِّث npm (يتطلّب النشر الموثوق npm 11.5.1 أو أحدث).
2. يشغّل yarn twenty app:publish، الذي يبني التطبيق وينشر .twenty/output إلى npm. في بيئة CI يضيف تلقائيًا --provenance و--access public، لذا لا حاجة إلى أي أعلام في سير العمل.

​

تثبيت الإجراءات القابلة لإعادة الاستخدام

​

النشر على npm

​

المتطلبات

• حساب على npm
• الكلمة المفتاحية twenty-app في مصفوفة keywords في package.json (أضفها يدويًا — فهي غير مضمنة افتراضيًا في قالب create-twenty-app)

{
  "name": "twenty-app-postcard-sender",
  "version": "1.0.0",
  "keywords": ["twenty-app"]
}

​

بيانات التعريف لسوق التطبيقات

export default defineApplication({
  universalIdentifier: '...',
  displayName: 'My App',
  description: 'A great app',
  logo: 'public/logo.png',
  galleryImages: [
    'public/screenshot-1.png',
    'public/screenshot-2.png',
  ],
});

​

أبعاد صور المعرض الموصى بها

​

الحد الأقصى لحجم الصورة

​

النشر

yarn twenty app:publish

yarn twenty app:publish --tag beta

​

كيف تعمل آلية الاكتشاف في السوق

yarn twenty dev:catalog-sync
# To target a specific remote:
# yarn twenty dev:catalog-sync --remote production

​

النشر عبر CI

​

تثبيت التطبيقات

yarn twenty app:install