用途:指导基于 Domo CLI 的应用构建与发布流程,解决首次发布后应用 ID 变化导致重复发布新应用的问题。
前置条件:需安装 Node.js 和 Domo CLI,安装命令为 npm install -g @domoinc/ryuu。本地开发使用 npm install 安装依赖,npm run dev 启动开发服务器(通常为 Vite);本地 API 调用需配置 ryuu-proxy 并完成 domo login 认证。生产构建执行 npm run build,Vite 输出到 dist/,CRA 输出到 build/。
认证与发布:使用 domo login 登录 Domo 实例,需输入实例 URL 和凭据。发布时进入构建输出目录执行 cd dist 和 domo publish。
首次发布关键点:Domo 会为新应用生成新 ID,该 ID 出现在 dist 目录下已发布的 manifest.json 中。必须将该 ID 复制回源 manifest.json(如 public/manifest.json)的 id 字段;否则每次发布都会创建新应用而非更新现有应用。后续发布流程为 npm run build && cd dist && domo publish。
构建检查清单:manifest.json 中数据集需使用正确的 dataSetId(而非 id);每个数据集映射需包含 fields: [];thumbnail.png 需存在且为 300x300 像素;所有查询须用 .select() 指定列,不得拉取全部列;每个可视化应有各自优化的查询;不得使用 .aggregate() 调用,改用 .groupBy() 或客户端聚合;.groupBy() 调用须包含分组列,不能仅含聚合。
限制:资料仅描述上述流程与检查项,未提供收费、价格、平台兼容性或效果方面的信息。