通用接入文档
打包工具使用说明

打包工具1.0 操作说明

1 打包工具简介

OPSDK是一款专门解决CP商接入第三方SDK的自动化工具,目的是让CP商快速接入第三方SDK,能有更多时间更专注于游戏本身的品质。OPSDK生成的apk包或ipa包完全符合第三方渠道上线要求。

1.1 安卓支持渠道说明

目前支持渠道SDK如下:
3G门户、37玩、360游戏、机锋、OPPO、PPS、UC、安拓无限、安智、百度移动游戏、暴风影音、步步高、当乐、多玩、华为游戏中心、金立、酷派、联想、泡椒、搜狗、豌豆荚、小米、丫丫玩、应用汇、优酷、HTC、4399、步步高、PPTV、迅雷、酷派、魅族、畅玩、靠谱助手、XY助手、泡椒网、滴滴打车、乐视手机应用商店、今日头条、虫虫游戏、安趣网、快用助手、叉叉助手。

1.2 iOS支持渠道说明

目前支持91、PP、快用、同步推、海马助手、i苹果、XY助手、iTools、爱思助手、叉叉助手、多多助手、乐8苹果助手等SDK。

2 安装,更新与卸载

2.1 windows操作系统配置及安装

2.1.1 安装环境

操作系统:win7 win10 或 xp

2.1.2 安装

直接点击打包工具里的run.exe就能启动该软件。

2.2 mac操作系统配置及安装

2.2.1 安装环境

Mac OS X:10.11及以上
Xcode:需要同时安装xcode7 或更高版本
Jdk:1.7及以上

2.2.2 安装

直接点击打包工具里的OPSDK就能启动该软件。

注意:
初次安装会提示无法安装,如下图:

应用程序->系统偏好设置->安全性与隐私->通用,将应用程序的权限改为“任何来源”,如下图:

2.3 软件卸载

直接将整个打包工具目录删除即可,不会遗留任何垃圾文件。

3 打包配置说明

在进行打包之前需要在软件配置项配置一下打包所需要的一些系统参数和打包本身需要的一些参数。

3.1 安卓配置

在游戏包签名时如果没有上传安卓密钥文件就会使用掌趣的默认签名文件。如果需要配置则点击配置菜单:

可以选择使用掌趣默认签名,或者手动导入签名:

3.2 iOS配置

以打包PP渠道包为例,其他渠道类似。
例如,CP在PP渠道发行的bundleid是com.ourpalm.cn.pp
安装com.ourpalm.cn.pp所对应的证书文件(.cer)和授权文件(. mobileprovision)

配置->IOS证书,如下图:

注意:
证书文件与授权文件是一一对应的
导入证书成功后,如下图:

设置成功弹出成功对话框:

3.3 包输出路径配置

windows环境:打包工具打出的游戏包支持配置输出路径,如果不选择就会输出到默认路径下即打包工具根目录的dist文件夹下。

mac环境:mac操作系统的默认路径为/Applications/OPSDK.app/Contents/Resources/OPSDK_FOR_MAC/dist/

输出路径均可以手动配置:

3.4 平台配置

用户可以通过”平台”进行安卓打包和ios打包进行切换。windows不支持ios打包。

4 打包流程操作说明

以ios为例来进行说明,安卓的和IOS打包流程都是一样的,差别在于安卓导入的是游戏的原始apk包而IOS导入的是游戏的源码包。

4.1 导入游戏包

注意:此处的游戏工程为接入掌趣官网SDK,并能成功生成ipa或apk。
打开->游戏,如下图

4.1.1导入工程

选择.xcodeproj文件,导入工程

安卓选择原始apk文件,导入游戏工程

导入成功提示

4.2 导入渠道参数

导入->参数(掌趣支持提供),如下图:

注意:
1、在导入参数过程中,OPSDK会检查第三方渠道SDK是否要更新,如果需要更新,OPSDK会自动下载更新SDK。
2、参数导入成功后,会提示用户是否需要更换图标资源,如下图:

3、参数文件由相应的游戏发行经理提供,接入时可以向找相关人员索要参数文件。参数文件是以.dat为后缀名的。例如:

4.3 导入icon图标(具体根据第三方渠道要求)

导入->图标(512x512),如下图:

4.4 设置横竖屏

根据需求设置横竖屏:

4.5 设置闪屏信息

根据需求设置闪屏配置:

(1)增加闪屏:
增加闪屏,根据要求上传图片
(2)更换闪屏图片:
替换原有图片
(3)修改单张闪屏持续时间:
支持修改单张闪屏程序时间(2-5秒)

4. 6运行生成游戏包

安卓生成apk游戏包,ios生成ipa游戏包。
运行->编译,生成ipa,如下图:

ipa输出路径:
/Applications/OPSDK.app/Contents/Resources/OPSDK_FOR_MAC/dist/opsdkdemo_ppzhushou_010002_3100140031001400.ipa

5 工具功能介绍

5.1 APK解析签名工具

导入Apk或者ipa进行包体解析

5.2 Android日志查看工具

连接Android设备进行日志查看,可根据包名选择查看的app日志信息
点击:”捕获”开始日志查看:

5.3 包体检测工具

支持apk、ipa检测:
(1)检测Android渠道包 apk中接入的sdk内容是否完整,资源是否有遗漏。
(2)检测AppStore上线包配置是否完整,基于苹果审核机制对上传包体检测,提早发现问题,减少上传成本。

5.4 IP联网抓包工具

提供Android包指定包名IP地址抓取检测:

操作步骤简述:
(1)请将待测手机与您安装打包工具的pc连接在同一个wifi环境内。
(2)在您的待测手机中安装“手机ip抓取辅助工具.apk” 。
(3)请打开apk在 ip地址栏中,填写您pc工具上展示的ip地址

(4)请在手机apk中点击开始检测,并在pc工具中点击开始检测,检测开始
(5)切换到您测试的app中使用,pc工具上会刷新您app请求的地址(重复的地址不会显示)
续作如有问题可点击界面上的”提示”