1. 概述
本文主要总结了移动端常见的问题以及解决方案。
2. APP首页不显示参数面板
问题描述：
移动端首页模板存在参数面板，但在APP预览时不显示参数面板。
解决方案：
正常现象，可安装「顶部参数面板」插件。
3. 折叠屏手机展示样式变化
问题描述：
使用折叠屏手机，折叠时正常，展开后模板样式会变。
原因分析：
由于屏幕宽度改变，折叠屏手机展开后，默认为平板，按照平板样式展示。
解决方案：
暂不支持显示为普通手机样式。
4. 移动端图例无法滑动
问题描述：
移动端图例较多，但是无法滑动查看。
原因分析：
当图例较多时，移动端会分页显示。
布局下按钮切换/轮播切换（隐藏按钮）禁用了图表内部手势，不支持图例的滑动操作。
解决方案：
手指按住图例停一下，不松开，才能滑动图例，否则都是默认滑动的整个报表
5. 修改移动端目录标题
问题描述：
希望自定义显示移动端目录标题
解决方案：
管理员创建移动端服务器时的命名，即为移动端目录标题。
6. 单元格纵向文字不显示
问题描述：
App内，纵向文字不显示/显示不全
原因分析：
对于纵向文字，部分Android机型会自动解析，但还有一些Android机型和IOS设备不会自动解析。
解决方案：
将文字显示方式设置为换行显示。
7. 单元格插入图片有白边
原因分析：
浏览器的 Bug，单元格缩放之后会有间隙，需要修改单元格的位置来隐藏。
解决方案：
通过设置圆角规避该问题。
8. 组件之间有白色的空白区域
问题描述：
组件之间有白色的空白区域。
解决方案：
可以修改移动端的组件间隔，调整为 0 即可。
9. H5 和 App 下预览千分位效果不一致
问题描述：
App 显示类似于顿号，H5 显示类似于逗号
原因分析：
ios-app 和 h5 使用的字体不同，对于中文逗号(，)和英文逗号(,) ：
在 ios-app 使用的字体中，逗号展示的是类似顿号表现形式
在 h5 中，逗号显示的是类似逗号表现形式
不同系统原生和 h5 都存在字体差异。例如：设计器上Mac os和windows系统的字体也存在差异。
10. Android H5，打开圆角较多的模板，多次滑动，容易导致模板内容空白
问题描述：
模板内设置了多个报表块圆角或单元格圆角，上下滑动模板，容易导致部分组件空白加载不出来。
解决方案：
减少报表块圆角或单元格圆角的使用，可以用图片代替。
11. IOS 导出或下载文件找不到文件
问题描述：
iPhone 浏览器中 url 导出文件后，找不到文件，无法使用；Android系统正常。
原因分析：
IOS11 及之后的系统中更新了 App 文件管理器（Files），手机下载的文件可选择保存到文件管理器中。在此之前的系统，文件存放于 iCloud Drive 中。url 导出后明明看到浏览器进度条已经加载完，但是没有任何提示，以为文件导出失败，实际上是文件下载完会在浏览器中预览，看起来效果只是刷新了一下页面。
解决方案：
1）导出后点击浏览器中的分享按钮，分享至其他可读取文件的 App（如微信、WPS等）。
2）IOS11 及之后的系统可以保存到到文件管理器中找到。
12. 鸿蒙系统预览网络异常
问题描述：
访问模板过几分钟后就会出现网络异常，提示网络不可用，手机重启后可以恢复，但一段时间之后还会这样。
原因分析：
单元格用了公式计算时间过长，导致移动端请求超时。
解决方案：
修改单元格公式，以及更新 H5 插件后问题解决。
13. 移动端 App 语言显示英文
问题描述：
Android系统，打开数据分析 App 显示英文，重新下载安装后依旧是英文，且手机系统设置里没有改语言的选项。
原因分析：
手机地区为“阿拉伯联合酋长国”，因此下载 App 之后登录 Demo 服务器均显示英文。
解决方案：
修改地区为中国。
14. App 字体颜色设置没有效果
问题描述：
Android上字体设置没有效果。
原因分析：
手机设置问题。
解决方案：
关掉了“设置-智能辅助-无障碍-关闭高对比文字”即可。
15. PC端挂载模板，移动端展示不出来相应的模板
问题描述：
在 PC 新挂载一个模板，展示终端有手机，但 App 不显示该模板，之前挂载的模板移动端显示正常，目录无法操作。
原因分析：
日志有报错：java.lang.NullPointerException
解决方案：
可尝试重启设计器或者找到脏数据删掉。fine_authority_object 是目录表，目录挂载的 FR 模板，在里面 expandType 是 102，FR 模板都会在 fine_report_extend 里面有一条额外信息，记录参数和类型，看报错日志又像是报表模板的问题，执行 select * from fine_authority_object where expandType = '102' and expandId not in(select id from fine_report_expand)，就找到脏数据了
16. 移动端电视外接鼠标无法获取提示信息
问题描述：
客户再小米电视上显示大屏（android系统），去除 H5 效果 PC 展示，在外接鼠标后放置到地图上没提示信息，点击页没有反应。
原因分析：
即使链接的预览方式是 PC 端预览，但是环境还是移动端设备，代码中监听的是设备，监听到移动端设备后，只能触发 touch 事件而不能监听到鼠标的 click 点击事件，因此 android 系统外接鼠标是对点击是不生效的。
解决方案：
可以使用触屏电视，触屏点击出现提示框，或者电脑外接电视投屏。
17. 移动端嵌套网页框模板想要实现分页
问题描述：
移动端模板使用网页框嵌套 cpt 模板，cpt 模板想要实现分页展示的效果，目前直接嵌套的话，网页框中不显示工具栏，cpt 无法分页。拼接op=page_plus 参数（新引擎分页的参数）可以实现显示分页按钮，但是会有卡顿的效果。
原因分析：
移动端不支持参数 op=page_plus，移动端目前的显示逻辑是，网页框中放 cpt 时不显示 cpt 的工具栏，没显示分页按钮。
解决方案：
用报表块来替代网页框嵌套，使用报表块的工具栏。
18. 报表块单元格内容被截断
问题描述：
决策报表单元格输入多个字符，Android-H5 打开被截断。
原因分析：
单元格字符中包含有空格，浏览器的 bug 导致了这个问题。
解决方案：
删除空格。
19. App预览报表报错500
问题描述：
BI 工程里通过放置 FR 模板文件，挂载了 FR 模板，预览时报错：发生了未知错误，错误码：500，请联系管理员
原因分析：
产品不支持在一个容器下部署两个工程，会出现一系列插件问题。
解决方案：
删除工程中的冲突插件或重新部署。
20. PC 端正常打开，移动端可以看到模板名字但是没有图标且打不开
问题描述：
服务器挂载的 frm 模板，PC 端以及App都能正常看到，html5 看不到这个模板的图标，能看到这个模板的名字，如图所示：
原因分析：
插件版本不匹配。
解决方案：
替换插件版本和服务器 JAR 匹配即可。
21. java.lang.ArithmeticException
问题描述：
移动端预览模板，报错：java.lang.ArithmeticException
原因分析：
模板中使用了Tab块组件，Tab块组件的标题留空导致报错
解决方案：
Tab块组件标题填充内容，不要留空
22. 12400007
23. 当前网络不可用，请检查网络配置
问题描述：
移动端预览大数据量模板，报错：当前网络不可用，请检查网络配置
原因分析：
模板请求超时时间过短，需要调整
解决方案：
超级管理员可通过「fine_conf_entity可视化配置插件」设置模板请求超时时间。重启服务器后设置生效。
注：修改 FineDB 数据库表字段值的方法请参考 FineDB 常用表字段修改 。
| 配置项 | 修改规则 |
|---|---|
| MobileConfig.templateFetchTimeout | 参数值需为整型，默认值为 -1 字段值小于等于 0 时，填报请求、表单数据、请求组件数据限制超时时间为30s 字段值大于 0 时，按照设置的时间生效，单位秒 请求（填报请求、表单数据、请求组件数据）没有返回结果则取消加载；其中填报请求、表单数据超时会弹出提示「模板请求超时，请联系管理员增加请求超时时间」 |
24. Html5Config has the same tableName
问题描述：
工程升级后预览模板报错：非常抱歉，您无法查看该页面 : com.fr.plugin.mobile.web.server.config.Html5Config has the same tableName with com.fr.plugin.mobile.web.server.config.Html5Config
原因分析：
工程下存在不同版本的移动端插件
解决方案：
1）关闭工程
2）删除%Tomcat_HOME%\webapps\webroot\WEB-INF\plugins路径下h5相关插件
3）重启工程
4）安装h5相关插件
