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 或 xp

2.2.2 安装

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

2.2 mac操作系统配置及安装

2.2.1 安装环境

Mac OS X：10.9.3及以上
Xcode：需要同时安装xcode5\xcode6
Jdk：1.6及以上

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 包输出路径配置

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

注意：mac操作系统的默认路径为/Applications/OPSDK.app/Contents/Resources/OPSDK_FOR_MAC/dist/
配置任意的输出路径操作如下
选中配置->游戏包输出路径

点击该菜单会出现如下对话框，选中配置单选按钮。

然后点击选择按钮选择要输出的游戏包路径，点击确定即可。

3.4 平台配置

菜单栏里的平台菜单项是用对安卓打包和ios打包进行切换的，如果打IOS游戏包选中IOS菜单选项。

如果打安卓游戏包选中按照菜单选项。

4 打包流程操作说明

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

4.1 导入游戏包

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

设置横竖屏

IOS选择.xcodeproj文件，导入游戏工程

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

导入成功后如下图：

4.2 导入渠道参数

导入->参数（掌趣运营分配），如下图：

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

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

4.3 导入图标（具体根据第三方渠道要求）

导入->图标（512x512），如下图：

图片导入成功后，如下图：

4.4 运行生成游戏包

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

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

5 打包注意事项

5.1 安卓注意事项

5.1.1 游戏需要在安卓AndroidManifest.xml中添加如下配置

<application <!-- 如游戏本身有Application类，则需要在代码中继承 ourpalm.android.channels.Info.Ourpalm_Channels_Application；如游戏本身没有 Application类，则需要在此添加配置，将AndroidManifest.xml中application的名字 命名为“ourpalm.android.channels.Info.Ourpalm_Channels_Application” -->        android:name="ourpalm.android.channels.Info.Ourpalm_Channels_Application"        android:allowBackup="true"        android:icon="@drawable/ic_launcher"        android:label="@string/app_name"        android:theme="@style/AppTheme">        <activity          android:name="com.ourpalm.test_ourpalm_v3.MainActivity"          android:configchanges="orientation|keyboardHidden|navigation|screenSize"          android:label="@string/app_name">          <intent-filter>            <action android:name="android.intent.action.MAIN">              <category android:name="android.intent.category.LAUNCHER"></category>            </action>          </intent-filter>        </activity>        <!-- 客服反馈功能的Activity V3.1.7新增加 -->        <activity           android:name="ourpalm.android.opservice.Ourpalm_OpService_Activity"           android:configChanges="keyboardHidden|orientation|screenSize"           android:theme="@android:style/Theme.Translucent.NoTitleBar" >        </activity>        <!-- 游戏自己的启动activity类名，需要完整路径，必须配置，          例如com.ourpalm.test_ourpalm_v3.MainActivity-->        <meta-data          android:name="ourpalm_class_name"          android:value="com.ourpalm.test_ourpalm_v3.MainActivity" />        <!-- 游戏请配置自己游戏的展示类型，竖屏游戏请配置成 portrait，横屏游戏请配置成landscape -->        <meta-data           android:name="ourpalm_screenOrientation"           android:value="landscape" /> </application>

1.2 游戏需要在AndroidManifest.xml中添加如下权限：

<!-- OurpalmSDK需要的权限 --> <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" /> <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" /> <uses-permission android:name="android.permission.CHANGE_NETWORK_STATE" /> <uses-permission android:name="android.permission.CHANGE_WIFI_STATE" /> <uses-permission android:name="android.permission.INTERNET" /> <uses-permission android:name="android.permission.READ_PHONE_STATE" /> <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" /> <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />

5.1.2 游戏需要在AndroidManifest.xml中添加如下权限

<!-- OurpalmSDK需要的权限 --><uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"><uses-permission android:name="android.permission.ACCESS_WIFI_STATE"><uses-permission android:name="android.permission.CHANGE_NETWORK_STATE"><uses-permission android:name="android.permission.CHANGE_WIFI_STATE"><uses-permission android:name="android.permission.INTERNET"><uses-permission android:name="android.permission.READ_PHONE_STATE"><uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"><uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"><uses-permission android:name="android.permission.MOUNT_UNMOUNT_FILESYSTEMS"><uses-permission android:name="android.permission.SYSTEM_ALERT_WINDOW"></uses-permission></uses-permission></uses-permission></uses-permission></uses-permission></uses-permission></uses-permission></uses-permission></uses-permission></uses-permission>

5.1.3 游戏的名称需要定义到res/values/strings.xml的app_name

例如： 掌趣SDK-DEMO

5.1.4 android:launchMode和android:configChanges配置要求

游戏本身所有的Activity的配置项android:launchMode必须使用红色字体如下配置，android:configChanges最少包含以下配置：<activity android:name="com.ourpalm.test_3c_console_v3.MainActivity" android:configchanges="orientation|keyboardHidden|navigation|scre enSize" android:label="@string/app_name" android:screenorientation="portrait" android:launchmode="standard"><intent-filter><action android:name="android.intent.action.MAIN"><category android:name="android.intent.category.LAUNCHER"></category></action></intent-filter></activity>如游戏本身未对android:launchMode进行配置，请忽略此说明。

5.1.5 游戏res资源文件命名注意事项

游戏res资源文件中，png及xml文件命名最好不好过于简单，以免和第三方渠道重复。如close.png或close.xml命名的文件，可以加上游戏名前缀，game_close.png或game_close.xml。

5.1.6 游戏内容的初始化时机

