推广员项目Sdk for android使用说明.md
2.57 KB
Gump游戏推广员 Android SDK使用文档
第一章 接入指南
配置环境
本接口API 适用于Android2.2以上各版本Android平台。
1. 导入资源工程
1.将PromoterRelease资源工程拷贝到工作空间，在eclipse中的导航栏右键弹出如图1画面，选择Import导入资源工程，如图1.
1. 导入资源工程
2.导入工程后，右键此工程，在Properties->Android中选中此工程为library工程（勾选红色方框标识处）如图2。
图 2
2. 添加资源工程
添加资源工程为游戏项目的 library。右键游戏项目，在Properties->Android中点击Add添加资源工程为项目工程的library，结果如图3。
图 3
注意:如果ADT版本低于14，ADT不支持jar包自动引入，请手动拷贝libs到您的工作
空间。
Eclipse查看ADT版本号的方法:
Help==>About Eclips点击Android对应的图标就可以查看版本了.
如图，红色框部分就是ADT版本号。
3. 代码实现
1、 修改AndroidManifest.xml文件
首先添加必要的权限，如下所示：
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.WRITE_SETTINGS" />
<uses-permission android:name="android.permission.READ_PHONE_STATE" />
<uses-permission android:name="android.permission.BLUETOOTH" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
其次注册相应的Activity，具体如下：
<activity
android:name="com.gumptech.promoter.activity.PromoterActivity"
android:label="@string/app_name"
android:theme="@android:style/Theme.NoTitleBar.Fullscreen"
android:screenOrientation="landscape" >
</activity>
2、调用推广接口
Entrance.DoPromoter("1545402", "10022", "serverId", "ruleId", Context);
1545402：uid //设置用户ID 必须
10022 :appid //设置appId 必须
serverId :serverId //设置 serverId 必须
roleId: roleId // 设置 角色Id 必须
Context context // 上下文环境 必须
3、获取sdk版本
Constant.VERSION_CODE
第二章 常见问题
问题1： 如何避免混淆对SDK的影响？
解答：有些开发者对接入了SDK的程序进行混淆时，有可能会覆盖某些java
类，导致SDK无法正常工作，解决方法如下:
? 请开发者在混淆配置文件proguard.cfg或proguard-project.txt的最后加上
-keep public class com.gumptech.promoter.Entrance { *;}
-keep public class com.gumptech.promoter.view.ProgressBar { *;}
-keep public class com.gumptech.promoter.util.Constant { *;}
使得混淆的时候不会影响SDK的命名空间。