ios新打包工具使用指南

1.ios版本打包工具说明

打包工具是一个轻量级的出包工具,根据portal游戏配置自动完成资源下载与注入。

基本原理 :在西瓜Portal上配置游戏需要的渠道参数,如AppId,appKey等。然后打包工具基于iosPacking.yaml文件所填写的的xgProductId和xgPlanId去西瓜Portal后台查找相对应的游戏,然后使用您所配置的渠道参数进行对接。

西瓜打包原理 :以游戏指定的target为基础,先复制一个copy_target,再将xgsdk的所有资源(包括库,bundle,脚本,编译选项)注入到copy_target。 原来的target不会做任何修改,游戏最终需切换到copy_target,并从copy_target出ipa包。

2. 配置运行环境

通过命令行方式,配置mac机器的打包环境,步骤如下:

  • 安装ruby库(如已安装,则可省略此步骤)

    gem install rubyzip

    gem install plist

  • 移除旧资源

    gem sources –-remove https://rubygems.org/

  • 等有反应之后再敲入以下命令

    gem sources -a https://gems.ruby-china.com/

  • 用以下命令查看 gem sources -l

  • 出现下面文字才表明上面的命令是成功的

    *** CURRENT SOURCES ***

    https://gems.ruby-china.com/

  • 安装xcodeproj库

    sudo gem install xcodeproj

等待安装完成。**(注:这一步会下载大量资源,需要耐心等待)**

整个执行过程如下图:
<img src="section5NewdocPictures/rubyInstall1.png"/>

3. 命令行打包

3.1 使用方法:

3.1.1 在 西瓜打包工具下载地址 下载IOS新打包工具,解压 zip包,得到资源文件夹ios_packagetool(内含iosPacking.yaml与iosPackingWrapper.rb)。

3.1.2 将iosPacking.yaml使用文本编辑工具打开,根据portal后台的参数填写iosPacking.yaml中的参数值,注意:参数冒号后保留一个空格。其中:

  project_path -- Unity工程所在绝对文件夹

  projectName -- 游戏工程名

  targetName -- 游戏target

  xgUserName -- 登录西瓜SDK的账号

  xgPassWord -- xgUserName对应的密码

  xgProductId -- 产品Id,地址栏中products后数字即是,eg: https://www.xgsdk.com/access#/products/200/plans/1497/progress 则值为200

  xgPlanId -- 发布计划id (点击发布计划,地址栏中plans后数字即是,eg: https://www.xgsdk.com/access#/products/200/plans/1497/progress 则值为1497,海外渠道查看方式在下图)

  xgChannelId -- 根据https://www.xgsdk.com/doc/section2/XGSDK.html 中IOS渠道列表中渠道ID填写

  exportIpa -- 默认为false(不建议修改)

海外渠道查看xgPlanId方法如下图,将鼠标放置在该渠道名称上,将会显示planId:

3.1.3 打包

进入终端,将路径切换到iosPacking.yaml所在目录。然后输入下面命令

ruby ./iosPackingWrapper.rb

如出现以下界面,代表打包成功:

3.1.4 结束。最终效果: 每个target都是在原始的target复制过来(如游戏的原来的target是ios-bi-demo),然后注入了xgsdk的资源,生成新的target(如下图中的xg_ios_jinshanApple)。因此,原来的target仍然是独立的,打包工具不会修改原来target的任何配置。 游戏需使用新的target进行编译出包(需选择真机编译,不可用模拟器)。

3.1.5 push功能

若使用push功能,需在xcode工程Target-Capabilities中打开Push Notifications开关,再出ipa包 如下所示: