??我們在進行安卓開發的時候,并不能完成所有的功能。目前市場上有許多的服務商給我們提供了各種各樣的服務。這里介紹友盟。用于統計,分享和推送的功能。
1.1 注冊友盟賬號
??在使用第三方服務商提供的服務時都需要先進行賬號注冊,登錄http://www.umeng.com/ 友盟官網注冊https://i.umeng.com/signup,如下圖所示,注冊完成之后進入友盟的官網,這時候我們就可以開始使用自己需要的功能了。我們主要是使用產品這塊的功能,選擇U-App ,然后點擊立即使用,進入圖三,因為我們沒有應用在這里面,所以需要自己添加應用。
友盟統計賬號注冊
|
友盟統計
|
---|---|
友盟統計
|
友盟統計添加應用
|
1.2 友盟統計
- 在上圖的步驟完成之后,我們需要的是添加APP進來統計,在上圖四中左下角有一個 添加新應用,,再添加完成應用信息之后,會直接返回一個AppKey的值,這個值保存好,然后在你的AndroidManifest.xml文件中添加。
添加應用名稱
|
得到APPkey
|
---|
- 在完成AppKey的申請操作之后,我們就可以下載SDK ,在下載SDK的時候,最好選擇最新的版本。解壓之后有三個包和一個text,我們需要的是libs包,這個包里面有兩個jar包,一個是umeng的jar,這個包是我們需要的,兩一個utdid4all包,這個包是阿里UTDID服務的補充包,如果需要請導入UTDID包。上次項目里面重新運行的時候,這個包會導致包沖突。
sdk下載
|
解壓sdk
|
---|---|
友盟包
|
- 配置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,
友盟分享
|
下載sdk
|
---|
??根據你需要的選擇分享的第三方平臺。這里選擇QQ,微博,微信。根據你的需要你選擇完整版還是精簡版。選擇完成之后,點擊下載,解壓,然后選擇友盟集成工具,雙擊或者選擇打開方式->Java Platform SE binary ,有些電腦雙擊是解壓這個壓縮包,有些不是所以選擇圖二解壓。圖三打開工具的界面,圖四是生成一個umeng_integratetool_result包文件,然后將這個文件里面對應的子文件拷貝進工程中對應的包中。如下圖所示:
友盟下載的sdk
|
解壓工具
|
---|---|
解壓生成代碼
|
解壓完成
|
添加完成之后,外部的準備工作就基本完成了,接下來就是內部的代碼工作。
- 添加權限
<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 。
- 在進行推送之前,我們必須創建應用,如果之前使用了統計的話就從已有應用中添加
注冊應用
|
生成的key和secret值
|
---|
-
然后按照下面的步驟,進行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();
- 最后一步,打包運行。記得要打包,不打包的話,推送貌似不行。