SDK / Spreader

Blame view

doc/推广员项目Sdk for android使用说明.md 2.57 KB
edit raw normal view history
e95375daf   luohaijiang   调用接口参数是否必须添加 
1
 
  # GumpÓÎÏ·ÍƹãÔ± Android  SDKʹÓÃÎĵµ
d1683fe9a   luohaijiang   Promoter Resulce 
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
 
  ## 第一章  接入指南
  配置环境
  
  本接口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文件
  	首先添加必要的权限，如下所示：
b52cc5b1e   luohaijiang   修改 
24
e451969ec   luohaijiang   文档格式修改 
25
 
      <uses-permission android:name="android.permission.INTERNET" />
d538277ad   luohaijiang   内容修改 
26
 
      <uses-permission android:name="android.permission.WRITE_SETTINGS" />
b2efc159c   luohaijiang   推广员项目使用说明修改 
27
28
 
      <uses-permission android:name="android.permission.READ_PHONE_STATE" />
      <uses-permission android:name="android.permission.BLUETOOTH" />
511447b12   luohaijiang   修改权限写法 
29
 
      <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
79b86efd3   luohaijiang   追加判断网络是否可用等权限 
30
31
32
 
      <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" />
b52cc5b1e   luohaijiang   修改 
33
c9d8b4828   luohaijiang   修改样式 
34
 
  其次注册相应的Activity，具体如下：
b52cc5b1e   luohaijiang   修改 
35
 
      <activity
177c635a1   luohaijiang   修改 
36
37
38
39
 
              android:name="com.gumptech.promoter.activity.PromoterActivity"
              android:label="@string/app_name"
              android:theme="@android:style/Theme.NoTitleBar.Fullscreen"
              android:screenOrientation="landscape" >
e451969ec   luohaijiang   文档格式修改 
40
 
       </activity>
eedf3d6ef   luohaijiang   补全文档：添加pc调用接口、添加获... 
41
 
  #### 2｡｢ｵﾃﾍﾆｹ羶ﾓｿﾚ
a55575185   luohaijiang   接口调用注释格式修改 
42
 
  	 Entrance.DoPromoter("1545402", "10022", "serverId", "ruleId", Context);
e95375daf   luohaijiang   调用接口参数是否必须添加 
43
44
45
46
47
 
  	 1545402：uid  //设置用户ID 必须
  	 10022  :appid //设置appId 必须
  	 serverId :serverId //设置 serverId 必须
  	 roleId: roleId    // 设置 角色Id  必须
  	 Context context   // 上下文环境  必须
eedf3d6ef   luohaijiang   补全文档：添加pc调用接口、添加获... 
48
49
 
  #### 3¡¢»ñÈ¡sdk°æ±¾
  	Constant.VERSION_CODE
d1683fe9a   luohaijiang   Promoter Resulce 
50
51
52
 
  ## 第二章 常见问题      
  ### 问题1： 如何避免混淆对SDK的影响？       
  解答：有些开发者对接入了SDK的程序进行混淆时，有可能会覆盖某些java
b52cc5b1e   luohaijiang   修改 
53
54
 
  类，导致SDK无法正常工作，解决方法如下:      
  ?  请开发者在混淆配置文件proguard.cfg或proguard-project.txt的最后加上
d538277ad   luohaijiang   内容修改 
55
56
 
       -keep public class com.gumptech.promoter.Entrance { *;}
       -keep public class com.gumptech.promoter.view.ProgressBar { *;}
f8e87ba3f   luohaijiang   版本目录修改 
57
 
       -keep public class com.gumptech.promoter.util.Constant { *;}
d1683fe9a   luohaijiang   Promoter Resulce 
58
b52cc5b1e   luohaijiang   修改 
59
 
  使得混淆的时候不会影响SDK的命名空间。