דלג לתוכן הראשי
עקוב אחר ה-quickstart הזה כדי להוסיף את Base44 לפרויקט Hono שלך. תיצור בקאנד Base44, תגדיר entities, ותשלב את ה-SDK ב-API routes שלך.
ה-CLI דורש Node.js 20.19.0 ומעלה.

הגדרה

1

התקן את Base44 CLI

התקן את Base44 CLI גלובלית:
npm install -g base44@latest
2

צור בקאנד Base44

נווט לתיקיית פרויקט Hono שלך, ולאחר מכן הרץ:
base44 create
אם אתה לא מחובר כבר, הפקודה תבקש ממך לבצע אימות.בחר Create a basic project כשתתבקש. פעולה זו יוצרת את קבצי הבקאנד בתוך תיקיית פרויקט Hono שלך. לאחר מכן עקוב אחר ההוראות להגדיר את הפרויקט שלך.כאשר אתה יוצר פרויקט, Base44 skills נכללים אוטומטית, ומספקים לסוכן ה-AI שלך הוראות והקשר עבור משימות Base44.
3

הגדר את ספריית הפלט (אופציונלי)

אם אתה מגיש קבצים סטטיים עם Hono, עדכן את config.jsonc כדי להצביע על ה-build output שלך. הוסף או שנה את שדה site.outputDirectory:
{
  "site": {
    "outputDirectory": "dist"
  }
}
אם אתה בונה API נקי עם Hono ולא מגיש frontend, ניתן לדלג על תצורת outputDirectory או להשמיט שלב זה.
4

הגדר entities

צור entity schemas כדי להגדיר את מבני הנתונים שלך. קבצי entity חייבים להיות ממוקמים בתיקיית base44/entities/.לדוגמה, צור את base44/entities/task.jsonc:
{
  "name": "Task",
  "type": "object",
  "properties": {
    "title": {
      "type": "string"
    },
    "completed": {
      "type": "boolean",
      "default": false
    }
  },
  "required": ["title"]
}
5

דחוף entities ל-Base44

דחוף את ה-entity schemas שלך ל-Base44:
base44 entities push
פקודה זו מסנכרנת את הגדרות ה-entity המקומיות שלך עם הבקאנד Base44 שלך, ומאפשרת אותן לשימוש באפליקציה שלך. ראה entities push למידע נוסף.
6

התקן את Base44 SDK

התקן את Base44 JavaScript SDK:
npm install @base44/sdk
7

צור לקוח Base44

צור client של Base44 SDK בפרויקט שלך. ה-appId ניתן למצוא בקובץ base44/.app.jsonc שלך.לדוגמה, צור את lib/base44.js:
import { createClient } from '@base44/sdk';

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

השתמש ב-SDK ב-API routes שלך

השתמש ב-Base44 SDK כדי לתקשר עם entities שלך ב-route handlers של Hono. לדוגמה:
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;
השתמש בשם ה-entity המדויק מה-schema שלך בעת קריאה ל-SDK, כולל אותיות גדולות. לפי המוסכמה, שמות entities מתחילים באות גדולה. לדוגמה, אם ל-schema שלך יש "name": "Task", אתה ניגש אליו כ-base44.entities.Task.list().
9

הרץ את ה-API שלך מקומית

התחל את שרת הפיתוח של Hono כדי לבדוק את האינטגרציה שלך. משורש הפרויקט שלך, הרץ:
npm run dev
ה-API של Hono שלך יתחבר לבקאנד Base44 דרך לקוח SDK, ויאפשר לך לעבוד עם ה-entities המופצות שלך בזמן אמת.

השלבים הבאים

עכשיו שהבקאנד Base44 שלך משולב בפרויקט שלך, אתה יכול:
  • להשתמש ב-SDK כדי להוסיף עוד פונקציונליות ל-API שלך.
  • להוסיף entities, backend functions, ו-agents. אם אתה עובד ב-TypeScript, ייצר types כדי לקבל autocomplete ובטיחות סוגים.
  • לבדוק באופן מקומי על ידי הרצת base44 dev עבור הבקאנד Base44 לצד שרת הפיתוח של Hono שלך. ראה Local development להוראות הגדרה.
  • להמשיך לבנות את ה-API שלך ולפרוס אותו בהתאם ל-runtime שבחרת.

ראה גם

דף זה תורגם באמצעות בינה מלאכותית. למידע המדויק והעדכני ביותר, עיין בגרסה האנגלית.