> ## 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](/ja/controller) は、アプリケーションの作成、設定、バージョン管理、デバイスへのデプロイを行う場所です。

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

アプリケーションはいくつかの方法で作成・開発できます：

* **BRICKS Controller** — **Applications** タブで作成し、[Config Editor](/ja/controller/config-editor) を使用してブラウザでビジュアルに開発する
* **[CTOR](/ja/ctor)** — デスクトップ IDE で AI エージェントを使って開発する
* **[BRICKS CLI](/ja/cli)** — `bricks app new` でコマンドラインから作成する

### BRICKS Controller から作成する

<Steps>
  <Step title="アプリケーションを開く">
    BRICKS Controller で **Applications** に移動します。
  </Step>

  <Step title="新しいアプリケーションを作成する">
    **Create Application** をクリックして名前と説明を入力します。
  </Step>

  <Step title="アプリケーションを設定する">
    アプリケーションのビューポート、シークレット、その他のオプションを設定します。
  </Step>
</Steps>

## Config Editor

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

<Card title="Config Editor ガイド" icon="pen-to-square" href="/ja/controller/config-editor">
  Config Editor を使って BRICKS アプリケーションを作成・編集する方法を確認する。
</Card>

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

アプリケーションを 1 つ以上のデバイスに割り当てて実行を開始します：

1. アプリケーション詳細ページを開く
2. **Devices** タブに移動する
3. **Add Device** をクリックしてターゲットのデバイスまたはデバイスグループを選択する
4. アプリケーションが選択したデバイスに自動的にデプロイされる

<Info>
  デバイスグループにアプリケーションをバインドして、グループ内のすべてのデバイスに一括デプロイすることもできます。
</Info>

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

アプリケーションが異なる画面サイズでどのようにレンダリングされるかを定義するビューポートプリセットを設定します：

1. アプリケーション詳細ページを開く
2. **Settings** > **Viewport** に移動する
3. 幅と高さを設定するか、プリセットサイズから選択する

ビューポート設定は、物理的な画面サイズとは独立して、デバイスのレンダリング解像度を決定します。

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

デプロイのたびにアプリケーションの新しいバージョンが作成されます。以下の操作が可能です：

* **バージョン履歴の確認** — タイムスタンプと変更ログを含む全デプロイバージョンを確認する
* **ロールバック** — 必要に応じて以前のバージョンに戻す
* **アクティブバージョンの設定** — デバイスが実行するバージョンを選択する

## リリースと共有

アプリケーションを共有するためのパブリックリリースを作成します：

1. アプリケーション詳細ページを開く
2. **Releases** に移動する
3. **Create Release** をクリックしてリリースするバージョンを選択する
4. パブリック URL を他のユーザーと共有する

パブリックバージョンにより、リンクを持つ誰でもアプリケーションを表示できます。

## シークレット管理

アプリケーションがランタイムでアクセスできる API キーなどの機密値を保存します：

1. アプリケーション詳細ページを開く
2. **Settings** > **Secrets** に移動する
3. キーと値のペアを追加する

<Warning>
  シークレットは保存時に暗号化され、ランタイムでのみアプリケーションが使用できます。シークレットをアプリケーションコードに保存しないでください。
</Warning>

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

本番デバイスにデプロイする前にアプリケーションをテストします：

* **プレビュー** — [Config Editor](/ja/controller/config-editor) で直接アプリケーションをプレビューするか、[bricks-ctor](/ja/ctor-pkg) から `bun preview` を使用する
* **仮想デバイス** — クラウドベースのテスト用に[仮想デバイス](/ja/controller/devices)にデプロイする
* **ステージングデバイス** — 統合テスト用に専用のステージングデバイスをバインドする
* **[オートメーション](/ja/foundation/automations)** — デバイスでエンドツーエンドのオートメーションテストを実行してアプリケーションの動作を検証する

## プロジェクトの生成

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

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

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

### BRICKS CLI で初期化する

```bash theme={null}
bricks app project-init <application-id> --yes
```

### CTOR で初期化する

[CTOR](/ja/ctor) でアプリケーションを開き、AI エージェントを使ってプロジェクトをプルしてセットアップします。

生成されたプロジェクトには、TypeScript ソースファイル、ビルドスクリプト、オプションの AI エージェントインストラクションと CI/CD ワークフローが含まれます。完全な開発ワークフローについては、[bricks-ctor 入門](/ja/ctor-pkg/getting-started)を参照してください。