Gradle实现Android多渠道定制化打包

  1. 云栖社区>
  2. 博客列表>
  3. 正文

Gradle实现Android多渠道定制化打包

玄学酱 2017-08-03 15:14:00 浏览684 评论0

摘要: 最近在项目中遇到需要实现 Apk 多渠道、定制化打包, Google 、百度查找了一些资料,成功实现了上述功能,在此记录以备不时之需,温故而知新,可以为师矣~ 需求可以总结如下: 如何实现多个 Apk 安装在同一设备 在之前的印象中,同一个应用在同一设备上只能安装一个,除非手动修改 AndroidManifest.xml 文件中的包名( package ),但这么做的后果就是新的应用真的是新的应用,旧版应用再也收不到更新。

最近在项目中遇到需要实现 Apk 多渠道、定制化打包, Google 、百度查找了一些资料,成功实现了上述功能,在此记录以备不时之需,温故而知新,可以为师矣~

需求可以总结如下:

如何实现多个 Apk 安装在同一设备

在之前的印象中,同一个应用在同一设备上只能安装一个,除非手动修改 AndroidManifest.xml 文件中的包名( package ),但这么做的后果就是新的应用真的是新的应用,旧版应用再也收不到更新。而现在你通过 Gradle,你可以轻松构建多个不同版本的应用,并且在同一设备上安装使用。

这里要用到 productFlavors ,productFlavors 可以用来自定义应用构建版本,我们可以用其 applicationId 属性来实现多个 Apk 安装在同一设备上。

