Android通过gradle 配置release与debug版本

前言

在项目中配置release和debug环境还是很有必要的,可以随时打包线下和线上的版本并且在一部手机上同时开发线下app,又可以体验观察线上app的情况。

当然,配置的主要思路都是一样的,但是具体细节可以有很多不同,文章只是按照思路实现,具体的细节有很多可以根据自己的喜好来配置,都是可以的。
(1)在project项目结构视图中,根目录下创建一个config.gradle文件,用来配置一些项目公共的参数,这样其他部分直接引用就好,其实这部分完全可以在project的build.gradle里去配置或者project的gradle.properties等这些项目级别的都可以。

config.gradle文件内容:

ext{
    url = [
            "debug":"https://......",
            "release":"https://......"
    ]
}

这里我们只设置线上线下服务器接口地址的变化部分(一般为服务器地址),当然可以设置很多公共的参数,比如版本号,相关sdk版本号,但是这里我们以实现配置release和debug两种版本app为目标。

(2)在project的build.gradle引用config.build(所以说可以直接定义在project的build.gradle这里面)
apply from: "config.gradle"

这段代码写在最外层就ok,不影响文件的其他部分内容。

(3)在工程moudle的build.gradle中正式配置
android {
    compileSdkVersion 27
    defaultConfig {
        applicationId "com.dhasa.fun"
        minSdkVersion 19
        targetSdkVersion 27
        versionCode 2
        versionName "1.0"
        testInstrumentationRunner "android.support.test.runner.AndroidJUnitRunner"
        sourceSets.main {
            jniLibs.srcDirs = ['libs']
        }
    }
    signingConfigs {
        release {
            keyAlias RELEASE_KEY_ALIAS
            keyPassword RELEASE_KEY_PASSWORD
            storeFile file('C:/appsign/abc.jks')
            storePassword RELEASE_KEYSTORE_PASSWORD
        }
        debug {
            keyAlias DEBUG_KEY_ALIAS
            keyPassword DEBUG_KEY_PASSWORD
            storeFile file('C:/appsign/debugabc.jks')
            storePassword DEBUG_KEYSTORE_PASSWORD
        }
    }

    buildTypes {
        release {
            buildConfigField "String", "HostUrl", "\"${url["release"]}\""
            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
            signingConfig signingConfigs.release
            android.applicationVariants.all { variant ->
                variant.outputs.all {
                    outputFileName = "easymeetingmanager_v${defaultConfig.versionName}.apk"
                }
            }
            manifestPlaceholders = [
                    //这里也是在AndroidManifest.xml中配置的app图标,同样在这里写了了不同的资源文件,从而实现了动态配置
                    app_icon: "@mipmap/logo",
                    app_name: "@string/app_name_release"
            ]
        }
        debug {
            applicationIdSuffix '.debug'
            signingConfig signingConfigs.debug
            buildConfigField "String", "HostUrl", "\"${url["debug"]}\""
            manifestPlaceholders = [
                    //这里也是在AndroidManifest.xml中配置的app图标,同样在这里写了了不同的资源文件,从而实现了动态配置
                    app_icon: "@mipmap/logo_debug",
                    app_name: "@string/app_name_debug"
            ]
        }
    }
}

1、defaultConfig中是一些默认的配置,无论是release还是debug都会执行的部分,其中包名applicationId还有版本号这些都可以配置到其他部分引入进来。
2、signingConfigs翻译过来签名配置,分为release和debug两部分,签名需要使用不同的签名,可以看到这部分很明显是其他文件声明好的,这里我写在了gradle.properties文件中,这些值都是生成签名文件时随便定义的:

DEBUG_KEY_ALIAS=debuga
DEBUG_KEYSTORE_PASSWORD=debugmeet
DEBUG_KEY_PASSWORD=debugmeet
RELEASE_KEY_ALIAS=abcxy
RELEASE_KEYSTORE_PASSWORD=zwxy
RELEASE_KEY_PASSWORD=sss

3、buildTypes中同样分成了release和debug两部分,其中根据版本引用了不同的服务器地址,不同的签名,混淆配置文件,是否压缩,是否去除无用资源文件等等,其中:

  • buildConfigField是会在BuildConfig文件(这个文件在app->build->generated->source->buildConfig->包名->BuildConfig)中生成一个对应类型的变量,并且将设置好的值付给它(我们还经常通过里面的布尔值DEBUG来判断是否输出日志),因为是在编译期完成,java代码中就可以这样来引用:
public static final String COMMON_URL = BuildConfig.HostUrl;

当然这也是在公共文件中声明的,可以在任何代码处使用。

  • manifestPlaceholders,这个里面根据名字可以看到是可以和Manifest文件关联起来的,上面代码我们设置了不同版本app的图标,AndroidManifest中其他的需要动态配置变量也可以通过对manifestPlaceholders数组配置相应的键值对来实现,但是这篇忽略这个不讲了。看一下在Manifest文件中的使用情况(这样一来开发版本和线上版本从图标和名字上都可以区分了,这主要是帮助使用者清楚的区分):
<application
        android:allowBackup="true"
        android:icon="${app_icon}"
        android:label="${app_name}"
        android:supportsRtl="true"
        android:theme="@style/AppTheme">
        ......
</application>
  • applicationIdSuffix ‘.debug’,注意buildTypes下debug中的这行代码,可以看出是在之前applicaionId后面加个字符串,这样才能打成两个包名,而这也是在同一部手机上同时运行开发版本和正式版本的关键
(4)也许设置完这些后应该就可以打包出两个app了,这时候要注意了,还是可能存在问题,因为你的applicationId为了app能在同一部手机上同时运行,两种打包出来的名字是不同的,如果你在app中用到了applicationId的部分同样需要动态替换,比如android7.0访问文件时需要provider

在AndroidManifest.xml中:

<provider
            android:name="android.support.v4.content.FileProvider"
            android:authorities="${applicationId}.fileprovider"
            android:exported="false"
            android:grantUriPermissions="true">
            <meta-data
                android:name="android.support.FILE_PROVIDER_PATHS"
                android:resource="@xml/file_paths" />
</provider>

在java代码中:

public static final String PROVIDER_FILE = BuildConfig.APPLICATION_ID+".fileprovider";

这样就ok了

(5)下面我们通过AS左下角的Build Variants 中app的release和deubug 打两个包到手机上看一下效果(切换到目标版本点运行按钮即可),如下图:

《Android通过gradle 配置release与debug版本》 切换debug和release版本.png

END
点赞