# M3云定制功能及注意事项
# 一、概述
M3云定制服务旨在为客户提供标准M3产品的个性化定制，包括更换APP图标、名称及预制后端服务器地址等功能，以满足客户在Android和IOS平台上的特定需求。
个性化意味着存在定制成本和风险约束，本文档旨在明确云定制服务的注意事项、处理步骤和方法，以确保服务的顺利进行，所有涉及云定制诉求的客户务必详细看完文档，再做是否定制的决策。
本文档适用场景：
- 协同云-M3云定制：适用于需要对标准M3进行浅层二次封装（不用开发获取源码定制），以满足APP个性化需求的场景。
当前主要提供更换 APP 图标，修改 APP 名称，预制服务器地址等功能。
# 二、操作文档
在线和离线分别提供了一份M3云定制文档（二选一参考即可）：
在线文档存放于协同云-帮助手册-基础操作指南-工作台-【M3云定制】 (opens new window)
离线文档存放于商务公布的安装程序/文档下载地址-客户版本-文档-操作手册-M3用户操作手册-“定制版本管理-云打包”章节
# 三、风险与注意事项
- 交付成本：M3云定制仅省去了代码开发工作量，实际获取证书、签名、注册定位key、注册离线消息、打包上架都存在工作量，并且需要具备相关经验的人员操作，请参考本文做好成本的预估，不要仅仅只考虑云定制配置成本！
- 标准产品问题：云定制后的 APP 已非标准产品 APP ，如出现标准产品问题或安全审计问题，可能无法立刻解决，一般都要用最新版本APP做重新打包，需提前与客户沟通成本和时间风险。
- 权益使用：一个端一次权益，如同时封装 iOS 和 Android，需购买两次权益。权益自生效时间起一个月内有效，过期后将无法重新构建。
- 隐私协议：用户隐私协议需要客户自行编写，隐私协议具有法律效应，建议客户法务确认后发布。可以基于M3标准协议进行修改，单需要剔除所有与致远相关的信息。
注意：隐私协议是具有法律效益的文书，切忌直接拷贝致远的隐私协议。如客户基于致远隐私协议进行修改不可包含任何致远信息，否则客户可能会承担相关的法律责任。
# 四、能力要求
# Android APP定制要求
注：以下所有操作都是M3云定制的额外成本支出：
| 类型 | 操作人能力要求 | 影响范围 | 参考文档 |
|---|---|---|---|
| 证书文件 | 具备计算机基础能力人员 | 必做，如无证书无法做APP定制 | M3操作手册-云打包 |
| 构建错误 | 具备Android APP编译构建错误日志分析能力 | 必做，如出现错误无法成功构建APP | 无参考，建议先做纯证书构建，再依次加入别的配置，错误时方便找原因 |
| 高德定位 | 具备计算机基础，自主去高德官网申请 | 不做会导致APP定位功能不可用 | 高德定位官网（手册中有地址） |
| Mob分享 | 具备计算机基础，自主去分享官网申请 | 不做会影响APP分享给QQ、微信、钉钉 | 各自官网申请（手册中有地址） |
| 乐播投屏 | 具备计算机基础，自主去乐播官网申请 | 不做会影响APP投屏到乐播 | 乐播分享官网（手册中有地址） |
| 华为推送 | 具备申请华为推送证书经验，并且必须上架华为市场 | 不做影响华为手机收到离线消息 | 华为推送官网（手册中有地址） |
| 小米推送 | 具备申请小米推送证书经验，并且必须上架小米市场 | 不做影响小米手机收到离线消息 | 小米推送官网（手册中有地址） |
| VIVO推送 | 具备申请VIVO推送证书经验，暂时无需上架市场 | 不做影响VIVO手机收到离线消息 | VIVO推送官网（手册中有地址） |
| OPPO推送 | 具备申请OPPO推送证书经验，暂时无需上架市场 | 不做影响OPPO手机收到离线消息 | OPPO推送官网（手册中有地址） |
| 魅族推送 | 具备申请魅族推送证书经验，暂时无需上架市场 | 不做影响魅族手机收到离线消息 | 魅族推送官网（手册中有地址） |
| 荣耀推送 | 具备申请荣耀推送证书经验，暂时无需上架市场 | 不做影响荣耀手机收到离线消息 | 荣耀推送官网（手册中有地址） |
| ICP备案 | 具备ICP备案经验 | 2024年工信部新规，不做备案会影响APP分发 | APP备案参考文档 (opens new window) |
| 隐私协议 | 客户的法务参考M3标准协议做修改，涉及“致远”内容全部剔除 | 不能照抄M3隐私，完全复制极大概率审核无法通过 | 工信部关于隐私政策的说明，以及M3隐私协议 (opens new window) |
| APP上架 | 具备APP上架应用市场经验 | 如无离线消息接收需求尽量建议内部分发，如果上架，涉及大量客户资质、审核等动作，成本和周期不低 | 各应用市场上架规范 |
# IOS APP定制要求
注：以下所有操作都是M3云定制的额外成本支出：
| 类型 | 能力要求 | 影响范围 | 参考文档 |
|---|---|---|---|
| 根证书文件 | 具备IOS开发能力人员+Mac电脑+客户已注册299证书 | 必做，如无根证书无法做APP定制 | M3操作手册-云打包 |
| 构建错误分析 | 具备IOS APP编译构建错误日志分析能力 | 必做，如出现错误无法成功构建APP | 无参考，建议先做纯证书构建，再依次加入别的配置，错误时方便找原因 |
| 高德定位 | 同Android | 不做会导致APP定位功能不可用 | 可复用Android申请的Key，无需重复申请 |
| Mob分享 | 同Android | 不做会影响APP分享给QQ、微信、钉钉 | 可复用Android申请的Key，无需重复申请 |
| 乐播投屏 | 同Android | 不做会影响APP投屏到乐播 | 可复用Android申请的Key，无需重复申请 |
| 百度推送 | 可忽略 | 可忽略，M3 IOS不用百度推送 | 可忽略 |
| 离线消息 | 具备计算机基础，需要将IOS根证书上传到融云，由融云推送 | 不做影响IOS接收离线消息 | M3操作手册-云打包 |
| ICP备案 | 同Android | 2024年工信部新规，不做备案会影响APP分发 | 与Android统一申请即可 |
| 隐私协议 | 同Android | 不做影响APP上架应用市场 | 与Android统一协议即可 |
| APP上架 | 具备IOS APP上架应用市场经验 | IOS应用市场上架规范 |
# 五、云打包步骤与方法
1、需求分析：
- 与客户沟通，明确定制需求，包括APP图标、名称、服务器地址等。
- 评估需求实现的可行性，并提供初步解决方案。
此步骤非常关键，如果客户后续有其他的客开需求，那么不建议使用云定制。并且云定制不支持云定制已提供的功能外的其他定制化开发需求。
2、环境准备：
- 根据定制平台（Android或IOS）准备相应的开发环境和工具。
- 准备必要的证书文件和资源文件。
3、定制开发：
- 按照客户需求进行APP图标、名称的更换。
- 根据需要预制后端服务器地址。
- 如需使用第三方服务（如推送、定位、分享等），进行必要的配置和集成。
4、测试验证：
- 在开发环境中进行功能测试，确保定制功能正常运行。
- 如有必要，进行多机型、多系统版本的兼容性测试。
5、打包发布：
- 打包生成APK或IPA文件。
- 如需上架应用商店，按照平台要求准备相关资料并提交审核。
6、后期维护：
- 提供必要的后期技术支持和维护服务。
- 如遇标准产品问题，及时与客户沟通并寻求解决方案。
# 常见问题
# 问题：云端构建失败，如何排查？
解决方案： 如果看不懂日志，则一步一步操作来排查构建失败原因。
第一步：仅上传证书文件，然后进行编译，如果失败则说明证书有问题，请找专业人员注册证书；
第二步：如果证书没问题，再加入定位Key，然后进行编译，如果失败则说明定位Key有问题；
后续步骤，依葫芦画瓢，一个一个加，排查具体编译失败的问题点！
# 问题：APP上架应用市场失败，如何排查？
解决方案： 根据应用市场的错误信息，自行网上搜索解决方案消除问题，或联系有上架经验的人员协助上架。
