Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
HXX_1990
unidocs-zh
提交
e861e698
U
unidocs-zh
项目概览
HXX_1990
/
unidocs-zh
与 Fork 源项目一致
Fork自
DCloud / unidocs-zh
通知
1
Star
0
Fork
0
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
0
列表
看板
标记
里程碑
合并请求
0
DevOps
流水线
流水线任务
计划
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
U
unidocs-zh
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
0
Issue
0
列表
看板
标记
里程碑
合并请求
0
合并请求
0
Pages
DevOps
DevOps
流水线
流水线任务
计划
分析
分析
仓库分析
DevOps
Wiki
0
Wiki
成员
成员
收起侧边栏
关闭侧边栏
动态
分支图
创建新Issue
流水线任务
提交
Issue看板
体验新版 GitCode,发现更多精彩内容 >>
提交
e861e698
编写于
7月 27, 2022
作者:
D
DCloud_LXH
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
docs: sourcemap
上级
8345cd98
变更
1
隐藏空白更改
内联
并排
Showing
1 changed file
with
96 addition
and
0 deletion
+96
-0
docs/uni-stat-v2.md
docs/uni-stat-v2.md
+96
-0
未找到文件。
docs/uni-stat-v2.md
浏览文件 @
e861e698
...
...
@@ -355,6 +355,102 @@ uni统计新增的文件主要包括:
![
关联前后台数据
](
https://vkceyugu.cdn.bspapp.com/VKCEYUGU-f184e7c3-1912-41b2-b81f-435d1b37c7b4/14744bf3-c88e-4408-b2fa-0ecf0dcf4fe1.png
)
### 错误解析 <Badge text="uni-admin 1.9.4+" />@sourcemap-parse-error
> 此功能只支持 web平台、App平台、微信小程序平台
为方便开发者使用 sourceMap 文件定位代码问题,增加在统计中使用 sourceMap 错误解析功能。
#### 使用环境
1.
使用腾讯云服务空间,不支持阿里云服务空间
2.
HBuiderX 3.5.3+
3.
uni-admin 1.9.4+
4.
不支持 IE
#### 生成 sourceMap@create-sourcemap
-
在 HBuiderX 中生成 sourceMap 文件
-
web 平台在
`发行-> 网站`
时,勾选
`生成 sourceMap`
选项。
!
[
web 平台生成 sourceMap
](
https://vkceyugu.cdn.bspapp.com/VKCEYUGU-f184e7c3-1912-41b2-b81f-435d1b37c7b4/57724126-e970-48f5-bcbf-0dde4b713542.jpg
)
-
App 平台在
`发行 -> 原生App-云打包`
时,勾选
`生成 sourceMap`
选项。
!
[
app 平台生成 sourceMap
](
https://vkceyugu.cdn.bspapp.com/VKCEYUGU-f184e7c3-1912-41b2-b81f-435d1b37c7b4/db7fd53a-7d8a-4e50-977a-552f40e82600.jpg
)
-
微信小程序平台在
`发行 -> 小程序-微信`
时,勾选
`生成 sourceMap`
选项。
!
[
微信小程序平台生成 sourceMap
](
https://vkceyugu.cdn.bspapp.com/VKCEYUGU-f184e7c3-1912-41b2-b81f-435d1b37c7b4/f73bed9a-7b9d-4ab2-b080-ea6571942fdc.jpg
)
-
cli 项目生成 sourceMap 文件
-
vue 2
```
sh
yarn build:h5
--sourcemap
yarn build:app-plus
--sourcemap
yarn build:mp-weixin
--sourcemap
```
-
vue 3
```
sh
yarn build:h5
--sourcemap
yarn build:app
--sourcemap
yarn build:mp-weixin
--sourcemap
```
1.
项目编译完成后,可在
`/unpackage/dist/build/.sourcemap`
中查看到生成的各平台的 sourceMap 文件。
!
[
生成的 sourceMap 路径
](
https://vkceyugu.cdn.bspapp.com/VKCEYUGU-f184e7c3-1912-41b2-b81f-435d1b37c7b4/52e1a71d-a6f2-4458-9213-186dd78684de.jpg
)
3.
由于微信小程序平台上传发布后,会再压缩打包一次,所以需要额外一个步骤:
1.
在
[
微信公众平台
](
https://mp.weixin.qq.com/
)
的
`开发管理/运维中心/错误日志`
中下载线上版本 sourceMap 文件
2.
将下载好的 sourceMap 文件解压到所生成的 sourcemap 文件夹中:
`/unpackage/dist/build/.sourcemap/mp-weixin/__WEIXIN__/`
(__WEIXIN__为新建的目录,解析错误时会根据这个名字查找)
!
[
微信 download sourceMap
](
https://vkceyugu.cdn.bspapp.com/VKCEYUGU-a90b5f95-90ba-4d30-a6a7-cd4d057327db/2e4d0e4f-5be6-4a72-adf0-697a576dd3fa.png
)
**注意事项**
1.
如果下载的 sourceMap 文件中,只有
`__FULL__`
文件夹,请改名为
`__APP__`
2.
只支持
`发行模式`
生成的 sourceMap 文件解析
#### 上传 sourceMap@upload-sourcemap
1.
在
`uni-admin 项目/pages/uni-stat/error/js/js.vue`
页面中搜索
`cloudSpaceId`
补充腾讯云服务空间ID信息
!
[
cloudSpaceId
](
https://vkceyugu.cdn.bspapp.com/VKCEYUGU-f184e7c3-1912-41b2-b81f-435d1b37c7b4/85a05c7a-9523-446e-8c49-3bf40e8a2636.jpg
)
2.
将 uni-admin 项目运行到浏览器中,在
`uni 统计 / 错误统计 / js报错`
页面,错误信息列表表格的右上角有
`上传 sourceMap`
按钮。点击后展示如下:
!
[
上传 sourceMap
](
https://vkceyugu.cdn.bspapp.com/VKCEYUGU-a90b5f95-90ba-4d30-a6a7-cd4d057327db/50878ced-c415-4d8d-923d-f3127e4a1add.png
)
1.
上传请前请填写完整信息:
`应用`
、
`平台`
、
`版本`
2.
点击
`选择文件并上传`
按钮,弹出
`选择文件夹`
框后,请选中编译的对应该平台版本的 sourceMap。如:
**项目根目录/unpackage/dist/build/.sourcemap/h5**
,选中
`h5`
目录后点击上传。如果中途上传失败,在不刷新页面的情况下,重新选择文件夹上传可以跳过已上传文件。
3.
文件夹内容会上传至
`云存储/__UNI__/uni-stat/sourcemap/应用 appId/平台(如:web、mp-weixin、ios)/版本/`
目录下
**注意事项**
1.
云存储需要配置权限:
`所有用户可读`
2.
如果出现跨域需要在
`跨域配置`
中绑定安全域名
3.
上传失败可能会有如下原因:
1.
如果文件名称、文件夹名称带
`ad`
或者广告类的字段,请关闭浏览器广告拦截扩展再上传
2.
如果云存储中该目录已有同名文件,也可能会上传失败。所以在再次上传相同平台,相同版本的 sourceMap 文件前请将云存储中对应目录 (如:
`云存储/__UNI__/uni-stat/sourcemap/应用 appId/平台(如:web、mp-weixin、ios)/版本/`
) 删除
#### 解析错误@parse-error
在
`uni 统计 / 错误统计 / js报错`
页面,错误信息列表表格中,点击表格行中右侧
`详情按钮`
即可在弹窗中查看解析后错误信息。
**示例**
原始错误信息:
![
原始错误:
](
https://vkceyugu.cdn.bspapp.com/VKCEYUGU-f184e7c3-1912-41b2-b81f-435d1b37c7b4/1a8f0fcc-9bbf-4563-9c33-ebe4c7e14800.jpg
)
解析后的错误信息:
![
原始错误:
](
https://vkceyugu.cdn.bspapp.com/VKCEYUGU-f184e7c3-1912-41b2-b81f-435d1b37c7b4/300b16e0-bfea-4dd5-ba95-e06dc1b75b51.jpg
)
-
解析错误是逐行解析,某一行解析失败会返回原错误信息
-
`runtime error`
分隔线下方为平台框架运行时错误栈信息,可以不用关心
## 开源代码解读
...
...
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录