メインコンテンツへスキップ

Documentation Index

Fetch the complete documentation index at: https://docs.bricks.tools/llms.txt

Use this file to discover all available pages before exploring further.

BRICKS Controller は、アプリケーションの作成、設定、バージョン管理、デバイスへのデプロイを行う場所です。

​
アプリケーションの作成

アプリケーションはいくつかの方法で作成・開発できます：
  • BRICKS Controller — Applications タブで作成し、Config Editor を使用してブラウザでビジュアルに開発する
  • CTOR — デスクトップ IDE で AI エージェントを使って開発する
  • BRICKS CLI — bricks app new でコマンドラインから作成する

​
BRICKS Controller から作成する

1

アプリケーションを開く

BRICKS Controller で Applications に移動します。
2

新しいアプリケーションを作成する

Create Application をクリックして名前と説明を入力します。
3

アプリケーションを設定する

アプリケーションのビューポート、シークレット、その他のオプションを設定します。

​
Config Editor

アプリケーションを開き、Config Editor をクリックすると、ブラウザでビジュアルに設定を作成・編集できます。Config Editor では、コードを書かずに Subspace、Canvas、Brick、Generator、Data、Animation、アクションを管理できます。

Config Editor ガイド

Config Editor を使って BRICKS アプリケーションを作成・編集する方法を確認する。

​
アプリケーションをデバイスにバインドする

アプリケーションを 1 つ以上のデバイスに割り当てて実行を開始します：
  1. アプリケーション詳細ページを開く
  2. Devices タブに移動する
  3. Add Device をクリックしてターゲットのデバイスまたはデバイスグループを選択する
  4. アプリケーションが選択したデバイスに自動的にデプロイされる
デバイスグループにアプリケーションをバインドして、グループ内のすべてのデバイスに一括デプロイすることもできます。

​
ビューポートプリセット

アプリケーションが異なる画面サイズでどのようにレンダリングされるかを定義するビューポートプリセットを設定します：
  1. アプリケーション詳細ページを開く
  2. Settings > Viewport に移動する
  3. 幅と高さを設定するか、プリセットサイズから選択する
ビューポート設定は、物理的な画面サイズとは独立して、デバイスのレンダリング解像度を決定します。

​
アプリケーションのバージョン管理

デプロイのたびにアプリケーションの新しいバージョンが作成されます。以下の操作が可能です：
  • バージョン履歴の確認 — タイムスタンプと変更ログを含む全デプロイバージョンを確認する
  • ロールバック — 必要に応じて以前のバージョンに戻す
  • アクティブバージョンの設定 — デバイスが実行するバージョンを選択する

​
リリースと共有

アプリケーションを共有するためのパブリックリリースを作成します：
  1. アプリケーション詳細ページを開く
  2. Releases に移動する
  3. Create Release をクリックしてリリースするバージョンを選択する
  4. パブリック URL を他のユーザーと共有する
パブリックバージョンにより、リンクを持つ誰でもアプリケーションを表示できます。

​
シークレット管理

アプリケーションがランタイムでアクセスできる API キーなどの機密値を保存します：
  1. アプリケーション詳細ページを開く
  2. Settings > Secrets に移動する
  3. キーと値のペアを追加する
シークレットは保存時に暗号化され、ランタイムでのみアプリケーションが使用できます。シークレットをアプリケーションコードに保存しないでください。

​
アプリケーションのテスト

本番デバイスにデプロイする前にアプリケーションをテストします：
  • プレビュー — Config Editor で直接アプリケーションをプレビューするか、bricks-ctor から bun preview を使用する
  • 仮想デバイス — クラウドベースのテスト用に仮想デバイスにデプロイする
  • ステージングデバイス — 統合テスト用に専用のステージングデバイスをバインドする
  • オートメーション — デバイスでエンドツーエンドのオートメーションテストを実行してアプリケーションの動作を検証する

​
プロジェクトの生成

既存のアプリケーションをコードファーストな開発のための bricks-ctor TypeScript コードベースに変換します：

​
BRICKS Controller からダウンロードする

  1. アプリケーション詳細ページを開く
  2. Generate Project をクリックする
  3. AI インストラクションと CI/CD オプションを設定する
  4. Download Project (.zip) をクリックする

​
BRICKS CLI で初期化する

bricks app project-init <application-id> --yes

​
CTOR で初期化する

CTOR でアプリケーションを開き、AI エージェントを使ってプロジェクトをプルしてセットアップします。 生成されたプロジェクトには、TypeScript ソースファイル、ビルドスクリプト、オプションの AI エージェントインストラクションと CI/CD ワークフローが含まれます。完全な開発ワークフローについては、bricks-ctor 入門を参照してください。