Zum Hauptinhalt springen
Folge diesem Quickstart, um Base44 zu deinem Hono-Projekt hinzuzufügen. Du erstellst ein Base44-Backend, definierst Entitäten und integrierst das SDK in deine API-Routen.
Die CLI erfordert Node.js 20.19.0 oder höher.

Einrichtung

1

Base44 CLI installieren

Installiere die Base44 CLI global:
npm install -g base44@latest
2

Ein Base44-Backend erstellen

Navigiere in dein Hono-Projektverzeichnis und führe aus:
base44 create
Wenn du noch nicht eingeloggt bist, fordert dich der Befehl auf, dich zu authentifizieren.Wähle Create a basic project, wenn du dazu aufgefordert wirst. Dies erstellt die Backend-Dateien in deinem Hono-Projektverzeichnis. Folge dann den Eingabeaufforderungen, um dein Projekt zu konfigurieren.Wenn du ein Projekt erstellst, werden Base44 skills automatisch eingebunden und liefern deinem KI-Agenten Anweisungen und Kontext für Base44-Aufgaben.
3

Ausgabeverzeichnis konfigurieren (optional)

Wenn du mit Hono statische Dateien ausspielst, aktualisiere config.jsonc, um auf deine Build-Ausgabe zu verweisen. Füge das Feld site.outputDirectory hinzu oder ändere es:
{
  "site": {
    "outputDirectory": "dist"
  }
}
Wenn du mit Hono eine reine API baust und kein Frontend ausspielst, kannst du die outputDirectory-Konfiguration überspringen oder diesen Schritt weglassen.
4

Entitäten definieren

Erstelle Entity-Schemas, um deine Datenstrukturen zu definieren. Entity-Dateien müssen im Verzeichnis base44/entities/ abgelegt werden.Erstelle zum Beispiel base44/entities/task.jsonc:
{
  "name": "Task",
  "type": "object",
  "properties": {
    "title": {
      "type": "string"
    },
    "completed": {
      "type": "boolean",
      "default": false
    }
  },
  "required": ["title"]
}
5

Entitäten zu Base44 pushen

Pushe deine Entity-Schemas zu Base44:
base44 entities push
Dieser Befehl synchronisiert deine lokalen Entity-Definitionen mit deinem Base44-Backend, sodass sie in deiner Anwendung verfügbar werden. Siehe entities push für weitere Informationen.
6

Base44 SDK installieren

Installiere das Base44 JavaScript-SDK:
npm install @base44/sdk
7

Einen Base44-Client erstellen

Erstelle einen Base44-SDK-Client in deinem Projekt. Die appId findest du in deiner Datei base44/.app.jsonc.Erstelle zum Beispiel lib/base44.js:
import { createClient } from '@base44/sdk';

export const base44 = createClient({
  appId: 'your-app-id-from-app.jsonc'
});
8

Das SDK in deinen API-Routen verwenden

Verwende das Base44-SDK, um in Hono-Route-Handlern mit deinen Entitäten zu interagieren. Zum Beispiel:
import { Hono } from 'hono';
import { base44 } from './lib/base44Client';

const app = new Hono();

// Get all tasks
app.get('/api/tasks', async (c) => {
  const tasks = await base44.entities.Task.list();
  return c.json(tasks);
});

// Create a new task
app.post('/api/tasks', async (c) => {
  const body = await c.req.json();
  const newTask = await base44.entities.Task.create({
    title: body.title,
    completed: false
  });
  return c.json(newTask, 201);
});

export default app;
Verwende beim Aufruf des SDK den exakten Entity-Namen aus deinem Schema, einschließlich Groß- und Kleinschreibung. Konventionell beginnen Entity-Namen mit einem Großbuchstaben. Wenn dein Schema z. B. "name": "Task" hat, greifst du als base44.entities.Task.list() darauf zu.
9

Deine API lokal ausführen

Starte deinen Hono-Entwicklungsserver, um deine Integration zu testen. Führe aus dem Projekt-Stammverzeichnis aus:
npm run dev
Deine Hono-API verbindet sich über den SDK-Client mit deinem Base44-Backend, sodass du in Echtzeit mit deinen veröffentlichten Entitäten arbeiten kannst.

Nächste Schritte

Nun, da dein Base44-Backend in dein Projekt integriert ist, kannst du:
  • Das SDK verwenden, um deiner API weitere Funktionalität hinzuzufügen.
  • Entitäten, Backend-Funktionen und Agenten hinzufügen. Wenn du in TypeScript arbeitest, generiere Typen, um Autovervollständigung und Typsicherheit zu erhalten.
  • Lokal testen, indem du base44 dev für das Base44-Backend zusammen mit deinem Hono-Dev-Server ausführst. Siehe Lokale Entwicklung für Einrichtungsanweisungen.
  • Deine API weiterentwickeln und sie gemäß der von dir gewählten Laufzeit veröffentlichen.

Siehe auch

Diese Seite wurde mit KI übersetzt. Für die genauesten und aktuellsten Informationen siehe die englische Version.