Kbone 框架快速上手：把 Web 端代码直接移植到小程序的工具是否好用？

对于这个前端同构框架，知晓云之前也略有耳闻。我们比较关注的是官方宣传的优点—— 提供了常用的 DOM/BOM 接口，让用户代码无需做太大改动便可从 Web 端迁移到小程序端 。

抱着拉出来溜溜的心态，我们找了几个 web 项目，使用 Kbone 框架迁移到小程序端。结果让我大失所望。

我总共试了三个项目，其中两个跑了起来，一个直接放弃。项目一卡在了属性选择器和轮播图上；项目二卡在 css-in-js 上；项目三是后端渲染的模版，这个直接无法使用。过程中主要遇到的问题就是样式。过程细节就省略了，都是泪。下面是我这几次尝试总结下来的几个要点与问题。

一、配置

这个按照官方文档配置，问题不大。需要注意以下几个问题：

1. 如果在小程序中不想把全部内容都在一个页面的渲染的话，webpack 需要配置多入口；

2. eval 相关的 devtool 不能用，例如 cheap-module-eval-source-map；

3. css 样式必须抽离出 css 文件。

二、axios 在微信小程序中使用

使用对应的 adapt，问题不大。使用以下代码解决：

import axios from 'axios'

import mpAdapter from 'axios-miniprogram-adapter'

axios.defaults.adapter = mpAdapter

三、DOM/BOM 接口的兼容性问题

官方提供了 DOM/BOM 的拓展接口，问题不大。此次遇到了以下两个问题：

1. 兼容性。例如 Event 对象以浏览器提供接口并不完全一致，使用以下代码兼容（只是举例说明，并未做完全的兼容测试）：

// Event

const RawEvent = Event

const CustomEvent = function(...args) {

if (typeof args[0] === 'string') {

return new RawEvent({

name: args[0],

target: null,

})

}

return new RawEvent(...args)

}

Event = CustomEvent

2. 某些接口需要自己实现，例如：

window.$$extend('element', {

insertAdjacentHTML: () => {},

})

四、样式

迁移应用到小程序，最大的问题应该就是样式。这个也是由于微信小程序自身的限制 。 除非小程序本身支持，否则框架也是无能为力的。 主要有以下几个问题：

1. 不支持「属性选择器」以及其他微信小程序不支持的选择器；

2. 小程序端某些组件的样式问题，例如，input 组件在渲染成 view + 自定义组件，样式需做特殊处理；

3. 部分 css-in-js 框架不支持抽离 css 文件，无法在小程序上使用。

五、页面鉴权

由于小程序端的页面模版是前端渲染的，无法通过后端对页面鉴权，也无法 redirect。

六、后端渲染

后端渲染无法使用。我迁移的第三个应用，由于 SEO 的需要，采用「后端渲染 + vue（非同构）」的技术栈。同样，由于小程序端的模版是前端渲染出来的，无法迁移该项目。

七、调试

这个问题有点大。前面的问题，可以通过改代码或新项目通过技术选型避开。但是在开发的过程中，没有调试工具，这是个灾难。目前唯一能用的只有 wxml 节点树页面。但是这个的问题也很大。绝大部分的元素都渲染成了 view，并且每个节点都差不多。例如下图，这一堆东西，看到就头疼。

虽然旧项目迁移很不顺利，但是使用 Kbone 开发新项目，相对来说，体验好很多，也顺利很多。我们直接使用了官方的 cli 工具初始化项目，并开发了「知晓云 SDK demo」应用（ 源码 ）。界面如下图：

开发过程中遇到的阻碍，也是「样式」和「调试工具」的问题。这里跟大家介绍一下，Kbone 框架接入知晓云后端云服务 SDK 的步骤：

1. 安装 SDK npm 包。

npm install minapp-sdk 或 yarn add minapp-sdk

2. package.josn 里添加 alias。

{

…

“alias”: {

“baas”: “minapp-sdk/lib/web”,

},

}

3. scripts/webpack.mp.config.js 里添加 alias。

{

…

resolve: {

…

alias: {

baas: “minapp-sdk/lib/index”,

},

...

},

...

}

4. 在需要用的 sdk 的文件中引入 「baas」模块。

import baas from ‘baas’

完成了以上几步，即可在不同平台中引入对应的 sdk。

结论：

从我们目前的体验来看，Kbone 可以帮助开发者将 Web 端的代码编译到微信小程序端，这为开发者节省了时间；但另一方面，新的框架不但有学习成本，而且同构框架难免会遇到兼容性问题。

打个比方，项目维护的工作量并非是简单的 2 - 1 = 1，结果可能是 1.1、1.2 或 1.3。在我们看来，如果超过了 1.5 那几乎没有使用的必要了。由于没做完整的体验，并且框架也在迭代开发中，这里并不能下结论。

另外，由于微信小程序自身的原因，框架对样式的支持也是有限制的，这还得靠开发者自己避开。

因此，我们建议，Kbone 还是适合从头开始做的新项目，如果是迁移旧项目，一定要调研清楚之前的技术栈是否支持 Kbone。毕竟 Kbnoe 只是提供了一个「类 web 的 JS 执行环境」，而一个项目能否跑正常起来还有其他的很多因素，前端的技术栈也是五花八门。

另外还有一个问题可能，如果使用了 Kbone，之前 Web 端使用的第三方组件很有可能不能正常工作了。可能是 JS 问题，也可能是样式问题。

关于 Kbone 框架 就介绍到这里啦，如果你需要获取文中所提及的源码，请在知晓云公众号后台回复「 Kbone 」。