#الإضافة (Plugin)

في NocoBase، توفر إضافة الخادم (Server Plugin) طريقة برمجية معيارية لتوسيع وتخصيص وظائف الخادم. يمكن للمطورين توسيع فئة Plugin من @nocobase/server لتسجيل الأحداث، والواجهات البرمجية (APIs)، وتكوينات الصلاحيات، وغيرها من المنطق المخصص في مراحل دورة الحياة المختلفة.

#فئة الإضافة (Plugin Class)

الهيكل الأساسي لفئة الإضافة هو كما يلي:

import { Plugin } from '@nocobase/server';

export class PluginHelloServer extends Plugin {
  async afterAdd() {}

  async beforeLoad() {}

  async load() {}

  async install() {}

  async afterEnable() {}

  async afterDisable() {}

  async remove() {}

  async handleSyncMessage(message: Record<string, any>) {}

  static async staticImport() {}
}

export default PluginHelloServer;

#دورة الحياة

يتم تنفيذ طرق دورة حياة الإضافة بالترتيب التالي، ولكل طريقة وقت تنفيذ وغرض محدد:

#شرح ترتيب التنفيذ

تدفق التنفيذ النموذجي لطرق دورة الحياة:

1. مرحلة التهيئة الثابتة: staticImport()
2. مرحلة بدء تشغيل التطبيق: afterAdd() ← beforeLoad() ← load()
3. مرحلة تمكين الإضافة لأول مرة: afterAdd() ← beforeLoad() ← load() ← install()
4. مرحلة تمكين الإضافة للمرات التالية: afterAdd() ← beforeLoad() ← load()
5. مرحلة تعطيل الإضافة: يتم تنفيذ afterDisable() عند تعطيل الإضافة.
6. مرحلة حذف الإضافة: يتم تنفيذ remove() عند حذف الإضافة.

#الكائن app والأعضاء ذوي الصلة

في تطوير الإضافات، يمكنك الوصول إلى مختلف الواجهات البرمجية (APIs) التي يوفرها مثيل التطبيق من خلال this.app؛ وهو الواجهة الأساسية لتوسيع وظائف الإضافة. يحتوي الكائن app على وحدات وظيفية مختلفة للنظام، ويمكن للمطورين استخدام هذه الوحدات في طرق دورة حياة الإضافة لتنفيذ متطلبات الأعمال.

#قائمة أعضاء app

تنبيه: للحصول على تفاصيل استخدام كل وحدة، يرجى الرجوع إلى فصول التوثيق المقابلة.