跳轉到主要內容

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. 開啟應用程式詳細資訊頁面
  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 入門