解決游戲接入渠道SDK的繁瑣工作彼乌。做到一次接入砸西，通過打包工具生成不同的渠道安裝包贸典。
SDK接入框架
閃屏接入
定義一個Activity繼承TSplashActivity
public class TestSplashActivity extends TSplashActivity {
@Override
protected void onCreate(Bundle savedInstance) {
//設(shè)置SDK的橫豎屏
setLandScape(true);
super.onCreate(savedInstance);
}
public int getBackgroundColor() {
//當(dāng)閃屏PNG圖片無法鋪滿部分機型的屏幕時凤粗，設(shè)置與閃屏顏色配合的背景色會給用戶更好的體驗
return Color.WHITE;
}
@Override
public void onSplashStop() {
//閃屏結(jié)束后纠炮，啟動游戲的Activity
Intent intent = new Intent(this, MainActivity.class);
startActivity(intent);
this.finish();
}
}
AndroidManifest.xml 配置修改
<!-- 設(shè)置閃屏為啟動的Activity start -->
<activity
android:name="packname +.TestSplashActivity"<!-- 建議填完整路徑 -->
android:configChanges="orientation|keyboardHidden|screenSize"
android:screenOrientation="portrait" >
<intent-filter>
<action android:name="android.intent.action.MAIN" />
<category android:name="android.intent.category.LAUNCHER" />
</intent-filter>
</activity>
<!-- 設(shè)置閃屏為啟動的Activity end -->
<!-- 配置對應(yīng)的參數(shù) start-->
<meta-data
android:name="T_C_ID"
android:value="100000" >
</meta-data>
<meta-data
android:name="T_G_ID"
android:value="100000" >
</meta-data>
<meta-data
android:name="T_SUPPLIER_KEY"
android:value="123456" >
</meta-data>
<!-- 配置對應(yīng)的參數(shù) end-->
接入函數(shù)調(diào)用
| 方法 | 描述 |
|---|---|
| login | TSDK的登陸入口 |
| logout | TSDK的登陸注銷 |
| pay | TSDK的支付入口 |
| quit | 游戲退出調(diào)用 |
| submitExtendData | 上傳擴展數(shù)據(jù) |
| onResume | SDK生命周期函數(shù)一罩，在activity的onResume 中調(diào)用 |
| onPause | SDK生命周期函數(shù)杨幼，在activity的onPause中調(diào)用 |
| onDestroy | SDK生命周期函數(shù)，在activity的onPause中調(diào)用 |
TSDK入口類為TSDKUserCenter聂渊，主要函數(shù)如下：
| 方法 | 描述 |
|---|---|
| login | TSDK的登陸入口 |
| logout | TSDK的登陸注銷 |
| pay | TSDK的支付入口 |
| quit | 游戲退出調(diào)用 |
| submitExtendData | 上傳擴展數(shù)據(jù) |
| onResume | SDK生命周期函數(shù)差购，在activity的onResume 中調(diào)用 |
| onPause | SDK生命周期函數(shù)，在activity的onPause中調(diào)用 |
| onDestroy | SDK生命周期函數(shù)歧沪，在activity的onPause中調(diào)用 |
函數(shù)介紹
-
登錄介紹
調(diào)用TSDK的login登錄歹撒，會調(diào)起相對應(yīng)的SDK登錄流程public static void login(Context context, GameParams params, ILoginCallback callback)
用于登錄融合SDK。登錄成功或取消登錄ILoginCallback 均能監(jiān)聽到诊胞。
| 參數(shù) | 描述 |能否為空|
| :------ | :------------------------------------------| -- |
| context | 當(dāng)前Activity的context | 否 |
| params | 用于傳遞游戲登錄的參數(shù) | 否 |
| callback | 監(jiān)聽登錄成功或取消登錄的回調(diào) | 否 |
| GameParams 屬性| 描述 |
| :------ | :------------------------------------------ |
| frm | 來源 |
| fdata | 來源描述 |
LoginResponse 包含下列字段
public int code; //登陸狀態(tài)CODE_SUCCESS = 1; CODE_FAIL = -1;
public String msg; //code=CODE_FAIL 暖夭，是msg會有相關(guān)的內(nèi)容
public String uid; // 我方給出的不沖突用戶id
public String channel; //渠道標(biāo)識，用來區(qū)分用戶來自哪個渠道
public String access_token;//令牌
public String c_uid; //渠道返回的uid,TSDK內(nèi)部使用撵孤，請勿使用迈着，一般情況為空；
public int adult; //成年-1未成年邪码， 0未知裕菠， 1成年
-
注銷登錄介紹
調(diào)起融合SDK的logout注銷，會調(diào)起相應(yīng)的SDK注銷流程public static void logout(Context context, GameParams params,ILogoutCallback callback)
用于注銷登錄闭专。參數(shù) 描述 能否為空 context 當(dāng)前Activity的context 否 params 用于傳遞游戲注銷登錄的參數(shù) 否 callback 監(jiān)聽注銷登錄的回調(diào) 否 GameParams 屬性 描述 暫無
LogoutResponse 包含下列字段
public int code; //登出狀態(tài)CODE_SUCCESS = 1; CODE_FAIL = -1;
public String msg; //code=CODE_FAIL 奴潘，是msg會有相關(guān)的內(nèi)容
-
支付接口介紹
調(diào)起融合SDK的pay支付，會調(diào)起相應(yīng)的SDK支付流程public static void pay(Context context, GameParams params, IPayCallback callback)
用于支付的方法影钉。參數(shù) 描述 能否為空 context 當(dāng)前Activity的context 否 params 用于傳遞游戲支付的參數(shù) 否 callback 監(jiān)聽支付的回調(diào) 否 GameParams 屬性 描述 uid 用戶id access_token 令牌 productId 商品id productName 商品名 price 金額（元） serverId 服務(wù)器id roleId 角色id roleName 角色名 roleLevel 角色等級 gold 游戲幣画髓，如鉆石 extension 擴展字段 PayResponse 包含下列字段
public int code; //支付返回狀態(tài)CODE_SUCCESS = 1; CODE_FAIL = -1; public String msg; //code=CODE_FAIL ，是msg會有相關(guān)的內(nèi)容 -
游戲退出
調(diào)起融合SDK的quit退出平委，會調(diào)起相應(yīng)的SDK退出流程public static void quit(Context context, GameParams params, IQuitCallback callback)
用于調(diào)起SDK的退出框的方法奈虾。參數(shù) 描述 能否為空 context 當(dāng)前Activity的context 否 params 用于傳游戲退出的參數(shù) 否 callback 監(jiān)聽退出的回調(diào) 否 GameParams 屬性 描述 暫無 回調(diào)說明
//渠道帶有退出框 @Override public void quitCallback(QuitResponse quitResponse) { Toast.makeText(this, "退出回調(diào)", Toast.LENGTH_SHORT).show(); if (quitResponse != null) { LogUtils.d(quitResponse.toString()); } finish(); } //渠道不帶退出框 @Override public void onNo3rdQuitCallback(QuitResponse quitResponse) { quitDialog(); } private void quitDialog() { AlertDialog.Builder builder = new Builder(this); builder.setMessage("確定要退出嗎?"); builder.setTitle("提示"); builder.setPositiveButton("確認(rèn)", new android.content.DialogInterface.OnClickListener() { @Override public void onClick(DialogInterface dialog, int which) { dialog.dismiss(); finish(); } }); builder.setNegativeButton("取消", new android.content.DialogInterface.OnClickListener() { @Override public void onClick(DialogInterface dialog, int which) { dialog.dismiss(); } }); builder.create().show(); }QuitResponse 包含下列字段
public int code; //支付返回狀態(tài)CODE_SUCCESS = 1; CODE_FAIL = -1; public String msg; //code=CODE_FAIL ，是msg會有相關(guān)的內(nèi)容 -
上傳擴展數(shù)據(jù)
調(diào)起融合SDK的上傳擴展數(shù)據(jù)接口廉赔，請在用戶選擇角色以及服務(wù)器后調(diào)用肉微，否則無法正常支付public static void submitExtendData(Context context, GameParams params)
參數(shù) 描述 能否為空 context 當(dāng)前Activity的context 否 params 用于傳擴展字段 否 GameParams 屬性 描述 score 分?jǐn)?shù) topnid 可選參數(shù)，排行榜標(biāo)識蜡塌，使用該參數(shù)需要確認(rèn)對應(yīng)ID的排行榜已經(jīng)開通 roleId 角色id roleName 角色名 roleLevel 角色等級 zoneId 當(dāng)前登錄的游戲區(qū)服ID碉纳，必須為數(shù)字，且不能為0馏艾，若無村象，傳入1 zoneName 當(dāng)前登錄的游戲區(qū)服名稱笆环，不能為空，不能為null厚者，若無躁劣，傳入游戲名稱+”1區(qū)”，如”刀塔傳奇1區(qū)” balance balance 當(dāng)前用戶游戲幣余額库菲，必須為數(shù)字账忘，若無，傳入0 vip vip 當(dāng)前用戶VIP等級熙宇，必須為數(shù)字鳖擒，若無，傳入1 partyName partyName 當(dāng)前用戶所屬幫派烫止，不能為空蒋荚，不能為null，若無馆蠕，傳入”無幫派 上傳數(shù)據(jù)接口需在三處調(diào)用期升，分別為進入服務(wù)器、玩家創(chuàng)建用戶角色互躬、玩家升級播赁，有如下二點需注意：
a）若游戲中無對應(yīng)接口功能，如游戲中無需創(chuàng)建角色吼渡，則可根據(jù)自身情況在合適位置進行調(diào)用容为，如登錄成功后；
b）在上傳游戲數(shù)據(jù)時寺酪，若存在無對應(yīng)字段值的情況坎背，可傳入默認(rèn)值，具體參見數(shù)據(jù)組成部分寄雀； -
生命周期函數(shù)調(diào)用
public static void onResume(Context context) public static void onPause(Context context) public static void onDestroy(Context context) SDK的生命周期函數(shù)沼瘫，在程序的主Activity的生命周期相應(yīng)函數(shù)中調(diào)用
抽象工廠
定義一個抽象工廠，規(guī)范需要實現(xiàn)的接入函數(shù)
public interface IChannel {
public void init(Context context, boolean isLandScape, IChannelInitCallback callback);
public void login(GameParams params);
public void pay(GameParams params);
public void logout(GameParams params);
public void quit(GameParams params);
public void onResume(Context context);
public void onPause(Context context);
public void onStop(Context context);
public void onDestroy(Context context);
public void submitExtendData(Context context, GameParams params);
}
調(diào)用對應(yīng)的工廠實例
根據(jù)配置在 manifest 文件中的 CHANNEL_KEY 調(diào)用對應(yīng)的工廠實例
public class DispatchChannel {
private static IChannel channel;
private static final String CHANNEL_KEY = "CHANNEL_KEY";
public static IChannel getChannel(Context context){
if(channel == null) {
ChannelFactory cf = new ChannelFactory();
String channelString = ChannelUtil.getChannel(context, SDKTools.getMetaData(context, CHANNEL_KEY));
channel = cf.createChannel(channelString);
}
return channel;
}
}
各渠道接入實現(xiàn)
AndroidManifest.xml中配置要調(diào)用的渠道以及對應(yīng)渠道設(shè)置的代理Application
<!-- 渠道key start -->
<meta-data
android:name="CHANNEL_KEY"
android:value="" >
</meta-data>
<!-- 渠道key end-->
<!-- 代理Application start-->
<meta-data
android:name="T_APPLICATION_PROXY_NAME"
android:value="" >
</meta-data>
<!-- 代理Application end-->
<!-- 設(shè)置 application 標(biāo)簽的 name 屬性-->
<application
android:name="com.tongbulv.sdk.TApplication"
定義一個具體的渠道類實現(xiàn) 抽象工廠接口
public class Channel360 extends BaseChannel implements IChannel
調(diào)用渠道登陸成功后和服務(wù)端做一次用戶綁定咙俩，返回用戶信息
支付前請求一次服務(wù)端的支付參數(shù)信息，再調(diào)起渠道SDK支付
打包工具
1. 解母包(copy 到對應(yīng)的工作目錄)
apktool d -f -o $game_path $game_path${apk_suffix}
2. 資源處理
2.1 準(zhǔn)備對應(yīng)渠道的資源文件
assets(copy 到對應(yīng)的工作目錄)
t_splash_images //閃屏文件夾湿故，不存在或為空則沒有配閃屏
... //渠道此文件夾下的資源
libs (copy 到對應(yīng)的工作目錄 lib 下)
... //渠道的非 .jar 文件
res (copy 到對應(yīng)的工作目錄)
...
如碰到 strings.xml, styles.xml, colors.xml, dimens.xml, ids.xml, attrs.xml ... 則合并其內(nèi)容
帶有對應(yīng)渠道角標(biāo)的 ic_launcher 對應(yīng)的文件夾
classes.dex (具體接入渠道的 .dex 文件) 后面會用到
具體命令如下
cp -R -f $game_path/* $channel_name/
cp -R -f $config_name/AndroidManifest.xml $channel_name/
cp -R -f $config_name/assets/* $channel_name/assets/
cp -R -f $config_name/libs/* $channel_name/lib/
cp -R -f $config_name/res/* $channel_name/res/
# 合并strings.xml ...
$tool/xml -f $game_path/res/values/ -s $channel_name/res/values/ -t $config_name/res/values/
if [ -d "$config_name/channel_icon" ];then
# 合成icon
$tool/icon -f $channel_name/res/drawable-ldpi/$icon_name.png -s $channel_name/res/drawable-ldpi/$icon_name.png -t $config_name/channel_icon/ldpi.png -x 0 -y 0
$tool/icon -f $channel_name/res/drawable-mdpi/$icon_name.png -s $channel_name/res/drawable-mdpi/$icon_name.png -t $config_name/channel_icon/mdpi.png -x 0 -y 0
$tool/icon -f $channel_name/res/drawable-hdpi/$icon_name.png -s $channel_name/res/drawable-hdpi/$icon_name.png -t $config_name/channel_icon/hdpi.png -x 0 -y 0
$tool/icon -f $channel_name/res/drawable-xhdpi/$icon_name.png -s $channel_name/res/drawable-xhdpi/$icon_name.png -t $config_name/channel_icon/xhdpi.png -x 0 -y 0
$tool/icon -f $channel_name/res/drawable-xxhdpi/$icon_name.png -s $channel_name/res/drawable-xxhdpi/$icon_name.png -t $config_name/channel_icon/xxhdpi.png -x 0 -y 0
$tool/icon -f $channel_name/res/drawable-xxxhdpi/$icon_name.png -s $channel_name/res/drawable-xxxhdpi/$icon_name.png -t $config_name/channel_icon/xxxhdpi.png -x 0 -y 0
fi
3. 處理 AndroidManifest.xml文件阿趁， 并覆蓋到對應(yīng)的工作目錄
3.1 渠道權(quán)限添加
3.2 包名修改
3.3 activity name屬性為全路徑
3.4 渠道 activity 等內(nèi)容合并
3.5 渠道參數(shù)在 meta-data
3.6自有的參數(shù) meta-data
3.7具體對應(yīng)的 CHANNEL_KEY meta-data
3.8 具體對應(yīng)的 T_APPLICATION_PROXY_NAME meta-data
4. 生成 R.java 文件
4.1 建一個gen文件夾
mkdir -p $channel_name/gen
4.2 執(zhí)行 aapt p ... 命令
aapt p -f -m -J $channel_name/gen -S $channel_name/res -I $tool/android.jar -M $channel_name/AndroidManifest.xml
5. 將 R.java 編譯成對應(yīng)的 .class 文件
javac -encoding UTF-8 $channel_name/gen/${package}${package_suffixs[$index]}/R.java
6. 將生成的 .class 文件生成 .dex 文件
$tool/dx --no-strict --dex --output=$channel_name/Rclasses.dex $channel_name/gen/$package/${package_suffixs[$index]}
7. 將生成的 .dex 文件 編譯成 smali格式的文件合并到 （1）中復(fù)制的對應(yīng)工作目錄下的 smali 文件夾
java -jar $tool/baksmali.jar $channel_name/Rclasses.dex -o $channel_name/smali/
8. 將 （2）中準(zhǔn)備好的 classes.dex 編譯成 smali 格式的文件合并到 （1）中復(fù)制的對應(yīng)工作目錄下的 smali 文件夾
java -jar $tool/baksmali.jar $config_name/classes.dex -o $channel_name/smali/
9. 使用 apktool b ... 命令打包
apktool b -b ${channel_name}/
10. 使用 jarsinger 簽名
jarsigner -keystore $tool/${keystore} -storepass ${keypass} -signedjar ${channel_name}/dist/${game_name}_signed.apk ${channel_name}/dist/${game_name}.apk "${keyalias}"
11. zipalign 命令進行 4 字節(jié)對齊優(yōu)化產(chǎn)生最終的 apk 文件
$tool/zipalign -f 4 ${channel_name}/dist/${game_name}_signed.apk $dir/apk/${game_name}/${channel}.apk
