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类名对应。

   
   
   
   
   
   

例如：org.cocos2dx.lua.SplashActivity

3. 生成KeyHash，并配置KeyHash。
   • 下载OpenSSL，并添加到环境变量。
   • 命令行执行：keytool -exportcert -alias androiddebugkey -keystore %HOMEPATH%\.android\debug.keystore | openssl sha1 -binary | openssl
     base64,注意-keystore后面是签名文件的路径，执行完之后会生成如图：
     
4. 将生成的KeyHash（28个字符的字符串）配置到FB后台，可添加多个。
5. 其它配置，如图：
   
   
   

（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，添加如下配置：

   repositories {
   flatDir {
   dirs 'libs'
   }
   }

   compile(name: 'facebook-android-sdk-4.8.2', ext: 'aar')
   如图：
   
   然后，重新Rebuild Project一下，成功则会生成如下：
   

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

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

（4）FB SDK接入

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

   172633573185136

2. 配置AndroidManifest，添加权限

   
   在application项下配置：

   
   
   

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

   public void onCreate() {
   super.onCreate();
   FacebookSdk.sdkInitialize(getApplicationContext());
   AppEventsLogger.activateApp(this);
   }

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

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

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

   callbackManager = CallbackManager.Factory.create();

   LoginManager.getInstance().registerCallback(callbackManager,
   new FacebookCallback() {
   @Override
   public void onSuccess(LoginResult loginResult) {
   // App code
   }

   @Override
   public void onCancel() {
   // App code
   }

   @Override
   public void onError(FacebookException exception) {
   // App code
   }
   });

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

   private static final String PERMISSION = "public_profile";

   LoginManager loginManager = LoginManager.getInstance();
   loginManager.setDefaultAudience(loginManager.getDefaultAudience());
   loginManager.setLoginBehavior(loginManager.getLoginBehavior());
   loginManager.logInWithReadPermissions(AppActivity.context_self, Arrays.asList(PERMISSION));

   onActivityResult处理代码：

   public static void onActivityResult(int requestCode, int resultCode, Intent data) {
   if (callbackManager != null) {
   callbackManager.onActivityResult(requestCode, resultCode, data);
   }
   }

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

   public void onSuccess(LoginResult loginResult) {
   AccessToken accessToken = loginResult.getAccessToken();
   String userId = accessToken.getUserId();
   String token = accessToken.getToken();
   // TODO：拿到userId和token，传给游戏服务器校验
   }

   public void onCancel() {
   }

   public void onError(FacebookException exception) {
   if (exception instanceof FacebookAuthorizationException) {
   LoginManager.getInstance().logOut();
   // TODO：
   }
   }

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/
版权所有，欢迎保留原文链接进行转载 😃