#Visión general

Los plugins de cliente de NocoBase pueden hacer muchas cosas: registrar nuevas páginas, escribir componentes personalizados, llamar a la API del backend, añadir Blocks y Fields, e incluso extender botones de Action. Todas estas capacidades se organizan a través de un punto de entrada de Plugin unificado.

Si usted ya tiene experiencia con React, le resultará rápido empezar: en la mayoría de los casos solo se trata de escribir componentes React normales y, mediante las capacidades de contexto que proporciona NocoBase (como enviar peticiones, internacionalización), integrarlos con NocoBase. Solo cuando necesite que un componente aparezca en la interfaz de configuración visual de NocoBase, tendrá que conocer FlowEngine.

#Ruta de aprendizaje

Se recomienda conocer el desarrollo de plugins de cliente en el siguiente orden, de lo simple a lo complejo:

Plugin (entrada) → Router (página) → Component (componente) → Context (contexto) → FlowEngine (extensión de UI)

Donde:

1. Plugin: la clase de entrada del plugin, que registra rutas, modelos y otros recursos en ciclos de vida como load().
2. Router: registre rutas de página mediante router.add() y registre páginas de configuración del plugin mediante pluginSettingsManager.
3. Component: lo que la ruta monta es un componente React. Por defecto basta con usar React + Antd, sin diferencia respecto al desarrollo frontend habitual.
4. Context: dentro del plugin puede obtener el contexto mediante this.context, y dentro de los componentes mediante useFlowContext(), para utilizar las capacidades que ofrece NocoBase: enviar peticiones (ctx.api), internacionalización (ctx.t), logs (ctx.logger), etc.
5. FlowEngine: si su componente necesita aparecer en los menús «Add Block / Field / Action» y permitir configuración visual del usuario, debe envolverlo con FlowModel.

Los primeros cuatro pasos cubren la mayoría de los escenarios de plugins. Solo cuando necesite una integración profunda con el sistema de configuración de UI de NocoBase deberá llegar al quinto paso. Si no está seguro de qué método utilizar, consulte Component vs FlowModel.

#Índice rápido

#Enlaces relacionados

• Escribir su primer plugin — crear un plugin funcional desde cero
• Visión general del desarrollo de servidor — los plugins de cliente normalmente requieren un complemento del servidor
• Documentación completa de FlowEngine — referencia completa de FlowModel, Flow y Context
• Estructura de directorios del proyecto — dónde colocar los archivos del plugin