我们在进行安卓开发的时候,并不能完成所有的功能。目前市场上有许多的服务商给我们提供了各种各样的服务。这里介绍友盟。用于统计,分享和推送的功能。
1.1 注册友盟账号
在使用第三方服务商提供的服务时都需要先进行账号注册,登录http://www.umeng.com/ 友盟官网注册https://i.umeng.com/signup,如下图所示,注册完成之后进入友盟的官网,这时候我们就可以开始使用自己需要的功能了。我们主要是使用产品这块的功能,选择U-App ,然后点击立即使用,进入图三,因为我们没有应用在这里面,所以需要自己添加应用。
1.2 友盟统计
- 在上图的步骤完成之后,我们需要的是添加APP进来统计,在上图四中左下角有一个 添加新应用,,再添加完成应用信息之后,会直接返回一个AppKey的值,这个值保存好,然后在你的AndroidManifest.xml文件中添加。
- 在完成AppKey的申请操作之后,我们就可以下载SDK ,在下载SDK的时候,最好选择最新的版本。解压之后有三个包和一个text,我们需要的是libs包,这个包里面有两个jar包,一个是umeng的jar,这个包是我们需要的,两一个utdid4all包,这个包是阿里UTDID服务的补充包,如果需要请导入UTDID包。上次项目里面重新运行的时候,这个包会导致包冲突。
- 配置AndroidManifest.xml 文件,添加必要的权限,一个都不能少,还有就是添加你申请的AppKey,name 值为UMENG_APPKEY,还需要添加对应的渠道的名称,UMENG_CHANNEL,不同的应用市场对应的不同的值,例如:豌豆荚 value=wdj 。
<manifest>
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.INTERNET"/>
<uses-permission android:name="android.permission.READ_PHONE_STATE"/>
···
<meta-data android:value="YOUR_APP_KEY "
android:name="UMENG_APPKEY"/>
<meta-data android:value="Channel ID"
android:name="UMENG_CHANNEL"/>
</manifest>
- 友盟统计在代码中的使用
在Activity中,每个Activity都添加onResume和onPause方法
@Override
public void onResume() {
super.onResume();
MobclickAgent.onPageStart(mPageName);
MobclickAgent.onResume(mContext);
}
@Override
public void onPause() {
super.onPause();
MobclickAgent.onPageEnd(mPageName);
MobclickAgent.onPause(mContext);
}
Fragment
SDK在统计Fragment时,需要关闭Activity自带的页面统计,然后在每个页面中重新集成页面统计的代码(包括调用了 onResume 和 onPause 的Activity)。
就这么简单。
友盟的文档:http://dev.umeng.com/analytics/android-doc/integration#2_5
友盟更新
记录时间: 2018年3月13日
因为太久没有去看友盟的文档了,今天才发现友盟有了一个更新,这里再加上一个补充说明。
友盟文档:http://dev.umeng.com/sdk_integate/android_sdk/android_common_guide#1_1_1
自动集成
使用方法很简单:
- app build.gradle 文件添加依赖
compile 'com.umeng.sdk:common:latest.integration'
project build.gradle 文件
allprojects {
repositories {
mavenCentral()
}
}
- AndroidMainifest.xml
<meta-data android:value="YOUR_APP_KEY" android:name="UMENG_APPKEY"/>
<meta-data android:value="Channel ID" android:name="UMENG_CHANNEL"/>
权限:别忘记了
<!-- 必须的权限 -->
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.READ_PHONE_STATE" />
<uses-permission android:name="android.permission.INTERNET" />
<!-- 推荐的权限 -->
<!-- 添加如下权限,以便使用更多的第三方SDK和更精准的统计数据 -->
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<uses-permission android:name="android.permission.CHANGE_WIFI_STATE" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
- Application 中的onCreate()
//设置LOG开关,默认为false
UMConfigure.setLogEnabled(false);
//第二 ,三 个参数 是appkey channel manifest中有的话 传null,没有传具体的值
// 第四个参数是集成推送的 ,不集成直接传null
UMConfigure.init( context,null, null, UMConfigure.DEVICE_TYPE_PHONE,null);
登录:
//用户使用自有账号登录时
MobclickAgent.onProfileSignIn("userID");
//当用户使用第三方账号(如新浪微博)登录时
MobclickAgent.onProfileSignIn("WB","userID");
登出:
MobclickAgent.onProfileSignOff();
代码统计:
在你的BaseActivity 中添加代码
@Override
protected void onResume() {
super.onResume();
MobclickAgent.onResume(this);
}
@Override
protected void onPause() {
super.onPause();
MobclickAgent.onPause(this);
}
1.3 友盟分享
友盟的分享和市场上的大多数分享一样,都是必须先在各大平台上注册,注册完成之后,得到各大平台的App Key 和App Id 这两个值,然后在集成友盟分享的时候再将这些需要分享的平台的值添加进去。我们这里是安卓的分享,点击sdk及文档,进行安卓的文档查看。下载sdk http://dev.umeng.com/social/android/sdk-download,
根据你需要的选择分享的第三方平台。这里选择QQ,微博,微信。根据你的需要你选择完整版还是精简版。选择完成之后,点击下载,解压,然后选择友盟集成工具,双击或者选择打开方式->Java Platform SE binary ,有些电脑双击是解压这个压缩包,有些不是所以选择图二解压。图三打开工具的界面,图四是生成一个umeng_integratetool_result包文件,然后将这个文件里面对应的子文件拷贝进工程中对应的包中。如下图所示:
添加完成之后,外部的准备工作就基本完成了,接下来就是内部的代码工作。
- 添加权限
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.READ_PHONE_STATE" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"/>
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_LOCATION_EXTRA_COMMANDS" />
2.配置 AndroidManifest.xml文件
<!--友盟分享-->
<!--新浪-->
<activity
android:name=".WBShareActivity"
android:configChanges="keyboardHidden|orientation"
android:screenOrientation="portrait" >
<intent-filter>
<action android:name="com.sina.weibo.sdk.action.ACTION_SDK_REQ_ACTIVITY" />
<category android:name="android.intent.category.DEFAULT" />
</intent-filter>
</activity>
<!--微信-->
<activity
android:name=".wxapi.WXEntryActivity"
android:configChanges="keyboardHidden|orientation|screenSize"
android:exported="true"
android:screenOrientation="portrait"
android:theme="@android:style/Theme.Translucent.NoTitleBar" />
<!--QQ-->
<activity
android:name="com.tencent.tauth.AuthActivity"
android:launchMode="singleTask"
android:noHistory="true" >
<intent-filter>
<action android:name="android.intent.action.VIEW" />
<category android:name="android.intent.category.DEFAULT" />
<category android:name="android.intent.category.BROWSABLE" />
<data android:scheme="tencent你申请的id" />
</intent-filter>
</activity>
<activity
android:name="com.tencent.connect.common.AssistActivity"
android:screenOrientation="portrait"
android:theme="@android:style/Theme.Translucent.NoTitleBar"
android:configChanges="orientation|keyboardHidden|screenSize"/>
2.新建一个 类App 继承Application,在这个类里面配置你的App Key值。
public class App extends Application {
@Override
public void onCreate() {
super.onCreate();
//开启debug模式,方便定位错误,具体错误检查方式可以查看http://dev.umeng.com/social/android/quick-integration的报错必看,正式发布,请关闭该模式
Config.DEBUG = true;
QueuedWork.isUseThreadPool = false;
UMShareAPI.get(this);
}
//各个平台的配置,建议放在全局Application或者程序入口
//这里的信息都要自己注册,按照你的需要添加,我没有加上我自己的
{
PlatformConfig.setWeixin("wxdc1e388c3822c80b", "3baf1193c85774b3fd9d18447d76cab0");
//豆瓣RENREN平台目前只能在服务器端配置
PlatformConfig.setSinaWeibo("3921700954", "04b48b094faeb16683c32669824ebdad","http://sns.whalecloud.com");
PlatformConfig.setYixin("yxc0614e80c9304c11b0391514d09f13bf");
PlatformConfig.setQQZone("100424468", "c7394704798a158208a74ab60104f0ba");
PlatformConfig.setTwitter("3aIN7fuF685MuZ7jtXkQxalyi", "MK6FEYG63eWcpDFgRYw4w9puJhzDl0tyuqWjZ3M7XJuuG7mMbO");
PlatformConfig.setAlipay("2015111700822536");
PlatformConfig.setLaiwang("laiwangd497e70d4", "d497e70d4c3e4efeab1381476bac4c5e");
PlatformConfig.setPinterest("1439206");
PlatformConfig.setKakao("e4f60e065048eb031e235c806b31c70f");
PlatformConfig.setDing("dingoalmlnohc0wggfedpk");
PlatformConfig.setVKontakte("5764965","5My6SNliAaLxEm3Lyd9J");
PlatformConfig.setDropbox("oz8v5apet3arcdy","h7p2pjbzkkxt02a");
PlatformConfig.setYnote("9c82bf470cba7bd2f1819b0ee26f86c6ce670e9b");
}
}
- 从原来的项目中拿出来的,里面的部分内容按照你的要求更改,我这里面只有一个微信分享 SHARE_MEDIA.WEIXIN, SHARE_MEDIA.WEIXIN_CIRCLE,如果需要的话,只需要在这里面继续添加。另外说一下,关于微信的appid和secret,如果不能分享的话,注意检查一下安卓的微信开放平台的申请是跟包名和签名相关的,统统换你自己的。这个很重要。还有微信的测试的时候要用打包签名的进行测试, 以打包签名的为准 别说为啥我之前就好使现在怎么就不行的事儿, 如果出现 一定先检查下签名。代码只能帮你到这里了。
public class MainActivity extends AppCompatActivity implements View.OnClickListener{
private Button btn_share_um;
private ShareAction mShareAction;
private UMShareListener mShareListener;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP) {
Window window = getWindow();
window.addFlags(WindowManager.LayoutParams.FLAG_DRAWS_SYSTEM_BAR_BACKGROUNDS);
window.setStatusBarColor(getResources().getColor(R.color.colorPrimary));
}
setContentView(R.layout.activity_main);
btn_share_um = (Button) findViewById(R.id.btn_share_um);
btn_share_um.setOnClickListener(this);
initData();
}
private void initData() {
mShareListener = new CustomShareListener(this);
mShareAction = new ShareAction(MainActivity.this).setDisplayList(
SHARE_MEDIA.WEIXIN, SHARE_MEDIA.WEIXIN_CIRCLE
).setShareboardclickCallback(new ShareBoardlistener() {
@Override
public void onclick(SnsPlatform snsPlatform, SHARE_MEDIA share_media) {
UMWeb web = new UMWeb("http://www.baidu.com");
web.setTitle("分享的标题");
web.setDescription("分享的内容");
web.setThumb(new UMImage(MainActivity.this, R.mipmap.ic_launcher));
new ShareAction(MainActivity.this).withMedia(web)
.setPlatform(share_media)
.setCallback(mShareListener)
.share();
}
}
);
}
@Override
public void onClick(View view) {
switch (view.getId()){
case R.id.btn_share_um:
ShareBoardConfig config = new ShareBoardConfig();
config.setMenuItemBackgroundShape(ShareBoardConfig.BG_SHAPE_ROUNDED_SQUARE);
mShareAction.open(config);
break;
}
}
public class CustomShareListener implements UMShareListener {
private WeakReference<MainActivity> mActivity;
private CustomShareListener(MainActivity activity) {
mActivity = new WeakReference(activity);
}
@Override
public void onStart(SHARE_MEDIA platform) {
}
@Override
public void onResult(SHARE_MEDIA platform) {
if (platform != SHARE_MEDIA.MORE && platform != SHARE_MEDIA.SMS
&& platform != SHARE_MEDIA.EMAIL
&& platform != SHARE_MEDIA.FLICKR
&& platform != SHARE_MEDIA.FOURSQUARE
&& platform != SHARE_MEDIA.TUMBLR
&& platform != SHARE_MEDIA.POCKET
&& platform != SHARE_MEDIA.PINTEREST
&& platform != SHARE_MEDIA.INSTAGRAM
&& platform != SHARE_MEDIA.GOOGLEPLUS
&& platform != SHARE_MEDIA.YNOTE
&& platform != SHARE_MEDIA.EVERNOTE) {
Toast.makeText(mActivity.get(), " 分享成功", Toast.LENGTH_SHORT).show();
}
}
@Override
public void onError(SHARE_MEDIA platform, Throwable t) {
if (platform != SHARE_MEDIA.MORE && platform != SHARE_MEDIA.SMS
&& platform != SHARE_MEDIA.EMAIL
&& platform != SHARE_MEDIA.FLICKR
&& platform != SHARE_MEDIA.FOURSQUARE
&& platform != SHARE_MEDIA.TUMBLR
&& platform != SHARE_MEDIA.POCKET
&& platform != SHARE_MEDIA.PINTEREST
&& platform != SHARE_MEDIA.INSTAGRAM
&& platform != SHARE_MEDIA.GOOGLEPLUS
&& platform != SHARE_MEDIA.YNOTE
&& platform != SHARE_MEDIA.EVERNOTE) {
Toast.makeText(mActivity.get(), "分享失败", Toast.LENGTH_SHORT).show();
if (t != null) {
Log.d("throw", "throw:" + t.getMessage());
}
}
}
@Override
public void onCancel(SHARE_MEDIA platform) {
Toast.makeText(MainActivity.this, platform + " 分享取消了", Toast.LENGTH_SHORT).show();
}
}
@Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
super.onActivityResult(requestCode, resultCode, data);
/** attention to this below ,must add this**/
UMShareAPI.get(this).onActivityResult(requestCode, resultCode, data);
}
/**
* 屏幕横竖屏切换时避免出现window leak的问题
*/
@Override
public void onConfigurationChanged(Configuration newConfig) {
super.onConfigurationChanged(newConfig);
mShareAction.close();
}
//友盟统计代码;
public void onResume() {
super.onResume();
MobclickAgent.onResume(this); //统计时长
}
public void onPause() {
super.onPause();
MobclickAgent.onPause(this);
}
}
关于分享的代码就只有这些了,如果这些不能满足你的基本需要的话,你可以参考友盟的sdk文档。友盟问题查看文档:http://bbs.umeng.com/thread-17764-1-1.html
友盟集成推送文档:http://dev.umeng.com/social/android/quick-integration#2
1.4 友盟推送
目前市场上有很多推送服务,极光,个推,友盟等。友盟集成推送是很简单。推送文档 http://dev.umeng.com/push/android/api-doc 。
- 在进行推送之前,我们必须创建应用,如果之前使用了统计的话就从已有应用中添加
-
然后按照下面的步骤,进行sdk的配置和进入后台。
按照文档配置http://dev.umeng.com/push/android/integration#2_2_9,将下载sdk包解压,将PushSDK这个包作为model导入工程中(File->New->import Module),然后在build gradle 中的 dependencies{} 添加 compile project(':PushSDK') 或者选择 File ->Project Structure->app-> Dependencies->右上角的+号->Model dependency->弹框中选择 :PushSDK->OK->OK这样就添加依赖完成了。
配置AndroidManifest.xml,在第一步的图二中,我们有AppKey,和Umeng Message Secret,将这两个值添加进去,这里还有一个渠道,按照你的要求选择渠道,没有不改也可以。
<meta-data
android:value="59e032a43eae25098b000010"
android:name="UMENG_APPKEY"/>
<meta-data
android:name="UMENG_MESSAGE_SECRET"
android:value="0cb66cd0b897b2b6201461fc1be20c20" />
<meta-data
android:name="UMENG_CHANNEL"
android:value="Umeng" />
- 在工程的Application类的 onCreate() 方法中注册推送服务。
PushAgent mPushAgent = PushAgent.getInstance(this);
//注册推送服务,每次调用register方法都会回调该接口
mPushAgent.register(new IUmengRegisterCallback() {
@Override
public void onSuccess(String deviceToken) {
//注册成功会返回device token
Log.e("tag","deviceToken="+deviceToken);
}
@Override
public void onFailure(String s, String s1) {
}
});
- 在所有的Activity 的onCreate 方法或在应用的BaseActivity的onCreate方法中添加
PushAgent.getInstance(context).onAppStart();
- 最后一步,打包运行。记得要打包,不打包的话,推送貌似不行。