メインコンテンツへスキップ
このクイックスタートに従って、Hono プロジェクトに Base44 を追加してください。Base44 バックエンドを作成し、エンティティを定義して、SDK を API ルートに統合します。
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 を更新してビルド出力を指すように設定してください。site.outputDirectory フィールドを追加または変更します:
{
  "site": {
    "outputDirectory": "dist"
  }
}
Hono で純粋な API を構築しフロントエンドを配信しない場合、outputDirectory の構成をスキップするか、このステップを省略できます。
4

エンティティを定義

データ構造を定義するエンティティスキーマを作成します。エンティティファイルは base44/entities/ ディレクトリに配置する必要があります。例えば、base44/entities/task.jsonc を作成します:
{
  "name": "Task",
  "type": "object",
  "properties": {
    "title": {
      "type": "string"
    },
    "completed": {
      "type": "boolean",
      "default": false
    }
  },
  "required": ["title"]
}
5

エンティティを Base44 にプッシュ

エンティティスキーマを Base44 にプッシュします:
base44 entities push
このコマンドは、ローカルのエンティティ定義を Base44 バックエンドと同期し、アプリケーションで使用できるようにします。詳細は entities push を参照してください。
6

Base44 SDK をインストール

Base44 JavaScript SDK をインストールします:
npm install @base44/sdk
7

Base44 クライアントを作成

プロジェクトで 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

API ルートで SDK を使用

Base44 SDK を使用して、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;
SDK を呼び出すときは、大文字小文字を含むスキーマの正確なエンティティ名を使用してください。慣例上、エンティティ名は大文字で始まります。例えば、スキーマに "name": "Task" がある場合、base44.entities.Task.list() としてアクセスします。
9

API をローカルで実行

Hono 開発サーバーを起動して、インテグレーションをテストします。プロジェクトルートから次を実行します:
npm run dev
Hono API は SDK クライアントを介して Base44 バックエンドに接続し、デプロイされたエンティティをリアルタイムで操作できます。

​
次のステップ

これでプロジェクトに Base44 バックエンドが統合されたので、次のことができます:
  • SDK を使用して API により多くの機能を追加します。
  • エンティティ、バックエンド関数、エージェントを追加します。TypeScript で作業している場合は、オートコンプリートと型安全性を得るために型を生成してください。
  • Hono 開発サーバーと並行して Base44 バックエンドに対して base44 dev を実行してローカルでテストします。セットアップ手順については、ローカル開発を参照してください。
  • API の構築を続け、選択したランタイムに従ってデプロイします。

​
関連項目

このページは AI を使用して翻訳されました。最も正確で最新の情報については、英語版 を参照してください。