评论

kbone,十分钟让 Vue 项目同时支持小程序

hey,同学。这里是kbone~

什么是kbone

微信小程序开发过程中,许多开发者会遇到 小程序 与 Web 端一起的需求,由于 小程序 与 Web 端的运行环境不同,开发者往往需要维护两套类似的代码,这对开发者来说比较耗费力气,并且会出现不同步的情况。

为了解决上述问题,微信小程序推出了同构解决方案 kbone 来解决此问题。

那么,kbone 要怎么使用呢?这里我们将通过一个 todo 的例子来跟大家讲解。

基本结构

首先,我们来看下一个基本的 kbone 项目的目录结构(这里的 todo 是基于 Vue 的示例,kbone 也有 ReactPreactOmi 等版本,详情可移步 kbone github)。

因为 kbone 是为了解决 小程序 与 Web 端的问题,所以每个目录下的配置都会有两份(小程序 与 Web 端各一份)

入口

不管是 小程序 端还是 Web 端,都需要入口文件。在 src/index 目录下,main.js 为 Web 端用主入口,main.mp.js 则为 小程序 端用主入口。

当然,Web 端会比 小程序 多一个入口页面,即 index.html(位于根目录下)。

下面两段代码分别是 小程序端 入口与 Web 端入口的代码,可以看到 小程序端的入口代码封装在 createApp 函数里面(这里固定即可),内部会比 Web 端多一个创建 app 节点的操作,其他的基本就是一致的。

// 小程序端入口
import Vue from 'vue'
import todo from './todo.vue'

export default function createApp() {
  // 创建app节点用于绑定
  const container = document.createElement('div')
  container.id = 'app'
  document.body.appendChild(container)

  return new Vue({
    el: '#app',
    render: h => h(todo)
  })
}
// web端入口
import Vue from 'vue'
import todo from './todo.vue'

new Vue({
  el: '#app',
  render: h => h(todo)
})

todo.vue

在上面的入口图可以看到,源码目录中,除了入口文件分开之前,页面文件就是共用的了,这里直接使用 Vue 的写法即可,不用做特殊的适应。

配置

写完代码之后,我们要怎么跑项目呢?这时,配置就派上用场啦。

Web 端配置为正常的 Vue 配置,小程序端配置与 Web 端配置的唯一不同就是需要引入 mp-webpack-plugin 插件来将 Vue 组件转化为小程序代码。

构建代码

接着,我们需要构建代码,让代码可以运行到各自的运行环境中去。构建完成后,生产代码会位于 dist 目录中。

// 构建 web 端代码
// 目标代码在 dist/web
npm run build

// 构建小程序端代码
// 目标代码在 dist/mp
npm run mp

小程序端 的构建会比 Web 端的构建多一个步骤,就是 npm 构建。

进入 dist/mp 目录,执行 npm install 安装依赖,用开发者工具将 dist/mp 目录作为小程序项目导入之后,点击工具栏下的 构建 npm,即可预览效果。

效果

最后,我们来看一下 todo 的效果。kbone 初体验,done~

todo 代码可到 kbone/demo13 自提。

最后

如果你想了解更多 kbone 相关的使用及详情,可移步 kbone github

如有疑问,可到 Kbone小主页 发帖沟通。

最后一次编辑于  2020-04-22  
点赞 14
收藏
评论

42 个评论

  • 黄堪仁👌
    黄堪仁👌
    2020-02-16

    只支持微信小程序?

    2020-02-16
    赞同
    回复 5
  • 逸海🐇
    逸海🐇
    2020-02-13

    这个比uni-app的优势是? 微信推出的?

    2020-02-13
    赞同
    回复 1
    • 小程序技术专员-binnie
      小程序技术专员-binnie
      2020-02-13
      因为 kbone 是通过提供适配器的方式来实现同构,所以它的优势很明显:


      大部分流行的前端框架都能够在 kbone 上运行,比如 Vue、React、Preact 等。
      支持更为完整的前端框架特性,因为 kbone 不会对框架底层进行删改(比如 Vue 中的 v-html 指令、Vue-router 插件)。
      提供了常用的 dom/bom 接口,让用户代码无需做太大改动便可从 Web 端迁移到小程序端。
      在小程序端运行时,仍然可以使用小程序本身的特性(比如像 live-player 内置组件、分包功能)。
      提供了一些 Dom 扩展接口,让一些无法完美兼容到小程序端的接口也有替代使用方案(比如 getComputedStyle 接口)。

      具体可以看下:https://wechat-miniprogram.github.io/kbone/docs/


      是微信推出的
      2020-02-13
      1
      回复
  • 唏嘘
    唏嘘
    2020-01-14

    哇偶,kbone

    2020-01-14
    赞同
    回复 1
  • 星河
    星河
    2019-12-31

    你好编译速度太慢怎么破,每次修改代码保存都要十几秒的编译

    2019-12-31
    赞同
    回复 1
  • Jelon
    Jelon
    2019-11-17
    2019-11-17
    赞同
    回复
  • 一昂杨
    一昂杨
    2019-11-06


    这里星期四是不是bug,今天才星期三

    2019-11-06
    赞同
    回复 3
  • 刘辉
    刘辉
    2019-11-06
    小程序啥时候支持webassembly
    2019-11-06
    赞同
    回复
  • 2019-10-31
    挺好的,接入试试
    2019-10-31
    赞同
    回复
  • Stephen
    Stephen
    2019-10-31

    getComputedStyle 和 getBoundingClientRect 不能同步是硬伤,导致现有组件库无法直接使用,官方能出个kbone专用的组件库就好了,下一步就是可以打包成其他小程序,甚至APP

    2019-10-31
    赞同
    回复 2
  • 拾忆
    拾忆
    2019-10-31
    月底骗赞,我先点了。
    2019-10-31
    赞同
    回复

正在加载...

登录 后发表内容