Commit 4360990e704c31f9b6388c9a70d21bf506b2b409

Authored by 赵康
1 parent 16abcbfff5
Exists in master

更新常见问题

Showing 1 changed file with 6 additions and 2 deletions Inline Diff

doc/AndroidDocument.md
1 # Gump Android SDK使用文档 1 # Gump Android SDK使用文档
2 2
3 3
4 接入手册 4 接入手册
5 V 2.3.1 5 V 2.3.1
6 2015年01月08日 6 2015年01月08日
7 7
8 快速入口: 8 快速入口:
9 [支付部分服务端回调文档](http://git.letsgame.mobi/document/gumptech-document/blob/master/ServerDocument.md) 9 [支付部分服务端回调文档](http://git.letsgame.mobi/document/gumptech-document/blob/master/ServerDocument.md)
10 10
11 ## 目录 11 ## 目录
12 12
13 * [第一章 接入指南](http://git.letsgame.mobi/document/gumptech-document/blob/master/AndroidDocument.md#) 13 * [第一章 接入指南](http://git.letsgame.mobi/document/gumptech-document/blob/master/AndroidDocument.md#)
14 - [1. 导入资源工程](http://git.letsgame.mobi/document/gumptech-document/blob/master/AndroidDocument.md#1) 14 - [1. 导入资源工程](http://git.letsgame.mobi/document/gumptech-document/blob/master/AndroidDocument.md#1)
15 - [2. 添加资源工程](http://git.letsgame.mobi/document/gumptech-document/blob/master/AndroidDocument.md#2) 15 - [2. 添加资源工程](http://git.letsgame.mobi/document/gumptech-document/blob/master/AndroidDocument.md#2)
16 - [3. 代码实现](http://git.letsgame.mobi/document/gumptech-document/blob/master/AndroidDocument.md#3) 16 - [3. 代码实现](http://git.letsgame.mobi/document/gumptech-document/blob/master/AndroidDocument.md#3)
17 > [1.修改AndroidManifest.xml文件](http://git.letsgame.mobi/document/gumptech-document/blob/master/AndroidDocument.md#1-androidmanifest-xml) 17 > [1.修改AndroidManifest.xml文件](http://git.letsgame.mobi/document/gumptech-document/blob/master/AndroidDocument.md#1-androidmanifest-xml)
18 > [2.向Gump平台索要游戏ID(GID),完成代码接入](http://git.letsgame.mobi/document/gumptech-document/blob/master/AndroidDocument.md#2-gump-id-gid) 18 > [2.向Gump平台索要游戏ID(GID),完成代码接入](http://git.letsgame.mobi/document/gumptech-document/blob/master/AndroidDocument.md#2-gump-id-gid)
19 * [第二章 常见问题](http://git.letsgame.mobi/document/gumptech-document/blob/master/AndroidDocument.md#) 19 * [第二章 常见问题](http://git.letsgame.mobi/document/gumptech-document/blob/master/AndroidDocument.md#)
20 - [问题1: 如何避免混淆对SDK的影响?](http://git.letsgame.mobi/document/gumptech-document/blob/master/AndroidDocument.md#1-sdk) 20 - [问题1: 如何避免混淆对SDK的影响?](http://git.letsgame.mobi/document/gumptech-document/blob/master/AndroidDocument.md#1-sdk)
21 - [问题2:后台已经配置ok的情况下,支付列表仍然为空或登录总是出错?](http://git.letsgame.mobi/document/gumptech-document/blob/master/AndroidDocument.md#2-ok)
21 22
22 23
23 24
24 25
25 ## 第一章 接入指南 26 ## 第一章 接入指南
26 配置环境 27 配置环境
27 28
28 本接口API 适用于Android2.2以上各版本Android平台。 29 本接口API 适用于Android2.2以上各版本Android平台。
29 ### 1. 导入资源工程 30 ### 1. 导入资源工程
30 1.将LoginSDK资源工程拷贝到工作空间,在eclipse中的导航栏右键弹出如图1画面,选择Import导入资源工程,如图1. 31 1.将LoginSDK资源工程拷贝到工作空间,在eclipse中的导航栏右键弹出如图1画面,选择Import导入资源工程,如图1.
31 32
32 ![](images/1.png) 33 ![](images/1.png)
33 图1 34 图1
34 35
35 2.导入工程后,右键此工程,在Properties->Android中选中此工程为library工程(勾选红色方框标识处)如图2。 36 2.导入工程后,右键此工程,在Properties->Android中选中此工程为library工程(勾选红色方框标识处)如图2。
36 ![](images/2.png) 37 ![](images/2.png)
37 图 2 38 图 2
38 ### 2. 添加资源工程 39 ### 2. 添加资源工程
39 添加资源工程为游戏项目的 library。右键游戏项目,在Properties->Android中点击Add添加资源工程为项目工程的library,结果如图3。 40 添加资源工程为游戏项目的 library。右键游戏项目,在Properties->Android中点击Add添加资源工程为项目工程的library,结果如图3。
40 ![](images/3.png) 41 ![](images/3.png)
41 图 3 42 图 3
42 43
43 44
44 注意:如果ADT版本低于14,ADT不支持jar包自动引入,请手动拷贝libs到您的工作 45 注意:如果ADT版本低于14,ADT不支持jar包自动引入,请手动拷贝libs到您的工作
45 空间。 46 空间。
46 47
47 Eclipse查看ADT版本号的方法: 48 Eclipse查看ADT版本号的方法:
48 Help==>About Eclips点击Android对应的图标就可以查看版本了. 49 Help==>About Eclips点击Android对应的图标就可以查看版本了.
49 如图,红色框部分就是ADT版本号。 50 如图,红色框部分就是ADT版本号。
50 51
51 ![](images/4.png) 52 ![](images/4.png)
52 53
53 54
54 ### 3. 代码实现 55 ### 3. 代码实现
55 #### 1、 修改AndroidManifest.xml文件 56 #### 1、 修改AndroidManifest.xml文件
56 首先添加必要的权限,如下所示: 57 首先添加必要的权限,如下所示:
57 58
58 <uses-permission android:name="android.permission.INTERNET" /> 59 <uses-permission android:name="android.permission.INTERNET" />
59 <uses-permission android:name="android.permission.READ_PHONE_STATE" /> 60 <uses-permission android:name="android.permission.READ_PHONE_STATE" />
60 <uses-permission android:name="android.permission.BLUETOOTH" /> 61 <uses-permission android:name="android.permission.BLUETOOTH" />
61 <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" /> 62 <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
62 <uses-permission android:name="android.permission.WRITE_SETTINGS"/> 63 <uses-permission android:name="android.permission.WRITE_SETTINGS"/>
63 <uses-permission android:name="android.permission.GET_ACCOUNTS"/> 64 <uses-permission android:name="android.permission.GET_ACCOUNTS"/>
64 <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/> 65 <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>
65 <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/> 66 <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>
66 <uses-permission android:name="android.permission.MOUNT_UNMOUNT_FILESYSTEMS"/> 67 <uses-permission android:name="android.permission.MOUNT_UNMOUNT_FILESYSTEMS"/>
67 <!-- upay --> 68 <!-- upay -->
68 <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" /> 69 <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
69 <uses-permission android:name="android.permission.RECEIVE_BOOT_COMPLETED" /> 70 <uses-permission android:name="android.permission.RECEIVE_BOOT_COMPLETED" />
70 <uses-permission android:name="android.permission.VIBRATE" /> 71 <uses-permission android:name="android.permission.VIBRATE" />
71 <uses-permission android:name="android.permission.SEND_SMS" /> 72 <uses-permission android:name="android.permission.SEND_SMS" />
72 <uses-permission android:name="android.permission.CHANGE_NETWORK_STATE" /> 73 <uses-permission android:name="android.permission.CHANGE_NETWORK_STATE" />
73 <uses-permission android:name="android.permission.CHANGE_WIFI_STATE" /> 74 <uses-permission android:name="android.permission.CHANGE_WIFI_STATE" />
74 <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" /> 75 <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
75 <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" /> 76 <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
76 <!-- for card.io card scanning --> 77 <!-- for card.io card scanning -->
77 <uses-permission android:name="android.permission.CAMERA" /> 78 <uses-permission android:name="android.permission.CAMERA" />
78 <uses-permission android:name="android.permission.VIBRATE" /> 79 <uses-permission android:name="android.permission.VIBRATE" />
79 <uses-permission android:name="android.permission.SEND_SMS" /> 80 <uses-permission android:name="android.permission.SEND_SMS" />
80 <!--coda--> 81 <!--coda-->
81 <uses-permission android:name="android.permission.RECEIVE_SMS" /> 82 <uses-permission android:name="android.permission.RECEIVE_SMS" />
82 <uses-permission android:name="android.permission.READ_SMS" /> 83 <uses-permission android:name="android.permission.READ_SMS" />
83 <uses-permission android:name="android.permission.WRITE_SMS" /> 84 <uses-permission android:name="android.permission.WRITE_SMS" />
84 <uses-permission android:name="android.permission.GET_TASKS" /> 85 <uses-permission android:name="android.permission.GET_TASKS" />
85 <uses-feature android:name="android.hardware.camera" android:required="false" /> 86 <uses-feature android:name="android.hardware.camera" android:required="false" />
86 <uses-feature android:name="android.hardware.camera.autofocus" android:required="false" /> 87 <uses-feature android:name="android.hardware.camera.autofocus" android:required="false" />
87 <!-- VERY IMPORTANT! Don't forget this permission, or in-app billing won't work. --> 88 <!-- VERY IMPORTANT! Don't forget this permission, or in-app billing won't work. -->
88 <uses-permission android:name="com.android.vending.BILLING" /> 89 <uses-permission android:name="com.android.vending.BILLING" />
89 90
90 其次注册相应的Activity,具体如下: 91 其次注册相应的Activity,具体如下:
91 92
92 <activity 93 <activity
93 android:name="com.gumptech.sdk.ContainerActivity" 94 android:name="com.gumptech.sdk.ContainerActivity"
94 android:theme="@style/container_dialog" 95 android:theme="@style/container_dialog"
95 android:configChanges="orientation|screenLayout" > 96 android:configChanges="orientation|screenLayout" >
96 </activity> 97 </activity>
97 <activity 98 <activity
98 android:name="com.facebook.LoginActivity" 99 android:name="com.facebook.LoginActivity"
99 android:theme="@android:style/Theme.Translucent.NoTitleBar" > 100 android:theme="@android:style/Theme.Translucent.NoTitleBar" >
100 </activity> 101 </activity>
101 <activity 102 <activity
102 android:name="com.gumptech.sdk.PaymentActivity" 103 android:name="com.gumptech.sdk.PaymentActivity"
103 android:configChanges="orientation|screenLayout" 104 android:configChanges="orientation|screenLayout"
104 android:theme="@android:style/Theme.Translucent.NoTitleBar" > 105 android:theme="@android:style/Theme.Translucent.NoTitleBar" >
105 </activity> 106 </activity>
106 <activity 107 <activity
107 android:name="com.gumptech.sdk.ExchangeWindow" 108 android:name="com.gumptech.sdk.ExchangeWindow"
108 android:configChanges="orientation|screenLayout" 109 android:configChanges="orientation|screenLayout"
109 android:theme="@style/ex_win" > 110 android:theme="@style/ex_win" >
110 </activity> 111 </activity>
111 <service android:name="com.gumptech.sdk.PushService" > 112 <service android:name="com.gumptech.sdk.PushService" >
112 </service> 113 </service>
113 <!-- paypal --> 114 <!-- paypal -->
114 <service 115 <service
115 android:name="com.paypal.android.sdk.payments.PayPalService" 116 android:name="com.paypal.android.sdk.payments.PayPalService"
116 android:exported="false" /> 117 android:exported="false" />
117 118
118 <activity android:name="com.paypal.android.sdk.payments.PaymentActivity" /> 119 <activity android:name="com.paypal.android.sdk.payments.PaymentActivity" />
119 <activity android:name="com.paypal.android.sdk.payments.LoginActivity" /> 120 <activity android:name="com.paypal.android.sdk.payments.LoginActivity" />
120 <activity android:name="com.paypal.android.sdk.payments.PaymentMethodActivity" /> 121 <activity android:name="com.paypal.android.sdk.payments.PaymentMethodActivity" />
121 <activity android:name="com.paypal.android.sdk.payments.PaymentConfirmActivity" /> 122 <activity android:name="com.paypal.android.sdk.payments.PaymentConfirmActivity" />
122 <activity android:name="com.paypal.android.sdk.payments.PayPalFuturePaymentActivity" /> 123 <activity android:name="com.paypal.android.sdk.payments.PayPalFuturePaymentActivity" />
123 <activity android:name="com.paypal.android.sdk.payments.FuturePaymentConsentActivity" /> 124 <activity android:name="com.paypal.android.sdk.payments.FuturePaymentConsentActivity" />
124 <activity android:name="com.paypal.android.sdk.payments.FuturePaymentInfoActivity" /> 125 <activity android:name="com.paypal.android.sdk.payments.FuturePaymentInfoActivity" />
125 <activity 126 <activity
126 android:name="io.card.payment.CardIOActivity" 127 android:name="io.card.payment.CardIOActivity"
127 android:configChanges="keyboardHidden|orientation" /> 128 android:configChanges="keyboardHidden|orientation" />
128 <activity android:name="io.card.payment.DataEntryActivity" /> 129 <activity android:name="io.card.payment.DataEntryActivity" />
129 <activity 130 <activity
130 android:name="com.android.easy2pay.Easy2PayScreen" 131 android:name="com.android.easy2pay.Easy2PayScreen"
131 android:theme="@android:style/Theme.Translucent.NoTitleBar" /> 132 android:theme="@android:style/Theme.Translucent.NoTitleBar" />
132 <activity 133 <activity
133 android:name="com.codapayments.sdk.pay.CodaWeb" 134 android:name="com.codapayments.sdk.pay.CodaWeb"
134 android:alwaysRetainTaskState="true" 135 android:alwaysRetainTaskState="true"
135 android:configChanges="orientation|screenSize" 136 android:configChanges="orientation|screenSize"
136 android:screenOrientation="unspecified" > 137 android:screenOrientation="unspecified" >
137 </activity> 138 </activity>
138 139
139 <receiver 140 <receiver
140 android:name="com.codapayments.sdk.message.PendingTxnReceiver" 141 android:name="com.codapayments.sdk.message.PendingTxnReceiver"
141 android:enabled="true" > 142 android:enabled="true" >
142 </receiver> 143 </receiver>
143 <!-- upay --> 144 <!-- upay -->
144 <activity 145 <activity
145 android:name="com.upay.billing.UpayActivity" 146 android:name="com.upay.billing.UpayActivity"
146 android:configChanges="orientation|keyboardHidden|screenSize" 147 android:configChanges="orientation|keyboardHidden|screenSize"
147 android:theme="@android:style/Theme.Translucent" /> 148 android:theme="@android:style/Theme.Translucent" />
148 <activity 149 <activity
149 android:name="com.upay.billing.engine.ais.AisActivity" 150 android:name="com.upay.billing.engine.ais.AisActivity"
150 android:configChanges="orientation|keyboardHidden|screenSize" 151 android:configChanges="orientation|keyboardHidden|screenSize"
151 android:theme="@android:style/Theme.Translucent" /> 152 android:theme="@android:style/Theme.Translucent" />
152 153
153 <service android:name="com.upay.billing.sdk.LocalService" > 154 <service android:name="com.upay.billing.sdk.LocalService" >
154 <intent-filter> 155 <intent-filter>
155 <action android:name="yourPackageName.LocalService" /> 156 <action android:name="yourPackageName.LocalService" />
156 </intent-filter> 157 </intent-filter>
157 </service> 158 </service>
158 159
159 #### 2、 向Gump平台索要游戏ID(GID),完成代码接入 160 #### 2、 向Gump平台索要游戏ID(GID),完成代码接入
160 1.调用GumpSDK前需要执行初始化。 161 1.调用GumpSDK前需要执行初始化。
161 若不需要分渠道 162 若不需要分渠道
162 163
163 GumpSDK.init(Context,Appid, Appkey); 164 GumpSDK.init(Context,Appid, Appkey);
164 如果需要定义渠道,必须使用如下方法 165 如果需要定义渠道,必须使用如下方法
165 166
166 GumpSDK.init(Context,Appid, Appkey,ChannelId); 167 GumpSDK.init(Context,Appid, Appkey,ChannelId);
167 *gump logo的显示控制方法,此方法参数指定是否显示GumpLogo 168 *gump logo的显示控制方法,此方法参数指定是否显示GumpLogo
168 169
169 GumpSDK.setShowLogo(boolean); 170 GumpSDK.setShowLogo(boolean);
170 2.调用GumpSDK的开始方法,将执行登录流程,需要一个Activity实例作参数 171 2.调用GumpSDK的开始方法,将执行登录流程,需要一个Activity实例作参数
171 172
172 GumpSDK.start(Activity); 173 GumpSDK.start(Activity);
173 开发者需要在调用的Activity里重写onActivityResult方法以接受用户的登录结果,通常如下: 174 开发者需要在调用的Activity里重写onActivityResult方法以接受用户的登录结果,通常如下:
174 175
175 //登录请求返回结果 176 //登录请求返回结果
176 if (requestCode == GumpSDK.LOGIN_REQUEST_CODE) { 177 if (requestCode == GumpSDK.LOGIN_REQUEST_CODE) {
177 if (resultCode == RESULT_OK) { 178 if (resultCode == RESULT_OK) {
178 String uid = data.getIntExtra("userId", -1); 179 String uid = data.getIntExtra("userId", -1);
179 int accountType = data.getIntExtra("accountType", -1); 180 int accountType = data.getIntExtra("accountType", -1);
180 String sessionkey = data.getStringExtra("sessionKey"); 181 String sessionkey = data.getStringExtra("sessionKey");
181 182
182 } else if (resultCode == RESULT_CANCELED) { 183 } else if (resultCode == RESULT_CANCELED) {
183 Toast.makeText(this, "operate be canceled", Toast.LENGTH_SHORT).show(); 184 Toast.makeText(this, "operate be canceled", Toast.LENGTH_SHORT).show();
184 } 185 }
185 } 186 }
186 187
187 如上将收到成功登录用的userid,此Id标识唯一用户! 188 如上将收到成功登录用的userid,此Id标识唯一用户!
188 189
189 3.支付功能(已过期,请优先考虑手机页面支付,参考地址:[GumpTech页面支付](http://git.letsgame.mobi/document/gumptech-document/blob/master/doc/webpay.md) ) 190 3.支付功能(已过期,请优先考虑手机页面支付,参考地址:[GumpTech页面支付](http://git.letsgame.mobi/document/gumptech-document/blob/master/doc/webpay.md) )
190 1)使用gump通行证登录 191 1)使用gump通行证登录
191 192
192 Bundle payInfo = new Bundle(); 193 Bundle payInfo = new Bundle();
193 payInfo.putString("nick", "thi"); 194 payInfo.putString("nick", "thi");
194 payInfo.putString("product", "元宝"); 195 payInfo.putString("product", "元宝");
195 payInfo.putFloat("amount", 40.0f); 196 payInfo.putFloat("amount", 40.0f);
196 payInfo.putString("extraInfo", "This is demo!"); 197 payInfo.putString("extraInfo", "This is demo!");
197 payInfo.putString("serverId", "B4003"); 198 payInfo.putString("serverId", "B4003");
198 payInfo.putString("roleId", "10010"); 199 payInfo.putString("roleId", "10010");
199 GumpSDK.pay(MainActivity.this, payInfo); 200 GumpSDK.pay(MainActivity.this, payInfo);
200 调用pay方法时,必须穿入一个bundle对象,包含如上字段,可以设置值为空,但是字段必须全部包含,支付完成仍然通过onActivityResult回调,requestCode为GumpSDK.PAY_REQUEST_CODE,回调信息除code和msg外,还含有orderId和传入的extraInfo. 201 调用pay方法时,必须穿入一个bundle对象,包含如上字段,可以设置值为空,但是字段必须全部包含,支付完成仍然通过onActivityResult回调,requestCode为GumpSDK.PAY_REQUEST_CODE,回调信息除code和msg外,还含有orderId和传入的extraInfo.
201 2)未使用gump通行证登录,需要传入用户id 202 2)未使用gump通行证登录,需要传入用户id
202 203
203 Bundle payInfo = new Bundle(); 204 Bundle payInfo = new Bundle();
204 payInfo.putString("nick", "thi"); 205 payInfo.putString("nick", "thi");
205 payInfo.putString("product", "元宝"); 206 payInfo.putString("product", "元宝");
206 payInfo.putFloat("amount", 40.0f); 207 payInfo.putFloat("amount", 40.0f);
207 payInfo.putString("extraInfo", "This is demo!"); 208 payInfo.putString("extraInfo", "This is demo!");
208 payInfo.putString("serverId", "B4003"); 209 payInfo.putString("serverId", "B4003");
209 payInfo.putString("roleId", "10010"); 210 payInfo.putString("roleId", "10010");
210 GumpSDK.pay(MainActivity.this, payInfo,"1021"); 211 GumpSDK.pay(MainActivity.this, payInfo,"1021");
211 5.注销登录 212 5.注销登录
212 213
213 GumpSDK.logout(Activity,GumpSDK.Callback); 214 GumpSDK.logout(Activity,GumpSDK.Callback);
214 当此方法调用后,用户退出登录,并会通过callback接口通知调用程序! 215 当此方法调用后,用户退出登录,并会通过callback接口通知调用程序!
215 ## 第二章 常见问题 216 ## 第二章 常见问题
216 ### 问题1: 如何避免混淆对SDK的影响? 217 ### 问题1: 如何避免混淆对SDK的影响?
217 解答:有些开发者对接入了SDK的程序进行混淆时,有可能会覆盖某些java 218 解答:有些开发者对接入了SDK的程序进行混淆时,有可能会覆盖某些java
218 类,导致SDK无法正常工作,解决方法如下: 219 类,导致SDK无法正常工作,解决方法如下:
219 Ø 请开发者在混淆配置文件proguard.cfg或proguard-project.txt的最后加上 220 Ø 请开发者在混淆配置文件proguard.cfg或proguard-project.txt的最后加上
220 221
221 -keep class com.gumptech.sdk.view.* {*;} 222 -keep class com.gumptech.sdk.view.* {*;}
222 -keep class com.gumptech.sdk.web.* {*;} 223 -keep class com.gumptech.sdk.web.* {*;}
223 -keep class com.gumptech.sdk.GumpSDK$Callback{ 224 -keep class com.gumptech.sdk.GumpSDK$Callback{
224 void onLogout(); 225 void onLogout();
225 } 226 }
226 -keep class com.gumptech.sdk.GumpPreference{ 227 -keep class com.gumptech.sdk.GumpPreference{
227 public static final <fields>; 228 public static final <fields>;
228 } 229 }
229 -keep class com.upay.billing.** { *; } 230 -keep class com.upay.billing.** { *; }
230 -dontwarn com.upay.billing.** 231 -dontwarn com.upay.billing.**
231 232
232 -keepattributes Signature 233 -keepattributes Signature
233 -keep class com.upay.billing.** { *; } 234 -keep class com.upay.billing.** { *; }
234 -dontwarn com.upay.billing.** 235 -dontwarn com.upay.billing.**
235 使得混淆的时候不会影响SDK的命名空间。
236 使得混淆的时候不会影响SDK的命名空间。
237 ### 问题2:后台已经配置ok的情况下,支付列表仍然为空或登录总是出错?
238 解答:sdk在debug模式下使用的默认服务器地址是开发环境地址,此地址区别于正式环境地址,为开发调试用;若进行线上调试或正式环境测试,需要使用release模式来进行!