SDK接入(1)之Android Facebook SDK接入

SDK接入(1)之Android Facebook SDK接入

由于游戏已上线，且处于维护阶段，所以有空写写各种SDK接入过程和遇到的问题，也当作一种工作总结。SDK接入主流分为这么几类，登录、支付、分享、推送、统计等，达到借‘他山之石’的效果。顺便吐槽下，现在国内是个渠道就弄个所谓的自己的SDK，各种文档更新不及时、文档与Sample不对应、Sample测试不全或运行报错、技术支持沟通无人回复等，真是深受其害。

（1）接入前准备工作

1. 需***（FQ，VPN什么的自己解决），注册Facebook（后面统称FB）帐号。
   

2. FB SDK下载地址为：https://origincache.facebook.com/developers/resources/?id=facebook-android-sdk-current.zip
   

3. FB SDK接入文档地址为：https://developers.facebook.com/docs/android/getting-started/

4. FB SDK完整源码地址为：https://github.com/facebook/facebook-android-sdk

（2）创建应用，获取应用编号和密钥

步骤如下：

1. 登录facebook.com,在侧边可以看到有个开发者项，点击管理应用程序。如图：
   

2. 创建应用，并添加要发布的平台。填写Package Name和Default Activity Class Name
   

   注：Package Name为应用程序的包名，与Manifest里面的包名对应。
   Default Activity Class Name为第一个启动的Activity，要用完整的类名，与声明如下的Activity类名对应。

1.     <intent-filter>
2.        <action android:name="android.intent.action.VIEW"/>
3.        <category android:name="android.intent.category.DEFAULT"/>
4.        <category android:name="android.intent.category.BROWSABLE"/>
5.        <data android:scheme="bigdevil"/>
6.    </intent-filter>

例如：org.cocos2dx.lua.SplashActivity

1. 生成KeyHash，并配置KeyHash。

• 下载OpenSSL，并添加到环境变量。

• 命令行执行：keytool -exportcert -alias androiddebugkey -keystore %HOMEPATH%\.android\debug.keystore | openssl sha1 -binary | openssl
  base64,注意-keystore后面是签名文件的路径，执行完之后会生成如图：
  

2. 将生成的KeyHash（28个字符的字符串）配置到FB后台，可添加多个。
   

3. 其它配置，如图：
   
   
   

（3）下载FB SDK，并配置参数

FB SDK下载后的文件，形如：facebook-android-sdk-4.8.2.aar。
若使用AndroidStudio作为IDE，则导入该.aar文件。步骤为：

1. 直接将facebook-android-sdk-4.8.2.aar复制到工程的libs路径下。如图：
   
   

2. 修改build.gradle，添加如下配置：

   如图：
   
   然后，重新Rebuild Project一下，成功则会生成如下：
   

1.    repositories {
2.        flatDir {
3.            dirs 'libs'
4.        }
5.    }
7.    compile(name: 'facebook-android-sdk-4.8.2', ext: 'aar')

若使用Eclipse作为IDE，则需将.aar文件解压。解压完如下图：

拷贝assets，res，AndroidManifest.xml，classes.jar，新建Eclipse工程并覆盖对应文件。

（4）FB SDK接入

1. 配置FB id（FB后台获取的应用编号）。打开res/values/strings.xml,添加：

    <string name="facebook_app_id">172633573185136</string>

2. 配置AndroidManifest，添加权限

    <uses-permission android:name="android.permission.INTERNET"/>

   在application项下配置：

1. <application android:label="@string/app_name">
2.     <meta-data android:name="com.facebook.sdk.ApplicationId" android:value="@string/facebook_app_id"/>
3. </application>

3. 初始化FB SDK和激活事件，在Application的onCreate()调用如下代码：

1. publicvoidonCreate() {
2. super.onCreate();
3. FacebookSdk.sdkInitialize(getApplicationContext());
4. AppEventsLogger.activateApp(this);
5. }

