> ## 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](/zh-Hant/controller) 是您建立、設定、版本控制及將應用程式部署至裝置的地方。

## 建立應用程式

您可以透過多種方式建立及開發應用程式：

* **BRICKS Controller** —在 **Applications** 分頁中建立，然後使用 [Config Editor](/zh-Hant/controller/config-editor) 在瀏覽器中以視覺方式開發
* **[CTOR](/zh-Hant/ctor)** —在桌面 IDE 中搭配 AI 代理開發
* **[BRICKS CLI](/zh-Hant/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="/zh-Hant/controller/config-editor">
  了解如何使用 Config Editor 建立及編輯 BRICKS 應用程式。
</Card>

## 將應用程式綁定至裝置

將應用程式指派給一個或多個裝置，使其開始執行：

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](/zh-Hant/controller/config-editor) 中預覽應用程式，或從 [bricks-ctor](/zh-Hant/ctor-pkg) 使用 `bun preview`
* **虛擬裝置** —部署至[虛擬裝置](/zh-Hant/controller/devices)進行雲端測試
* **暫存裝置** —綁定專用的暫存裝置整合測試
* **[自動化](/zh-Hant/foundation/automations)** —在裝置上執行端對端自動化測試以驗證應用程式行為

## 產生專案

將現有應用程式轉換為 [bricks-ctor](/zh-Hant/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](/zh-Hant/ctor) 中開啟應用程式，並使用 AI 代理拉取並設定專案。

產生的專案包含 TypeScript 原始程式碼檔案、建置指令碼，以及可選的 AI 代理指令與 CI/CD 工作流程。完整開發流程請參閱 [bricks-ctor 入門](/zh-Hant/ctor-pkg/getting-started)。