APP在正式上線前,會在測試環境進行一系列的業務功能測試,而開發人員應該要提供一個測試環境的apk給測試人員,在測試人員完整測試完畢后,開發人員又去修改參數,調整為正式環境后,再進行打包。
有人會問,這不很簡單嗎?全局有一個管理環境變量的類,打包前去修改這個類的內容就好啦。當然,這沒有錯,但是,如果兩個環境下不僅僅是一個請求接口URL的差異呢?如果包含了各種第三方SDK(極光推送,友盟統計等)的key等信息,切換環境就會特別麻煩,而且需要非常地謹慎,一旦有一個key錯了,那問題就嚴重了。為了避免每次打包都要進行這樣繁瑣的操作,我們可以利用gradle的特性,將常量存放在BuildConfig中,能夠優雅地區分測試環境和正式環境。
環境的變量BuildConfig
請求的URL,第三方SDK的密鑰等信息,一般會作為靜態變量,存放于一個所謂的Constants類里面,需要引用的時候直接調用這個類即可。但是就像文章開頭所說的,變量太多的時候,修改起來就會比較麻煩。我們可以利用一個叫BuildConfig的類,這個類會在APP編譯時生成,我們經常利用BuildConfig.DEBUG==true來識別當前是否為調試環境。根據這個思路,那么有沒有辦法將我們的URL,密鑰等信息存放于BuildConfig呢?利用gradle的特性,即可實現。
buildTypes
在app module 的build.gradle中修改buildTypes節點:分別對應debug調試環境、areaTest測試環境、release正式環境,debug環境可與devTest環境配置一致。
applicationIdSuffix
在debug或者測試環境下設置applicationIdSuffix,即可更改APP的包名,以下代碼會自動將當前包名更改為默認的包名后加上.test
debug{
applicationIdSuffix:".test"
}
it.buildConfigField
如下面的代碼塊,it.buildConfigField 主要用來配置BuildConfig的靜態變量,寫入成功后通過BuildConfig調用,那么在三個環境內配置不同的變量屬性即可區分三個環境。
manifestPlaceholders
AndroidManifest文件下的占位標識
AndroidManifest下的節點設置屬性=${PAKAGE_NAME},
<meta-data
android:name="UMENG_CHANNEL"
android:value="${PAKAGE_NAME}"
/>
那么在manifestPlaceholders配置對應字段即可
manifestPlaceholders = [ PAKAGE_NAME:"com.***.sample"]
在編譯打包的過程中,會將AndroidManifest的占位標識自動替換。對于一些sdk只能在AndroidManifest去設置key的情況,那么這種方式就可以用于區分各個環境了。
buildTypes {
release {
it.buildConfigField 'String', 'BASE_URL', "\"http://sample.com:8080/\"";
it.buildConfigField 'String', 'API_URL', "\"dlpmobile/mobile/\"";
it.buildConfigField 'String', 'UPLOAD_FILE_URL', "\"dlpfilesystem/utils/imageService/\"";
it.buildConfigField 'String', 'E_CMS_URL', "\"dlpecms/ecms/\""; it.buildConfigField 'String', 'JPUSH_APPKEY',"\"adadasd\"";
it.buildConfigField 'String', 'MIPUSH_APPKEY',"\"2123\"";
it.buildConfigField 'String', 'MIPUSH_APP_ID',"\"312312\"";
it.buildConfigField 'String', 'BUGLY_APP_ID',"\"312312\"";
manifestPlaceholders = [
APP_NAME:"測試用例",
PAKAGE_NAME:"****.sample",
JPUSH_PERMISSION:"***.sample.permission.JPUSH_MESSAGE",
MIPUSH_PERMISSION:"***.sample.permission.MIPUSH_RECEIVE",
UMENG_CHANNEL: "sample",
JPUSH_PKGNAME: "***.sample",
JPUSH_APPKEY : "adads21312", //JPush上注冊的包名對應的appkey.
JPUSH_CHANNEL: "tencent" //用戶渠道統計的渠道名稱
] signingConfig signingConfigs.config minifyEnabled false proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro' }
debug {
applicationIdSuffix ".test"
it.buildConfigField 'String', 'BASE_URL', "\"http://172.16.17.152:8080/\"";
it.buildConfigField 'String', 'API_URL', "\"dlpmobile/mobile/\"";
it.buildConfigField 'String', 'UPLOAD_FILE_URL', "\"dlpfilesystem/utils/imageService/\"";
it.buildConfigField 'String', 'E_CMS_URL', "\"dlpecms/ecms/\"";
it.buildConfigField 'String', 'JPUSH_APPKEY',"\"adasdasd\"";
it.buildConfigField 'String', 'MIPUSH_APPKEY',"\"dadasd\"";
it.buildConfigField 'String', 'MIPUSH_APP_ID',"\"dasdasd\"";
it.buildConfigField 'String', 'BUGLY_APP_ID',"\"dasdasd\"";
manifestPlaceholders = [
APP_NAME:"sample測試版",
PAKAGE_NAME:"****.sample.test",
JPUSH_PERMISSION:"****.dlp.sample.test.permission.JPUSH_MESSAGE",
MIPUSH_PERMISSION:"****.dlp.sample.test.permission.MIPUSH_RECEIVE",
UMENG_CHANNEL: "sample",
JPUSH_PKGNAME: "****.sample.test",
JPUSH_APPKEY : "dasdasdasd", //JPush上注冊的包名對應的appkey.
JPUSH_CHANNEL: "tencent" //用戶渠道統計的渠道名稱
] }
devTest{ applicationIdSuffix ".test"
it.buildConfigField 'String', 'BASE_URL', "\"http://172.16.17.152:8080/\"";
it.buildConfigField 'String', 'API_URL', "\"dlpmobile/mobile/\"";
it.buildConfigField 'String', 'UPLOAD_FILE_URL', "\"dlpfilesystem/utils/imageService/\"";
it.buildConfigField 'String', 'E_CMS_URL', "\"dlpecms/ecms/\"";
it.buildConfigField 'String', 'JPUSH_APPKEY',"\"dadasdasd\"";
it.buildConfigField 'String', 'MIPUSH_APPKEY',"\"dasdadasd\"";
it.buildConfigField 'String', 'MIPUSH_APP_ID',"\"dasdasd\"";
it.buildConfigField 'String', 'BUGLY_APP_ID',"\"dadasd\"";
manifestPlaceholders = [
APP_NAME:"sample測試版",
PAKAGE_NAME:"****.sample.test",
JPUSH_PERMISSION:"****.sample.test.permission.JPUSH_MESSAGE",
MIPUSH_PERMISSION:"****.sample.test.permission.MIPUSH_RECEIVE",
UMENG_CHANNEL: "sample",
JPUSH_PKGNAME: "****.sample.test",
JPUSH_APPKEY : "dasdasdasd", //JPush上注冊的包名對應的appkey.
JPUSH_CHANNEL: "tencent" //用戶渠道統計的渠道名稱
] signingConfig signingConfigs.config minifyEnabled false }}
打包
發布正式環境時,選擇release編譯打包即可,測試環境則選擇devTest