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

הגדרה

1

התקן את Base44 CLI

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

צור בקאנד Base44

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

הגדר את ספריית הפלט

עדכן את config.jsonc כדי להצביע על ה-build output של React. הוסף או שנה את שדה site.outputDirectory:
{
  "site": {
    "outputDirectory": "dist"
  }
}
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 שלך.לדוגמה, צור את src/api/base44Client.js:
import { createClient } from '@base44/sdk';

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

השתמש ב-SDK ב-frontend שלך

צור קומפוננטה פשוטה לרישום והוספת tasks. לדוגמה, צור את src/components/TaskList.jsx:
import { useState, useEffect } from 'react';
import { base44 } from '../api/base44Client';

export default function TaskList() {
  const [tasks, setTasks] = useState([]);
  const [newTaskTitle, setNewTaskTitle] = useState('');
  const [isLoading, setIsLoading] = useState(false);

  useEffect(() => {
    loadTasks();
  }, []);

  const loadTasks = async () => {
    setIsLoading(true);
    try {
      // Get records
      const taskList = await base44.entities.Task.list();
      setTasks(taskList);
    } catch (error) {
      console.error('Error loading tasks:', error);
    }
    setIsLoading(false);
  };

  const addTask = async (e) => {
    e.preventDefault();
    if (!newTaskTitle.trim()) return;

    setIsLoading(true);
    try {
      // Create a record
      const newTask = await base44.entities.Task.create({
        title: newTaskTitle,
        completed: false
      });
      setTasks([...tasks, newTask]);
      setNewTaskTitle('');
    } catch (error) {
      console.error('Error creating task:', error);
    }
    setIsLoading(false);
  };

  return (
    <div>
      <h1>Tasks</h1>

      {isLoading && <p>Loading...</p>}

      <ul>
        {tasks.map((task) => (
          <li key={task.id}>{task.title}</li>
        ))}
      </ul>

      <form onSubmit={addTask}>
        <input
          type="text"
          value={newTaskTitle}
          onChange={(e) => setNewTaskTitle(e.target.value)}
          placeholder="New task"
          disabled={isLoading}
        />
        <button type="submit" disabled={isLoading || !newTaskTitle.trim()}>
          Add Task
        </button>
      </form>
    </div>
  );
}
השתמש בשם ה-entity המדויק מה-schema שלך בעת קריאה ל-SDK, כולל אותיות גדולות. לפי המוסכמה, שמות entities מתחילים באות גדולה. לדוגמה, אם ל-schema שלך יש "name": "Task", אתה ניגש אליו כ-base44.entities.Task.list().
9

הרץ את האפליקציה שלך מקומית

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

בנה את ה-frontend שלך

כאשר אתה מרוצה מאיך שהכל נראה מקומית, בנה את פרויקט React שלך לפרודקשן:
npm run build
זה יוצר קבצי פרודקשן מאופטמים בספריית הפלט שלך (בדרך כלל dist).
11

פרוס את ה-frontend שלך

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

השלבים הבאים

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

ראה גם

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