النشر

​

نظرة عامة

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

​

النشر على npm

​

المتطلبات

• حساب على npm
• يجب أن يستخدم اسم الحزمة البادئة twenty-app- (مثلًا، twenty-app-postcard-sender)

​

الخطوات

1. قم ببناء تطبيقك — تقوم أداة CLI بتجميع مصادر TypeScript الخاصة بك وإنشاء ملف بيان التطبيق:

yarn twenty app:build

2. النشر على npm — ادفع الحزمة المبنية إلى سجل npm:

npx twenty app:publish

​

الاكتشاف التلقائي

​

النشر عبر CI

name: Publish
on:
  release:
    types: [published]

permissions:
  contents: read
  id-token: write

jobs:
  publish:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: "24"
          registry-url: https://registry.npmjs.org
      - run: yarn install --immutable
      - run: npx twenty app:build
      - run: npm publish --provenance --access public
        working-directory: .twenty/output
        env:
          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

​

التوزيع الداخلي

​

إرسال tarball

npx twenty app:publish --server <server-url>

​

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

1. ارفع قيمة الحقل version في ملف package.json
2. أرسل tarball جديدًا باستخدام npx twenty app:publish --server <server-url>
3. سترى مساحات العمل على ذلك الخادم الترقية متاحة في إعداداتها

​

فئات التطبيقات