Fluid Portal CLI — Pull & Push App 公告

Fluid CLI允许您将一个Fluid OS定义(您的应用程序显示——屏幕,主题,导航,配置)拉入本地的JSON文件,进行编辑,并被推回生产.

创建门户项目

fluid portal create my-portal

创建默认使用捆绑的条形起动器. 过 --remote-template 只有在您有意想要 GitHub 镜像时,或者 --skip-install 当您想要只使用脚手架输出时。 当前脚手架的使用 createPortal({ customPages })软件包 src/widgets.config.ts,且不包含 iframe 预览条目.

一次性设置

• 构建 CLI (从回波根出):

  pnpm --filter @fluid-app/fluid-cli --filter @fluid-app/fluid-cli-portal build
  

• 这个 fluid 二进制是 packages/cli/core/dist/bin/fluid.mjs可选的别名:

  alias fluid="node /path/to/repo/packages/cli/core/dist/bin/fluid.mjs"
  

  (以下所有例子都假定这个别名。) 没有它,替换 fluid 与 node packages/cli/core/dist/bin/fluid.mjs. ) (中文(简体) )

认证

• 电子邮件 + MFA 流量 :

  fluid login
  

• 或者用 API 符号跳过 MFA :

  FLUID_TOKEN="<your-api-token>" fluid login
  

拉一个定义

fluid portal pull

• 交互式拾取器,或直接瞄准一个: fluid portal pull --app "<definition name>"
• 写作 portal/ (单位:千美元)screens/, (中文(简体) ), themes/, (中文(简体) ), navigations/, (中文(简体) ), profiles/, (中文(简体) ), definition.json加上一个 .portal-sync/ 跟踪同步状态的文件夹.
• 切换到另一个定义, 并附带未加压缩的本地更改 ? 添加 --force 要覆盖.

编辑预览( P)

• 编辑 JSON 下的文件 portal/。 。 。 .

• 本地预览( 保存本地文件中的列表) :

  fluid portal dev
  

将更改往后推

fluid portal push

• 显示 diff 并请求确认( 添加) --yes 跳过).
• Push 不发布 它更新了定义的工作状态/草稿状态。 终端用户不断看到当前活跃的已发布版本.
• 对于经核实的非互动释放, fluid portal push --yes --activate 推动草稿,并创建/激活一个活版,只当每次推动时 阶段成功。 部分推出非零并从未被激活.

发布门户版本( 仅在您想要显示的更改为活时)

fluid portal version create --activate     # snapshot current state + make it live
fluid portal version list                  # see all versions
fluid portal version activate <version-id> # promote a specific version

发布部件运行时的文物

门户部件包与主机门户外壳分开发布. 创建远程 DOM 部件并在单一源包中注册 :

fluid portal widget create stock-ticker

脚手架将部件写在下面 src/widgets/ 创建或更新 src/widgets.config.ts 使用 defineWidget 财务报告和审定财务报表 defineWidgetPackage 从 工人安全门户SDK入口. portal.config.ts, (中文(简体) ), customWidgets和遗产 显端不是部件发现的一部分 .

门户网站CLI发布公司拥有的门户网站部件包:

fluid portal deploy

• 构建 defineWidgetPackage 输入 widget.js,范围CSS, manifest.json, (中文(简体) ), 财务报告和审定财务报表 publish-manifest.json 下级 .fluid/widget-dist 默认.
• manifest.json 使用 Canonical 远程 DOM 描述符。 内容 workerEntryUrl 和 CSS URL 是软件包本地化的工艺品路径; 目录 在主机使用描述符之前, 将它们确定为绝对的公开 URL . 公司和液滴包ID仍然完全合格(company.* 或者说 droplet.*) (中文(简体) ). 出版清单记录了文物清单和散列物.
• 发表a 公司拥有 fluid OS 使用的门户部件包 .
• 默认为 --environment production (产出/报告标签)和 --out-dir .fluid/widget-dist。 。 。 .
• 添加 --dry-run 来构建和打印上传的有效载荷,而不创建 上传会话 .
• 这只发布部件运行时的文物; 它确实 没有 部署 主机门户外壳 .

对于自有的滴滴市场部件包,请使用专用部件 CLI (单位:千美元)@fluid-app/fluid-cli-widget改为:

fluid widget create my-widget --droplet <uuid>
fluid widget link --droplet <uuid>
fluid widget publish

滴盘在部件 CLI 外管理, 在您之前必须已经存在 链接或发布 driplet 拥有的部件包.

手动命令

• fluid whoami 显示活动配置
• fluid switch - 在配置文件之间切换
• fluid logout - 清空储存的证书
• fluid portal doctor 诊断门户项目问题