Umi4集成阿里低代碼框架lowcode-engine實(shí)現(xiàn)

更新時(shí)間：2022年08月12日 11:28:42 作者：杰出D

這篇文章主要為大家介紹了Umi4集成阿里低代碼框架lowcode-engine實(shí)現(xiàn)詳解，有需要的朋友可以借鑒參考下，希望能夠有所幫助，祝大家多多進(jìn)步，早日升職加薪

前言

最近準(zhǔn)備研究下阿里低代碼框架lowcode-engine, 官方Demo是提供好的腳手架，由于我們的框架使用的是umi，官方文檔提供了一些教程，在此記錄下在umi4集成lowcode-engine.

實(shí)現(xiàn)

搭建umi4項(xiàng)目

1.通過官方文檔的快速開始，我們可以快速創(chuàng)建出項(xiàng)目

先找個(gè)地方建個(gè)空目錄

mkdir myapp && cd myapp

通過官方工具創(chuàng)建項(xiàng)目, 這里我們采用pnpm包管理工具

$ pnpm dlx create-umi@latest
? Install the following package: create-umi? (Y/n) · true
? Pick Npm Client ? pnpm
? Pick Npm Registry ? taobao
Write: .gitignore
Write: .npmrc
Write: .umirc.ts
Copy:  layouts/index.tsx
Write: package.json
Copy:  pages/index.tsx
Copy:  pages/users.tsx
Copy:  pages/users/foo.tsx
> @ postinstall /private/tmp/sorrycc-vylwuW
> umi setup
info  - generate files

創(chuàng)建完成后，安裝依賴, 執(zhí)行 pnpm dev就可以看到我們的項(xiàng)目啟動(dòng)起來了。

集成lowcode-engine

引入U(xiǎn)MD包, 我們?cè)?.umirc.ts中配置externals,styles和scripts

 externals: {
    'react': 'var window.React',
    'react-dom': 'var window.ReactDOM',
    'prop-types': 'var window.PropTypes',
    '@alifd/next': 'var window.Next',
    '@alilc/lowcode-engine': 'var window.AliLowCodeEngine',
    '@alilc/lowcode-editor-core': 'var window.AliLowCodeEngine.common.editorCabin',
    '@alilc/lowcode-editor-skeleton': 'var window.AliLowCodeEngine.common.skeletonCabin',
    '@alilc/lowcode-designer': 'var window.AliLowCodeEngine.common.designerCabin',
    '@alilc/lowcode-engine-ext': 'var window.AliLowCodeEngineExt',
    '@ali/lowcode-engine': 'var window.AliLowCodeEngine',
    'moment': 'var window.moment',
    'lodash': 'var window._',
  },
  styles: [
    'https://alifd.alicdn.com/npm/@alilc/lowcode-engine@latest/dist/css/engine-core.css',
    'https://g.alicdn.com/code/lib/alifd__next/1.23.24/next.min.css',
    'https://alifd.alicdn.com/npm/@alifd/theme-lowcode-light/0.2.0/next.min.css',
    'https://alifd.alicdn.com/npm/@alilc/lowcode-engine-ext@latest/dist/css/engine-ext.css'
  ],
  scripts: [
    {
      src: 'https://g.alicdn.com/code/lib/react/18.0.0/umd/react.development.js',
      defer: false,
    },
    {
      src: 'https://g.alicdn.com/code/lib/react-dom/18.0.0/umd/react-dom.development.js',
      defer: false,
    },
    {
      src: 'https://g.alicdn.com/code/lib/prop-types/15.7.2/prop-types.js',
      defer: false,
    },
    {
      src: 'https://g.alicdn.com/platform/c/react15-polyfill/0.0.1/dist/index.js',
      defer: false,
    },
    {
      src: 'https://g.alicdn.com/platform/c/lodash/4.6.1/lodash.min.js',
      defer: false,
    },
    {
      src: 'https://g.alicdn.com/code/lib/moment.js/2.29.1/moment-with-locales.min.js',
      defer: false,
    },
    {
      src: 'https://g.alicdn.com/code/lib/alifd__next/1.23.24/next.min.js',
      defer: false,
    },
    {
      src: 'https://alifd.alicdn.com/npm/@alilc/lowcode-engine@latest/dist/js/engine-core.js',
      defer: false,
    },
    {
      src: 'https://alifd.alicdn.com/npm/@alilc/lowcode-engine-ext@latest/dist/js/engine-ext.js',
      defer: false,
    }

我們使用lowcode-enginey引擎提供的init進(jìn)行初始化，init() 內(nèi)部會(huì)調(diào)用 ReactDOM.render() 函數(shù)，這樣初始化有些弊端。一些內(nèi)容沒有辦法與外部的 React 組件進(jìn)行通信，也就沒有辦法在一些自定義的 plugin 中獲取 redux 上的全局?jǐn)?shù)據(jù)等內(nèi)容，但也有好處，就是低代碼引擎比較獨(dú)立，后期可以拆出供多個(gè)項(xiàng)目使用。

我們參考官方提供的Demo的入口文件。在我們這里封裝成一個(gè)LowcodeEditor組件。

import { init, plugins } from '@alilc/lowcode-engine';
import { useEffect } from 'react';
import registerPlugins from './plugin';
import './global.less';
export default function LowcodeEditor() {
  useEffect(() => {
    const preference = new Map();
    preference.set('DataSourcePane', {
      importPlugins: [],
      dataSourceTypes: [
        {
          type: 'fetch',
        },
        {
          type: 'jsonp',
        },
      ],
    });
    (async function main() {
      await registerPlugins();
      console.log('first-2')
      init(
        document.getElementById('engine-container')!, {
          // designMode: 'live',
          // locale: 'zh-CN',
          enableCondition: true,
          enableCanvasLock: true,
          // 默認(rèn)綁定變量
          supportVariableGlobally: true,
          // simulatorUrl 在當(dāng) engine-core.js 同一個(gè)父路徑下時(shí)是不需要配置的?。?！
          // 這里因?yàn)橛玫氖?alifd cdn，在不同 npm 包，engine-core.js 和 react-simulator-renderer.js 是不同路徑
          simulatorUrl: [
            'https://alifd.alicdn.com/npm/@alilc/lowcode-react-simulator-renderer@latest/dist/css/react-simulator-renderer.css',
            'https://alifd.alicdn.com/npm/@alilc/lowcode-react-simulator-renderer@latest/dist/js/react-simulator-renderer.js',
          ],
          requestHandlersMap: {
            fetch: async () => {}
          }
        },
        preference,
      );
    })();
  }, []);
  return <div id='engine-container' style={{backgroundColor: 'red'}}></div>;
}

這里只是入口組件的初始化，組件內(nèi)部還有很多內(nèi)容，我們重Deom中copy出來。比如plugin，assets.josn,schem.json等，這里不做過多的介紹，里面的內(nèi)容好多，后續(xù)我們一邊學(xué)習(xí)，一邊慢慢拆解，分享。

使用LowcodeEditor組件，在我們需要的地方直接導(dǎo)入，使用就行

import yayJpg from '../assets/yay.jpg';
import LowcodeEditor from '@/components/lowcode-editor2';
export default function HomePage() {
  return (
    <div style={{height: '100%'}}>
      <LowcodeEditor />
    </div>
  );
}

4.訪問頁面