跳转到主要内容

​
创建应用

BuildingAI 提供了两种便捷的应用创建方式，帮助开发者快速生成标准化的应用开发模板。

​
创建方式对比

BuildingAI 支持以下两种应用创建方式：
创建方式适用场景优势特点
可视化创建初次使用者简单直观，图形化界面通过Web界面操作
命令行创建高级开发者自动化程度高，批量操作通过终端命令操作

​
可视化创建

通过BuildingAI的Web界面创建应用，操作简单直观。

​
操作步骤

​
1. 进入创建界面

可视化创建界面

​
2. 配置应用信息

应用配置界面

​
3. 等待应用生成

系统会显示应用创建的进度状态。
刚安装完可能会出现短暂的服务中断，那是因为应用需要重启以重新载入刚刚创建的应用。
应用创建进度

​
4. 查看生成结果

此时打开源代码目录，可以看到在根目录的 extensions 目录下生成了刚刚创建的应用文件夹，里面包含了一个应用示例模板。
生成的应用模板

​
命令行创建

通过终端命令创建应用，适合自动化和批量操作场景。

​
前置条件

确保本地已安装 pnpm 包管理器。

​
操作步骤

​
1. 进入项目根目录

cd BuildingAI

​
2. 执行创建命令

pnpm extension:create

​
3. 交互式配置

此时，终端会出现如下交互界面：
命令行交互界面

​
4. 填写应用信息

根据输入指引，依次输入以下信息：
  • 应用标识符：唯一标识符
  • 应用名称：显示名称
  • 应用版本号：版本信息
  • 应用描述：功能描述
  • 应用作者：开发者信息
  • 应用作者主页：联系地址
应用信息配置

​
5. 确认创建完成

等待命令执行完成后出现如下提示则说明创建成功：
创建成功提示

​
6. 重新载入应用

# 重启服务以载入新创建的应用
pnpm dev:main

​
创建结果

​
文件位置

无论通过哪种方式创建，最终应用都会生成在根目录下的 extensions 目录下。 
BuildingAI/
└── extensions/
    └── {your-app-name}/
        ├── manifest.json
        ├── package.json
        ├── README.md
        └── ... (应用模板文件)

​
下一步操作

成功创建应用模板后，您可以：

查看模板结构

了解生成的应用模板目录结构和文件组织

开始开发

进入开发环境，开始编写应用代码

​
常见问题

  • 检查网络连接是否正常
  • 确认pnpm版本是否符合要求
  • 查看控制台错误信息
  • 编辑 manifest.json 文件
  • 更新 package.json 中的应用信息
  • 重启服务使更改生效