工具介绍

此工具可以帮助开发者快速创建一个基于百度智能云千帆AppBuilder的快应用项目，支持通过命令行参数和JSON文件自定义创建项目，开发者可以将应用发布为一个快应用。

如何使用

1 命令行定义参数

``shell
npx create-appbuilder appName="..." package="..." appId="..." authorization="..." [projectName="..."] [path="..."] [versionName="..."] [versionCode="..."] [miniPlatformVersion="..."]
`
如果是yarn用户，
`shell
yarn create appbuilder appName="..." package="..." appId="..." authorization="..." [projectName="..."] [path="/home"] [versionName="..."] [versionCode="..."] [miniPlatformVersion="..."]
`
其中[]可以省略; 每组[key=value]之间的空格分割 ; 参数顺序可改变

参数定义如下：

| 序号 | key | 必填 | 默认值 | Value |
| ---- | ------------------- | --------- | --------|--------------|
| 1 | appName | 是 | | 应用名称 |
| 2 | package | 是 | |应用包名 |
| 3 | appId | 是 | | 应用ID |
| 4 | authorization | 是 | | 请求签名 |
| 5 | projectName | 否 |"helloWorld" | 项目名称 |
| 6 | path | 否 |"." | 项目生成的目录 |
| 7 | versionName | 否 |"1.0.0" | 版本名称 |
| 8 | versionCode | 否 |1 | 版本号 |
| 9 | miniPlatformVersion | 否 |1020 | 最小平台号 |

举例说明：

``shell
npx create-appbuilder appName='appBuilder' package='com.app.demo' appId="xxx" authorization="xxx" projectName="testApp" path='/home' versionName="1.0.0" versionCode=1 minPlatformVersion=1020
``

2 JSON文件定义参数


`shell
npx create-appbuilder xxx.json
`
如果是yarn用户，
`shell
yarn create appbuilder xxx.json
`
其中xxx.json为JSON格式的参数文件路径:

`json
{
"package": "...",
"appName": "...",
"appId": "...",
"authorization": "...",
"projectName": "...", // 可选
"path": "...", // 可选
"versionName": "...", // 可选
"versionCode": "...", // 可选
"minPlatformVersion": "..." // 可选
}
`
其中[]可以省略; 每组[key=value]之间的空格分割 ; 参数顺序可改变

举例说明：

``shell
npx create-appbuilder /home/test.json
``

其中，/home/test.json文件内容如下：
`json
{
"package": "com.app.demo",
"appName": "appBuilder",
"appId": "...",
"authorization": "...",
"projectName": "testApp"
}
``

如何获取appId和authorization

1 进入千帆AppBuilder官网，创建智能体应用、选择相应的工具组件、发布应用


2 获取应用ID（appId）


3 获取请求签名（authorization）

百度智能云千帆提供了API在线调试平台-示例代码，用于帮助开发者调试接口，获取请求签名(此签名为应用工作台密钥)authorization。