多渠道打包

环境

OSX
AndroidStudio 1.0

多渠道设置

渠道号

以友盟SDK为例,打包多渠道:GooglePlay小米友盟360豌豆荚应用宝
AndroidManifest.xml中加入渠道区分标识

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

然后在build.gradle(Module: app)中加入渠道打包替换对应的UMENG_CHANNEL_VALUE代码

// 渠道Flavors,配置不同的渠道
    productFlavors {
        GooglePlay {}
        xiaomi {}
        umeng {}
        qihu360 {}
        wandoujia {}
        yingyongbao {}
        //其他...
    }

    // 批量配置渠道
    productFlavors.all {
        flavor -> flavor.manifestPlaceholders = [UMENG_CHANNEL_VALUE: name]
    }

apk名字

我们还可以指定不同渠道号生成的apk的名字,这样方便打包出来区别哪个apk是对应哪个渠道的。以下的例子生成的命名格式 app_v(版本号)_打包时间_渠道号.apk

android{

        applicationVariants.all { variant ->
            variant.outputs.each { output ->
                def outputFile = output.outputFile
                if (outputFile != null && outputFile.name.endsWith('.apk')) {
                    File outputDirectory = new File(outputFile.parent);
                    def fileName
                    if (variant.buildType.name == "release") {
                        fileName = "app_v${defaultConfig.versionName}_${packageTime()}_${variant.productFlavors[0].name}.apk"
                    } else {
                        fileName = "app_v${defaultConfig.versionName}_${packageTime()}_beta.apk"
                    }
                    output.outputFile = new File(outputDirectory, fileName)
                }
            }
        }

    }

打包

签名文件

生成签名文件可用命令行生成,也可以直接用AndroidStudio的Build -> Generate signed apk -> create new 生成新证书即可。然后为了方便,这里我把证书放到 项目 -> app 目录下。

签名配置

gradle支持直接签名打包,只需要设置一下证书的路径和对应密码一键打包出正式可以发布的apk。
signingConfigs里面写上对应的storeFilestorePasswordkeyAliaskeyPassword
一般地,为了保护签名文件,这些信息不应该写入到版本库中,我这里把它们写在local.properties中然后在版本库中排除这个文件。
//获取local.properties的内容

//这里是读取local.properties文件,提供给下方代码用来提取keystroe_storeFile等key的值
Properties properties = new Properties()
properties.load(project.rootProject.file('local.properties').newDataInputStream())
signingConfigs {

        release {
            // relase签名
            storeFile file(properties.getProperty("keystroe_storeFile"))
            storePassword properties.getProperty("keystroe_storePassword")
            keyAlias properties.getProperty("keystroe_keyAlias")
            keyPassword properties.getProperty("keystroe_keyPassword")
        }
    }

local.properties文件中加入

keystroe_storeFile=keystore.jks  //对应自己实际的证书路径和名字,因为我上面提到 把证书放在 项目的app目录下,所以不用写绝对路径。
keystroe_storePassword=123456
keystroe_keyAlias=alias
keystroe_keyPassword=123456

打包apk

在终端窗口,或者可以使用AndroidStudio工具栏下面提供的终端 Terminal ,cd 到 项目根目录下执行:

// 打包出上面所有渠道apk
./gradlew build
// 下面这行例子是单独打包wandoujia渠道的apk
// ./gradlew assembleWandoujia

对应渠道的apk就会自动在 项目/app/build/outputs/apk/ 目录下按照上面指定的命名格式生成了。

产品定制

ApplicationId,版本号

Android 应用都有自己的包名。包名是设备上每个应用程序的唯一标识,同样也是在各个下载平台的唯一标识。就是说,假如你已经使用某个包名来发布应用,就不能再去改变应用的包名,因为这样做会导致你的应用被视为一个全新的应用,你现有的用户也不会收到应用的更新通知。
有时候我们需要发布不同的版本,例如 prohd 版本,支持用户可以下载安装不同的版本。那么我们需要设置不同的ApplicationId和对应的版本号, 同时要与 PackageName 解耦合。

  • 代码中引用的 R 类要保持不变;

  • 在构建不同版本的应用时,对应的(引用了 R 的) .java 源文件也不能改动。

那么我们只需要在productFlavors对应的渠道中指定applicationIdversionCode,versionName,例我们指定GooglePlayapplicationId

productFlavors {
        GooglePlay {
            //指定这个渠道的版本号
            versionCode 2
            versionName "2.0"
            //指定区别于其他渠道的 applicationId
            applicationId "com.bigkoo.gradledemo.hd"
        }
        xiaomi {}
        umeng {}
        qihu360 {}
        wandoujia {}
        yingyongbao {}
        //其他...
    }

