微服务打包系统使用手册
<h1>微服务打包系统使用手册</h1>
<p>[TOC]</p>
<h1>1.综述</h1>
<ul>
<li>微服务打包系统是基于Android MSSDK设计的渠道分发打包工具。</li>
<li>打包：Android外放包体制作过程，涉及APK反编译、SDK资源合并、SDK配置、APK加固和签名等流程。</li>
</ul>
<h3>1.1功能简介</h3>
<ul>
<li>MSSDK整合乐逗原休闲和网游SDK，旨在为Android应用快速接入乐逗公版、渠道联运、功能插件等各类SDK,并制作满足上线需求的包体。</li>
<li>Android MSSDK功能图：
<img src="https://www.showdoc.cc/server/api/common/visitfile/sign/385ece16d9cbaf14983ae98edcd73db2?showdoc=.jpg" alt="" /></li>
</ul>
<h3>1.2域名地址</h3>
<ul>
<li><a href="http://biz.cloud.idreamsky.com">http://biz.cloud.idreamsky.com</a></li>
</ul>
<h3>1.3帐号申请</h3>
<ul>
<li>推荐使用飞书登录，账号问题可咨询「技术中台-技术平台部-平台产品组」。</li>
<li><img src="https://www.showdoc.cc/server/api/common/visitfile/sign/5aefce7408f0dde2fe6f16d3245ae782?showdoc=.jpg" alt="" /></li>
</ul>
<h3>1.4应用权限</h3>
<ul>
<li>
<p>可由应用的「业务负责人」将你邀请加入团队成员，并赋予对应角色。
<img src="https://www.showdoc.cc/server/api/common/visitfile/sign/4ae6eb279fa2c219e7d0ab10c3a90b3c?showdoc=.jpg" alt="" /></p>
</li>
<li>如有疑问请咨询「技术中台-技术平台部-平台产品组」</li>
</ul>
<h3>1.5打包入口</h3>
<ul>
<li>
<p><strong>步骤一</strong>：在业务控制台点击「你的应用」进入应用。
<img src="https://www.showdoc.cc/server/api/common/visitfile/sign/aad6d37331c2514aac542f09a59bd953?showdoc=.jpg" alt="" /></p>
</li>
<li>
<p><strong>步骤二</strong>：选择「渠道打包」服务
<img src="https://www.showdoc.cc/server/api/common/visitfile/sign/40867d7cfe328e8bc1840b67902dc5e8?showdoc=.jpg" alt="" /></p>
</li>
<li><strong>注意</strong>：如无「渠道打包」服务，在服务菜单栏底部「添加服务」进入「服务管理」，添加「渠道打包」服务。
<img src="https://www.showdoc.cc/server/api/common/visitfile/sign/9078ce8dc98a3340f45a6ba9cd52b970?showdoc=.jpg" alt="" /></li>
</ul>
<p><img src="https://www.showdoc.cc/server/api/common/visitfile/sign/8cfbb2321e40c0de5984111c479f4db6?showdoc=.jpg" alt="" /></p>
<h3>1.6用户使用流程</h3>
<ul>
<li>用户使用流程图
<img src="https://www.showdoc.cc/server/api/common/visitfile/sign/29096eb5dac3e84a1b4b8b241c9e0dbf?showdoc=.jpg" alt="" /></li>
</ul>
<h2>2.应用配置</h2>
<ul>
<li><img src="https://www.showdoc.cc/server/api/common/visitfile/sign/86c72f4bff70f4a4087c1f735c27ab92?showdoc=.jpg" alt="" /></li>
</ul>
<h3>2.1配置解释</h3>
<ul>
<li>应用简称（英文）：英文名称将被使用在应用包体的命名和获取目录中，1-50个字符，支持英文和下划线。</li>
<li>屏幕方向：选择应用的屏幕方向。</li>
</ul>
<h2>2.2打包模板</h2>
<ul>
<li>打包模板：基于渠道、渠道SDK和插件组合建立的打包模版，用于需要反复多次打包的业务场景。</li>
</ul>
<h3>2.2.1关键定义</h3>
<ul>
<li>渠道：用户所属的流量媒体，如应用商店、手机厂商、移动运营商等合作方。</li>
<li>渠道号：最小颗粒度的用户来源属性，为了标识用户所属媒体，使用大写英文字母和数字组成。</li>
<li>渠道SDK：渠道要求上架应用必须接入的软件开发工具包，主要集成登录和支付为核心功能。</li>
<li>模板配置状态：完成仅代表你所选择的渠道和插件依赖的参数已具备可打包的值，缺失则无法进行打包。</li>
</ul>
<h3>2.2.2新增模板</h3>
<ul>
<li>打包模板名称：为模板填写名称，便于记忆和查找，例如：XXX版本测试、XX渠道更新等等，1-50个字符。</li>
<li>选择渠道：选择需要上线的渠道，此数据是从「业务控制台-渠道管理-渠道」获取，如找不到你想要的渠道，请联系「业务中台-发行支持部-渠道运营中心-渠道支撑及分析组」进行核实或创建。</li>
<li>添加渠道号：选择需要进行打包的渠道号，此数据是从「业务控制台-渠道管理-渠道号」获取，如在此渠道下找不到你想要的渠道号，请联系「业务中台-发行支持部-渠道运营中心-渠道支撑及分析组」进行核实或创建。</li>
<li>渠道号导入：渠道号批量选中功能，支持重复上传。<a href="http://dl.uu.cc/upgrade/channelIDSelect.xlsx" title="导入模板文件">导入模板文件</a></li>
<li>渠道号导出：支持批量导出已选中的渠道号。</li>
</ul>
<p><img src="https://www.showdoc.cc/server/api/common/visitfile/sign/e99bf33b20f9a7903e9322b84a546b03?showdoc=.jpg" alt="" /></p>
<ul>
<li>选择渠道SDK：选择需要接入的渠道SDK。</li>
<li>包名：填写上线该渠道的应用包名，注意满足渠道规范。</li>
<li>签名证书：选择该渠道打包使用的签名证书。</li>
<li>签名方案：选择签名方案，注意兼容已发布版本的签名方案，可质询开发人员获取正确方案。</li>
</ul>
<p><img src="https://www.showdoc.cc/server/api/common/visitfile/sign/1632b0eed52b45dc6ec822feb8532410?showdoc=.jpg" alt="" /></p>
<ul>
<li>加固方式：支持选择无、梆梆加固、乐固加固，请选择应用所需加固方式，并完善其加固参数（如需）。</li>
<li>添加插件：选择当前渠道打包所需的功能插件。</li>
<li><img src="https://www.showdoc.cc/server/api/common/visitfile/sign/d004cfb55ee312e8b9bb206f53276d43?showdoc=.jpg" alt="" /></li>
</ul>
<h3>2.2.3完善模板配置</h3>
<ul>
<li>完善模板配置：在新增模板后，需要完善模板所需配置才能打包，主要是填写渠道SDK、功能插件参数。</li>
<li>进入模板配置：在「打包模板列表」点击「操作-修改」，或点击「渠道SDK配置」和「插件配置」的状态「X」</li>
<li><img src="https://www.showdoc.cc/server/api/common/visitfile/sign/b9ec3e0b8e31b0fe0ae7faa4a761835d?showdoc=.jpg" alt="" /></li>
</ul>
<h5>2.2.3.1渠道SDK配置</h5>
<ul>
<li>填写渠道SDK参数，完善渠道定制资源（如需）
<img src="https://www.showdoc.cc/server/api/common/visitfile/sign/9405bf2ddddaca3a62eedf82a08d9893?showdoc=.jpg" alt="" /></li>
</ul>
<h5>2.2.3.2插件配置</h5>
<ul>
<li>填写插件所需参数
<img src="https://www.showdoc.cc/server/api/common/visitfile/sign/bfa89fe804d8a65cac7aaeec920aeac3?showdoc=.jpg" alt="" /></li>
</ul>
<h5>2.2.3.3自定义配置</h5>
<ul>
<li>自定义参数：适用于乐逗SDK配置文件和AndroidManifest.xml新增参数，例如manifest的<meta-data插入，provider的authorities的对应包名替换。</li>
<li>自定义资源：适用于assets和res目录下的文件替换，例如icon替换，登录支付控制文件替换。
<img src="https://www.showdoc.cc/server/api/common/visitfile/sign/7decf5b012341743c49dcb91fbd9b182?showdoc=.jpg" alt="" /></li>
</ul>
<h4>2.2.4修改模板</h4>
<ul>
<li>操作入口：「打包模板列表-操作-修改」</li>
</ul>
<h4>2.2.5复制模板</h4>
<ul>
<li>操作入口：「打包模板列表-操作-复制」</li>
<li>复制模板：需填写新模板的模板名称，复制生成的模板配置数据与被复制模板完全一致。</li>
<li><img src="https://www.showdoc.cc/server/api/common/visitfile/sign/4375ad61dfdda5d844261863aac6a939?showdoc=.jpg" alt="" /></li>
</ul>
<h4>2.2.6移除模板</h4>
<ul>
<li>操作入口：「打包模板列表-操作-移除」</li>
</ul>
<h4>2.2.7搜索模板</h4>
<ul>
<li>在「打包模板列表」可筛选全部、可用、缺失状态的模板，并支持搜索。
<img src="https://www.showdoc.cc/server/api/common/visitfile/sign/6b8c3cac2e35991104438f83c4df37b9?showdoc=.jpg" alt="" /></li>
</ul>
<h2>3.母包管理</h2>
<ul>
<li>母包：已集成乐逗MSSDK的应用程序包（APK）。</li>
<li>母包资源管理，一次上传多次使用。
<img src="https://www.showdoc.cc/server/api/common/visitfile/sign/8e07276c47623c4578373efd83701d88?showdoc=.jpg" alt="" />
<h3>3.1母包上传</h3></li>
<li>操作入口：「母包管理-添加」</li>
<li>母包别名：用于区分同一版本的不同母包，1-50个字符。</li>
<li><img src="https://www.showdoc.cc/server/api/common/visitfile/sign/16aa862727731784324cd45d108eadf4?showdoc=.jpg" alt="" /></li>
</ul>
<h3>3.2母包下载</h3>
<ul>
<li>操作入口：「母包管理-母包版本列表-母包数量」进入母包详情弹窗，点击「操作-下载」
<img src="https://www.showdoc.cc/server/api/common/visitfile/sign/e1d24d1dc94aad243421d77d74aca218?showdoc=.jpg" alt="" /></li>
</ul>
<h3>3.3母包删除</h3>
<ul>
<li>整个版本删除：「母包管理-母包版本列表-操作-删除」</li>
<li>单个删除：「母包管理-母包版本列表-母包数量」进入母包详情弹窗，点击「操作-删除」
<h3>母包搜索</h3></li>
<li>操作入口：「母包管理-母包版本列表-搜索框」
<img src="https://www.showdoc.cc/server/api/common/visitfile/sign/bd0e8cca04fa03587c5566c8c4d57e94?showdoc=.jpg" alt="" /></li>
</ul>
<h2>4打包任务</h2>
<ul>
<li>打包任务：一个打包模板的一次打包。</li>
<li>执行打包，获取打包结果，并支持查看打包任务信息和快速重做。
<img src="https://www.showdoc.cc/server/api/common/visitfile/sign/b0ed0256dfbc72795139e78858a70d87?showdoc=.jpg" alt="" /></li>
</ul>
<h3>4.1创建任务</h3>
<ul>
<li>操作入口：「打包任务-打包」</li>
<li>
<p><strong>步骤一</strong>：选择母包
<img src="https://www.showdoc.cc/server/api/common/visitfile/sign/dac008c74ea1b763fdfbdb08f3a40163?showdoc=.jpg" alt="" /></p>
</li>
<li><strong>步骤二</strong>：选择模板，支持多选，即使用同一母包进行多个模板打包。</li>
<li>
<p><img src="https://www.showdoc.cc/server/api/common/visitfile/sign/981a95e983c2dd59ead42b32faec7482?showdoc=.jpg" alt="" /></p>
</li>
<li><strong>步骤三</strong>：设置资源版本，默认选择最新版本，可支持版本切换。
<img src="https://www.showdoc.cc/server/api/common/visitfile/sign/d825ec2e180a5ff29024f091b928307c?showdoc=.jpg" alt="" /></li>
</ul>
<h3>4.2包体获取</h3>
<ul>
<li>操作入口：「打包任务-任务列表-操作-包体地址」，点击获取，自动复制共享盘的包体地址到粘贴板。
<img src="https://www.showdoc.cc/server/api/common/visitfile/sign/c785f6bce0fdcf7e39278e87baeb18e0?showdoc=.jpg" alt="" /></li>
</ul>
<h3>4.3任务搜索</h3>
<ul>
<li>操作入口：「打包任务-任务列表-搜索框」「打包任务-任务列表-母包版本」</li>
<li>任务搜索：支持按任务序号、打包模板名称搜索。</li>
<li>母包版本筛选：支持按母包版本&母包别名筛选。</li>
</ul>
<h3>4.4任务状态</h3>
<ul>
<li>操作方法：查看「打包任务-任务列表-状态、开始时间、结束时间」</li>
</ul>
<h3>4.5快速查看打包资源</h3>
<ul>
<li>操作方法：将鼠标悬停在打包任务列表中的打包模板名称。</li>
<li><img src="https://www.showdoc.cc/server/api/common/visitfile/sign/5c110c3f8efd256aa26f317a04efd1e4?showdoc=.jpg" alt="" /></li>
</ul>
<h3>4.6任务取消</h3>
<ul>
<li>操作入口：「打包任务-任务列表-操作-更多-取消」</li>
<li>任务取消：只有在打包中的任务才能取消，点击取消后，由于打包任务只有在一定步骤上才能中止，因此打包状态可能需要短暂时间才会转变为「取消」。</li>
</ul>
<h3>4.7获取日志</h3>
<ul>
<li>操作入口：「打包任务-任务列表-操作-更多-打包日志」</li>
<li>日志导出：打包日志支持导出，可用于打包问题排查。</li>
<li><img src="https://www.showdoc.cc/server/api/common/visitfile/sign/f6cedcdff399ebed328cd7a11f53c535?showdoc=.jpg" alt="" /></li>
</ul>
<h3>4.8任务重做</h3>
<ul>
<li>操作入口：「打包任务-任务列表-操作-更多-重做」</li>
<li>任务重做：快速复制打包任务，支持切换母包版本、渠道SDK资源版本和插件SDK资源版本。
<img src="https://www.showdoc.cc/server/api/common/visitfile/sign/e063e265872d7ffc5a7a45a01880ee63?showdoc=.jpg" alt="" /></li>
</ul>
<h3>4.9任务删除</h3>
<ul>
<li>操作入口：「打包任务-任务列表-操作-更多-删除」</li>
<li><img src="https://www.showdoc.cc/server/api/common/visitfile/sign/a413569e606fc867057085ee5373b9a0?showdoc=.jpg" alt="" /></li>
</ul>
<h3>4.10任务备注</h3>
<ul>
<li>操作入口：「打包任务-任务列表-备注」</li>
<li>任务备注：支持填写任务信息
<img src="https://www.showdoc.cc/server/api/common/visitfile/sign/38f369e33aa8682e86d0ada9cb25c56e?showdoc=.jpg" alt="" /></li>
</ul>