1. 温馨小贴士

本文只针对用户如何使用QuickSDK_iOS打包工具在本地环境输出渠道包的流程。

母包工程：即iOS游戏工程接入了QuickSDK后，母包工程不要使用xcode自动签名。

渠道包：母包通过打包工具客户端输出的包，咱们统称为渠道包，渠道包可以直接给对应渠道审核上线。

渠道调试工程： 打包工具会在母包工程同目录下创建渠道号结尾的调试工程，可以用来连接设备调试出现的bug，快速定位原因，亦可用于处理特殊资源编译出渠道包，虽然通常可能不会使用。

 

2. 登录QuickSDK_iOS打包工具

启动QuickSDK_iOS打包工具，输入账号密码后，点击登录按钮即可进入，用户还可勾选记住密码，保证下次登录无需重复输入账号密码；若无账号，点击立即注册进行注册，或者登录【http://www.quicksdk.com/register.html】进行注册。

 

3. 打包工具基本配置

（1）单击左边的游戏进行选择，这里和CP控制台对应，如目录中没有游戏，请跳转到【CP控制台】创建您的游戏。

（2）选择打包的项目工程，打开您本地存储的iOS工程路径，这里也可以叫做选择母包路径。【注意：路径中不能包含中文】

（3）选择打包的Target，如下图，工程的Target有Unity-iPhone和Unity-iPhone Tests, 选择你要打包的Target.

（4）选择最终生成渠道ipa的输出目录路径，路径中尽量不要带有中文汉字。

（5）ipa的包名可以不设置，打包工具已经提供了默认包名

{$gameName}_{$channelName}_{$channelVersion}_{$date}。

对应生成的包名样式：游戏名_渠道名_渠道版本_日期.ipa

游戏可以自行修改里面的某项或多项，每一个{$xxxx}这样格式的代表一项。

当所有配置完成后点击下一步，即可进入选择渠道界面。

 

4. 渠道选择与配置

进入选择渠道界面后，可以选择您要上线的渠道，这里可用渠道默认为空，必须先在CP控制台中的【渠道管理→渠道配置】配置对应的渠道参数，才可再此处显示可用渠道。详情请见【CP控制台使用流程】，渠道配置成功后，如下图。

（1）可用渠道列表可以进行勾选与取消，选中后则在右侧对应展示。可点击全选和清空选中。

（2）右边展示的是渠道的基本信息，可以对已经勾选的内容进行修改。

• 查看参数：可以查看QuickSDK_CP控制台关于此渠道的配置参数；

•  包名：可以显示当前出包的包名，该包名已经在QuickSDK_CP控制台配置，工具可以点击此编辑框进行临时修改，点击右边的还原按钮则还原成QuickSDK_CP控制台的配置，由于此修改是临时的，下次出包此栏目会自动还原。

• 自定义显示名称：安装后显示的游戏名称，默认为工程中配置的名称。

•  添加宏名：可以添加工程预编译宏，工具会将此宏添加到渠道打包工程进行控制代码的编译。

• 证书：选择出包时要用的证书，如果下拉框空白，请检查钥匙串里面证书是否失效。如证书失效，请参考文档【关于iOS证书失效问题的处理方法】，检查证书是否过期。如果打出的包不能安装到测试设备，或者提交AppStore报签名失败。打开电脑的钥匙串，查看登录-我的证书和系统-我的证书，删除重复证书；检查证书和签名描述文件是否匹配。

• 签名：选择打包的签名文件。点击签名右边的小加号，可以添加一个签名文件的设置，这是为了方便出appstore包和adhoc测试包，同时选择这两种签名则可以一次性打出两种包。 

打包证书的选择：

由于游戏经常面临证书选择问题，在这里统一说明：

越狱渠道可以选择发布证书或开发证书的通用adhoc签名，通用签名就是指创建签名的时候选择AppID为*类型的，然后生成的签名文件。保证选择证书和签名描述文件(mobileprovision)同是Distribution或者Development。

Appstore渠道请选择发布证书和AppStore签名。

渠道参数均检查完毕后，点击打包则工具进行自动打包流程。

 

5. 工具自动打包

打包过程中工具会自动编译打包，请耐心等待，不要关闭打包工具，否则会影响工具自动出包。每个渠道包出包时间，由游戏大小而定可能会耗时1~5分钟不等。

 

打包成功时，如上图。可以点击成功标题切换到成功界面，可以选择打开目录查看ipa的输出目录。

 

打包失败时，如上图。可选择打开测试工程进行错误调试，也可选择查看日志，查看具体的失败原因。如果失败原因无法判断或解决，可以通过QQ对接组，咨询我们的技术大大~

 

6. 命令行支持

首先通过打包工具界面进行打包渠道配置，配置好后就可以使用下面的命令进行自动打包。

open -g /Applications/QuickTool.app --args command [option]

option:

unclean     //不执行clean

unbuild     //不执行build

unproject   //不保留调试工程文件

-project  //指定本地xcode项目路径以.xcodeproj结尾
-out //指定打包输出路径

-productCode  //指定出包游戏productCode

比如:open -g /Applications/QuickTool.app --args command unclean 该命令表示打包时不执行clean的动作

open -g /Applications/QuickTool.app --args command unclean unbuild 该命令表示打包时不执行clean和build，只生成调试工程

open -g /Applications/QuickTool.app --args command 该命令表示既生成调试工程，打包时又会clean和build

其中/Applications/QuickTool.app是本地打包工具程序的目录