m8-framework-mcp 1.0.0

package/docs/m8mpdoc-develop/014-/345/270/270/350/247/201/351/227/256/351/242/230/M8.3/351/241/271/347/233/256/350/277/201/347/247/273/350/207/263M8.4.md

@@ -0,0 +1,216 @@
+# M8.3 项目迁移 M8.4 指南
+
+M8.4 框架相比 M8.3，由 `webpack + vue2 + vuex` 升级为 `vite + vue3 + ts + pinia`，对于业务代码来说，最主要的变化就是语法上面的变化。
+
+## Vue 非兼容性语法调整
+
+Vue3 支持选项式和组合式两种 API 风格书写，但仍有一些特性发生了变化，必须根据新变化做出对应修改。
+
+[Vue3 迁移指南](https://v3-migration.vuejs.org/zh/breaking-changes/)中已经列出所有非兼容性改变，并详细解释了改变的理由，提供了迁移策略，请逐一对照进行调整。
+
+## 框架部分调整
+
+#### 1. 状态管理调整
+
+`M8.4` 使用`pinia`进行状态管理，使用方式上与`vuex`有些区别，具体使用方式请参考框架文档[Pinia 的使用](/m8mpdoc/?file=015-工程化/Pinia的使用)进行调整。
+
+#### 2. 只支持使用 `ES6` 模块规范
+
+`vite`基于`ESM`，业务代码也应遵循 `ESM` 的导入导出规范。
+
+##### 1）如果项目中存在`CommonJS`规范的导入导出需要进行调整：
+
+`CommonJS`：
+
+```js
+// 导入
+const obj = require('./test.js');
+
+// 导出
+const obj = { a: 1 };
+module.exports = obj;
+```
+
+需要改为`ESM`:
+
+```js
+// 导入
+import obj from './test.js';
+
+// 导出
+export default { a: 1 };
+```
+
+##### 2）如果项目仅仅用到了`require`引入资源，有几种解决方案：
+
+-   一是手动改为 `import` 引入资源;
+
+-   二是安装转换插件`vite-plugin-require-transform`，自动将`require`语句转为`import`语句：
+
+```js
+// 首先安装该插件
+npm i vite-plugin-require-transform -D
+
+// 然后在根目录vite.config.ts文件中添加该插件
+import requireTransform from 'vite-plugin-require-transform';
+
+const plugins = [
+    ...
+    requireTransform({
+        fileRegex: /.ts$|.tsx$|.vue$|.js$/
+    })
+];
+
+export default defineConfig({
+    plugins,
+    ...
+});
+```
+
+-   第三种改为使用 `vite` 语法获取静态资源，该方法只支持 H5 端。官方文档说明：[new URL(url, import.meta.url)](https://vitejs.cn/vite3-cn/guide/assets.html#new-url-url-import-meta-url)
+
+```js
+const imgUrl = new URL('../../static/logo.jpg', import.meta.url).href;
+```
+
+##### 3）如果项目引入三方`UMD`或`CommonJS`库，要在 `vite.config.ts`中配置三方库将其转为 `ES` 模块：
+
+`vite` 的开发服务器将所有代码视为原生 ES 模块。因此，`vite` 会先将`node_modules`中以 `CommonJS` 或 `UMD` 形式提供的依赖项转换为 `ES` 模块。
+
+而不在`node_modules`中的文件，需要我们在 `vite.config.ts`中手动配置以进行转换，示例：
+
+```js
+// 引入了一个标准的UMD库
+// 引入路径不能是相对路径，需要使用别名进行引入
+// 三方库建议都放在 static 目录下
+import web from '@static/uni.webview.1.5.2.js'
+
+// 在 vite.config.ts 配置需要被转换的文件
+export default defineConfig({
+    ...
+    optimizeDeps: { // dev模式
+        include: [
+            ...
+            '@static/uni.webview.1.5.2.js' // 该配置只接受字符串，需要与引入路径完全相同
+        ]
+    },
+    build: {
+        commonjsOptions: { // build模式
+            include: [
+                ...
+                /uni.webview.1.5.2/ // 该配置可接受字符串和正则表达式
+            ]
+        }
+    }
+});
+```
+
+#### 3. 组件库相关调整
+
+所有组件`v-model`双向绑定的默认 prop 由`value`改为`modelValue`，默认触发事件由`input`改为`update:modelValue`;
+
+该变化对原本使用`v-model`没有影响，仅需注意单向传递时要改为使用`modelValue`而不是`value`，对应的监听事件也应相应修改。
+
+```html
+<!-- 无影响 -->
+<em-field v-model="msg" />
+<!-- 在M8.4中不会生效 -->
+<em-field :value="msg" />
+<!-- 在M8.4中正确使用 -->
+<em-field :modelValue="msg" />
+```
+
+#### 4. `css` 调整
+
+##### 1）出于性能考虑，style 中暂不支持 div、p 等 HTML 标签选择器，推荐使用 class 选择器
+
+##### 2）如果项目上存在输出样式变量的 `scss` 文件，需要添加文件名后缀`.module`启用 `CSS Modules`，例如 `common.scss` 改为 `common.module.scss`：
+
+```scss
+// common.module.scss文件输出样式变量
+$zIndex: 1;
+:export {
+    zIndexSm: $zIndex;
+}
+```
+
+```js
+// js中引入样式变量
+import styles from '../css/common.module.scss';
+console.log(styles.zIndexSm); // 1
+```
+
+#### 5. $mp 调整为 $scope
+
+在 Vue3 中，组件实例对象下的 `$mp` 调整为 `$scope`
+
+## 跨平台小程序端注意
+
+#### 1. 作用域插槽相关问题
+
+作用域插槽在支付宝小程序存在一些 bug，具体内容请查看文档[组件库下载使用的 M8.4 调整章节](/m8mpdoc/?file=009-UI组件/000-组件库下载使用)的**作用域插槽注意**小节，这里不进行赘述。
+
+#### 2. 部分小程序端事件延迟或调用失败
+
+可在执行事件的元素上添加 `data-eventsync="true"` 属性以解决此问题，如：
+
+```html
+<template>
+    <button @click="onClick" data-eventsync="true">OK</button>
+</template>
+```
+
+#### 3. 监听原生的点击事件
+
+在平台小程序端，监听原生的点击事件可以先使用 `tap`。
+
+在 Vue3 中，移除了`.native` 修饰符，所以编译器无法预知 `click` 是要触发原生事件，还是组件的自定义事件，故并未转换成小程序的 `tap` 事件。
+
+#### 4. 微信小程序端真机调试问题
+
+-   Vue3 微信开发者工具真机调试页面空白，如[帖子](https://ask.dcloud.net.cn/question/162915)
+-   Vue3 微信小程序真机调试，页面多个输入框、 picker 一起排版时，输入框内容会影响 picker 内容，如[帖子](https://ask.dcloud.net.cn/question/173162)
+
+均可以通过在 `manifest.json` 的 `mp-weixin` 中配置 `minified` 为 `true` 来解决:
+
+```js
+{
+  "mp-weixin": {
+    "setting": {
+      // ...其他配置
+      "minified": true
+    }
+  }
+}
+```
+
+#### 5. 国际化注意
+
+因运行平台限制，目前在平台小程序端不支持插值方式定义国际化,需要使用 `Messages Functions` 定义国际化信息，[参考文档](https://kazupon.github.io/vue-i18n/zh/guide/messages.html#%E5%91%BD%E5%90%8D%E6%A0%BC%E5%BC%8F)。
+
+示例：
+
+```js
+const messages = {
+    en: {
+        greeting: (ctx) => `hello, ${ctx.named('name')}!`
+    }
+};
+```
+
+```html
+<template>{{ $t('greeting', { name: 'DIO' }) }}</template>
+<!-- 结果：hello, DIO! -->
+```
+
+## 插件支持
+
+Vue3 项目中，强烈推荐使用 Vue 官方提供的 VS Code 扩展：`Vue-Official` (之前是 `Volar`) ，它提供了 Vue 单文件组件中的 TypeScript 支持，还伴随着一些其他非常棒的特性。如果你之前已经安装了 Vetur，请确保在 Vue 3 的项目中禁用它。
+
+## Vue3 支持的手机版本
+
+Vue3 支持的范围是：
+
+`Android > 4.4`（具体因系统 webview 版本而异，原生安卓系统升级过系统 webview 一般 5.0 即可，国产安卓系统未使用 x5 内核时一般需 7.0 以上）, `ios >= 10`
+
+`Android < 4.4`，配置 X5 内核支持。

package/docs/m8mpdoc-develop/014-/345/270/270/350/247/201/351/227/256/351/242/230/M8/350/200/201/351/241/271/347/233/256/350/277/201/347/247/273/350/267/250/347/253/257.md

@@ -0,0 +1,55 @@
+# M8老项目迁移跨端指南
+
+迁移前请确认项目需要运行在哪些平台，若只需运行在公司容器、钉钉等H5平台，改造工作量预计较小，若需要跨微信或支付宝小程序端，预计工作量较大。
+
+## 框架资源引入
+
+1. `EJS`库资源引入：跨端框架默认使用的`ejs`版本为`4.2.0+`，资源通过npm下载。
+<br>若原项目使用`v4`版本，可直接迁移。
+<br>若原项目使用的是`v3`或`v2`版本的`EJS`，建议升级至`v4`版本，否则只能手动添加对应版本`EJS`资源并引入，此时无法跨平台小程序端。
+
+2. `Util`资源引入：跨端框架通过npm下载`Util`资源，且将`Util`设置为全局方法，业务代码不用再从`@boot`文件中引入`Util`，可直接使用，请删除引入`Util`的相关语句。
+<br>注意，`config.js`文件中无法使用`Util`，请检查项目的`config.js`文件并作出相应修改。
+
+3. 组件库引入：跨端框架使用的组件库通过npm下载，无需引入注册，可直接在页面上使用，请删除业务代码中原本的组件引入注册代码，并将原本组件的前缀`van-`修改为`em-`。<br>部分通过函数调用的组件，如`Toast`，需要在页面上手动添加下组件节点，具体请查看对应组件使用文档。<br>
+**由于需要跨端使用，组件库部分组件功能受限，请依据跨端组件库文档，检查项目用到的组件及功能在跨端组件库中是否仍支持，若不支持需要项目改为其他方式实现功能。**
+
+4. `Config`配置：跨端框架支持的`Config`配置与`M8.2`框架不完全一致，请检查项目用到的配置在跨端框架中的支持度，若不支持需要项目自己想办法实现或者反馈框架同事评审。
+
+
+## 业务代码改造
+
+1. 路由配置：跨端框架不再使用`vue-router`，项目需要对页面的路由配置作改造，参考文档[Router的使用](/m8mpdoc/?file=011-vuex%E4%B8%8Erouter%E7%9A%84%E4%BD%BF%E7%94%A8/router%E7%9A%84%E4%BD%BF%E7%94%A8)。
+<br>页面的路由跳转都要改为`EJSAPI`方法进行跳转，若使用其他跳转方式可能会导致页面功能异常。
+<br>若使用了路由守卫，需要改为其他方式实现原本的功能，因为平台小程序端完全不支持`vue-router`的功能。
+
+2. `Mock`引入：若调试时用到了`Mock`方法，请注意与`M8.2`应用不同，跨端中通过重新定义别名引用。注意引用的名称为 `@mock`，参考[Mock的使用](/m8mpdoc/?file=012-Mock%E7%9A%84%E4%BD%BF%E7%94%A8/Mock%E7%9A%84%E4%BD%BF%E7%94%A8)。
+
+3. 选人功能：跨端框架的选人功能不再以组件形式提供，而是在框架`src/modules`目录下内置了选人页面`modules/selectperson/index`。<br>项目使用选人功能时，需要将组件调用方式改为跳转选人页面，具体方法参见[selectperson选人](/m8mpdoc/?file=009-UI%E7%BB%84%E4%BB%B6/069-selectperson%E9%80%89%E4%BA%BA%E7%BB%84%E4%BB%B6)。
+
+4. 别名：请注意，跨端框架中部分别名代表的实际路径与M8.2中不同，请使用别名前先查看文档确认下：[路径别名](/m8mpdoc/?file=001-%E9%A1%B5%E9%9D%A2%E5%BC%80%E5%8F%91/003-%E8%B7%AF%E5%BE%84%E5%88%AB%E5%90%8D)。
+
+5. 获取url上参数：跨端框架中获取url上携带的参数不再通过`Util.getExtraDataByKey`方法获取，而是在页面的 `onLoad` 生命周期中获取，具体请查看：[路径别名](/m8mpdoc/?file=001-页面开发/009-生命周期)。
+
+6. 返回拦截：ejs容器内，可以调用ejs方法进行返回监听拦截；在H5和支付宝小程序端，跨端框架提供了`onBackPress`生命周期，但是H5端无法拦截浏览器返回按钮以及安卓端的实体返回键，支付宝小程序端只能监听不能拦截默认返回，具体请查看：[自定义返回逻辑](https://ask.dcloud.net.cn/article/35120)；在微信小程序端及支付宝小程序端，可以调用[wx.enableAlertBeforeUnload](https://developers.weixin.qq.com/miniprogram/dev/api/ui/interaction/wx.enableAlertBeforeUnload.html)或[my.enableAlertBeforeUnload](https://opendocs.alipay.com/mini/api/my.enableAlertBeforeUnload?pathHash=50cb112e)，在离开页面时进行弹窗确认，但都有无法拦截的情况，例如微信小程序不能拦截手势右划返回，支付宝小程序不能拦截`navigateBack`方法返回，具体请查看对应文档。
+
+### 跨平台小程序端注意
+
+1. window等全局对象：小程序端没有`window`、`document`等浏览器对象，若代码中用到浏览器对象，需要查阅跨端文档，寻找对应的方案避开，例如监听页面显隐可以使用框架提供的页面生命周期等。<br>项目中使用的第三方依赖也必须避开浏览器对象，若三方依赖不符合要求，需要寻找替代方案。可以去uniapp插件市场搜索
+
+2. 静态资源引入：如图片、视频等静态资源必须放在`static`目录下，参考文档[引用静态资源](/m8mpdoc/?file=001-%E9%A1%B5%E9%9D%A2%E5%BC%80%E5%8F%91/000-%E5%BC%95%E7%94%A8%E9%9D%99%E6%80%81%E8%B5%84%E6%BA%90)。<br>
+**请注意，部分小程序端不支持`css`引入本地图片，若图片大小小于`40kb`，跨端框架会将本地图片转为`base64`格式，若大于`40kb`，请参考上述文档中介绍的方案安排资源**
+
+3. 语法受限：`Vue`的部分语法在小程序端使用受限，如不支持动态组件、不支持自定义指令`directives`等，请参考文档检查业务代码并改造：[具体见](https://uniapp.dcloud.net.cn/tutorial/vue-api.html)。
+
+4. 样式隔离：平台小程序有自己的样式隔离策略，若项目需要修改子组件样式，可能不会按预期展示。建议直接关闭小程序端的样式隔离。<br>
+若需要给框架跨端组件添加类名，建议通过组件库提供的公共属性`custom-class`添加，参考文档[组件库下载使用](/m8mpdoc/?file=009-UI%E7%BB%84%E4%BB%B6/000-%E7%BB%84%E4%BB%B6%E5%BA%93%E4%B8%8B%E8%BD%BD%E4%BD%BF%E7%94%A8)的公共属性小节。<br>
+由于编译到小程序端，页面的DOM结构会与H5端有差异，页面部分样式可能受到影响，建议仔细排查。
+
+5. 网络协议：平台小程序端的网络请求只支持`HTTPS`协议，且需要配置域名白名单，请提前知悉。具体请查看对应小程序官方文档。
+
+6. 分包：平台小程序对包的大小有限制，超出限制需要对应用进行分包，可以在模块下的`router.js`中配置`options.autoSubPackages`来指定需要设置为分包的模块，参考文档[Router的使用](/m8mpdoc/?file=011-vuex%E4%B8%8Erouter%E7%9A%84%E4%BD%BF%E7%94%A8/router%E7%9A%84%E4%BD%BF%E7%94%A8)。<br>分包相关知识请查看[全局文件`pages.json`](/m8mpdoc/?file=0001-%E5%89%8D%E6%9C%9F%E5%87%86%E5%A4%87/005-pages)中的`subPackages`介绍。请提前规划好应用的资源分配。
+
+7. 动态类名及内联样式设置方式与限制: 使用动态类名时，内联绑定动态类名请使用**数组**或**对象**形式，使用字符串在编译至平台小程序时会报错；而绑定类名变量时，该变量建议提供为**字符串**，否则，若是对象会在微信和支付宝小程序中渲染失败，若是数组，会在支付宝小程序中渲染失败。绑定动态内联样式时，内联绑定请使用**数组**或**对象**形式，使用字符串在编译至平台小程序时会报错；而绑定样式变量时，该变量建议提供为**字符串**，否则，若是数组会在微信和支付宝小程序中渲染失败，若是对象会在微信小程序中渲染失败。
+
+8. 小程序原生组件：部分组件如input、textarea在平台小程序端渲染的是小程序原生的组件，表现与H5浏览器不同，受到小程序限制，使用时请参照跨端文档介绍使用：[基础组件](https://app.epoint.com.cn/m8mpdoc/?file=017-%E5%86%85%E7%BD%AE%E7%BB%84%E4%BB%B6/019-input)

package/docs/m8mpdoc-develop/014-/345/270/270/350/247/201/351/227/256/351/242/230/install.md

@@ -0,0 +1,91 @@
+# npm install 依赖安装常见问题
+
+
+##### 1. code ERR_INVALID_AUTH
+
+![](assets/000/ERR_INVALID_AUTH.png)
+
+这个报错是在Node-v16下，私有npm源的身份配置需要修改。请将`M8跨端框架`升级到`8.3.12`版本；或者修改工程下的`.npmrc`文件，将
+```
+_auth = "ZXBvaW50ZmU6MTExMTE="
+```
+
+修改为：
+
+```
+//192.168.0.99:8081/nexus/repository/npmpublic/:_authToken=NpmToken.98899b04-91a5-353a-be60-cc401e119a79
+```
+
+##### 2. npm ERR! code E404
+
+![](assets/000/codeE404.png)
+
+报错为：`@a-epoint-mrc/vue-cli-plugin-del-uni-tips` 未找到。跨端框架工程请升级到`8.3.11`版本；或者在工程下的`.npmrc`文件中增加：
+
+```
+@a-epoint-mrc:registry = http://192.168.0.99:8081/nexus/repository/npmpublic/
+```
+
+##### 3. npm ERR! code ETARGET
+
+![](assets/000/codeETARGET.png)
+
+报错为： `@epoint-mrc/xxx@8.3.x`版本未找到，实际已发布的框架工程相关依赖都是已发布的。
+
+此报错需要清除npm cache 缓存，然后重新安装依赖。
+
+```bash
+npm cache clean --force # 清除缓存
+npm install # 重新安装依赖
+```
+
+##### 4. package-lock.json文件报错
+
+![](assets/000/package-lock.png)
+
+报错为`package-lock.json`文件报错，一般出现在升级框架工程后出现。
+
+此报错需要删除`package-lock.json`文件，删除`node_modules`文件夹，然后重新安装依赖。
+
+##### 4. code CERT_HAS_EXPIRED 报错
+
+![](assets/000/WX20240122-165411.png)
+
+`/registry.npm.taobao.org`源报错，安装&升级 `nrm` 更换其他npm源。
+
+安装&升级：
+
+```bash
+npm install -g nrm --registry=https://registry.npmmirror.com
+```
+
+使用：
+
+```bash
+nrm ls # 查看所有源
+nrm use taobao # 切换到淘宝源
+```
+
+##### 5. code EINTEGRITY 报错
+
+`@epoint-mrc/ejsv4` 依赖安装失败，提示校验 sha512 值失败。
+
+![alt text](assets/014/sha512.png)
+
+原因是 @epoint-mrc/ejsv4 需要给三方开发安装使用，没有发布至公司私有源。由于统一@epoint-mrc前缀包名为私有源安装，所以安装到 ejsv4 时，私有源会从公有源拉到私有源。私有源可能定时清理这类没有发布的仓库包，有人安装时会同步进来，这里可能导致哈希不一致。
+
+如果遇到这种情况，可以先尝试删除 `node_modules` 目录和 `package-lock.json` 文件，然后重新安装依赖。
+
+如果还不行，需要将 `package.json` 文件中的 `@epoint-mrc/ejsv4` 依赖版本号改为版本号对应的私有源地址，然后重新安装依赖。 例如：
+
+将`package.json`中：
+
+```json
+"@epoint-mrc/ejsv4": "4.x.x"
+```
+
+修改为：
+
+```json
+"@epoint-mrc/ejsv4": "http://192.168.0.99:8081/nexus/repository/npmpublic/@epoint-mrc/ejsv4/-/ejsv4-4.x.x.tgz"
+```

package/docs/m8mpdoc-develop/014-/345/270/270/350/247/201/351/227/256/351/242/230/pageopen.md

@@ -0,0 +1,52 @@
+# 移动前端框架M8页面跳转相关
+
+在使用移动前端框架M8页面跳转的过程中，容易混淆的部分特此说明：
+
+由于移动前端框架M8使用vue技术栈，建议使用vue-router进行路由跳转：
+
+使用vue-router跳转有两种方式，EJSAPI调用与vuerouter调用
+
+`ejs` 调用
+
+```js
+ejs.page.open({
+    pageUrl: './helloworld',
+    data: {
+        key1: 'value1',
+    },
+    // 是否使用vue-router跳转
+    useRouter: true,
+    success: function (result) {},
+    error: function (error) {},
+});
+```
+
+`vue-router`API 调用
+
+```js
+// 字符串
+this.$router.push('helloworld');
+
+// 对象
+this.$router.push({ path: 'helloworld' });
+
+// 带查询参数，变成 /helloworld?key1=value1
+this.$router.push({ path: 'helloworld', query: { key1: 'value1' } });
+
+```
+
+`ejs.page.open`中的参数`useRouter`为`true`时，使用`vue-router`单页面跳转，`pageUrl`仅需要填写相对的路由地址。例如  `pageUrl: './helloworld'`。
+
+如果使用`useRouter`为`false`，调用时将在EJS容器内使用原生`webview`新打开页面。此时的`pageUrl`需要填写dist目录下的完整路径。例如 `pageUrl: './index.html#/module/helloworld'`
+
+注意：
+
+当页面资源部署在后台接口工程下时，访问不带`·`的页面地址，默认会被框架sso授权认证拦截。如果不需要sso授权认证（非第三方授权场景，例如企业微信、钉钉等），需要将`.html`部分带上，访问完整页面地址和跳转路径。例如：
+
+`http://127.0.0.1/frame/H5/dist/index.html#/module/helloworld`
+
+<style>
+img {
+    width: 900px
+}
+</style>

package/docs/m8mpdoc-develop/014-/345/270/270/350/247/201/351/227/256/351/242/230/postcss/350/256/276/347/275/256.md

@@ -0,0 +1,24 @@
+# Postcss设置
+
+PostCSS用于自动将px单位转换为vw和vh单位，用于在移动端页面尺寸根据设备自适应。
+
+配置路径：`buils/css.env.js`
+
+
+
+![](assets/014/postcss.png)
+
+需要注意，宽度基准默认使用的375，如果要开发pad平板等项目，需要将viewportWidth改为平板的宽度基准。
+
+## 指定class不转换
+
+`selectorBlackList`指定了不进行转换的class，只需要在不需要转换的class上带上`ignore`即可
+
+![](assets/014/postcss2.png)
+
+
+<style>
+img {
+    width: 900px
+}
+</style>

package/docs/m8mpdoc-develop/014-/345/270/270/350/247/201/351/227/256/351/242/230/spechara.md

@@ -0,0 +1,39 @@
+# 构建后文件名存在特殊字符 ~
+
+## 问题说明
+
+在跨端框架`v8.3.9`之前，构建的H5应用存在构建后的js资源存在特殊字符`~`。
+
+当页面加载时，由于存在特殊字符，会被F9框架安全拦截。
+
+![](assets/014/spechara_1.png)
+
+![](assets/014/spechara_2.png)
+
+
+## 修复
+
+### v8.3.9之前
+
+在跨端框架`v8.3.9`之前版本，可以通过修改工程个性化构建配置进行修改。
+
+文件位置：
+
+`ejs.m8.mobileframe\build\index.js`
+
+```js
+// ...
+const webpackChain = (config) => {
+    config.optimization.splitChunks({
+        automaticNameDelimiter: '-'
+    });
+};
+// ...
+```
+
+修改 webpackChain 函数，将默认的分隔符进行修改为`-`。
+
+修改完成之后重新运行构建命令。
+### v8.3.9及之后
+
+在跨端框架`v8.3.9`及之后的版本修复，构建不使用默认的特殊字符~进行分割。

package/docs/m8mpdoc-develop/014-/345/270/270/350/247/201/351/227/256/351/242/230/token/350/256/276/347/275/256.md

@@ -0,0 +1,14 @@
+# token设置
+
+使用本地代理调试时，以往的登录接口后带用户身份请求接口由于不同域，需要将token在config.js中手动设置，配置示例：
+
+
+![](assets/014/token.png)
+
+
+
+<style>
+img {
+    width: 900px
+}
+</style>

package/docs/m8mpdoc-develop/014-/345/270/270/350/247/201/351/227/256/351/242/230/transpile_dependencies.md

@@ -0,0 +1,18 @@
+## ** 使用三方npm依赖没有被es5转换 **
+
+默认跨端框架构建时会忽略非跨端框架的 node_modules 中的库文件。
+
+如果你使用了一些三方库，而这些三方库没有使用es5构建，导致低版本移动设备访问页面出现兼容性问题，或者构建时语法报错等，可以在这个选项中列出来。
+
+支持字符串，正则表达式。
+
+文件位置：build/index.js
+
+![img](assets/014/transpile_dependencies.png)
+
+#### 例如：
+
+```js
+// 默认情况下 babel-loader 会忽略所有 node_modules 中的文件。如果你想要通过 Babel 显式转译一个依赖，可以在这个选项中列出来。
+const transpileDependencies = ['lodash', /\@babel\/runtime/, 'xxx'];
+```