# 0.3.x 迁移指南

## What's new

`0.3.x` 版本最主要的更新是去掉运行时中 Vue 渲染和更新过程生成 VNode 和 patch 的过程，使得运行时无需创建 VNode 以及进行 VNode 的 DIFF，从而大幅提升了运行时性能，因为去除了 VNode，也简化了 Vue 的 render 函数，从而减小了包大小。对于 H5 的构建流程和运行时架构也进行了简化和重构，便于扩展新的功能。

其他的更新或 Bug 修复：

### Features

* **core:** 支持从 `@nbjump/core` 导出 `$platform`/`config`
* **core:** 支持通过运行时 `config` 配置 H5 路由 `mode`/`base`
* **core:** 增加 TypeScript 类型定义
* **build:** 组件名支持 PascalCase
* **build:** 模版中支持使用模版字符串
* **build:** 引入 SFC 组件时，支持 `*.vue` 后缀写法
* **build:** SFC script 导出支持 `Vue.extend()` 写法
* **cli & cli-template:** 支持跳过 Nbjump 编译用直接 serve H5 dest 目录


### Bug Fixes

* **build:** 修复 v-for 中的过滤器和复杂表达式取值错误
* **build:** 修复 v-on 中事件参数绑定 scoped 变量错误
* **build:** 修复 config 合并策略
* **cli & cli-template:** 修复 serve 自定义 H5 dest 目录时 path 错误


## 是否兼容

`0.3.x` 版本与 `0.2.x` 版本在开发规范层面完全兼容，但是由于 `0.3.x` 重构了运行时，在一些功能特性上有较小的差异和注意点需要检查。

1、computed

`0.2.x` 版本为了优化小程序初始渲染时能获取到 computed 值，进行了一些变通的处理，因为这些处理方法依赖预先创建完整的 Vue 组件树，以及会有一些性能开销。在 `0.3.x` 中，我们移除了对 computed 值的特殊处理，你需要检查是否依赖 computed 值的初始获取。

2、小程序 attached 生命周期

`0.3.x` 中组件对应的 vue 实例创建时机统一到小程序的 `lifetimes.attached` 生命周期，导致在 swan 的 lifetimes.created 生命周期中将无法通过 this 获取到 vue 实例，`lifetimes.created` 中 `this` 中仅可以访问 `$api` 和 `$mp.scope` （指向小程序组件实例）属性。如果有在 `lifetimes.created` 生命周期中通过 `this` 获取和操作 vue 实例，需要将逻辑迁移至小程序的 `lifetimes.attached` 或者 vue 的 `created` 生命周期。

3、事件绑定参数传递

`0.3.x` 在事件绑定中绑定参数时，`$event` 参数只支持作为单独的参数绑定，不支持将 `$event` 放在数组或对象字面量中。例如：

```html
<!-- 支持 -->
<Component @change="handle($event, otherArg, {otherArg})" />

<!-- 不支持 将获取不到 $event -->
<Component @change="handle({$event, otherArg}, otherArg)" />
```

4、npm 引入的 UI 组件库以及组件库作者

如果有使用 npm 引入的 UI 组件库，需要将组件库中的 Nbjump 框架升级到 `0.3.x` 并发布新版本。


## 如何迁移



1、新建项目并转移业务代码

```sh
# 安装 0.3.x nbjump-cli
npm install -g @nbjump/cli@next
```

安装 `0.3.x` 版本的 `@nbjump/cli`，创建一个新项目，然后将业务代码和配置文件合并转移到项目中。

2、从现有项目迁移

```sh
# 安装 0.3.x 依赖包, 非 H5 项目
npm install @nbjump/cli@next @nbjump/build@next @nbjump/core@next -D

# H5 项目
npm install @nbjump/cli@next @nbjump/build@next @nbjump/core@next -D
npm install @nbjump/cli-template@next -D

```


- 升级全局和本地安装的 `@nbjump/cli` 版本到 `0.3.x`
- 升级本地的 `@nbjump/core` `@nbjump/build` 版本到 `0.3.x`
- 升级本地的 `@nbjump/cli-template` 版本到 `0.3.x` （H5 项目）