自定义的 UI 组件可以整合到您的服务中 .
用户指南
支助
目前支持React 18,React 19,下14和下15.
更改日志
版本
- 我们使用语义化的版本,意思是除了主要版本之外,所有更新都应该是安全的更新.
- 如果在特定版本内有中断的更改,将标记为
❗️Breaking change在更改日志中, 请在更新前查看 . - 有的版本被后缀为"等.
1.0.102-framer并打算用于孤立的病例,所以你很可能 想要使用没有后缀的版本, 例如 .1.0.103。 。 。 .
文档
关于如何启动平台解决方案的文件是 这里 和原子列表可查看 这里
贡献者指南
版本
我们使用一个名为"更改"的工具,帮助记录与您的开发分支相关的更改,然后管理
原子版本和发布到 无。我们需要添加记录更改的日志,然后让更改et收集更改、更新 Changelog并更新版本 package.json。 。 。 .
- 假设你在开发部门 刚刚完成了在原子上添加新功能的工作 在开发分支时, 您需要添加一个记录此特性的日志, 以便它最终会出现在原子中 变动情况。 。 。 .
- 运行
yarn changesets-add从单列波根选择@calcom/atoms使用空间栏并按下输入进入下一步. - 然后,在语义化版本之后,您必须选择这是主要,次要还是补丁更新. 因为它是一个通过按下输入跳过主功能的特性,然后通过按下空间栏和按下输入来选择小功能进入下一步.
- 然后,您必须写下变化的描述并按入. 这将生成日志文件
.changeset例如,目录..changeset/hungry-donuts-cross.md。 。 。 . - 将此日志文件提交您的开发分支并按下 .
值得注意的是,你不必改变
"version"在原子中package.json文档,因为更改器将在下一步完成.
- 开发分支合并后, 更改将打开一个名为“ 调用” 的拉动请求
chore: version packages包含下一次发布更改。 此拖动请求将包含新日志文件, 将添加到原子中CHANGELOG.md文件与更改ets 将更新原子package.json文件基于主要、次要或补丁更新与否。 当我们想要释放原子时,我们只需要合并这个拉出请求,而更改器会将新的原子版本发布到npm. 值得注意的是, 更改ets 仅在 npm 中发布原子"version"在原子中package.json变化et的 PR 高于 npm .
以下两篇文章教人们如何为每个公关写好变化摘要
- https://keepachangelog.com/en/1.0.0/ (中文(简体) )
- https://docs.gitlab.com/development/changelog/ 页面存档备份,存于互联网档案馆
测试
原子在CI中通过实例平台应用内的e2e测试进行测试. 在当地管理:
- 转到"包装/平面/原子"并运行
yarn dev-on接下来yarn build- 这会在当地建立原子. - 在"packages/platform/examples/base/.env"文件中设置环境变量. 您需要自己的 oAuth 客户端来填充 NEXT PUBLICQCAL ID( oAuth id), QQCAL SECRET KEY( oAuth secret), VITE BOOKER EMBED OANDTH CLIENT ID( oAuth id) 和 Organization ID( oAuth 客户端所属的组织 id) - 所有这些在创建 oAuth 客户端后, 都可以在平台设置仪表板中找到 .
NEXT_PUBLIC_X_CAL_ID=""
X_CAL_SECRET_KEY=""
NEXT_PUBLIC_CALCOM_API_URL="https://api.cal.com/v2"
VITE_BOOKER_EMBED_OAUTH_CLIENT_ID=""
VITE_BOOKER_EMBED_API_URL="https://api.cal.com/v2"
ORGANIZATION_ID=""
- 转到"包装/平台/实例/基准"并运行
yarn dev:e2e- 这将启动实例平台应用,并通过使用本地所建原子运行e2e测试. 因为它不是在CI内部运行 它会打开浏览器并运行测试.