Plugin System
Das App-SDK stellt ein Plugin-System für Next.js bereit, das erweiterte Features wie automatische External Task Worker ermöglicht.
withApplicationSdk
Die withApplicationSdk Funktion erweitert Ihre Next.js Konfiguration mit ProcessCube®-spezifischen Features.
next.config.ts
import { withApplicationSdk } from '@5minds/processcube_app_sdk/server';
export default withApplicationSdk({
applicationSdk: {
useExternalTasks: true,
customExternalTasksDirPath: './my-tasks', // Optional
},
// Weitere Next.js-Optionen hier
});Das Plugin fügt automatisch esbuild zu serverExternalPackages hinzu und startet Worker nur im Server-Modus (nicht während next build).
Verfügbare Optionen
| Option | Typ | Standard | Beschreibung |
|---|---|---|---|
useExternalTasks | boolean | false | Aktiviert automatische External Task Worker |
customExternalTasksDirPath | string | — | Verzeichnis für External Task Handler (relativ zum Projektroot) |
Das Plugin ist nur erforderlich, wenn Sie External Tasks oder andere erweiterte Features nutzen möchten.
External Tasks
Eine vollständige Dokumentation zu External Tasks finden Sie im dedizierten Bereich:
- External Tasks Übersicht — Einführung und Schnellstart
- Handler entwickeln — Dateikonvention, Signatur, Beispiele
- Konfiguration — Worker-Optionen, Umgebungsvariablen
- Erweiterte Konzepte — AbortSignal, Resilienz, Hot Reload