气相组件
用于在 DCR 和 DCR 上显示 Braze 信件的 React 组件库 前门.
Braze信息以两种方式被曝光,以解决两个独立的使用案例.
- 一发信息
- 持久性通知
使用一发消息 Braze的应用信息 以显示用户的单个信件印象。 这对广告来说太无聊了 感觉。 和广告一样,这些讯息经常与其他的 用于页面共享消息槽的系统。 这些消息被曝光了 编辑 灰尘 课.
持续通知由 Braze 内容卡。 。 。 . 这些通知一直持续到驳回为止(自动或由 用户),或过期. 不同来源的通知可以 彼相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相 这些通知被秘书处披露 布雷泽卡 课.
发展
本地设置
$ bin/setup
故事书
我们用故事书来构建组件。 运行故事本 :
$ pnpm storybook
故事书中的网格图像拾取器集成需要auth. 必要时 你会被引导到 gutools 登录服务在发展时,这意味着 运行本地登录服务。 通常开发时你不需要使用 图像采集器。 在这种情况下,您可以通过运行"故事本"来完全跳过 Auth 像这样:
$ STORYBOOK_DISABLE_AUTH=true pnpm storybook
这意味着你不需要在当地运行登录服务.
指向您本地版本的 @ guardian/ braze- 组件
有时测试一个胸罩组件 改变对一个本地 运行使用它的项目的版本,例如 DCR.
建议使用 yalc 这样做.
安装雅尔克
执行指令 雅尔克读取。 。 。 .
在本地建立 @ guardian/ braze- 组件
$ pnpm build
将您的本地@ guardian/ braze- 组件发布到本地雅尔克注册簿
在本地的检查中 @guardian/braze-components,在词根中:
$ yalc publish
使用本地 yalc 登记册中的 braze 组件
$ yalc add @guardian/braze-components
例如,对 DCR 来说,它应该从dotcom 传输内部运行 次级项目.
这将更新本地软件包. json 和 yalc ref. 这是预期的,但 改变不应该被承诺.
页:1
以上步骤在修改胸罩组件时应当重复
你想看看本地情况 别忘了再跑 pnpm build来啊!
向国家预防机制公布
向国家防范机制的释放 变化 由CI执行.
在您的特性分支上, 在合并前运行 pnpm changeset. 这将
交互式地询问这是什么变化(主要、小、补丁)和
允许您描述变化。 将生成的更改et文件提交 git 和
推向你的树枝.
当您合并分支时,将自动打开一个版本的放出PR. 合并后,将再次向国家预防机制发布。 版本更改 将基于您更改器文件中的信息。 如果版本发布 公关不是马上合并的 没关系 任何其他有更改的 PR 合并 与此同时,将更新发布公关.
并不是所有的公关都要求释放,因此不需要一个变换器. 举个例子 修改读取器.
合并到主后的步骤
对于dotcom-递归:
- 运行
checkout主树枝和取出 - 运行
checkout -b启动更新 PR 的新分支 - 更新对胸罩组件的依赖性
dotcom-components/dotcom-components/package.json - 运行
pnpm更新 DCR 根中的 pnpm.lock 文件 - 推出分行并创建GitHub的PR.
- 如果修改涉及组件的视觉变化,请通过截图捕捉并包含在 PR 中
- 如果更改涉及更新到组件布局, 在 DCR 故事簿文件中添加代码以反映这些更改
- 如有必要(并不总是如此),请接受
DCR CODE(第一个通知在P&E/Dotcom CODE Semaphore并在那里部署代码. - 如果一切都好,并批准公关,则将公关合并为主(以 GitHub 为单位)
对于前端 :
- 运行
checkout主树枝和取出 - 运行
checkout -b启动更新 PR 的新分支 - 更新/package.json中的胸罩组件依赖性
- 运行
make install compile以更新依赖锁文件 - 推出分行并创建GitHub的PR.
- 如有必要(并不总是如此),请接受
Frontend CODE(第一个通知在P&E/Dotcom CODE Semaphore并在那里部署代码. - 如果一切都好,并批准公关,则将公关合并为主(以 GitHub 为单位)
排雷中心/发改委
当您推动到 GitHub 动作时, 将触发运行 Jest 测试
TypeScript 编译器等. 还将启动TeamCity建设。 打开 main
如果 TeamCity 构建成功 Riff Raff 将部署 Storybook 到
https://braze-communitys.gutools.co.uk 页面存档备份,存于互联网档案馆。 。 。 .