1. 背景
在年初的时候,公司的项目有个新的需求,在英文版的应用中加入Facebook和Twitter分享功能。
2. 完成情况
由于这个项目比较急,所以开发这个功能从预研到接入总共耗时一周。后来,在发了第一个英文正式版之后,在时间不是那么紧迫的情况下,将原来使用第三方库的Twitter分享,进行了重写,替换为Twitter官方SDK接入功能,耗时一周,所以从一开始的预研到最终定稿,总共花费时间两周。
3. 预研与接入
3.1 Facebook
在预研Facebook的时候,在我印象中,好像没有什么困难的地方,一切进行得都还挺顺利的样子。接着看吧,随着笔者的回忆,困难与问题也许会慢慢浮出水面的。
准备工作:
1) 从上方地址中可以下载到Facebook official SDK;
2) 从自己账户下拉菜单中选择add a new app,然后跟着里面的操作一步一步进行即可,最后你会得到一个Facebook app id;
3) 从 https://developers.facebook.com/docs/android/getting-started中可以看到
然后到可以执行这二条命令行之一的地方执行,可以得到一个公钥,并且将这个填写到(注意,在大部份windows下是不能执行以上命令的,所以笔者建议可以安装一个类似可以执行Linux命令的模拟器)
准备工作就这么多了,下面开始进行代码接入步骤了。
1) 集成Facebook SDK到项目中去:将准备工作中下载的Facebook SDK包放到项目中去,然后在gralde文件中加入代码
compile(name: 'facebook-android-sdk-4.10.0', ext: 'aar')
2) 在AndroidManifest.xml中加入
其中的APP_ID就是第二步中得到的值。
3) 在你主程序刚开始的地方,或者自己重写的Application类的onCreate()中加入:
FacebookSdk.sdkInitialize(getApplicationContext());
4) 组建要分享的内容并且调用分享代码即可,
ShareLinkContent.Builder shareLinkContentBuilder = new ShareLinkContent.Builder();
shareLinkContentBuilder.setContentDescription()
.setContentTitle()
.setContentUrl();
ShareLinkContent shareLinkContent = shareLinkContentBuilder.build();
if (ShareDialog.canShow(ShareLinkContent.class)) {
ShareDialog.show((Activity)mContext, shareLinkContent);
}
那么Facebook分享的内容差不多就是这么一些了。如果读者能跟着笔者走到这一步,相信目标近在咫尺了。
3.2 Twitter
接下来,笔者要说一说关于Twitter分享的过程与心得。这里笔者只介绍使用Twitter官方文档来接入Twitter功能,至于如何使用第三方库来完成,下次有空的时候再另写一篇Blog吧。相比Facebook分享的接入,笔者以为Twitter要复杂的多。其中涉及的操作也比Facebook繁琐很多,但是whatever,笔者此时能在这里记录这篇Blog,总算是能说明这件事情过去了,不管遇到了哪些问题,也总算是解决了。
弯路
凡事并不总是按照我们所预想着的方向顺利发展的。在笔者进行Twitter分享的过程中,尤能体现这一点。首先说一说笔者一开始通过查网页的方式进行查资料。笔者第一次进入Twitter官方介绍是在以下地址https://dev.twitter.com/oauth,这里主要介绍的是如何进行用户进入Twitter平台的授权方式。当然了,Twitter平台在用户登录时有一个授权的过程,只是有些时候,我们平常用户不能看到而已。于是笔者就顺着这条路往下走,然后就走进了开源的授权代码中。因为这是一条弯路,所以笔者只介绍到这里,不要再前进了,但是读者要是能一直走到底的话,那就太厉害了。笔者是不想继续了。
正途
弯路总归还是少走一点的好,毕竟人生路并不长。
https://docs.fabric.io/此站点是Twitter官方文档,有兴趣的可以自行查看。笔者主要介绍自己根据此文档,并且成功进行Twitter分享的步骤。
准备工作:
1) 给自己的Android Studio安装一个Fabric插件:只要打开Android Studio中的设置下的plugins,一搜Fabric for Android Studio就可以安装了;
2) 到https://apps.twitter.com/中进行create new app,跟着里面的步骤一直走会得到一个app key和一个app secret,注意,如果要进行发推功能的话,那么在这个步骤中,不要忘记选择Read, Write and Access direct messages这一项单选按钮;
准备工作就这点,少吧。
buildscript {
repositories {
jcenter()
maven { url 'https://maven.fabric.io/public' }
}
dependencies {
classpath 'com.android.tools.build:gradle:1.5.0'
// The Fabric Gradle plugin uses an open ended version to react
// quickly to Android tooling updates
classpath 'io.fabric.tools:gradle:1.+'
}
} apply plugin: 'com.android.application'
//Put Fabric plugin after Android plugin
apply plugin: 'io.fabric' repositories {
jcenter()
maven { url 'https://maven.fabric.io/public' }
}
将这一段代码拷到主程序的build.gradld的第一行中,此处是声明一个maven库,从中我们可以进行后续的下载包的工作。
compile('com.twitter.sdk.android:twitter:1.13.0@aar') {
transitive = true;
}
compile('com.twitter.sdk.android:tweet-composer:1.0.3@aar') {
transitive = true;
}
compile('com.crashlytics.sdk.android:crashlytics:2.5.5@aar') {
transitive = true;
}
compile('com.twitter.sdk.android:tweet-ui:1.10.0@aar') {
transitive = true;
}
将这一段代码拷到该文件的dependencies中进行程序包的下载。可以看到里面有跟Twitter毫无关系的程序包,比如crashlytics。但是笔者将其列在此处,说明少了它还是不行的,最起码程序无法正常通过编译。
在主程序目录下创建一个文件名为fabric.properties里面就写入
apiSecret=准备工作中的secret
apiKey=准备工作中的key
到这里,这个文件就不用去动了,等下要用到插件的时候,这个文件会自动进行更新并且替换掉原来的secret值,这些都是正常的。
接下来进行代码的接入。
1) 在Androidmanifest.xml中加入
注意此处的这个值不可改变,直接拷贝即可;
2) 在自己的主程序开始处,或者是在重写的Application类的onCreate()中加入
TwitterAuthConfig authConfig = new TwitterAuthConfig(Constants.TWITTER_API_KEY, Constants.TWITTER_API_SECRET);
Fabric.with(this, new Twitter(authConfig));
Fabric.with(this, new TwitterCore(authConfig), new TweetUi());
Fabric.with(this, new TwitterCore(authConfig), new TweetComposer(), new Crashlytics());
这个是为了加载你的授权信息;
3) 如果你的项目是要经过混淆的,那么就在混淆代码中加入
-dontwarn com.squareup.okhttp.**
-dontwarn com.google.appengine.api.urlfetch.**
-dontwarn rx.**
-dontwarn retrofit.**
-keepattributes Signature
-keepattributes *Annotation*
-keep class com.squareup.okhttp.** { *; }
-keep interface com.squareup.okhttp.** { *; }
-keep class retrofit.** { *; }
-keepclasseswithmembers class * {
@retrofit.http.* ;
}
4) 将Twitter官方的登录按钮写入到你自己的布局文件中去
并且在程序中能过findViewById()找到这个按钮,通过如下方法
loginButton = (TwitterLoginButton) findViewById(R.id.login_button);
btnShowTweet = (Button) findViewById(R.id.btn_show_tweet);
llTweets = (LinearLayout) findViewById(R.id.ll_tweets);
btnShowTweet.setOnClickListener(this);
loginButton.setCallback(new Callback() {
@Override
public void success(Result result) {
// Do something with result, which provides a TwitterSession for making API calls
TwitterAuthToken authToken = result.data.getAuthToken();
String token = authToken.token;
String secret = authToken.secret;
Toast.makeText(MainActivity.this, token + " " + secret, Toast.LENGTH_LONG).show();
//compose a tweet
TweetComposer.Builder builder = new TweetComposer.Builder(MainActivity.this)
.text("just setting up my Fabric.")
.image(getImgUri());
builder.show(); //load tweets
// TweetUtils.loadTweets(tweetIds, new Callback>() {
// @Override
// public void success(Result> result) {
// for (Tweet tweet : result.data) {
// llTweets.addView(new TweetView(MainActivity.this, tweet));
// }
// }
//
// @Override
// public void failure(TwitterException e) {
//
// }
// }); //app card
// final TwitterSession session = TwitterCore.getInstance().getSessionManager().getActiveSession();
// final Card card = new Card.AppCardBuilder(MainActivity.this).imageUri(getImgUri()).googlePlayId("com.medzone.twitterpic").build();
// final Intent intent = new ComposerActivity.Builder(MainActivity.this).session(session).card(card).createIntent();
// startActivity(intent);
} @Override
public void failure(TwitterException exception) {
// Do something on failure
Toast.makeText(MainActivity.this, "Error", Toast.LENGTH_LONG).show();
Log.d("hsc", exception.getMessage());
}
});
} @Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
super.onActivityResult(requestCode, resultCode, data); // Pass the activity result to the login button.
loginButton.onActivityResult(requestCode, resultCode, data);
}
此处需要注意的是应该将你的代码写在success()内部,不然你的登录信息将会丢失,当然了如果读者能找到解决方案,自然再好不