文档中心 | 一键联接，全心服务

更新日期：2023年 03月 10日iOS打包工具

<h3> 1. 温馨小贴士 </h3> 本文只针对用户如何使用QuickSDK_iOS打包工具在本地环境输出渠道包的流程。 母包工程：即iOS游戏工程接入了QuickSDK后，母包工程不要使用xcode自动签名。 渠道包：母包通过打包工具客户端输出的包，咱们统称为渠道包，渠道包可以直接给对应渠道审核上线。 渠道调试工程：打包工具会在母包工程同目录下创建渠道号结尾的调试工程，可以用来连接设备调试出现的bug，快速定位原因，亦可用于处理特殊资源编译出渠道包，虽然通常可能不会使用。   <h3> 2. 登录QuickSDK_iOS打包工具 </h3> 启动QuickSDK_iOS打包工具，输入账号密码后，点击登录按钮即可进入，用户还可勾选记住密码，保证下次登录无需重复输入账号密码；若无账号，点击立即注册进行注册，或者登录【<a href="http://www.quicksdk.com/register.html" target="_self">http://www.quicksdk.com/register.html</a>】进行注册。   <img src="http://data.tool.quicksdk.net/data/newFiles/image/20190306/20190306113101dFwj160.png" alt="" /> <h3> 3. 打包工具基本配置 </h3> <img src="http://data.tool.quicksdk.net/data/newFiles/image/20190306/20190306113201C1L0462.png" alt="" /> （1）单击左边的游戏进行选择，这里和CP控制台对应，如目录中没有游戏，请跳转到【CP控制台】创建您的游戏。 （2）选择打包的项目工程，打开您本地存储的iOS工程路径，这里也可以叫做选择母包路径。【注意：路径中不能包含中文】 （3）选择打包的Target，如下图，工程的Target有Unity-iPhone和Unity-iPhone Tests, 选择你要打包的Target. <img src="http://data.quicksdk.net/data/newFiles/image/20160727/1469604910801687.png" title="1462349955923697.png" alt="3.png" /> （4）选择最终生成渠道ipa的输出目录路径，路径中尽量不要带有中文汉字。 （5）ipa的包名可以不设置，打包工具已经提供了默认包名 {$gameName}_{$channelName}_{$channelVersion}_{$date}。 对应生成的包名样式：游戏名_渠道名_渠道版本_日期.ipa 游戏可以自行修改里面的某项或多项，每一个{$xxxx}这样格式的代表一项。 当所有配置完成后点击下一步，即可进入选择渠道界面。   <h3> 4. 渠道选择与配置 </h3> 进入选择渠道界面后，可以选择您要上线的渠道，这里可用渠道默认为空，必须先在CP控制台中的【渠道管理→渠道配置】配置对应的渠道参数，才可再此处显示可用渠道。详情请见【CP控制台使用流程】，渠道配置成功后，如下图。 <img src="http://data.tool.quicksdk.net/data/newFiles/image/20190306/20190306113349Piuy490.png" alt="" /> （1）可用渠道列表可以进行勾选与取消，选中后则在右侧对应展示。可点击全选和清空选中。 （2）右边展示的是渠道的基本信息，可以对已经勾选的内容进行修改。 <ul class=" list-paddingleft-2"> <li> 查看参数：可以查看QuickSDK_CP控制台关于此渠道的配置参数； </li> <li>  包名：可以显示当前出包的包名，该包名已经在QuickSDK_CP控制台配置，工具可以点击此编辑框进行临时修改，点击右边的还原按钮则还原成QuickSDK_CP控制台的配置，由于此修改是临时的，下次出包此栏目会自动还原。 </li> <li> 自定义显示名称：安装后显示的游戏名称，默认为工程中配置的名称。 </li> <li>  添加宏名：可以添加工程预编译宏，工具会将此宏添加到渠道打包工程进行控制代码的编译。 </li> <li> 证书：选择出包时要用的证书，如果下拉框空白，请检查钥匙串里面证书是否失效。如证书失效，请参考文档【关于iOS证书失效问题的处理方法】，检查证书是否过期。如果打出的包不能安装到测试设备，或者提交AppStore报签名失败。打开电脑的钥匙串，查看登录-我的证书和系统-我的证书，删除重复证书；检查证书和签名描述文件是否匹配。 </li> <li> 签名：选择打包的签名文件。点击签名右边的小加号，可以添加一个签名文件的设置，这是为了方便出appstore包和adhoc测试包，同时选择这两种签名则可以一次性打出两种包。  </li> </ul> 打包证书的选择： 由于游戏经常面临证书选择问题，在这里统一说明： 越狱渠道可以选择发布证书或开发证书的通用adhoc签名，通用签名就是指创建签名的时候选择AppID为*类型的，然后生成的签名文件。保证选择证书和签名描述文件(mobileprovision)同是Distribution或者Development。 Appstore渠道请选择发布证书和AppStore签名。 <img src="http://data.tool.quicksdk.net/data/newFiles/image/20190524/20190524173704XxIh454.png" alt="" /> 渠道参数均检查完毕后，点击打包则工具进行自动打包流程。   <h3> 5. 工具自动打包 </h3> <img src="http://data.tool.quicksdk.net/data/newFiles/image/20190306/20190306113439NQFs385.png" alt="" /> 打包过程中工具会自动编译打包，请耐心等待，不要关闭打包工具，否则会影响工具自动出包。每个渠道包出包时间，由游戏大小而定可能会耗时1~5分钟不等。   <img src="http://data.tool.quicksdk.net/data/newFiles/image/20190306/20190306113504p820786.png" alt="" /> 打包成功时，如上图。可以点击成功标题切换到成功界面，可以选择打开目录查看ipa的输出目录。   <img src="http://data.tool.quicksdk.net/data/newFiles/image/20190306/20190306113547IlzL472.png" alt="" /> 打包失败时，如上图。可选择打开测试工程进行错误调试，也可选择查看日志，查看具体的失败原因。如果失败原因无法判断或解决，可以通过QQ对接组，咨询我们的技术大大~   <h3> 6. 命令行支持 </h3> 首先通过打包工具界面进行打包渠道配置，配置好后就可以使用下面的命令进行自动打包。 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是本地打包工具程序的目录