# Gump游戏推广员 Android  SDK使用文档
## 第一章  接入指南
配置环境

本接口API	适用于Android2.2以上各版本Android平台。     
### 1. 导入资源工程     
1.将PromoterRelease资源工程拷贝到工作空间，在eclipse中的导航栏右键弹出如图1画面，选择Import导入资源工程，如图1.  
### 1. 导入资源工程     
2.导入工程后，右键此工程，在Properties->Android中选中此工程为library工程（勾选红色方框标识处）如图2。
![](images/2.png)         
			图 2        
### 2. 添加资源工程
添加资源工程为游戏项目的 library。右键游戏项目，在Properties->Android中点击Add添加资源工程为项目工程的library，结果如图3。 
![](images/3.png)       
	图 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", "roleId", Context); 
	 1545402：uid  //设置用户ID 必须
	 10022  :appid //设置appId 必须
	 serverId :serverId //设置 serverId 必须
	 roleId: roleId    // 设置 角色Id  必须
	 Context context   // 上下文环境  必须
#### 3、获取sdk版本
	Entrance.getVersion();
## 第二章 常见问题      
### 问题1： 如何避免混淆对SDK的影响？       
解答：有些开发者对接入了SDK的程序进行混淆时，有可能会覆盖某些java
类，导致SDK无法正常工作，解决方法如下:      
?  请开发者在混淆配置文件proguard.cfg或proguard-project.txt的最后加上       

     -keep public class com.gumptech.promoter.Entrance { *;}
    
使得混淆的时候不会影响SDK的命名空间。