@fluid-tools/build-cli (英语)
flub是流体框架GitHub寄存器的构建和放出工具. flub旨在取代现有的 液态建构工具,主要是通过重新使用现有建构工具的功能并将其包装为更一致的, 使用可维护的 CLI 奥克利夫。 。 。 .
使用量
$ npm install -g @fluid-tools/build-cli
$ flub COMMAND
running command...
$ flub (--version|-V)
@fluid-tools/build-cli/0.0.0
$ flub --help [COMMAND]
USAGE
$ flub COMMAND
...
命令主题
flub ai- AI授权助理 启动正确的AI代理.flub autocomplete- 显示自动完成安装指令.flub build-perf- 建立收集、处理和分析积分指标的可观察性命令.flub bump- 跳出软件包的版本、发布组及其依赖性.flub check- 检查命令用于验证Repo状态、应用政策等.flub commands- 列出所有的flub命令.flub exec- 在包或放行组上下文中运行 shell 命令.flub generate- 生成命令用于创建/更新代码,docs,readmes等.flub help- 显示flub的帮助.flub info- 获取关于Repo的信息, 释放组,和包.flub list- 按地形顺序在发布组中列出软件包.flub merge- 根据批量大小同步分枝flub modify- 修改命令用于修改项目以添加或去除依赖,更新Fluid导入等.flub promote- 推广命令,将公布的软件包推广到npm登记册.flub publish- 发布命令将软件包发布到npm登记册.flub release- 释放命令用于管理流体释放过程.flub rename-types- 将声明文件从.d.ts重命名为.d.mts.flub report- 报告关于密码库的分析,如密码覆盖和捆绑尺寸测量.flub transform- 变形命令用于将代码,docs等转换成可替代的形式.flub typetests- 更新包中类型测试的配置.json文件. 如果之前的版本在运行准备后发生变化,那么npm安装必须在构建前运行.flub vnext- Vnext命令是使用新的基础设施执行标准flub命令的新措施.
开发者笔记
此软件包输出其构建文件到 lib/ 改为 dist/ 就像我们其他的包裹一样 原因是
oclif通过常规使用 lib 文件夹, 并且有 oclif 错误可以通过将内容放入 lib 来避免 。 见
例如 https://github.com/microsoft/FluidFramework/pull/12155 页面存档备份,存于互联网档案馆
测试
这个 release 命令提供 a testMode 旗帜,在处理状态时需要检查哪个子类。 如果输入
测试模式,所有处理过的状态应立即返回真实状态。 这使测试能够核实新状态得到处理
在某种程度上。 其他命令可以采用,但只有 release command 今日用来.
这个 release 命令还提供 a state 可以用来将状态机器初始化到特定状态的旗帜.
这是用来测试的.
手动集成测试和调试
有一些VS码发射目标,例如: flub generate typetests 这在某些情况下可能可行.
在通过 packet.json 脚本引用 flub 时运行本地创建的 flub 版本,使用 pnpm 覆盖 . 对于客户端:
"@fluid-tools/build-cli": "file:./build-tools/packages/build-cli",
"@fluidframework/build-tools": "file:./build-tools/packages/build-tools",
"@fluid-tools/version-tools": "file:./build-tools/packages/version-tools"
这种方法可用于: flub generate typetests ,以确保 --entrypoint 包含来自脚本的配置(如果有的话),并且可以通过 JavaScript 调试控制台调试,尽管断点需要在 .js 文件在 node_modules (例如 node_modules/.pnpm/file+build-tools+packages+build-cli_@[email protected]/node_modules/@fluid-tools/build-cli/lib/commands/generate/typetests.js) (中文(简体) ).
或者, link: 超接会给出相似的结果,并且已知会支持直接在其中设置断点 .ts 文档。 使用时 link: 在 build-tools 已安装。 见 pnpm.ic 文档 更多信息.
"@fluid-tools/build-cli": "link:./build-tools/packages/build-cli",
"@fluidframework/build-tools": "link:./build-tools/packages/build-tools",
"@fluid-tools/version-tools": "link:./build-tools/packages/version-tools"
两种模式都需要 pnpm i --no-frozen-lockfile 设置后 overrides。如果有任何构建工具包 dependencies 使用时更新 file:中,请为两个工作区重新运行.
贡献准则
你们可以 贡献 通过这些方式实现流体框架:
详细指示改为: repo 文档。 。 。 .
本项目遵循 Microsoft 开源行为守则。 。 。 . 更多信息,改为: 《行为守则》经常被问到的问题。 。 。 . 问题或评论,联系 打开码@ microsoft.com。 。 。 .
这个项目可能包含微软项目的商标或标志,产品,或服务. 这些商标或标志的使用必须遵循微软 商标和品牌准则。 。 。 . 在这个项目的修改后版本中使用微软商标或标志不得造成混淆或暗示微软赞助.
帮助
读取 流体框架文件 用于了解流体框架概念和API.
要求提供文件未载列的资料, 创建问题。 。 。 .
商标
这个项目可能包含微软项目的商标或标志,产品,或服务.
这些商标或标志的使用必须遵循微软的 商标和品牌准则。 。 。 .
在这个项目的修改后版本中使用微软商标或标志不得造成混淆或暗示微软赞助.