BuildConfig

Gradle会在generateSources阶段为flavor生成一个BuildConfig.java文件。BuildConfig类默认提供了一些常量字段,比如应用的版本名(VERSION_NAME),应用的包名(PACKAGE_NAME)等。更强大的是,开发者还可以添加自定义的一些字段。下面的示例假设debug版开启LOG功能,使用test的api,而发布版则使用不开启LOG和使用发布时的api

buildTypes {
        debug {
            // debug模式下,显示log
            buildConfigField("boolean", "LOG_DEBUG", "true")
            buildConfigField ("String", "API_HOST", "\"http://api.test.com\"")//API Host
        }
        release {
            // release模式下,不显示log
            buildConfigField("boolean", "LOG_DEBUG", "false")
            buildConfigField("String", "API_HOST", "\"http://api.release.com\"")//API Host
        }
    }

那么代码中就可以使用 BuildConfig.LOG_DEBUG 和 BuildConfig.API_HOST 了。
甚至可以在productFlavors对应的渠道号进行区别,例如豌豆荚版默认禁止版本自动更新:

android {
    defaultConfig {
        buildConfigField "boolean", "AUTO_UPDATES", "true"
    }

    productFlavors {
        wandoujia {
            buildConfigField "boolean", "AUTO_UPDATES", "false"
        }        
    }

}

资源

通常对于不同渠道,我们会区别不同的资源。例如我们一款应用需要在360发布,而应用图标和欢迎界面要一个360标志的图,那么这个时候就需要按渠道打包对应的应用图标和欢迎图片了。Gradle在构建应用时,会优先使用flavor所属dataSet中的同名资源。所以,在flavordataSet中添加同名的字符串资源,以覆盖默认的资源。
上面我们已经有针对360的渠道了,就是qihu360,我们只需要在 app/src/ 目录下添加渠道对应的文件夹qihu360,然后覆盖对应要覆盖的内容。下面是定制应用图标的步骤:

  • 添加qihu360文件夹,那么在 app/src/ 目录下面就有 main , androidTest , qihu360 这三个文件夹了。main 目录是通用正常渠道包目录,qihu360是我们需要定制资源的渠道包目录。

  • 仿main的目录,添加 res/drawable/ic_launcher.png 图片以覆盖对应在 main里面的res/drawable/ic_launcher.png

通过以上例子,举一反三。定制其他资源,包括strings.xmlstyles.xml 甚至AndroidManifest.xml 也都是可以的。

第三方库

有些渠道需要加入广告,应用墙推荐,而有些则不上广告,我们常常也会遇到这样的问题吧。那么现在来说说怎么对于第三方库进行渠道区分打包。
这里以我的开源项目 为例,其他库或广告SDK同理:

dependencies {
    compile fileTree(dir: 'libs', include: ['*.jar'])
    compile 'com.android.support:appcompat-v7:21.0.3'
    //参与编译but不参与打包
    provided 'com.bigkoo:alertview:1.0.1'
    //指定qihu360这个渠道可以打包这个库
    qihu360Compile 'com.bigkoo:alertview:1.0.1'
}

然后在代码中进行反射判断是否有这个库存在,如果有就使用,没有就不使用。(或者用上面提及的BuildConfig方式设置一个渠道常量来判断也可以

public class MainActivity extends Activity {

    private boolean useAlertView;
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        try {
            Class.forName("com.bigkoo.alertview.AlertView");
            useAlertView = true;
        } catch (ClassNotFoundException ignored) {

        }
    }

    public void showAlertView(View view) {
        if(useAlertView) {
            new AlertView("标题", "内容", null, new String[]{"确定"}, null, this, AlertView.Style.Alert, null).show();
        }
    }
}

总结

常用的多渠道打包方式已经介绍完了,基本能满足日常大部分多渠道打包开发使用。如果你想更深入了解,请看Groovy,自己来定制一些任务。

本文参考

Gradle
美团Android自动化之旅—适配渠道包
安卓集成发布详解(二)

源码

本文例子的源码放在我的Github上了,地址:GradleDemo (PS:例子为了提供完整的演示,没有在.gitigonore里面加入 /local.properties 排除,实际是要加入的,另外签名文件也一并附上了,也实际是需要排除的。)

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 203,547评论 6 477
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 85,399评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 150,428评论 0 337
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,599评论 1 274
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,612评论 5 365
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,577评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,941评论 3 395
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,603评论 0 258
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,852评论 1 297
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,605评论 2 321
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,693评论 1 329
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,375评论 4 318
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,955评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,936评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,172评论 1 259
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 43,970评论 2 349
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,414评论 2 342

推荐阅读更多精彩内容