1. 概述
1.1 版本
| App版本 | 功能变动 |
|---|---|
| V11.0.89 | App打包支持在「关于」内展示备案信息，详情见4.4节 |
1.2 应用场景
App 打包就是对 FineMobile 数据分析 App 进行 OEM，定制企业专属的 App 。
1.3 功能介绍
通过 App 云打包服务，用户可以对 FineMobile 数据分析 App 进行 OEM，更换 App 的图标、名字、内置服务器、登录页等，实现个性化定制 App，打造企业专属应用。
打包后用户可以下载安装包自行发布并进行版本控制。
自动打包方便易操作、零代码、界面化配置。
2. 准备工作
1）用户需提前准备打包时的图片素材，详情请参见：App 打包素材准备
2）用户如需生成 Android 版 App ，需配置 Android 证书，详情请参见：App 打包配置 Android 证书
3）用户如需生成 iOS 版 App ，需配置 iOS 证书，详情请参见：App 打包配置 iOS 证书
4）用户如需生成 iOS 版 App ，无法申请到苹果企业账号，详情参见：App打包配置iOS自定义证书
3. 新建应用
登录 帆软市场，准备工作完成后，点击「用户中心」>「App打包」>「新建应用」，进入 App 打包信息配置页面。如下图所示：
4. 打包配置
4.1 应用信息
应用信息配置如下图所示：
具体设置如下表所示：
| 配置项 | 说明 |
|---|---|
| 应用名称 | 必填项，桌面及关于显示的应用名称，建议 5 字以内 |
| 应用描述 | 必填项，描述应用的作用，1000汉字以内 |
| 应用图标 | 必填项，桌面及关于显示的应用图标 建议上传尺寸为 1024*1024 像素、不超过 1M 的 png 图片 |
4.2 启动设置
启动设置如下图所示：
具体设置如下表所示：
| 配置项 | 说明 |
|---|---|
| 引导页 | 默认不勾选 勾选「显示」后，首次安装应用时会显示应用介绍页面 |
| 启动页 | 选填项，设置启动 App 时显示的背景图片，可分别上传手机和平板启动页
如上传其他尺寸的图片，会以图片中心为原点，自适应显示 如不上传启动页，将使用 App 自带的启动页图片 |
4.3 服务器设置
服务器设置如下图所示：
App 打包时，帆软自带的 Demo 服务器会自动删除。
用户可选择是否在 App 中内置自己的服务器，默认不勾选。
如勾选「是」，需填写以下信息：
| 配置项 | 说明 |
|---|---|
| 服务器名称 | 为自己的服务器命名 |
| 服务器地址 | 填写需要内置的服务器地址 |
| 添加服务器 | 可选项，默认勾选 不勾选「允许」时，打包的 App 登录界面将无服务器入口，用户无法「查看」/「修改」/「添加」服务器信息 |
4.4 关于设置
「关于」页面的设置如下图所示：
具体设置如下表所示：
| 配置项 | 说明 |
|---|---|
| 版本号 | 「关于」页面中显示的版本号 |
| 版本更新 | App 打包时可根据用户需求进行版本管理控制，自行决定是否更新 具体配置请参见：App 打包实现版本自主管理 |
| 备案信息 | 在「关于」中展示备案信息输入框中的内容，默认点击备案号链接跳转到：https://beian.miit.gov.cn |
| 版权信息 | 必填项，「关于」页面中显示的 App 版权信息 |
4.5 版本库
用户可根据自身需求选择 10.0 或 11.0 版本，使用当前最新的 iOS 和 Android 版本库，与官方应用同步。
版本库设置如下图所示：
4.6 插件设置
插件设置如下图所示：
具体设置如下表所示：
| 配置 | 说明 |
|---|---|
| 深信服 VPN | 可选项，选择是否要包含深信服 VPN 功能，默认不选 勾选打包后，可以将 VPN 地址、用户名、密码内置到 App 中。详情请参见：深信服 VPN |
| 消息推送 | 可选项，可以选择是否要包含消息推送功能 如需使用该功能，勾选「打包」后，具体配置方法请参见：App 打包支持消息推送 |
| 收藏 | 可选项，可以选择是否在模板中显示收藏按钮，默认不选 如需使用该功能，勾选打包后，模板中将出现「收藏」按钮，主页底部菜单有「常用」按钮 |
| 离线 | 可选项，可以选择是否在模板中显示下载按钮，默认不选 如需使用该功能，勾选打包后，模板中将出现「下载」按钮，设置中有「离线缓存」项 |
| 分享 | 可选项，可以选择是否在模板中显示分享按钮，默认不选 |
4.7 安全性设置
安全性设置如下图所示：
具体设置如下表所示：
| 配置 | 说明 |
|---|---|
| 自动登录 | 可选项，可以选择是否在打开 App 时自动登录，默认勾选 如需使用该功能，勾选「显示」后，登录时支持「自动登录」 |
| 登录安全键盘 | 可选项，可以选择在输入登录密码时使用安全键盘，默认不选 如需使用该功能，勾选「使用」后，登录页面输入密码时调用安全键盘 用户可选择键盘随机分布，App 中安全键盘的按键将随机分布 |
| HTTPS服务器证书 | 可选项，可以选择是否在模板中显示「分享」按钮，默认不选 如需使用该功能，勾选「合法性校验」后： 1）添加 HTTPS 服务器时，对服务器进行证书合法性校验 2）添加非 HTTPS 服务器时，可以正常添加 |
| 密码输入保护 | 可选项，可以选择在输入密码时是否开启密码保护，默认不选 如需使用该功能，勾选「使用」后，输入密码页面「禁止截屏」 使用该功能后，输入密码时，将 App 切换到「后台/其他 App 界面」，再次打开 App，已输入的密码将被清空 |
| WiFi安全检测 | 勾选「使用后」，每次请求前会检测代理 连接服务器、登录时、App 内打开模板时，如果检测到 WiFi 处于代理状态，则弹窗提示：当前无线网为不安全网络，无法访问 |
| 请求额外参数 | 可选项，可以选择是否设置额外参数，默认不选 如需使用该功能，勾选后显示 Key、Value 的文本框，文本框内容无限制，由客户自定义参数 |
4.8 其他设置
其他设置如下图所示：
具体设置如下表所示：
| 配置 | 说明 | |
|---|---|---|
| URL Scheme | 可以通过自定义的 URL 链接去启动 App，不需要手动点击 App 图标去启动 示例：com.fr.finereport://?serverName=远程10&serverUrl=http://ip:端口/webroot/decision&reportUrl=GettingStarted.cpt&reportName=模板名称 具体设置方式请参见：如何从外部 App 启动帆软的数据分析 | |
| 隐私策略 | 默认不隐藏「隐私策略」，则首次安装 App 引导页的底部和 App 内「关于」中显示「隐私策略」。 勾选「隐藏」后，则不显示「隐私策略」。 | |
4.9 高级配置
点击基本配置底部的「高级配置」按钮，进入高级配置的设置界面。
高级配置可进行更多的个性化定制，包括：「登录页」和「配色设置」。如下图所示：
1）登录页
2）配色设置
4.10 越狱环境检测
iOS 设备越狱后，处于不安全的环境下，在越狱环境中运行打包的 App，难以保证程序使用过程中数据的安全性。
登录打包的 iOS 版 App 时，将自动检测设备是否越狱并提醒。详情请参见：［App］iOS设备越狱环境检测
5. 完成打包
5.1 生成安装包
1）App 打包信息配置完成后，点击「保存」，下次打包时无需再次修改。此时「生成安装包」按钮从灰色不可选变为蓝色可选状态。
注意事项：
配置了华为消息推送通道的用户，之前配置过 AppID，升级版本后还没有配置 json 文件。会出现提示：
“华为官方推送通道尚未配置 json 文件，无法正常推送消息，是否继续？”
解决方案：可参考文档 华为消息推送通道 配置 json 文件。
2）点击「生成安装包」按钮后，提示开始打包，跳转到应用管理界面，可以查看到当前打包状态，如下图所示：
注：打包采用排队机制，可能耗时比较久，请耐心等待。
5.2 下载安装包
打包成功后，右边会出现三个可操作按钮，分别为：
打包：点击后可进入打包信息配置页面，再次进行编辑。
下载：悬浮在其上方会弹出二维码下载链接。
删除：点击后删除该应用。
点击下载，二维码下载链接如下图所示：
注：帆软市场提供的下载页面，只会保留一天（因为缓存原因，一段时间可能还能下到），每日凌晨会自动清理。打包之后如果当天不能测试完毕，请及时下载安装包进行备份。
5.3 分享安装包
由于 App 打包页面的下载按钮和扫码下载，有效期仅有一天，因此提供两种 App 发布方法，供企业用户分享发布，详情请参见：
1）发布到蒲公英平台：App 打包发布至蒲公英
2）发布到自定义平台：部署 App 自定义发布平台
如果是通过 Custom App 模式，完成 iOS 版 App 定制，那么供企业用户分享发布应用需参考文档：Custom App分发插件
6. 常见问题
6.1 报错41300002
问题现象：
集群环境下，APP 下拉框偶发显示为空，偶发报错 12400004 。如下图所示：
问题原因：
因为内存负载高，智能释放导致的。
问题排查：
建议检查并减少内存占用情况。
6.2 Custom App审核失败
成功打包custom APP之后会上传APPLE审核。有些设置可能导致APPLE审核失败
