创建宜搭应用,返回 appType。搭建应用的第一步。不适用于:应用已存在时(先查询是否已有同名应用),或只需在已有应用中创建页面/表单(直接使用 yida-create-page 或 yida-create-form-page)。
openyida env 确认登录态).cache/<项目名>-schema.json.cache/<项目名>-schema.json 持久化,不依赖跨会话的 memory 状态用户说"创建应用"、"新建系统"、"搭建平台"时使用此技能。
创建应用后,通常需要继续执行:创建表单(yida-create-form-page)→ 创建页面(yida-create-page)→ 发布页面(yida-publish-page)。
openyida create-app <appName> [description] [icon] [iconColor] [colour] [navTheme] [layoutDirection]
| 参数 | 必填 | 默认值 | 说明 |
|---|---|---|---|
appName | 是 | — | 应用名称 |
description | 否 | 同 appName | 应用描述 |
icon | 否 | xian-yingyong | 图标标识(见下方图标表) |
iconColor | 否 | #0089FF | 图标背景色 |
colour | 否 | deepBlue | 主题色(见下方主题色表) |
navTheme | 否 | dark | 导航风格:dark(深色)/ light(浅色) |
layoutDirection | 否 | slide | 导航布局:slide(侧边栏)/ ver(L 型顶导) |
主题色(colour)可选值:
| 值 | 颜色 | 适合场景 |
|---|---|---|
deepBlue | 深蓝 | 政务、金融、法律、企业管理、正式场合 |
podBlue | 蓝色 | 科技、教育、通用办公、SaaS 应用 |
royalBlue | 皇家蓝 | 高端商务、专业服务、企业级应用 |
lightBlue | 浅蓝 | 清新简约、云服务、通讯社交 |
teal | 青色 | 医疗健康、环保、清新简洁类应用 |
podGreen | 绿色 | 农业、环保、健康、生态 |
deepPurple | 深紫 | 创意设计、艺术、高端品牌 |
purple | 紫色 | 女性用户、美妆、时尚、创新科技 |
podOrange | 橙色 | 活力、电商、餐饮、娱乐、社交 |
yellow | 黄色 | 儿童教育、阳光活力、警示提醒 |
magenta | 玖红色 | 时尚、创意、社交、娱乐类应用 |
red | 红色 | 党建、政务、新闻、紧急类应用 |
greyBlue | 灰蓝 | 稳重商务、工业制造、技术工程 |
coffee | 咖啡 | 传统行业、文化教育、复古风格 |
black | 黑色 | 极简设计、奢侈品牌、科技前沿 |
{"success":true,"appType":"APP_XXX","appName":"考勤管理","url":"{base_url}/APP_XXX/admin"}
| 名称 | 标识 | 名称 | 标识 | |
|---|---|---|---|---|
| 新闻 | xian-xinwen | 地球 | xian-diqiu | |
| 政府 | xian-zhengfu | 汽车 | xian-qiche | |
| 应用 | xian-yingyong | 飞机 | xian-feiji | |
| 学术帽 | xian-xueshimao | 电脑 | xian-diannao | |
| 企业 | xian-qiye | 工作证 | xian-gongzuozheng | |
| 单据 | xian-danju | 购物车 | xian-gouwuche | |
| 市场 | xian-shichang | 信用卡 | xian-xinyongka | |
| 经理 | xian-jingli | 活动 | xian-huodong | |
| 法律 | xian-falv | 奖杯 | xian-jiangbei | |
| 报告 | xian-baogao | 流程 | xian-liucheng | |
| 火车 | huoche | 查询 | xian-chaxun | |
| 申报 | xian-shenbao | 打卡 | xian-daka |
图标背景色:#0089FF #00B853 #FFA200 #FF7357 #5C72FF #85C700 #FFC505 #FF6B7A #8F66FF #14A9FF
需要参考完整应用创建流程时,执行以下命令获取示例,再用
read_file读取:
openyida sample yida-create-app ipd-app-template # 完整应用创建示例(含多页面/表单/仪表盘的 IPD 应用模板)
| 异常场景 | 处理方式 |
|---|---|
| 命令返回失败(非 success) | 检查登录态(openyida env),确认 corpId 正确 |
| 应用名称重复 | 询问用户是否使用已有应用,或修改应用名称后重试 |
| 登录态失效(401) | 执行 openyida login 重新登录后重试 |
| 返回 JSON 中无 appType | 不要猜测 appType,重新执行命令获取 |