4. 讲FacebookActivity配置到AndroidManifest中，如下：

1. <activity
2.     android:name="com.facebook.FacebookActivity"
3.     android:configChanges="keyboard|keyboardHidden|screenLayout|screenSize|orientation"
4.     android:label="@string/app_name"
5.     android:theme="@android:style/Theme.Translucent.NoTitleBar"/>

5. FB登录分为带Facebook按钮和不带Facebook按钮两种形式。带Facebook按钮需要将FB提供的LoginButton添加到自己的布局中。而游戏登录，只需要点击对应的游戏登录按钮再调用FB登录即可。所以下面介绍下，不带Facebook按钮的这种形式。

   在MainActivity中的onCreate()中注册登录回调，代码如下：

1. callbackManager = CallbackManager.Factory.create();
3. LoginManager.getInstance().registerCallback(callbackManager,
4.        new FacebookCallback<LoginResult>() {
5.             @Override
6.             public void onSuccess(LoginResult loginResult) {
7.                  // App code
8.             }
10.             @Override
11.             public void onCancel() {
12.                  // App code
13.             }
15.             @Override
16.             public void onError(FacebookException exception) {
17.                  // App code
18.              }
19. });

6. FB登录，注意登录权限需使用public_profile，并在onActivityResult中处理用户授权，代码如下：

   onActivityResult处理代码：

1. public static void onActivityResult(int requestCode, int resultCode, Intent data) {
2.     if (callbackManager !=null) {
3.         callbackManager.onActivityResult(requestCode, resultCode, data);
4.     }
5. }
6. private static finalString PERMISSION ="public_profile";
8. LoginManager loginManager = LoginManager.getInstance();
9. loginManager.setDefaultAudience(loginManager.getDefaultAudience());
10. loginManager.setLoginBehavior(loginManager.getLoginBehavior());
11. loginManager.logInWithReadPermissions(AppActivity.context_self, Arrays.asList(PERMISSION));

7. 登录结果处理，在FacebookCallback中，代码如下：

1. public void onSuccess(LoginResult loginResult) {
2.     AccessToken accessToken = loginResult.getAccessToken();
3.     String userId = accessToken.getUserId();
4.     String token = accessToken.getToken();
5.     // TODO：拿到userId和token，传给游戏服务器校验
6. }
8. public void onCancel() {
9. }
11. public void onError(FacebookException exception) {
12.     if (exception instanceof FacebookAuthorizationException) {
13.         LoginManager.getInstance().logOut();
14.         // TODO：
15.     }
16. }

8. 使用AppEventsLogger来添加自定义统计事件，登录和支付（分别对应游戏FB登录和发起支付并支付成功时）的示例代码如下：

登录事件统计：

    Bundle parameters = new Bundle();    parameters.putString(AppEventsConstants.EVENT_PARAM_CONTENT_ID, roleId);    parameters.putInt(AppEventsConstants.EVENT_NAME_ACHIEVED_LEVEL, roleLevel);    AppEventsLogger logger = AppEventsLogger.newLogger(this, FACEBOOK_AD_ID);    logger.logEvent("Login", parameters);

支付事件统计：

    AppEventsLogger logger = AppEventsLogger.newLogger(this, FACEBOOK_AD_ID);    logger.logPurchase(BigDecimal.valueOf(orderInfo.getInt("price")), Currency.getInstance(SdkImp.CURRENCY));

FB SDK接入常见错误

1. 登录权限异常，FacebookCallback的onError中返回FacebookAuthorizationException：
   解决：一般是FB帐号设置了安全验证，例如登录需要安全码之类的，需要修改FB安全设置。

2. Invalid key hash错误。如图：
   
   解决：需要确认正式打包的签名文件(.keystore)和生成keyHash时是否为同一个签名文件。

作者：AlphaGL
出处：http://www.cnblogs.com/alphagl/
版权所有，欢迎保留原文链接进行转载 :)