build.gradle 中部分配置代码如下:


  1. android { 
  2.     compileSdkVersion 24 
  3.     buildToolsVersion "24.0.1" 
  4.  
  5.     //默认配置,所有 productFlavors 都会继承 defaultConfig 中配置的属性 
  6.     defaultConfig { 
  7.         //默认的 applicationId,一般与 AndroidManifest.xml 文件 package属性相同 
  8.         applicationId "com.littlejie.multichannel" 
  9.         minSdkVersion 15 
  10.         targetSdkVersion 24 
  11.         versionCode 1 
  12.         versionName "1.0" 
  13.     } 
  14.  
  15.     // productFlavors 定义了一个应用的自定义构建版本 
  16.     //一个单一的项目可以同时定义多个不同的 flavor 来改变应用的输出。 
  17.     // productFlavors 这个概念是为了解决不同的版本之间的差异非常小的情况,通常用于区分同一个应用的不同渠道/客户等,可包含少量业务功能差别。 
  18.     // productFlavors 中的 flavor 不能跟 buildType 中的一样,否则会报: "ProductFlavor names cannot collide with BuildType names" 
  19.     productFlavors { 
  20.  
  21.         //默认版本,不设置 applicationId ,继承 defaultConfig 中的配置 
  22.         flavors_default { 
  23.         } 
  24.  
  25.         //开发版本, applicationId 替换为 com.littlejie.multichannel.dev 
  26.         flavors_dev { 
  27.             applicationId "com.littlejie.multichannel.dev" 
  28.         } 
  29.  
  30.         //发布版本, applicationId 替换为 com.littlejie.multichannel.release 
  31.         flavors_release { 
  32.             applicationId "com.littlejie.multichannel.release" 
  33.         } 
  34.     } 
  35.  

MainActivity.java:


  1. public class MainActivity extends Activity { 
  2.  
  3.     private static final String TAG = MainActivity.class.getSimpleName(); 
  4.  
  5.     @Override 
  6.     protected void onCreate(Bundle savedInstanceState) { 
  7.         super.onCreate(savedInstanceState); 
  8.         setContentView(R.layout.activity_main); 
  9.  
  10.         Log.d(TAG, "package name = " + this.getPackageName()); 
  11.     } 
  12.  

在 Android Studio 中执行如下命令:


  1. //打 debug 包,gradle 命令会在后面 `gradle task`中详细讲述 
  2. gradle clean assembleDebug  

打包完成后,将 Apk 安装到模拟器(adb install name.apk),运行,log 如下:

flavors_default:


  1. 09-17 22:43:55.390 19747-19747/com.littlejie.multichannel D/MainActivity: package name = com.littlejie.multichannel 

flavors_dev:


  1. 09-17 22:11:30.860 2638-2638/com.littlejie.multichannel.dev D/MainActivity: package name = com.littlejie.multichannel.dev 

flavors_release:


  1. 09-17 22:44:55.610 20650-20650/com.littlejie.multichannel.release D/MainActivity: package name = com.littlejie.multichannel.release 

从这里可以看出,不同 flavor 的 package name 被 applicationId 替换掉了,而且同一个模拟器上可以同时安装以上三个应用。

下面我们再看看 AndroidManifest.xml 中发生了什么变化。这里需要用到 aapt 来查看 AndroidManifest.xml 的信息:


  1. //输出 apk 的 AndroidManifest.xml 文件的信息aapt dump xmltree ***.apk AndroidManifest.xml 

下面是 flavors_dev 版本的信息,可以看出 Java 源文件的包名并没有发生改变,而 package 属性的值被替换为 applicationId了。

如果在申请第三方 SDK 接入,则对应的包名应该填 applicationId ,而不是 AndroidManifest.xml 中的默认值


  1. lishengjiedeMacBook-Pro:apk littlejie$ aapt dump xmltree multichannel-flavors_dev-debug.apk AndroidManifest.xml 
  2. N: android=http://schemas.android.com/apk/res/android 
  3.   E: manifest (line=2) 
  4.     A: android:versionCode(0x0101021b)=(type 0x10)0x1 
  5.     A: android:versionName(0x0101021c)="1.0" (Raw: "1.0"
  6.     //此处 package 的值已替换成 applicationId 的值 
  7.     A: package="com.littlejie.multichannel.dev" (Raw: "com.littlejie.multichannel.dev"
  8.     A: platformBuildVersionCode=(type 0x10)0x18 (Raw: "24"
  9.     A: platformBuildVersionName=(type 0x4)0x40e00000 (Raw: "7.0"
  10.     E: uses-sdk (line=7) 
  11.       A: android:minSdkVersion(0x0101020c)=(type 0x10)0xf 
  12.       A: android:targetSdkVersion(0x01010270)=(type 0x10)0x18 
  13.     E: application (line=11) 
  14.       A: android:theme(0x01010000)=@0x7f08008e 
  15.       A: android:label(0x01010001)=@0x7f060020 
  16.       A: android:icon(0x01010002)=@0x7f030000 
  17.       A: android:debuggable(0x0101000f)=(type 0x12)0xffffffff 
  18.       A: android:allowBackup(0x01010280)=(type 0x12)0xffffffff 
  19.       A: android:supportsRtl(0x010103af)=(type 0x12)0xffffffff 
  20.       // Activity 的包名还是原来 AndroidManifest.xml 中申明的 
  21.       E: activity (line=17) 
  22.         A: android:name(0x01010003)="com.littlejie.multichannel.MainActivity" (Raw: "com.littlejie.multichannel.MainActivity"
  23.         E: intent-filter (line=18) 
  24.           E: action (line=19) 
  25.             A: android:name(0x01010003)="android.intent.action.MAIN" (Raw: "android.intent.action.MAIN"
  26.           E: category (line=21) 
  27.             A: android:name(0x01010003)="android.intent.category.LAUNCHER" (Raw: "android.intent.category.LAUNCHER" 

applicationId 的原理可以理解为在 gradle 打包的时,动态合并属性,将 package 替换为 applicationId 指定的值,但并不会替换 Java 文件的包名,包括生成的 R 文件(可以去对应 module 下的 build/generated 目录下查看对应 flavor 的 R 文件)。

另外,由于最终生成的包中 AndroidManifest.xml 文件中的 package 属性被 applicationId 替换掉,故对于某些第三方 SDK ,如:微信、高德地图等需要验证包名的,就会碰到相当蛋疼的事,每个包都需要重新去生成 APPID 和 APPKEY,如果渠道很多,那么像微信就会出现问题微信账号申请的应用数就会超出微信的限制。

Android 官方文档原文如下:

Therefore, we have decoupled the two usages of package name:

The final package that is used in your built .apk's manifest, and is the package your app is known as on your device and in the Google Play store, is the "application id".

The package that is used in your source code to refer to your R class, and to resolve any relative activityrvice registrations, continues to be called the "package".

补充:ApplicationId versus PackageName

替换 AndroidManifest.xml 中的属性

这里可以参考友盟统计 SDK 中使用的方案。该方案通过在 AndroidManifest.xml 文件中 application 标签下指定 <mate-data> 设置占位符来实现动态替换属性值。


  1. <meta-data android:name="UMENG_CHANNEL" android:value="${UMENG_CHANNEL}" /> 

占位符形如${name},在最终执行 AndroidManifest.xml 文件合并的时候,占位符会被

build.gradle 中对应值取代。 build.gradle 的配置需要用到上节讲到的 productFlavors 的 manifestPlaceholders 属性, manifestPlaceholders 属性直译过来就是清单文件占位符。

下面是 build.gradle 的节选代码:


  1. productFlavors { 
  2.  
  3.    //将 AndroidManifest.xml 文件中的 ${UMENG_CHANNEL} 替换为 default 
  4.    flavors_default { 
  5.        manifestPlaceholders = [UMENG_CHANNEL: "defalut"
  6.    } 
  7.  
  8.    flavors_dev { 
  9.        applicationId "com.littlejie.multichannel.dev" 
  10.        manifestPlaceholders = [UMENG_CHANNEL: "dev"
  11.    } 
  12.  
  13.    flavors_release { 
  14.        applicationId "com.littlejie.multichannel.release" 
  15.        manifestPlaceholders = [UMENG_CHANNEL: "release"
  16.    } 
  17.  
  18.  

如果你要替换多个属性,则只需要将 manifestPlaceholders 的写法如下:


  1. manifestPlaceholders = [VALUE_NAME1 : "value" , VALUE_NAME2 : "value"

补充:关于 AndroidManifest 文件合并规则可以查看 官方文档.

替换资源文件

多渠道打包的时候可能会碰到这种情况:每个应用市场的启动页图标、应用名称可能会有点小出入,更有甚者,连布局都不一样。这时候我们该怎么办呢?

有一种解决办法就是:在代码里进行判断,根据渠道的不一样,加载不同的图片和布局,这是一种解决办法。但是当渠道有很多时,代码就会变得很难维护,而且指定渠道用到的资源文件都会被打入所有 Apk 中。所以这个方法并不值得推荐。那么,有什么好的解决办法呢?

办法 Google 早就给我们想好了,而且相当简单,那就是:在 main 的同级目录下创建以渠道名命名的文件夹,然后创建资源文件(路径要与 main 中的一致),然后打包的时候 gradle 就会自己替换或者合并资源。

例如, App 的默认 icon 路径为 main\res\mipmap-hdpi\ic_launcher.png ,那么 flavors_dev的路径就为 flavors_dev\res\mipmap-hdpi\ic_launcher.png ,打包 flavors_dev 渠道的时候会自动替换图片。

对于资源合并,如果在 main 下的 strings.xml 内容为:


  1. <resources> 
  2.     <string name="app_name">MultiChannel</string> 
  3.     <string name="string_merge">我是string,我暂时没被合并</string> 
  4. </resources>  

在 flavors_dev 下的 strings.xml 内容为:


  1. <resources> 
  2.     <string name="string_merge">我是dev_string,我会把string合并</string> 
  3. </resources>  

当打 flavors_dev 渠道包时,最终 strings.xml 会变成:


  1. <resources> 
  2.     <string name="app_name">MultiChannel</string> 
  3.     <string name="string_merge">我是dev_string,我会把string合并</string> 
  4. </resources>  

以上特性可以用来替换 Apk 的应用名称和应用图标,这比使用前面讲到的占位符方便很多。同理,替换图片和合并颜色的原理也相似。

多渠道使用独立签名

多渠道打包的时候,可能每个渠道包的签名都必须不一样,真正做到定制化,那么,怎么实现每个渠道包使用指定的签名呢?

平时我们打包的时候是这样的:


  1. signingConfigs { 
  2.    release { 
  3.        storeFile file("签名文件路径"
  4.        storePassword "storePassword" 
  5.        keyAlias "keyAlias" 
  6.        keyPassword "keyPassword" 
  7.    } 
  8.  
  9.  
  10. buildTypes { 
  11.    release { 
  12.        minifyEnabled true 
  13.        proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro' 
  14.        shrinkResources true 
  15.        //指定打 release 包时使用的签名文件 
  16.        signingConfig signingConfigs.release 
  17.    } 
  18.  
  19.    //如果 debug 包需要测试诸如微信、地图等第三方 sdk ,则可以指定 debug 包使用 release 包的签名 
  20.    //debug { 
  21.    //    signingConfig signingConfigs.release 
  22.    //} 
  23.  

而给每个渠道包指定签名其实也差不多。

Google 官方原话:

This enables either having all release packages share the same SigningConfig, by setting android.buildTypes.release.signingConfig, or have each release package use their own SigningConfig by setting each android.productFlavors.*.signingConfig objects separately.

大意就是,在 buildType 下指定签名的具体属性,形如 android.productFlavors.*.signingConfig signingConfigs.* ,前一个 * 指代在 productFlavors 中定义的 flavor ,后一个 * 指代在 signingConfigs 定义的属性。值得注意的是,signingConfigs 必须定义在 buildType 之前。

以下是 build.gradle 的配置节选:


  1. //定义签名属性 
  2. signingConfigs { 
  3.    flavors_default { 
  4.        //如果签名文件在项目的根目录下,则可以这么写 
  5.        storeFile file("../littlejie.jks"
  6.        storePassword "******" 
  7.        keyAlias "******" 
  8.        keyPassword "*****" 
  9.    } 
  10.  
  11.    flavors_dev { 
  12.        storeFile file("../littlejie_dev.jks"
  13.        storePassword "*****" 
  14.        keyAlias "*****" 
  15.        keyPassword "*****" 
  16.    } 
  17.  
  18. buildTypes { 
  19.    release { 
  20.        minifyEnabled true 
  21.        proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro' 
  22.        shrinkResources true 
  23.  
  24.        //多个 flavor ,指定 flavor 使用指定 签名 
  25.        productFlavors.flavors_default.signingConfig signingConfigs.flavors_default 
  26.        productFlavors.flavors_dev.signingConfig signingConfigs.flavors_dev 
  27.    } 
  28.  
  29.    //如果 debug 包需要测试诸如微信、地图等第三方 sdk ,则可以指定 debug 包使用 release 包的签名 
  30.    //debug 并不能设置多个签名 
  31.    //debug { 
  32.    //   productFlavors.flavors_default.signingConfig signingConfigs.flavors_default 
  33.    //   productFlavors.flavors_dev.signingConfig signingConfigs.flavors_dev 
  34.    //} 
  35.  

下面我们来验证下生成的包的签名是否正确,查看签名我们会用到如下两个命令:


  1. //查看签名文件的属性 
  2. keytool -list -keystore 签名文件 
  3.  
  4. //查看 apk 的签名,需要提前解压 apk ,获取 CERT.RSA(位于解压目录下 /META-INF 下) 
  5. //以下命令行是在 apk 解压目录下执行 
  6. keytool -printcert -file META-INF/CERT.RSA  

更多 keytool 命令使用可以查看 官方文档

首先,我们来看下 littlejie.jks 的信息:


  1. lishengjiedeMacBook-Pro:AndroidDemo littlejie$ keytool -list -keystore littlejie.jks 
  2. 输入密钥库口令: 
  3.  
  4. 密钥库类型: JKS 
  5. 密钥库提供方: SUN 
  6.  
  7. 您的密钥库包含 1 个条目 
  8.  
  9. littlejie, 2016-9-18, PrivateKeyEntry, 
  10. 证书指纹 (SHA1): A2:B1:BF:BF:F1:F3:26:F4:FD:0C:94:95:B5:32:90:69:24:F7:99:84  

解压 multichannel-flavors_default-release.apk ,查看 CERT.RSA 信息


  1. lishengjiedeMacBook-Pro:apk littlejie$ keytool -printcert -file multichannel-flavors_default-release/META-INF/CERT.RSA 
  2. 所有者: CN=littlejie 
  3. 发布者: CN=littlejie 
  4. 序列号: 71693e05 
  5. 有效期开始日期: Sun Sep 18 17:20:34 CST 2016, 截止日期: Thu Sep 12 17:20:34 CST 2041 
  6. 证书指纹: 
  7.      MD5: AC:12:83:51:44:FC:82:68:8B:23:7B:E9:12:24:AE:52 
  8.      SHA1: A2:B1:BF:BF:F1:F3:26:F4:FD:0C:94:95:B5:32:90:69:24:F7:99:84 
  9.      SHA256: AD:04:19:5F:92:00:0D:FA:7C:E5:8A:12:57:72:4C:1E:0E:2E:FC:0D:92:28:05:D0:CC:42:FC:93:95:44:88:88 
  10.      签名算法名称: SHA256withRSA 
  11.      版本: 3  

可以发现两者的 SHA1 值是相等的。

同理,可以查看 littlejie_dev.jks 和 multichannel-flavors_dev-release.apk 的签名信息


  1. //littlejie_dev.jks 的签名信息 
  2. lishengjiedeMacBook-Pro:AndroidDemo littlejie$ keytool -list -keystore littlejie_dev.jks 
  3. 输入密钥库口令: 
  4.  
  5. 密钥库类型: JKS 
  6. 密钥库提供方: SUN 
  7.  
  8. 您的密钥库包含 1 个条目 
  9.  
  10. littlejie, 2016-9-18, PrivateKeyEntry, 
  11. 证书指纹 (SHA1): B4:25:67:A5:9F:8C:1F:12:BD:85:6B:2D:FE:71:62:57:8A:CC:AE:E2 
  12.  
  13. //multichannel-flavors_dev-release.apk 的签名信息 
  14. lishengjiedeMacBook-Pro:apk littlejie$ keytool -printcert -file multichannel-flavors_dev-release/META-INF/CERT.RSA 
  15. 所有者: CN=littlejie 
  16. 发布者: CN=littlejie 
  17. 序列号: 48346e15 
  18. 有效期开始日期: Sun Sep 18 17:21:23 CST 2016, 截止日期: Thu Sep 12 17:21:23 CST 2041 
  19. 证书指纹: 
  20.      MD5: 15:E9:E1:67:AB:33:8B:04:A4:C3:D0:05:8F:A6:35:37 
  21.      SHA1: B4:25:67:A5:9F:8C:1F:12:BD:85:6B:2D:FE:71:62:57:8A:CC:AE:E2 
  22.      SHA256: 96:A5:14:EC:28:25:32:0D:3E:D0:DB:D0:84:06:E7:9C:17:D7:91:83:A4:51:93:AB:34:3E:D9:FD:C5:FA:A1:8E 
  23.      签名算法名称: SHA256withRSA 
  24.      版本: 3  

但是这里有个问题,就是这种给某个 flavor 指定签名的方法对 debug 无效,有兴趣的同学可以看上述注释掉的 debug 签名部分配置。简单来说,debug 签名只能指定一个或者使用默认的 debug 签名。

若哪位大神有解决方案,欢迎指出~

这里再做几点补充:

1.多渠道使用独立签名,打包时千万不要使用 Android Studio 中 Build 菜单下的 Generate Signed APK,因为当你使用这个打包的时候, Android Studio 会让你指定使用的签名文件, so 你就等着哭吧~楼主因为这个折腾了半天。解决方法就是使用 gradle tasks。传送门:Android Gradle Build Tasks

2.鉴于第一点中的传送门,所以在这里简单介绍一下 Android Gradle Build Tasks 的使用。

  • 打全部包: gradle assemble
  • 打全部 Debug 包: gradle assembleDebug ,可以简写为 gradle aD ,前提是没有相同缩写的参数
  • 打全部 Release 包: gradle assembleRelease,可以简写为 gradle aR
  • 打指定 flavor 包: gradle assemble(flavor)(Debug|Release)
  • 打包完成后安装(设备上没有安装该 apk ,否则会失败,而且只能指定 flavor ,不然也会失败): gradle install(flavor)(Debug|Release)
  • 打包前先 clean 一下(在测试的时候很必要,如果不 clean 的话,可能会导致某些小修改不会及时打入新包): gradle clean assembleDebug

利用 Gradle 修改构建版本号

楼主表示对 Groovy 不是很熟,所以利用 Gradle 自动修改构建版本这个就先留着,我先去研究几天~

补充

有童鞋在评论中说:使用 productFlavors 打包效率太低,的确是这样, gradle 好用是好用,就是打包效率低。如果只是单纯生成渠道包,建议使用美团多渠道打包方案,另外 360 加固也是一种不错的选择,效率都比使用 gradle 来的高。但如果需要替换 Apk 中的图片、字符串、应用的 applicationId 、给指定渠道的包使用指定的签名,那么只能乖乖使用 gradle 打包了,慢你也得忍着~

之前刚开始调研的时候,发现 Github 上有个 ApkCustomizationTool 项目,它是通过对 Apk 解包,替换图片、字符串,然后重新签名,不过这毕竟是事后诸葛亮,控制在打包的源头总是毕竟好的,有兴趣的同学可以去研究下。

不知大家有没有这种感受,每次发版上传渠道的时候想死有没有?o(╯□╰)o

总结

以上就是自己在使用 Gradle 实现 Android 多渠道打包时碰到的问题, Android 官方关于使用 Gradle 的文档已经很详细了,自己总结的只是一点皮毛,有时间要去自习研读下。



作者:厉圣杰
来源:51CTO
【云栖快讯】阿里云栖开发者沙龙(Java技术专场)火热来袭!快来报名参与吧!  详情请点击

网友评论

玄学酱
文章23236篇 | 关注303
关注
用配置管理(Application Configuration Management,简称 ... 查看详情
移动测试(Mobile Testing)是为广大企业客户和移动开发者提供真机测试服务的云平台... 查看详情
业内领先的面向企业的一站式研发提效平台(研发效能),通过项目流程管理和专项自动化提效工具,能... 查看详情
为您提供简单高效、处理能力可弹性伸缩的计算服务,帮助您快速构建更稳定、安全的应用,提升运维效... 查看详情
双12

双12