編輯:關於Android編程
packer-ng-plugin是下一代Android渠道打包工具Gradle插件,支持極速打包,100個渠道包只需要10秒鐘,速度是gradle-packer-plugin的300倍以上,可方便的用於CI系統集成,支持自定義輸出目錄和最終APK文件名,依賴包:com.mcxiaoke.gradle:packer-ng:1.0.5簡短名:
packer,可以在項目的
build.gradle中指定使用,還提供了命令行獨立使用的Java和Python腳本。實現原理見本文末尾。
使用指南
Maven Central
修改項目根目錄的build.gradle
buildscript {
......
dependencies{
// add packer-ng
classpath 'com.mcxiaoke.gradle:packer-ng:1.0.5'
}
}
修改Android模塊的build.gradle
apply plugin: 'packer'
dependencies {
// add packer-helper
compile 'com.mcxiaoke.gradle:packer-helper:1.0.5'
}
注意:
packer-ng和
packer-helper的版本號需要保持一致
Java代碼中獲取當前渠道
提示:
PackerNg.getMarket(Context)內部緩存了結果,不會重復解析APK文件
// 如果沒有使用PackerNg打包添加渠道,默認返回的是""
// com.mcxiaoke.packer.helper.PackerNg
final String market = PackerNg.getMarket(Context)
// 或者使用 PackerNg.getMarket(Context,defaultValue)
// 之後就可以使用了,比如友盟可以這樣設置
AnalyticsConfig.setChannel(market)
渠道打包腳本
可以通過兩種方式指定
market屬性,根據需要選用:
打包時命令行使用-Pmarket= yourMarketFilePath指定屬性
在gradle.properties裡加入market=yourMarketFilePath
market是你的渠道名列表文件,market文件是基於項目根目錄的
相對路徑,假設你的項目位於
~/github/myapp你的market文件位於
~/github/myapp/config/markets.txt那麼參數應該是
-Pmarket=config/markets.txt,一般建議直接放在項目根目錄,如果market文件參數錯誤或者文件不存在會拋出異常。
渠道名列表文件是純文本文件,每行一個渠道號,列表解析的時候會自動忽略空白行和格式不規范的行,請注意看命令行輸出,渠道名和注釋之間用
#號分割開,可以沒有注釋,示例:
Google_Play#play store market
Gradle_Test#test
SomeMarket#some market
HelloWorld
渠道打包的Gradle命令行參數格式示例(在項目根目錄執行):
./gradlew -Pmarket=markets.txt clean apkRelease
打包完成後你可以在
${項目根目錄}/build/archives/目錄找到最終的渠道包。
任務說明
渠道打包的Gradle Task名字是
apk${buildType}buildType一般是release,也可以是你自己指定的beta或者someOtherType,使用時首字母需要大寫,例如release的渠道包任務名是
apkRelease,beta的渠道包任務名是
apkBeta,其它的以此類推。
注意事項
不支持
productFlavors中定義的條件編譯變量,不支持修改AndroidManifest
如果你的項目有多個
productFlavors,默認只會用第一個
flavor生成的APK文件作為打包工具的輸入參數,忽略其它
flavor生成的apk,代碼裡用的是
theVariant.outputs[0].outputFile。如果你想指定使用某個flavor來生成渠道包,可以用
apkFlavor1Release,
apkFlavor2Beta這樣的名字,示例(假設flavor名字是Intel):
./gradlew -Pmarket=markets.txt clean apkIntelRelease
插件配置說明(可選)
packer {
// 指定渠道打包輸出目錄
// archiveOutput = file(new File(project.rootProject.buildDir.path, "archives"))
// 指定渠道打包輸出文件名格式
// 默認是 `${appPkg}-${flavorName}-${buildType}-v${versionName}-${versionCode}`
// archiveNameFormat = ''
// 是否檢查Gradle配置中的signingConfig,默認不檢查
// checkSigningConfig = false
// 是否檢查Gradle配置中的zipAlignEnabled,默認不檢查
// checkZipAlign = false
}
舉例:假如你的App包名是
com.your.company,渠道名是
Google_Play,
buildType是
release,
versionName是
2.1.15,
versionCode是
200115,那麼生成的APK的文件名是
com.your.company-Google_Player-release-2.1.15-20015.apk
archiveOutput指定渠道打包輸出的APK存放目錄,默認位於
${項目根目錄}/build/archives
archiveNameFormat-Groovy格式字符串, 指定渠道打包輸出的APK文件名格式,默認文件名格式是:${appPkg}-${flavorName}-${buildType}-v${versionName}-${versionCode},可使用以下變量:
projectName- 項目名字
appName- App模塊名字
appPkg-applicationId(App包名packageName)
buildType-buildType(release/debug/beta等)
flavorName-flavorName(對應渠道打包中的渠道名字)
versionName-versionName(顯示用的版本號)
versionCode-versionCode(內部版本號)
buildTime-buildTime(編譯構建日期時間)
fileMD5-fileMD5(最終APK文件的MD5哈希值) (v1.0.5新增)
fileSHA1-fileSHA1(最終APK文件的SHA1哈希值) (v1.0.5新增)
命令行打包腳本
如果不想使用Gradle插件,這裡還有兩個命令行打包腳本,在項目的
tools目錄裡,分別是
ngpacker-x.x.x-capsule.jar和
ngpacker.py,使用命令行打包工具,在Java代碼裡仍然是使用
packer-helper包裡的
PackerNg.getMarket(Context)讀取渠道
Java腳本
java -jar ngpacker-x.x.x-capsule.jar release_apk_file market_file
// help: java -jar packer-ng-x.x.x-capsule.jar
Python腳本
python ngpacker.py [file] [market] [output] [-h] [-s] [-t TEST]
// help: python packer-ng.py -h
// python; import ngpacker; help(ngpacker)
不使用Gradle
使用命令行打包腳本,不想添加Gradle依賴的,可以完全忽略Gradle的配置,直接復制PackerNg.java到項目中使用即可
實現原理
PackerNg原理
優點
使用APK注釋字段保存渠道信息和MAGIC字節,從文件末尾讀取渠道信息,速度快
實現為一個Gradle Plugin,支持定制輸出APK的文件名等信息,方便CI集成
提供Java版和Python的獨立命令行腳本,不依賴Gradle插件,支持獨立使用
由於打包速度極快,單個包只需要5毫秒左右,可用於網站後台動態生成渠道包
缺點
沒有使用Android的productFlavors,無法利用flavors條件編譯的功能
文件格式
Android應用使用的APK文件就是一個帶簽名信息的ZIP文件,根據ZIP文件格式規范,每個ZIP文件的最後都必須有一個叫Central Directory Record的部分,這個CDR的最後部分叫"end of central directory record",這一部分包含一些元數據,它的末尾是ZIP文件的注釋。注釋包含Comment Length和File Comment兩個字段,前者表示注釋內容的長度,後者是注釋的內容,正確修改這一部分不會對ZIP文件造成破壞,利用這個字段,我們可以添加一些自定義的數據,PackerNg項目就是在這裡添加和讀取渠道信息。
細節處理
原理很簡單,就是將渠道信息存放在APK文件的注釋字段中,但是實現起來遇到不少坑,測試了好多次。
ZipOutputStream.setComment
FileOutputStream is = new FileOutputStream("demo.apk", true);
ZipOutputStream zos = new ZipOutputStream(is);
zos.setComment("Google_Market");
zos.finish();
zos.close();
ZipFile zipFile=new ZipFile("demo.apk");
System.out.println(zipFile.getComment());
使用Java寫入APK文件注釋雖然可以正常讀取,但是安裝的時候會失敗,錯誤信息是:
adb install -r demo.apk
Failure [INSTALL_FAILED_INVALID_APK]
原因未知,可能Java的Zip實現寫入了某些特殊字符導致APK文件校驗失敗,於是只能放棄這個方法。同樣的功能使用Python測試完全沒有問題,處理後的APK可以正常安裝。
ZipFile.getComment
上面是ZIP文件注釋寫入,使用Java會導致APK文件被破壞,無法安裝。這裡是讀取ZIP文件注釋的問題,Java 7裡可以使用
zipFile.getComment()方法直接讀取注釋,非常方便。但是Android系統直到API 19,也就是4.4以上的版本才支持
ZipFile.getComment()
方法。由於要兼容之前的版本,所以這個方法也不能使用。
解決方法
由於使用Java直接寫入和讀取ZIP文件的注釋都不可行,使用Python又不方便與Gradle系統集成,所以只能自己實現注釋的寫入和讀取。實現起來也不復雜,就是為了提高性能,避免讀取整個文件,需要在注釋的最後加入幾個MAGIC字節,這樣從文件的最後開始,讀取很少的幾個字節就可以定位渠道名的位置。
幾個常量定義:
// ZIP文件的注釋最長65535個字節
static final int ZIP_COMMENT_MAX_LENGTH = 65535;
// ZIP文件注釋長度字段的字節數
static final int SHORT_LENGTH = 2;
// 文件最後用於定位的MAGIC字節
static final byte[] MAGIC = new byte[]{0x21, 0x5a, 0x58, 0x4b, 0x21}; //!ZXK!
讀寫注釋
Java版詳細的實現見PackerNg.java,Python版的實現見ngpacker.py。
寫入ZIP文件注釋:
public static void writeZipComment(File file, String comment)
throws IOException {
byte[] data = comment.getBytes(UTF_8);
final RandomAccessFile raf = new RandomAccessFile(file, "rw");
raf.seek(file.length() - SHORT_LENGTH);
// write zip comment length
// (content field length + length field length + magic field length)
writeShort(data.length + SHORT_LENGTH + MAGIC.length, raf);
// write content
writeBytes(data, raf);
// write content length
writeShort(data.length, raf);
// write magic bytes
writeBytes(MAGIC, raf);
raf.close();
}
讀取ZIP文件注釋,有兩個版本的實現,這裡使用的是
RandomAccessFile,另一個版本使用的是
MappedByteBuffer,經過測試,對於特別長的注釋,使用內存映射文件讀取性能要稍微好一些,對於特別短的注釋(比如渠道名),這個版本反而更快一些。
public static String readZipComment(File file) throws IOException {
RandomAccessFile raf = null;
try {
raf = new RandomAccessFile(file, "r");
long index = raf.length();
byte[] buffer = new byte[MAGIC.length];
index -= MAGIC.length;
// read magic bytes
raf.seek(index);
raf.readFully(buffer);
// if magic bytes matched
if (isMagicMatched(buffer)) {
index -= SHORT_LENGTH;
raf.seek(index);
// read content length field
int length = readShort(raf);
if (length > 0) {
index -= length;
raf.seek(index);
// read content bytes
byte[] bytesComment = new byte[length];
raf.readFully(bytesComment);
return new String(bytesComment, UTF_8);
}
}
} finally {
if (raf != null) {
raf.close();
}
}
return null;
}
讀取APK文件,由於這個庫
packer-helper需要同時給Gradle插件和Android項目使用,所以不能添加Android相關的依賴,但是又需要讀取自身APK文件的路徑,使用反射實現:
// for android code
private static String getSourceDir(final Object context)
throws ClassNotFoundException,
InvocationTargetException,
IllegalAccessException,
NoSuchFieldException,
NoSuchMethodException {
final Class contextClass = Class.forName("android.content.Context");
final Class applicationInfoClass = Class.forName("android.content.pm.ApplicationInfo");
final Method getApplicationInfoMethod = contextClass.getMethod("getApplicationInfo");
final Object appInfo = getApplicationInfoMethod.invoke(context);
final Field sourceDirField = applicationInfoClass.getField("sourceDir");
return (String) sourceDirField.get(appInfo);
}
Gradle Plugin
這個和舊版插件基本一致,首先是讀取渠道列表文件,保存起來,打包的時候遍歷列表,復制生成的APK文件到臨時文件,給臨時文件寫入渠道信息,然後復制到輸出目錄,文件名可以使用模板定制。主要代碼如下:
// 添加打包用的TASK
def archiveTask = project.task("apk${variant.name.capitalize()}",
type: ArchiveAllApkTask) {
theVariant = variant
theExtension = modifierExtension
theMarkets = markets
dependsOn variant.assemble
}
def buildTypeName = variant.buildType.name
if (variant.name != buildTypeName) {
project.task("apk${buildTypeName.capitalize()}", dependsOn: archiveTask)
}
// 遍歷列表修改APK文件
theMarkets.each { String market ->
String apkName = buildApkName(theVariant, market)
File tempFile = new File(tempDir, apkName)
File finalFile = new File(outputDir, apkName)
tempFile << originalFile.bytes
copyTo(originalFile, tempFile)
PackerNg.Helper.writeMarket(tempFile, market)
if (PackerNg.Helper.verifyMarket(tempFile, market)) {
copyTo(tempFile, finalFile)
}
}
詳細的實現可以查看文件PackerNgPlugin.groovy和文件ArchiveAllApkTask.groovy
同類工具
gradle-packer-plugin- 舊版渠道打包工具,完全使用Gradle系統實現,能利用Android提供的productFlavors系統的條件編譯功能,無任何兼容性問題,方便集成,但是由於每次都要重新打包,速度比較慢,不適合需要大量打包的情況。(性能:200個渠道包需要一到兩小時)
前言: 關於Android中的動畫吧,從我一開始接觸Android的時候,就陸陸續續的接觸過,不得不說,動畫在Android應用中應用的還是很多的,熟悉掌握了動畫,也可以
一、 I2C簡介 I2C(Inter-Integrated Circuit)總線是一種由 Philips 公司開發的兩線式串行總線,用於連接微控制器及其外圍設備。I2
了解了基本的自定義view基礎後,現在我們就來實踐下自定義view,也是看到我華為手機上自帶的天氣預報軟件後,想著模仿做一個,於是,我自己嘗試了下,雖然不算太像,但是還算
當下很多手機應用都會有一個非常類似的功能,即屏幕的下方顯示一行Tab標簽選項,點擊不同的標簽就可以切換到不同的界面,如以下幾個應用所示:以上底部這四個標簽,每一個分別對應