游戏本身的初始化最好在SDK的初始化结束并成功后开始，因为部分渠道的SDK有自动展示LOGO的功能，如果游戏的初始化先于SDK的初始化或2者并行可能会造成渠道的LOGO展示部出来或显示时间很短的BUG。// 初始化SDK Ourpalm_Entry.getInstance(this).Ourpalm_Init(GameInfo.GameType_Console, gameVer, gameResVer, new Ourpalm_CallBackListener() { @Override public void Ourpalm_LogoutSuccess() { // TODO Auto-generated method stub // 当前渠道带有注销功能的话由游戏实现，如返回到登陆界面。 // 单机游戏不用实现 } @Override public void Ourpalm_LogoutFail(int code) { // TODO Auto-generated method stub // 当前渠道带有注销功能的话由游戏实现 // 单机游戏不用实现 } @Override public void Ourpalm_LoginSuccess(String tokenId, String data) { // TODO Auto-generated method stub // 登陆成功回调，网络游戏必须实现 // 单机游戏不用实现 } @Override public void Ourpalm_LoginFail(int code) { // TODO Auto-generated method stub // 登陆失败回调，网络游戏必须实现 // 单机游戏不用实现 } @Override public void Ourpalm_InitSuccess() { // TODO Auto-generated method stub // 待SDK的初始化完成后，游戏开始实现游戏本身的初始化 // 初始化游戏 initGame(); } @Override public void Ourpalm_InitFail(int code) { // TODO Auto-generated method stub // SDK初始化失败的回调，游戏可以在这里实现自己的逻辑处理，可以只提示用户后退出游戏，也可以继续游戏，但SDK的某些功能可能会受到影响 } @Override public void Ourpalm_ExitGame() { // TODO Auto-generated method stub // 游戏使用掌趣SDK退出接口时必须实现此回调，在此处实现退出游戏的功能。 MainActivity.this.finish(); // android.os.Process.killProcess(android.os.Process.myPid()); } @Override public void Ourpalm_SwitchingAccount(boolean Success, String tokenId, String userInfo) { // TODO Auto-generated method stub // 当前渠道带有切换账号功能时，游戏需要实现此接口逻辑进行游戏登录。 切换账号分2种情况，一是调用SDK的切换账号接口实现账号的切换，此类型的 切换 账号按钮是由游戏去实现，建议放到登陆界面，切换账号成功后，登陆数据会在此接口返回，游戏可执行游戏的登录流程，类似登陆成功接口的回调。 二是渠道SDK的悬浮框或者用户中心页面带有切换账号功能，如用户点击切换账 号并登录成功后，登录数据会在此接口返回，但如果当前游戏场景处于游戏中，游戏正常应该先返回到登陆界面，然后再通过SDK切换账号成功返回的数据执行 游戏的登录流程（游戏能在游戏中直接实现账号切换，人物改变的除外，不需返 回登录界面）。 // Success=true表示切换成功，Success=false表示切换失败，tokenId 和userInfo同登陆成功接口 // 单机游戏不用实现 } });

5.1.7 游戏必须必须接入掌趣 “用户中心”，“切换账号”，“注销”

这三个接口，但需要根据调用Ourpalm_GetEnableInterface这个接口的返回值来确认游戏是否需要启用这三个接口和相应的UI按钮展示，因为根据渠道不同会用到其中之一或者所有或者都不用。

5.1.8 Activity生命周期相关的接口

必须接入
Ourpalm_Entry.getInstance(this).Ourpalm_onPause(); Ourpalm_Entry.getInstance(this).Ourpalm_onRestart(); Ourpalm_Entry.getInstance(this).Ourpalm_onResume(); Ourpalm_Entry.getInstance(this).Ourpalm_onStart(); Ourpalm_Entry.getInstance(this).Ourpalm_onStop(); Ourpalm_Entry.getInstance(this).Ourpalm_onDestroy(); Ourpalm_Entry.getInstance(this).Ourpalm_onActivityResult(requestCode, resultCode, data); Ourpalm_Entry.getInstance(this).Ourpalm_onConfigurationChanged(newConfig); Ourpalm_Entry.getInstance(this).Ourpalm_onNewIntent(intent);

5.1.9 必须调用接口

掌趣SDK初始化接口；
掌趣SDK登录接口；
掌趣SDK支付接口；
掌趣SDK退出接口；
掌趣SDK Ourpalm_GetEnableInterface接口。

5.1.10 调用支付接口需注意内容

支付接口中的参数注意：
propName：商品名称（也可以理解为商品单位）。
propCount：商品数量。

注意：对该接口中的商品名称和商品数量2个参数具体说明，如游戏中所卖商品在游戏界面显示为“100元宝或100金币”，当调用支付接口时，商品名称务必传“元宝或金币”，商品数量务必传“100”，切记不可商品名称传“100元宝或100金币”，商品数量传“1”；如游戏中所卖商品在游戏界面显示为“月卡或礼包”一类，当调用支付接口时，商品名称请直接传“月卡或礼包”，商品数量传“1”。

简单一句话，如果当前商品是某种虚拟游戏货币，商品名称中不要出现数量的概念。

5.2 ios注意事项

5.2.1 xcode版本切换

由于有些第三方SDK没有针对于IOS8进行适配，可能会出现提示切换xcode版本，例如91SDK只支持xcode5不支持xcode6
解决办法如下：
打开工具command-line tool

1、输入xcode切换命令
sudo xcode-select -switch {xcode Developer路径}
例如：
sudo xcode-select -switch /Applications/Xcode.app/Contents/Developer
2、检查xcode版本号
xcodebuild -version