diff --git a/docs/.vitepress/utils.ts b/docs/.vitepress/utils.ts index 634cf0b..757b0e3 100644 --- a/docs/.vitepress/utils.ts +++ b/docs/.vitepress/utils.ts @@ -50,6 +50,10 @@ export default { text: "Uniapp踩坑合集", link: "/front/mini/uniapp/", }, + { + text: "Uniapp对接微信原生SDK", + link: "/front/mini/thirdSDK/", + }, ], }, { diff --git a/docs/front/base/debugger/image-15.png b/docs/front/base/debugger/image-15.png new file mode 100644 index 0000000..9ced2df Binary files /dev/null and b/docs/front/base/debugger/image-15.png differ diff --git a/docs/front/base/debugger/image-16.png b/docs/front/base/debugger/image-16.png new file mode 100644 index 0000000..07e9126 Binary files /dev/null and b/docs/front/base/debugger/image-16.png differ diff --git a/docs/front/base/debugger/image-17.png b/docs/front/base/debugger/image-17.png new file mode 100644 index 0000000..39ff582 Binary files /dev/null and b/docs/front/base/debugger/image-17.png differ diff --git a/docs/front/base/debugger/image-18.png b/docs/front/base/debugger/image-18.png new file mode 100644 index 0000000..ee44bfb Binary files /dev/null and b/docs/front/base/debugger/image-18.png differ diff --git a/docs/front/base/debugger/image-19.png b/docs/front/base/debugger/image-19.png new file mode 100644 index 0000000..00ef61a Binary files /dev/null and b/docs/front/base/debugger/image-19.png differ diff --git a/docs/front/base/debugger/image-20.png b/docs/front/base/debugger/image-20.png new file mode 100644 index 0000000..7bf8552 Binary files /dev/null and b/docs/front/base/debugger/image-20.png differ diff --git a/docs/front/base/debugger/image-21.png b/docs/front/base/debugger/image-21.png new file mode 100644 index 0000000..ef39c3a Binary files /dev/null and b/docs/front/base/debugger/image-21.png differ diff --git a/docs/front/base/debugger/image-22.png b/docs/front/base/debugger/image-22.png new file mode 100644 index 0000000..8887f5d Binary files /dev/null and b/docs/front/base/debugger/image-22.png differ diff --git a/docs/front/base/debugger/image-23.png b/docs/front/base/debugger/image-23.png new file mode 100644 index 0000000..e0d3fa8 Binary files /dev/null and b/docs/front/base/debugger/image-23.png differ diff --git a/docs/front/base/debugger/image-24.png b/docs/front/base/debugger/image-24.png new file mode 100644 index 0000000..957e492 Binary files /dev/null and b/docs/front/base/debugger/image-24.png differ diff --git a/docs/front/base/debugger/image-25.png b/docs/front/base/debugger/image-25.png new file mode 100644 index 0000000..f9f29a3 Binary files /dev/null and b/docs/front/base/debugger/image-25.png differ diff --git a/docs/front/base/debugger/image-26.png b/docs/front/base/debugger/image-26.png new file mode 100644 index 0000000..16371f2 Binary files /dev/null and b/docs/front/base/debugger/image-26.png differ diff --git a/docs/front/base/debugger/image-27.png b/docs/front/base/debugger/image-27.png new file mode 100644 index 0000000..415cd64 Binary files /dev/null and b/docs/front/base/debugger/image-27.png differ diff --git a/docs/front/base/debugger/image-28.png b/docs/front/base/debugger/image-28.png new file mode 100644 index 0000000..04a15fe Binary files /dev/null and b/docs/front/base/debugger/image-28.png differ diff --git a/docs/front/base/debugger/image-29.png b/docs/front/base/debugger/image-29.png new file mode 100644 index 0000000..8c3cec6 Binary files /dev/null and b/docs/front/base/debugger/image-29.png differ diff --git a/docs/front/base/debugger/image-30.png b/docs/front/base/debugger/image-30.png new file mode 100644 index 0000000..bfa7ad1 Binary files /dev/null and b/docs/front/base/debugger/image-30.png differ diff --git a/docs/front/base/debugger/image-31.png b/docs/front/base/debugger/image-31.png new file mode 100644 index 0000000..9b24ab6 Binary files /dev/null and b/docs/front/base/debugger/image-31.png differ diff --git a/docs/front/base/debugger/image-32.png b/docs/front/base/debugger/image-32.png new file mode 100644 index 0000000..08685a9 Binary files /dev/null and b/docs/front/base/debugger/image-32.png differ diff --git a/docs/front/base/debugger/index.md b/docs/front/base/debugger/index.md index adf000c..e918c7e 100644 --- a/docs/front/base/debugger/index.md +++ b/docs/front/base/debugger/index.md @@ -142,18 +142,124 @@ Sources 标签主要用于调试和分析 JavaScript 代码，它提供了强大 - SourceMap + - 问题：通常来说我们发到线上的静态资源为了减小包体积及防止源码泄露等问题，等会在发布前进行代码压缩和混淆，那么在可读性上会大打折扣，从而增加调试 bug 的难度 + ![alt text](image-15.png) + + - 方案：我们可以通过 Webpack 配置，来开启 SourceMap，本质上就是将源码保留并且和打包后的资源建立映射关系，在调试代码的时候，浏览器指向源码处，这样就能很轻松的进行调试了 + - 具体步骤： + + 1. 更改 Webpack 配置文件 + + ```js + module.exports = { + ..., + // 开发环境生成SourceMap, 一般不推荐包体积会增大，且代码易泄露 + productionSourceMap: true, + configureWebpack: { + // 开发环境开启SourceMap + devtool: 'source-map' + }, + } + ``` + + 2. 浏览器中开启 SourceMap 支持 + ![alt text](image-16.png) + +- Search + +Search 功能可以帮我们在当前本地及远程请求回来的所有资源中（静态和接口均可）搜索关键字来进行代码定位 + +![alt text](image-17.png) + +![alt text](image-18.png) + +按照上图步骤完成定位后，你可以通过 debugger(断点)或者 override(重写)的方式进行线上 bug 调试 + - Override -- 控制台 Search +Override 可以让我们在本地临时修改线上运行的代码来排查问题，具体的操作步骤如下： + +1. 先通过上述 Search 的方法定位到目标代码及所在文件 +2. 右键代码所在文件，点击 Override content + ![alt text](image-19.png) +3. 选择本地映射的资源位置，随便指定一个文件夹即可 + ![alt text](image-20.png) +4. 允许 DevTools 的授权 + ![alt text](image-21.png) +5. 在线上代码上做编辑，编辑完成后刷新页面即可生效 + ![alt text](image-22.png) +6. 还原线上代码 + ![alt text](image-23.png) ### Network(网络) +Network 该栏主要是针对浏览器网络进程做的抓包工具，所有网络请求均会被捕获，并且能在该栏中查看及调试 + +#### 基本功能 + +![alt text](image-24.png) + +#### 实用技巧 + +1. Curl + +在联调过程中，后端研发经常会让前端将请求数据给他们，或者重新调请求，我们前端可以通过复制 Curl 给到后端，里面包含一切请求数据，并且后端可以直接在终端中执行 Curl 自己请求接口 + +![alt text](image-25.png) + +![alt text](image-26.png) + +2. Override + +上文讲到我们可以在 Source 中对静态资源进行重写，在 network 中同样允许我们对接口资源进行重写，来达到 mock 数据的目的，比如将线上环境的数据拿到本地开发环境使用 + +![alt text](image-27.png) + +![alt text](image-28.png) + +3. 模拟请求失败场景 + +在我们日常开发中，可能有些时候需要模拟某个资源请求失败的场景，来做降级逻辑或异常兜底的开发 + +![alt text](image-29.png) + ### Performance(性能) -该 Tab 主要用于性能优化时排查使用，详情请见博客中[前端性能优化](https://doggyegg.github.io/charlie-blog/) +该 Tab 主要用于性能优化时排查使用，详情请见博客中[前端性能优化](https://doggyegg.github.io/charlie-blog/front/base/performance/) ### Application(应用) +该栏主要展示某些存放在浏览器文件夹下的缓存文件数据，如 Cookie,LocalStorage,SessionStorage,IndexDB 等 + +通过修改本地储存中 Token 的值，我们可以模拟其它账号登录，用于接口的数据调试等功能的调试 + +![alt text](image-30.png) + ## 三方框架插件 +除了浏览器自带的开发者工具外，我们也可以通过一些 3 方框架配套的浏览器插件来进行调试，如 Vue-DevTool 及 React + +### Vue-devTool + +- [安装链接（需要翻墙）](https://chromewebstore.google.com/detail/vuejs-devtools/iaajmlceplecbljialhhkmedjlpdblhp) +- 安装完成后在开发环境如果是 Vue 项目即可使用该插件进行状态、Dom、等等的调试 + ![alt text](image-31.png) +- 默认情况下，只有在开发环境该插件才能正常加载使用，但是我们可以通过安装[Vue force dev](https://chromewebstore.google.com/detail/vue-force-dev/oohfffedbkbjnbpbbedapppafmlnccmb) 来实现生产环境使用 Vue-devtool 调试 + +### React + +- [React Developer Tools 安装链接](https://chromewebstore.google.com/detail/react-developer-tools/fmkadmapgofadopljbjfkapdkoienihi) + +![alt text](image-32.png) + ## 移动端调试 + +常见的移动端应用一般分为 H5，小程序，APP 等，我们从这 3 个终端来讲讲移动端的真机调试技巧 + +### H5 + +### 小程序 + +### APP + +。。。未完待续 diff --git a/docs/front/mini/thirdSDK/image-1.png b/docs/front/mini/thirdSDK/image-1.png new file mode 100644 index 0000000..60a2b1e Binary files /dev/null and b/docs/front/mini/thirdSDK/image-1.png differ diff --git a/docs/front/mini/thirdSDK/image-2.png b/docs/front/mini/thirdSDK/image-2.png new file mode 100644 index 0000000..f6a6c32 Binary files /dev/null and b/docs/front/mini/thirdSDK/image-2.png differ diff --git a/docs/front/mini/thirdSDK/image.png b/docs/front/mini/thirdSDK/image.png new file mode 100644 index 0000000..f987566 Binary files /dev/null and b/docs/front/mini/thirdSDK/image.png differ diff --git a/docs/front/mini/thirdSDK/index.md b/docs/front/mini/thirdSDK/index.md new file mode 100644 index 0000000..882e965 --- /dev/null +++ b/docs/front/mini/thirdSDK/index.md @@ -0,0 +1,24 @@ +# Uniapp 使用微信原生 SDK 实战 + +Uniapp 本身是不支持引用微信原生页面的，本文以实际业务中对接微信慧眼人脸识别 SDK 作为 Demo,来介绍如何在 Uniapp 项目中集成微信三方 SDK 页面 + +## 具体步骤 + +Uniapp 虽然不支持引用原生页面，但是支持在页面中引用自定义组件，我们首先将三方 SDK 注册为自定义组件 + +1. 在根目录创建 wxcomponets,并且将三方 SDK 放入 + +![alt text](image.png) + +2. 在 pages.json 中注册该组件(也可以在对应页面的 style 中配置) + ![alt text](image-1.png) + +3. 创建一个 uniapp 页面用于承载该 SDK 组件,并且通过 Ref 来调取组件内通过 onLoad 执行的函数 + +![alt text](image-2.png) + +4. 在 SDK 目录下搜索原跳转路径，替换为你用于承载的 uniapp 页面路径 + +## 参考地址 + +- [小程序自定义组件支持](https://uniapp.dcloud.net.cn/tutorial/miniprogram-subject?id=%E5%B0%8F%E7%A8%8B%E5%BA%8F%E7%BB%84%E4%BB%B6%E6%94%AF%E6%8C%81)