安装umeng提供的插件

第一步：下载SDK

下载地址：http://dev.umeng.com/analytics/h5/sdk-download

第二步：配置appkey

下载解压缩后，打开里面*/umeng-plugin-android/下的plugin.xml，更改appkey：

1
2
3
 <!-- appkey -->
<meta-data android:name="UMENG_APPKEY" android:value="4f83c5d852701564XXXXXX" />
<meta-data android:name="UMENG_CHANNEL" android:value="Umeng-Channel"/>

将appkey替换为你自己应用的key。”UMENG_CHANNEL”可以先不替换，因为渠道名后面是动态设置的。

第三步：将友盟统计功能集成到你的项目中

首先通过本地安装cordova plugin的方式将umemg-plugin-android安装到你的项目。

1
cordova plugins add */umeng-plugin-android/        // 其中* 代表的是umeng-plugin-android所在的路径

在主界面集成友盟初始化

打开Android项目下的MainActivity.java文件，添加下面的代码，在onCreate()中调用initUmengSDK()。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
public class MainActivity extends CordovaActivity {
   @Override
   public void onCreate(Bundle savedInstanceState) {
       super.onCreate(savedInstanceState);
       initUmengSDK();
       // Set by <content src="index.html" /> in config.xml
       loadUrl(launchUrl);
   }

   /**
    * onCreate中调用
    */
   private void initUmengSDK() {
       MobclickAgent.setScenarioType(this, MobclickAgent.EScenarioType.E_UM_NORMAL);
       MobclickAgent.setDebugMode(true);
       MobclickAgent.openActivityDurationTrack(false);
       // MobclickAgent.setSessionContinueMillis(1000);
   }

   @Override
   protected void onResume() {
       super.onResume();
       MobclickAgent.onResume(this);
   }

   @Override
   protected void onPause() {
       super.onPause();
       MobclickAgent.onPause(this);
   }

}

友盟PhoneGap集成文档：http://dev.umeng.com/analytics/h5/phonegap-doc

到这一步就可以实现将友盟统计集成到你的App中了。接下来就是进行多渠道打包。

多渠道打包

多渠道打包是指：因Android市场的四分五裂，不同的厂家都有各自的应用市场和渠道，所以一个apk要根据不同应用市场的要求打包成不同渠道的apk。最后可以通过友盟的渠道统计来分析apk在各个应用市场的数据。

传统的多渠道打包一般是采用gradle打包，这种方式打包apk非常的慢，所以我放弃了。

这里我采用的是：Android批量打包提速 - 1分钟900个市场不是梦 这篇文章中介绍的技术（其中的思路其实是来自美团的技术分享 美团Android自动化之旅—生成渠道包 中提到的第三种实现方式）。
思路是

  1. 通过解压apk，往META-INF中放置一个类似 channel_xxx的空文件来标致渠道名称
  2. 在Java代码中解析这个文件名获取渠道名称。

去作者的github(https://github.com/GavinCT/AndroidMultiChannelBuildTool) 下载代码得到下面几个文件

  • JavaUtil/ChannelUtil.java 用于获取渠道名称；
  • PythonTool/info 该文件夹包括两个txt文件，channel.txt用于存放渠道列表，czt.txt用于添加到apk中的`META-INF中；
  • Python/MutilChannelBuildTool.py 用于执行打包替换多渠道的Python脚本

第一步：在项目中动态设置渠道名称

将ChannelUtil.java放入你的项目中，并在MainActivity.java中调用

1
2
3
4
5
6
7
@Override
public void onCreate(Bundle savedInstanceState) {
   super.onCreate(savedInstanceState);
    ChannelUtil.getChannel(this);    // 在这里便可以获取到渠道名称
   // Set by <content src="index.html" /> in config.xml
   loadUrl(launchUrl);
}

但是到这里，我们只能得到渠道的名称，所以我们还需要动态将渠道名称动态设置到友盟的代码中，这样才能分辨不同渠道的apk。

关于友盟渠道动态设置网上说的方法AnalyticsConfig.setChannel(getChannel(Context context) )已经不能用了 ，因为友盟提供的sdk中，已经废弃了该方法，而改用MobclickAgent.startWithConfigure()来进行初始化。所以我们需要在往MainActivity.java中添加友盟初始化的方法

1
2
3
4
5
6
/*
*传入渠道名称设置友盟渠道名称
*/
private MobclickAgent.UMAnalyticsConfig getConfig(String channel) {
   return new MobclickAgent.UMAnalyticsConfig(this, AnalyticsConfig.getAppkey(this), channel);
}

然后在onCreate()中调用

1
2
3
4
5
6
public void onCreate(Bundle savedInstanceState) {
   super.onCreate(savedInstanceState);
   MobclickAgent.startWithConfigure(getConfig(ChannelUtil.getChannel(this)));
   // Set by <content src="index.html" /> in config.xml
   loadUrl(launchUrl);
}

加上前面的初始化友盟代码，完整的MainActivity.java如下：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
public class MainActivity extends CordovaActivity {
   @Override
   public void onCreate(Bundle savedInstanceState) {
       super.onCreate(savedInstanceState);
       MobclickAgent.startWithConfigure(getConfig(ChannelUtil.getChannel(this)));
       initUmengSDK();
       // Set by <content src="index.html" /> in config.xml
       loadUrl(launchUrl);
   }

   /**
    * onCreate中调用
    */
   private void initUmengSDK() {
       MobclickAgent.setScenarioType(this, MobclickAgent.EScenarioType.E_UM_NORMAL);
       MobclickAgent.setDebugMode(true);
       MobclickAgent.openActivityDurationTrack(false);
       // MobclickAgent.setSessionContinueMillis(1000);
   }

   @Override
   protected void onResume() {
       super.onResume();
       MobclickAgent.onResume(this);
   }

   @Override
   protected void onPause() {
       super.onPause();
       MobclickAgent.onPause(this);
   }

   private MobclickAgent.UMAnalyticsConfig getConfig(String channel) {
       return new MobclickAgent.UMAnalyticsConfig(this, AnalyticsConfig.getAppkey(this), channel);
   }
}

第二步：执行python，进行多渠道打包

将想要批量打包的apk放到与Python/MutilChannelBuildTool.py一起，运行python脚本即可（前提是你的电脑已经安装python环境）。

如何重命名cordova生成apk的名称

cordova 生成apk的名称默认为android-release.apk，更改platforms/android/build.gradle,代码如下：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
buildTypes {
   release {
       signingConfig signingConfigs.release
       applicationVariants.all { variant ->
           variant.outputs.each { output ->
               // 重命名产出的apk文件 
               def outputFile = output.outputFile
                   File outputDirectory = new File(outputFile.parent);
                   def fileName
                   def manifestParser = new com.android.builder.core.DefaultManifestParser()
                   fileName = "TM_"+manifestParser.getVersionName(android.sourceSets.main.manifest.srcFile)+".apk"    // 格式为 'TM_2.1.0' 其中2.1.0是AndroidMainifest.xml中的versionName
                   output.outputFile = new File(outputDirectory, fileName)
               // 删除unaligned apk
               if (output.zipAlign != null) {
                   output.zipAlign.doLast {
                       output.zipAlign.inputFile.delete()
                   }
               }
           }
       }
   }
}

上面的代码命名风格为：TM_versionName.apk，其中versionName是当前apk的版本号。

如何测试友盟统计及渠道信息

友盟提供了集成测试，进入http://mobile.umeng.com/test_devices , 添加测试设备后，便可以实时看到统计日志了。如下图：
txt
txt