Skip to content

A simple ts template to teach user how write and publish remote react comp for hel-micro

Notifications You must be signed in to change notification settings

hel-eco/hel-tpl-remote-react-comp-ts

Repository files navigation

hel-tpl-remote-react-comps-ts

最简单的远程react组件模板(ts) codesandbox: https://codesandbox.io/s/demo-load-remote-react-comp-2bnpl0?file=/src/App.js

发布 npm

发布远程组件到npm

npm run build
npm publish

本地联调

辅助模块使用方的custom配置,基于当前模块的已构建产物进行联调

npm run build_cust
cd hel_dist
# 如未安装 http-server,执行 npm i http-server -g 即可
# 指导端口可执行 http-server --cors -p 8081
http-server --cors

chunk 设置

经过测试对比验证,对应带样式文件的组件项目,设置为4是最佳的,刚好拆分为 runtime-main.js main.js chunk.js chunk.css 且 chunk.css 可以直接注入到 index.html 里供 hel-micro 控制是否需要加载

// 同时也避免报错: // chunk runtime-main [entry] // Cannot convert undefined or null to object

new webpack.optimize.LimitChunkCountPlugin({
  // 必须大于或等于 1,
  maxChunks: 4,
}),

shouldInlineRuntimeChunk

设置为false,不产生产物map文件

单文件css

控制 splitChunks.cacheGroups.css

const cacheGroupsCss = {
  name: "css",
  test: /\.css$/,
  minChunks: 1,
  enforce: true,
}

有利于做 hel-micro 上层适配库做 shadow 处理 见:https://juejin.cn/post/6992887038093557796

css 插入规则

src/index.ts 导入函数全部写为 import()函数方式时,构建生成的index.html里不包含有css文件link, css文件link是由runtime.main.js动态拼接到header里的,这不是我们期望的结果,因为我们想让上层适配库(例如hel-micro-react) 有机会可控制css加载时机,从而方便做shaw-dom隔离

而写为头部静态导入时,就包含了css文件link了。

cjs包

以下package.json里的script命令暂时移出,这里涉及到如何使用webpack打包组件库的知识点,欢迎同事贡献

待后续hel-micro支持非浏览器环境能解析远程模块就不需要了,无该命名不影响远程模块的提供和使用,仅影响使用方执行测试是,jest需要自己打桩,如果提供了直接使用hel_bundle/xxx.js文件作文打桩对象会方便一些

    "build_bundle": "tsc & cross-env BUNDLE=true node ./scripts/replaceToRelativePath.js & cross-env BUNDLE=true node scripts/build.js",
    "build_npm": "npm run build_proxy && npm run build_bundle",

About

A simple ts template to teach user how write and publish remote react comp for hel-micro

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published