Vai al contenuto principale
Segui questa quickstart per aggiungere Base44 al tuo progetto Hono. Creerai un backend Base44, definirai entità e integrerai l’SDK nei tuoi route API.
La CLI richiede Node.js 20.19.0 o superiore.

​
Configurazione

1

Installa la CLI di Base44

Installa la CLI di Base44 a livello globale:
npm install -g base44@latest
2

Crea un backend Base44

Vai nella directory del tuo progetto Hono, quindi esegui:
base44 create
Se non hai già effettuato l’accesso, il comando ti chiederà di autenticarti.Seleziona Create a basic project quando richiesto. Questo crea i file backend all’interno della directory del tuo progetto Hono. Quindi segui le richieste per configurare il tuo progetto.Quando crei un progetto, le skill di Base44 sono incluse automaticamente, fornendo al tuo agente IA istruzioni e contesto per le attività Base44.
3

Configura la directory di output (opzionale)

Se stai servendo file statici con Hono, aggiorna config.jsonc in modo che punti al tuo output di compilazione. Aggiungi o modifica il campo site.outputDirectory:
{
  "site": {
    "outputDirectory": "dist"
  }
}
Se stai costruendo una pura API con Hono e non stai servendo un frontend, puoi saltare la configurazione di outputDirectory o omettere questo passaggio.
4

Definisci le entità

Crea schemi di entità per definire le tue strutture di dati. I file delle entità devono essere posizionati nella directory base44/entities/.Ad esempio, crea base44/entities/task.jsonc:
{
  "name": "Task",
  "type": "object",
  "properties": {
    "title": {
      "type": "string"
    },
    "completed": {
      "type": "boolean",
      "default": false
    }
  },
  "required": ["title"]
}
5

Invia le entità a Base44

Invia i tuoi schemi di entità a Base44:
base44 entities push
Questo comando sincronizza le tue definizioni di entità locali con il tuo backend Base44, rendendole disponibili per l’uso nella tua applicazione. Consulta entities push per maggiori informazioni.
6

Installa l'SDK di Base44

Installa il JavaScript SDK di Base44:
npm install @base44/sdk
7

Crea un client Base44

Crea un client SDK di Base44 nel tuo progetto. L’appId si trova nel tuo file base44/.app.jsonc.Ad esempio, crea lib/base44.js:
import { createClient } from '@base44/sdk';

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

Usa l'SDK nei tuoi route API

Usa l’SDK di Base44 per interagire con le tue entità negli handler dei route Hono. Ad esempio:
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;
Usa il nome esatto dell’entità dal tuo schema quando chiami l’SDK, comprese le maiuscole. Per convenzione, i nomi delle entità iniziano con una lettera maiuscola. Ad esempio, se il tuo schema ha "name": "Task", vi accedi come base44.entities.Task.list().
9

Esegui la tua API in locale

Avvia il tuo server di sviluppo Hono per testare l’integrazione. Dalla root del tuo progetto, esegui:
npm run dev
La tua API Hono si connetterà al tuo backend Base44 tramite il client SDK, permettendoti di lavorare con le tue entità distribuite in tempo reale.

​
Passaggi successivi

Ora che il tuo backend Base44 è integrato con il tuo progetto, puoi:
  • Usare l’SDK per aggiungere più funzionalità alla tua API.
  • Aggiungere entità, funzioni backend e agenti. Se stai lavorando in TypeScript, genera i tipi per ottenere autocompletamento e sicurezza dei tipi.
  • Testare in locale eseguendo base44 dev per il backend Base44 insieme al tuo dev server Hono. Consulta Sviluppo locale per le istruzioni di configurazione.
  • Continuare a sviluppare la tua API e distribuirla secondo il runtime scelto.

​
Vedi anche

Questa pagina è stata tradotta utilizzando l’IA. Per informazioni più accurate e aggiornate, consulta la versione inglese.