@m860/cerberus

cerberus

react-native微应用/微组件纯JS解决方案

Usage

• 安装cerberus-cli

  $ npm i -g @m860/cerberus-cli
  

• 添加cerberus-cli配置文件 配置参数

  $ touch cbs.json
  

• 启动本地服务

  $ npx cbs start cbs.json
  

• 安装cerberus

  $ npm i @m860/cerberus
  

• 使用useCerberus加载

  import * as React from "react"
  import {useCerberus} from "@m860/cerberus"
  
  export default function(){
      const [status,defined]=useCerberus({
          entry:"http://localhost:9000/main.js"
      });
      if(defined){
          const {default:App}=defined;
          return <App/>
      }
      return null;
  }
  

NOTE: 目前只支持hooks

Full Example

cli配置参数说明

type ConfigOption={
    // 同webpack.mode
    mode:string,
    // 同webpack.entry
    entry:any,
    // 同webpack.output
    output:any,
    /**
    * 需要替换的module
    * 
    * @example
    * {
    *     cerberusTransformOption:{
    *         modules:["dateformat"]
    *     }
    * }
    * 
    */
    cerberusTransformOption:{
        modules:Array<string>,
        /**
         * 需要处理的资源文件的正则表达式，默认：/\.(gif|png|jpeg|jpg|svg)$/i 
         */
        resourceTest?:?RegExp
    }
}

最佳实践

• 一级页面不要使用cerberus来管理组件
• 预加载组件，在APP启动的时候进行一次预加载。

自定义cloud访问的client

// 在App中使用CerberusContextProvider来自定义client
import * as React from "react"
import {CerberusContextProvider} from "@m860/cerberus"

export default function (){
    return (
        <CerberusContextProvider value={{
            client:{
                uri:"http://xxx"
            }
        }}>
        </CerberusContextProvider>
    );
}

Troubleshoot

• 图片没有显示出来

  cli在编译的时候将本地引用的图片编译为uri的方式，所以必须设置width和height才能够正常显示

  <Image source={require("image.png")} style={{width:100,height:100}}/>
  

• debug模式下缓存不生效

• queryEntry参数的urls的顺序和配置文件中的顺序可能不一致，不要使用如下方式：(urls)=>urls[2]