一、搭建搭建环境
1. 安装JDK 和 Android SDK
2. 配置环境变量
D:\android-sdk-windows\tools
C:\Program Files\Java\jdk1.6.0_20\bin
3. 例子信息
项目目录:D:\ProjectDemo
SDK目录 :D:\android-sdk-windows\platforms\android-8\
二、命令行编译Android项目
D:\android-sdk-windows\tools
C:\Program Files\Java\jdk1.6.0_20\bin
3. 例子信息
项目目录:D:\ProjectDemo
SDK目录 :D:\android-sdk-windows\platforms\android-8\
二、命令行编译Android项目
1. 生成R文件
2. Java代码生成class文件
3. class文件生成dex文件
4. 打包资源
5. 生成apk
6. 创建密匙
7. 签名apk
1. aapt命令, 生成R文件
-f 如果编译生成的文件已经存在,强制覆盖。
-m 使生成的包的目录存放在-J参数指定的目录
-J 指定生成的R.java 的输出目录路径
-S 指定res文件夹的路径
- > aapt package -f -m -J ./gen -S res -M AndroidManifest.xml -I D:\android.jar
-m 使生成的包的目录存放在-J参数指定的目录
-J 指定生成的R.java 的输出目录路径
-S 指定res文件夹的路径
-I 指定某个版本平台的android.jar文件的路径
-A 指定assert文件夹的路径
2. javac命令,生成class文件
- > javac -target 1.5 -bootclasspath D:\android-sdk-windows\platforms\android-8\android.jar -d bin src\demo\project\*.java gen\demo\project\R.java
-bootclasspath <路径> 覆盖引导类文件的位置
-d <目录> 指定存放生成的类文件的位置
-sourcepath <路径> 指定查找输入源文件的位置
3. dx 命令,把class文件转换为.dex文件
- > dx --dex --output=D:\ProjectDemo\bin\classes.dex D:\ProjectDemo\bin
4. aapt命令,打包资源
- > aapt package -f -M AndroidManifest.xml -S res -I D:\android-sdk-windows\platforms\android-8\android.jar -F bin\resources.ap_
-M 指定AndroidManifest.xml的路径
-S 指定res文件夹路径
-I 指定某个版本平台的android.jar的路径
-F 指定输出文件完整路径
5. apkbuilder命令,生成apk
- apkbuilder D:\ProjectDemo\bin\projectdemo.apk -v -u -z D:\ProjectDemo\bin\resources.ap_ -f D:\ProjectDemo\bin\classes.dex -rf D:\ProjectDemo\src
-u 创建一个无签名的包
-z 指定apk资源路径
-f 指定dex文件路径
-rf 指定源码路径
6. 创建密钥
-genkey 在用户主目录中创建一个默认文件".keystore",还会产生一个mykey的别名,mykey中包含用户的公钥、私钥和证书
-alias 产生别名
-keyalg 指定密钥的算法
-validity 指定创建的证书有效期多少天
-keystore 指定密钥库的名称(产生的各类信息将不在.keystore文件中)
7. 签名
-verbose 签名/验证时输出详细信息
-keystore 密钥库位置
-storepass 用于密钥库完整性的口令
-keypass 专用密钥的口令(如果不同)
-signedjar 已签名的 JAR 文件的名称 (第一个apk是签名之后的文件, 第二个apk是需要签名的文件)
- >keytool -genkey -alias release -keyalg RSA -validity 20000 -keystore release.keystore
-alias 产生别名
-keyalg 指定密钥的算法
-validity 指定创建的证书有效期多少天
-keystore 指定密钥库的名称(产生的各类信息将不在.keystore文件中)
7. 签名
- jarsigner -verbose -keystore C:\Users\UserName\Desktop\build\release.keystore -storepass antPassword -keypass antPassword -signedjar D:\ProjectDemo\bin\projectdemo-signed.apk D:\ProjectDemo\bin\projectdemo.apk release
-keystore 密钥库位置
-storepass 用于密钥库完整性的口令
-keypass 专用密钥的口令(如果不同)
-signedjar 已签名的 JAR 文件的名称 (第一个apk是签名之后的文件, 第二个apk是需要签名的文件)
参考资料:
Android系列之Android 命令行手动编译打包详解
上次使用命令行生成apk文件《Android 命令行编译、打包生成apk文件》,学习命令行生成的目的是为了编写ant打下基础。
一、 ant环境
下载ant包,配置环境变量
二、ant编译Android项目
1. 生成R文件
2. Java代码生成class文件
3. class文件生成dex文件
4. 打包资源
5. 生成apk
6
. 签名apk
1. aapt命令, 生成R文件
-f 如果编译生成的文件已经存在,强制覆盖。
-m 使生成的包的目录存放在-J参数指定的目录
-J 指定生成的R.java 的输出目录路径
-S 指定res文件夹的路径
- > aapt package -f -m -J ./gen -S res -M AndroidManifest.xml -I D:\android.jar
-f 如果编译生成的文件已经存在,强制覆盖。
-m 使生成的包的目录存放在-J参数指定的目录
-J 指定生成的R.java 的输出目录路径
-S 指定res文件夹的路径
-I 指定某个版本平台的android.jar文件的路径
-A 指定assert文件夹的路径
转换为ant为:
- <exec executable="aapt">
- <arg value="package" />
- <arg value="-m" />
- <arg value="-J" />
- <arg value="gen" />
- <arg value="-S" />
- <arg value="res" />
- <arg value="-M" />
- <arg value="AndroidManifest.xml" />
- <arg value="-I" />
- <arg value="${android-jar}" />
- <arg value="--auto-add-overlay" /> <!-- 覆盖资源 -->
- </exec>
- > javac -target 1.5 -bootclasspath D:\android-sdk-windows\platforms\android-8\android.jar -d bin src\demo\project\*.java gen\demo\project\R.java
-bootclasspath <路径> 覆盖引导类文件的位置
-d <目录> 指定存放生成的类文件的位置
-sourcepath <路径> 指定查找输入源文件的位置
- <javac target="1.5" destdir="bin/classes" bootclasspath="${android-jar}">
- <src path="src" />
- <src path="gen" />
- </javac>
3. dx 命令,把class文件转换为.dex文件
- > dx --dex --output=D:\ProjectDemo\bin\classes.dex D:\ProjectDemo\bin
转换为ant为:
- <exec executable="dx.bat" failonerror="true">
- <arg value="--dex" />
- <arg value="--output=${project-dir}\bin\classes.dex" />
- <arg path="${project-dir}\bin\classes" />
- </exec>
4. aapt命令,打包资源
-f 如果编译生成的文件已经存在,强制覆盖
-M 指定AndroidManifest.xml的路径
-S 指定res文件夹路径
- > aapt package -f -M AndroidManifest.xml -S res -I D:\android-sdk-windows\platforms\android-8\android.jar -F bin\resources.ap_
-M 指定AndroidManifest.xml的路径
-S 指定res文件夹路径
-I 指定某个版本平台的android.jar的路径
-F 指定输出文件完整路径
转换为ant为:
- <exec executable="aapt">
- <arg value="package" />
- <arg value="-f" />
- <arg value="-M" />
- <arg value="AndroidManifest.xml" />
- <arg value="-S" />
- <arg value="res" />
- <arg value="-A" />
- <arg value="assets" />
- <arg value="-I" />
- <arg value="${android-jar}" />
- <arg value="-F" />
- <arg value="bin\resources.ap_" />
- <arg value="--auto-add-overlay" />
- </exec>
5. apkbuilder命令,生成apk
-v Verbose 显示过程信息
-u 创建一个无签名的包
-z 指定apk资源路径
-f 指定dex文件路径
- apkbuilder D:\ProjectDemo\bin\projectdemo.apk -v -u -z D:\ProjectDemo\bin\resources.ap_ -f D:\ProjectDemo\bin\classes.dex -rf D:\ProjectDemo\src
-u 创建一个无签名的包
-z 指定apk资源路径
-f 指定dex文件路径
-rf 指定源码路径
转换为ant为:
- <exec executable="apkbuilder.bat">
- <arg value="${project-dir}\bin\unsigned.apk" />
- <arg value="-u" />
- <arg value="-z" />
- <arg value="${project-dir}\bin\resources.ap_" />
- <arg value="-f" />
- <arg value="${project-dir}\bin\classes.dex" />
- </exec>
- jarsigner -verbose -keystore C:\Users\UserName\Desktop\build\release.keystore -storepass antPassword -keypass antPassword -signedjar D:\ProjectDemo\bin\projectdemo-signed.apk D:\ProjectDemo\bin\projectdemo.apk release
-keystore 密钥库位置
-storepass 用于密钥库完整性的口令
-keypass 专用密钥的口令(如果不同)
-signedjar 已签名的 JAR 文件的名称 (第一个apk是签名之后的文件, 第二个apk是需要签名的文件)
转换为ant为:
- <exec executable="jarsigner">
- <arg value="-keystore" />
- <arg value="${project-dir}\release.keystore" />
- <arg value="-storepass" />
- <arg value="antPassword" />
- <arg value="-keypass" />
- <arg value="antPassword" />
- <arg value="-signedjar" />
- <arg value="${project-dir}\bin\signed.apk" />
- <arg value="${project-dir}\bin\unsigned.apk" />
- <arg value="release" />
- </exec>
三、完整build.xml文件
- <?xml version="1.0" encoding="utf-8"?>
- <project default="main">
- <property name="android-jar" value="D:\android-sdk-windows\platforms\android-8\android.jar" />
- <property name="project-dir" value="D:\ProjectDemo" />
- <target name="init">
- <echo>start initing ... </echo>
- <mkdir dir="gen" />
- <delete>
- <fileset dir="gen"></fileset>
- </delete>
- <mkdir dir="bin/classes" />
- <delete>
- <fileset dir="bin/classes"></fileset>
- </delete>
- <echo>finish initing. </echo>
- </target>
- <target name="main" depends="init">
- <echo>generating R.java for project to dir gen (using aapt) ... </echo>
- <exec executable="aapt">
- <arg value="package" />
- <arg value="-m" />
- <arg value="-J" />
- <arg value="gen" />
- <arg value="-S" />
- <arg value="res" />
- <arg value="-M" />
- <arg value="AndroidManifest.xml" />
- <arg value="-I" />
- <arg value="${android-jar}" />
- <arg value="--auto-add-overlay" /> <!-- 覆盖资源 -->
- </exec>
- <javac target="1.5" destdir="bin/classes" bootclasspath="${android-jar}">
- <src path="src" />
- <src path="gen" />
- </javac>
- <echo>packaging class files (include the third-party jars) to calsses.dex ... </echo>
- <exec executable="dx.bat" failonerror="true">
- <arg value="--dex" />
- <arg value="--output=${project-dir}\bin\classes.dex" />
- <arg path="${project-dir}\bin\classes" />
- </exec>
- <echo>packaging resource (include res, assets, AndroidManifest.xml, etc.) to res.zip ... </echo>
- <exec executable="aapt">
- <arg value="package" />
- <arg value="-f" />
- <arg value="-M" />
- <arg value="AndroidManifest.xml" />
- <arg value="-S" />
- <arg value="res" />
- <arg value="-A" />
- <arg value="assets" />
- <arg value="-I" />
- <arg value="${android-jar}" />
- <arg value="-F" />
- <arg value="bin\resources.ap_" />
- <arg value="--auto-add-overlay" />
- </exec>
- <echo>building unsigned.apk ... </echo>
- <exec executable="apkbuilder.bat">
- <arg value="${project-dir}\bin\unsigned.apk" />
- <arg value="-u" />
- <arg value="-z" />
- <arg value="${project-dir}\bin\resources.ap_" />
- <arg value="-f" />
- <arg value="${project-dir}\bin\classes.dex" />
- </exec>
- <echo>signing the unsigned apk to final product apk ... </echo>
- <exec executable="jarsigner">
- <arg value="-keystore" />
- <arg value="${project-dir}\release.keystore" />
- <arg value="-storepass" />
- <arg value="antPassword" />
- <arg value="-keypass" />
- <arg value="antPassword" />
- <arg value="-signedjar" />
- <arg value="${project-dir}\bin\signed.apk" />
- <arg value="${project-dir}\bin\unsigned.apk" />
- <arg value="release" />
- </exec>
- </target>
- <target name="clean">
- </target>
- </project>
之前第一篇和第二篇分别是都是完全自己手写代码,自己测试并执行所有命令行命令,并且把所有命令都用翻译成ant标签,现在可以使用ant自动打包了。
但是还存在问题,首先前两步骤没有加混淆(proguard)支持,而且复用也要检查下修改哪些内容,或者跨平台需要修改.bat文件引用等。
现在Android SDK中提供了包含之前写过的操作的封装,只需要使用一条命令android update project生成build.xml ,之后再修改配置文件支持不同特性即可,完全不用写ant代码,这些都由Android SDK自动生成。
一、生成SDK 命令生成build.xml文件
1. 执行命令创建
- D:\ProjectDemo>android update project --name ProjectDemo --target 8 --path ./
- Updated project.properties
- Updated local.properties
- Added file D:\ProjectDemo\build.xml
- Updated file D:\ProjectDemo\proguard.cfg
执行此命令会生成4个文件:
project.properties
local.properties
build.xml
proguard.cfg
3. 参数解释
--name ProjectDemo 项目名称
--target 8 指定项目Android版本
--path ./ 指定项目路径
如果不知道target后面使用哪个版本,可以使用如下命令查看本地支持Android版本号:
列出不同版本平台的对应id编号
android list targets
4. 相关资料
如果想了解android update project命令更多使用介绍,可以查看Android官方网站:
《Managing Projects from the Command Line》
http://developer.android.com/tools/projects/projects-cmdline.html
如果想了解andorid 命令参及含义,可以查看:
http://developer.android.com/tools/help/android.html
二、手动配置一些属性
1. 设置SDK路径
修改local.properties文件以下属性值,指定到本地SDK目录
sdk.dir=
例如:
sdk.dir=D:\\android-sdk-windows
2. 设置签名属性
把创建的密匙release.keystore放到当前目录下,并在此目录下创建ant.properties空文件,填入以下内容
key.store=release.keystore
key.store.password=antPassword
key.alias.password=antPassword
key.alias=release
proguard.config=proguard.cfg
三、使用ant运行项目
- ant release
可选:
debug:带调试用签名的构建
release:构建应用程序,生成的apk必须签名才可以发布
install:安装调试构建的包到运行着的模拟器或者设备;
通常ant项目只需要执行ant命令即可,但是Android提供了扩展参数,更多参数可以查看以下网址Ant Command Reference部分:
《Building and Running from the Command Line》
http://developer.android.com/tools/building/building-cmdline.html
四、异常记录
异常一、
BUILD FAILED
D:\ProjectDemo\build.xml:83: Cannot find D:\ProjectDemo\android-sdk-windows\tools\ant\build.xml imported from D:\ProjectDemo\build.xml
修改local.projects,必须是双斜杠
sdk.dir=D:\\android-sdk-windows
异常二:
[aapt] D:\ProjectDemo\res\layout\activity_main.xml:2: error: Error: String types not allowed (at 'layout_width' with value 'match_parent').
[aapt] D:\ProjectDemo\res\layout\activity_main.xml:2: error: Error: String types not allowed (at 'layout_height' with value 'match_parent').
BUILD FAILED
D:android-sdk-windows\tools\ant\build.xml:650: The following error occurred while executing this line:
D:android-sdk-windows\tools\ant\build.xml:691: null returned: 1
Total time: 1 second
当前Andorid版本不支持match_parent属性值,match_parent是Android 8以后开始支持的属性值,修改AndroidManifest中<uses-sdk android:minSdkVersion="8" />最少也要大于8。不过也可以把match_parent改为FILL_PARENT
转载请注明出处:http://blog.csdn.net/androiddevelop/article/details/11553215
当前描述多渠道批量打包是基于第3篇文章基础之上的打包方式。
批量按渠道打包要做几件事情:
1. 存储渠道号
2. 取出渠道号
3. 遍历渠道号执行4,5操作
4. 根据取出的渠道号修改AndroidManifest.xml文件并打包
1. 存储渠道号
我选择存在新建的build.properties中,这样可以和打包的分离,当然也可以放到ant.properties, project.properties, local.properties 等文件中。
2. 取出渠道号
从properties中读取信息,xml代码如下
- <?xml version="1.0" encoding="UTF-8"?>
- <project name="custom_rules" >
- <property file="build.properties"/>
- <echo>${market_channels}</echo>
- </project>
- D:\ProjectDemo>ant
- Buildfile: D:\ProjectDemo\build.xml
- [echo] 666666,88888888
- BUILD SUCCESSFUL
- Total time: 0 seconds
3. 遍历渠道号执行4,5操作
ant核心库本身不支持遍历功能,所以需要引入新库ant-contrib-1.0b3.jar,需要放到ant\lib目录下,我直接放到当前项目目录下。
ant-contrib 下载地址: http://sourceforge.net/projects/ant-contrib/
如果出现如下错误,说明没有放置jar文件
Buildfile: D:\ProjectDemo\build.xml
[taskdef] Could not load definitions from resource net/sf/antcontrib/antcontri
b.properties. It could not be found.
遍历foreach的小例子,结合之前1,2遍历打印出渠道号
- <?xml version="1.0" encoding="UTF-8"?>
- <project name="custom_rules" >
- <property file="build.properties"/>
- <!-- 支持循环执行 -->
- <taskdef resource="net/sf/antcontrib/antcontrib.properties" >
- <classpath>
- <!-- <pathelement location="lib/ant-contrib-1.0b3.jar" /> -->
- <pathelement location="./ant-contrib-1.0b3.jar" />
- </classpath>
- </taskdef>
- <echo>Run ant-contrib OK</echo>
- <target name="deploy">
- <foreach target="edit_and_build" list="${market_channels}" param="channel" delimiter=",">
- </foreach>
- </target>
- <target name="edit_and_build">
- <echo>Run '${channel}' apk</echo>
- </target>
- </project>
- D:\ProjectDemo>ant deploy
- Buildfile: D:\ProjectDemo\build.xml
- [echo] Run ant-contrib OK
- deploy:
- [echo] Run ant-contrib OK
- edit_and_build:
- [echo] Run '666666' apk
- [echo] Run ant-contrib OK
- edit_and_build:
- [echo] Run '88888888' apk
- BUILD SUCCESSFUL
- Total time: 0 seconds
4. 根据取出的渠道号修改AndroidManifest.xml文件并打包
* 正则替换 replaceregexp 标签
http://ant.apache.org/manual/Tasks/replaceregexp.html
** 先来看一个替换的例子,把当前文件夹下的AndroidManifest.xml指定的版本号修改为9
- <?xml version="1.0" encoding="UTF-8"?>
- <project name="custom_rules" >
- <!-- flags="g" 指定全局替换,替换所有符合规则的字段
- byline="false" 确认被替换的时候是一次替换一行还是多行
- pattern 属性用来指明正则表达式 -->
- <replaceregexp flags="g" byline="false">
- <regexp pattern="uses-sdk android:minSdkVersion="(.*)"" />
- <!-- substitution expression 中是替换的值,替换的值都定义在相对应的配置文件中 -->
- <substitution expression="uses-sdk android:minSdkVersion="9"" />
- <!-- fileset 属性中的 dir 用来指定被替换文件所在的目录
- includes 用来指定要替换哪个文件。 -->
- <fileset dir="" includes="AndroidManifest.xml" />
- </replaceregexp>
- </project>
自己查看AndroidManifest.xml指定的版本号修是否改为9
以上已经实现了批量打包的功能,现在只需要打开build.xml加载最上面:
- <property file="build.properties"/>
- <!-- 支持循环执行 -->
- <taskdef resource="net/sf/antcontrib/antcontrib.properties" >
- <classpath>
- <!-- <pathelement location="lib/ant-contrib-1.0b3.jar" /> -->
- <pathelement location="./ant-contrib-1.0b3.jar" />
- </classpath>
- </taskdef>
- <echo>Run ant-contrib OK</echo>
- <target name="deploy">
- <foreach target="edit_and_build" list="${market_channels}" param="channel" delimiter=",">
- </foreach>
- </target>
- <target name="edit_and_build">
- <echo>Run '${channel}' apk</echo>
- <!-- flags="g" 指定全局替换,替换所有符合规则的字段
- byline="false" 确认被替换的时候是一次替换一行还是多行
- pattern 属性用来指明正则表达式 -->
- <replaceregexp flags="g" byline="false">
- <regexp pattern="android:value="(.*)" android:name="CHANNEL""/>
- <!-- substitution expression 中是替换的值,替换的值都定义在相对应的配置文件中 -->
- <substitution expression="android:value="${channel}" android:name="CHANNEL"" />
- <!-- fileset 属性中的 dir 用来指定被替换文件所在的目录
- includes 用来指定要替换哪个文件。 -->
- <fileset dir="" includes="AndroidManifest.xml" />
- </replaceregexp>
- <!-- <property name="out.release.file"
- location="./${channel}.apk" />
- <antcall target="release" /> -->
- <!-- <property
- name="out.final.file"
- location="D:\ProjectDemo\${channel}.apk" /> -->
- <property name="out.final.file"
- location="D:\ProjectDemo\${channel}.apk" />
- <antcall target="clean" />
- <antcall target="release" />
- </target>
五、注意事项
1. 定义渠道名,由文章中“2. 取出渠道号”可以看出想要给不同渠道的包生成不同的名字需要在build.properties文件中添加market_channels。
例如:build.properties内容可以如下设置
- market_channels=88888888,666666
- app_version=1.2.1
2. 执行命令
这里对build.xml添加了自定义功能,不能直接使用ant release执行操作,因为release是SDK ant build.xml提供的功能,需要使用
ant deploy执行。
- ant deploy
参考资料:
Android学习系列(31)--App自动化之使用Ant编译项目多渠道打包
Android学习系列(33)--App应用之提交到各大市场渠道
参考资料:
Android学习系列(31)--App自动化之使用Ant编译项目多渠道打包
Android学习系列(33)--App应用之提交到各大市场渠道