Toluwalope Akinkunmi加载中…

正在画草图…

000
跳到正文
← 全部笔记

· 2 分钟阅读

共享逻辑,不共享界面

一个活动平台的 Next.js 与 Expo 应用之间,哪些放进了共享包,哪些没有,以及为什么。

这个活动平台最初是一个 Web 应用。移动应用到来时,最快的做法是把 API 调用和规则复制过去。没过几周,两个应用就在一些不起眼却很重要的地方出现分歧:奈拉金额怎么格式化,哪些订单状态算已支付,主办方什么时候可以申请提现。

一个包,三条规则

两个应用都迁入了基于 npm workspaces 的 monorepo,只有一个共享包。它遵循三条规则:

  • 共享必须一致的东西:API 服务、查询 hooks、校验 schema、货币格式化、状态映射,以及提现资格这类业务规则。
  • 不共享界面。每个应用的界面都保持各自平台的原生体验,谁都不像对方的移植版。
  • 共享代码中不允许出现平台相关的导入。如果某个模块需要 DOM 或原生 API,它就不属于这个包。
两个应用,一个共享包。参与者与主办方 → Web 应用; 参与者与主办方 → 移动应用; Web 应用 → 共享包; 移动应用 → 共享包; 共享包 → 平台 API; 平台 API ↔ 提现参与者与主办方Web 应用Next.js移动应用Expo共享包npm workspaces平台 APIREST提现Stripe引用引用类型化请求
两个应用,一个共享包。

难点在依赖

代码搬得很顺利,版本却不然。React、TanStack Query 和校验库在两个应用中必须解析到相同版本,而 Next.js 和 Metro 对依赖提升(hoisting)的处理并不一样。版本统一在一处对齐,lockfile 的变更在代码评审中检查。

值得吗?

值得。现在修改“何时可以申请提现”只需要改一个文件,两个应用同时生效。Web 和移动端再也不会在钱的问题上出现分歧,单凭这一点,这次迁移就物有所值。

下一篇多个应用,一次登录一组产品如何迁移到统一的 OAuth 2.0 登录服务,以及保证它安全的那些规则。