Ant搭建 一键生成APP技术 平台
1.博客概要
本文详细介绍了当今流行的一键生成APP技术。介绍了这种设计思想的来源,介绍了国内外的研究背景,并介绍了这个技术体系中的一些实现细节,欢迎各路大神们多提意见。一键生成技术,说的通俗点就是,要在自有平台上发布若干个代码一致,但包名,版本,引用资源都不同的App,即实现一套代码生成多个不同的APK(注意哦,这一系列的编译打包都是自动化的)。
2.认识一个Android项目
Android是一种基于Linux的自由及开放源代码的操作系统,主要使用于移动设备,如智能手机和平板电脑。
如上图所示,是一个Android项目的目录结构图,分别介绍如下:
- src文件,即source code,项目源代码。
- gen文件,该文件夹下面有个R.java文件,R.java是在建立项目时自动生成的,这个文件是只读模式的,不能更改。R.java文件中定义了一个类R,R类中包含很多静态类,且静态类的名字都与res中的一个名字对应,即R类定义该项目所有资源的索引。通过R.java我们可以很快地查找我们需要的资源,另外编绎器也会检查R.java列表中的资源是否被使用到,没有被使用到的资源不会编绎进软件中,这样可以减少应用在手机占用的空间。它定义的每个资源值都是唯一的,不会和系统冲突。这个文件由ADT插件自动更新,当你编辑过Res文件后保存,这个类就会自动更新。
- Android2.1文件,该文件夹下包含android.jar文件,这是一个Java归档文件,其中包含构建应用程序所需的所有的Android SDK 库(如Views、Controls)和APIs。通过android.jar将自己的应用程序绑定到Android SDK和Android Emulator,这允许你使用所有Android的库和包,且使你的应用程序在适当的环境中调试。
- asset文件,包含应用系统需要使用到的诸如mp3、视频类的文件。
- res文件,资源目录,包含你项目中的资源文件并将编译进应用程序。向此目录添加资源时,会被R.java自动记录。新建一个项目,res目录下会有三个子目录:drawabel、layout、values。drawabel:包含一些你的应用程序可以用的图标文件(*.png、*.jpg) ,存在多个是为了适应不同分辨率。layout:界面布局文件,自定义的UI。values:软件上所需要显示的各种文字,可以存放多个*.xml文件,还可以存放不同类型的数据:比如arrays.xml、colors.xml、strings.xml、styles.xml。
- AndroidMainfest.xml文件,项目的总配置文件。项目的总配置文件,记录应用中所使用的各种组件。这个文件列出了应用程序所提供的功能,在这个文件中,你可以指定应用程序使用到的服务(如电话服务、互联网服务、短信服务、GPS服务等等)。另外当你新添加一个Activity的时候,也需要在这个文件中进行相应配置,只有配置好后,才能调用此Activity。
- default.properties文件,记录项目中所需要的环境信息,比如Android的版本等。
3.Android项目是如何实现编译、打包、签名和发布的,这套流程是怎样的?
知道了一个Android项目的组成之后,我们来看一个apk是如何从Eclipse中的源文件组装成一个apk文件的。
如上图所示,apk的编译过程分为以下几个阶段:
1.用aapt命令生成R.java文件,命令“ aapt package -f -m -J ./gen -S res -M AndroidManifest.xml -I D:\android.jar ”
2.用aidl命令生成相应java文件。
3.用javac命令编译java源文件生成class文件
4.用dx.bat将class文件转换成classes.dex文件
5.用aapt命令生成资源包文件resources
6.用apkbuilder.bat打包资源和classes.dex文件,生成unsigned.apk
7.用jarsinger命令对apk认证,生成signed.apk
4.结合配置文件,详细解释一键生成APP是如何通过build.xml来自动化实现的?
从上面步骤,我们知道了通过一堆命令,可以依次来执行这七个步骤,是通过手动命令来编译打包的。一键生成APP技术则是利用了Ant的自动编译打包apk的技术,就是这么简单。相对应的有如下步骤:
1.生成R.java文件
<!-- Generate the R.java file for this project\'s resources. --> <target name="resource-src" depends="copy"> <echo>Generating R.java / Manifest.java from the resources</echo> <exec executable="${aapt}" failonerror="true"> <arg value="package" /> <arg value="-m" /> <arg value="-J" /> <arg value="${outdir-gen}" /> <arg value="-M" /> <arg value="AndroidManifest.xml" /> <arg value="-S" /> <arg value="${resource-dir}" /> <arg value="-I" /> <arg value="${android-jar}" /> </exec> </target>
效果等价于,执行了aapt命令生成R.java文件。
2.将aidl文件生成Java文件
<!-- Generate java classes from .aidl files. --> <target name="aidl" depends="copy"> <echo>Compiling aidl files into Java classes...</echo> <apply executable="${aidl}" failonerror="true"> <arg value="-p${android-framework}" /> <arg value="-I${srcdir}" /> <fileset dir="${srcdir}"> <include name="**/*.aidl"/> </fileset> </apply> </target>
3.将.java类文件生成class文件
<!-- Compile this project\'s .java files into .class files. --> <target name="compile" depends="copy, resource-src, aidl"> <javac encoding="GB18030" target="1.5" debug="true" extdirs="" srcdir="." destdir="${outdir-classes}" bootclasspath="${android-jar}"> <classpath> <fileset dir="${external-libs}" includes="*.jar"/> </classpath> </javac> </target>
下面的步骤,依次类推,详情参考:http://jojol-zhou.iteye.com/blog/729271
5.总结
<?xml version="1.0" ?> <!-- byread Package Utility Author: Jojol Zhou Date: 20100804 --> <project name="Byread" default="debug"> <!-- SDK Locations --> <property name="sdk2.2-folder" value="F:\explorer\android-sdk-windows2.2" /> <property name="sdk-folder" value="${sdk2.2-folder}/platforms/android-3" /> <property name="sdk-tools" value="${sdk-folder}/tools" /> <property name="android-tools" value="${sdk2.2-folder}/tools" /> <property name="proguardpath" location="${wtkhome}/lib/proguard" /> <!-- step 1.generate R.java by aapt 2.compile java to class by javac。exe 3.generate classes.dex by dx.bat --> <!-- 4.package resources by aapt 5. package resource and classes.dex by apkbuilder.bat 6.sign apk by jarsinger --> <!-- Tools --> <property name="aapt" value="${sdk-tools}/aapt.exe" /> <property name="dx" value="${sdk-tools}/dx.bat" /> <property name="apk-builder" value="${android-tools}/apkbuilder.bat" /> <property name="aidl" value="${android-tools}/aidl.exe" /> <property name="adb" value="${android-tools}/adb.exe" /> <property name="android-jar" value="${sdk-folder}/android.jar" /> <property name="jarsigner" value="C:\Program Files\Java\jdk1.6.0_07\bin\jarsigner.exe" /> <!-- Application Package Name --> <property name="application-package" value="com.byread.reader" /> <property name="useragent" value="byAndroidWeb" /> <property name="version" value="1.02" /> <!-- The intermediates directory --> <!-- Eclipse uses "bin" for its own output, so we do the same. --> <property name="outdir-bin" value="bin" /> <property name="outdir-gen" value="gen" /> <!-- source directories --> <property name="resource-dir" value="res" /> <property name="asset-dir" value="assets" /> <property name="srcdir" value="src" /> <property name="srcdir-ospath" value="${basedir}/${srcdir}" /> <property name="external-libs" value="libs" /> <property name="external-libs-ospath" value="${basedir}/${external-libs}" /> <!-- dest directories --> <property name="des-resource-dir" value="${outdir-bin}/res" /> <property name="des-asset-dir" value="${outdir-bin}/assets" /> <property name="des-srcdir" value="${outdir-bin}/src" /> <property name="des-srcdir-ospath" value="${basedir}/${outdir-bin}/${srcdir}" /> <property name="des-external-libs" value="${outdir-bin}/libs" /> <property name="des-external-libs-ospath" value="${basedir}/${outdir-bin}/${external-libs}" /> <!-- Output directories --> <property name="outdir-classes" value="${outdir-bin}/src" /> <property name="outdir-obfuscate-classes" value="${outdir-bin}/classes" /> <property name="outdir-obfuscate-classes-ospath" value="${basedir}/${outdir-obfuscate-classes}" /> <!-- Intermediate files --> <property name="dex-file" value="classes.dex" /> <property name="intermediate-dex" value="${outdir-bin}/${dex-file}" /> <property name="intermediate-dex-ospath" value="${basedir}/${intermediate-dex}" /> <!-- The final package file to generate --> <property name="resources-package" value="${outdir-bin}/${ant.project.name}" /> <property name="resources-package-ospath" value="${basedir}/${resources-package}" /> <property name="out-debug-package" value="${outdir-bin}/${ant.project.name}-debug.apk" /> <property name="out-debug-package-ospath" value="${basedir}/${out-debug-package}" /> <property name="out-unsigned-package" value="${outdir-bin}/${ant.project.name}-unsigned.apk" /> <property name="out-unsigned-package-ospath" value="${basedir}/${out-unsigned-package}" /> <property name="out-signed-package" value="${useragent}\${ant.project.name}.apk" /> <property name="out-signed-package-ospath" value="${basedir}\${out-signed-package}" /> <!-- init --> <target name="init"> <echo>Creating all output directories </echo> <delete dir="${outdir-bin}" /> <delete dir="${useragent}" /> <mkdir dir="${outdir-bin}" /> <mkdir dir="${outdir-classes}" /> <mkdir dir="${useragent}" /> </target> <!-- copy original strings and modify useragent --> <target name="copy" depends="init"> <echo>copy files to output folder</echo> <delete file="${resource-dir}\values\strings.xml"/> <copy file="strings.xml" todir="${resource-dir}\values" /> <replace file="${resource-dir}\values\strings.xml" token="@USERAGENT@" value="${useragent}" encoding="utf-8"/> </target> <!-- Generate the R.java file for this project\'s resources. --> <target name="resource-src" depends="copy"> <echo>Generating R.java / Manifest.java from the resources...</echo> <exec executable="${aapt}" failonerror="true"> <arg value="package" /> <arg value="-m" /> <arg value="-J" /> <arg value="${outdir-gen}" /> <arg value="-M" /> <arg value="AndroidManifest.xml" /> <arg value="-S" /> <arg value="${resource-dir}" /> <arg value="-I" /> <arg value="${android-jar}" /> </exec> </target> <!-- Generate java classes from .aidl files. --> <target name="aidl" depends="copy"> <echo>Compiling aidl files into Java classes...</echo> <apply executable="${aidl}" failonerror="true"> <arg value="-p${android-framework}" /> <arg value="-I${srcdir}" /> <fileset dir="${srcdir}"> <include name="**/*.aidl"/> </fileset> </apply> </target> <!-- Compile this project\'s .java files into .class files. --> <target name="compile" depends="copy, resource-src, aidl"> <javac encoding="GB18030" target="1.5" debug="true" extdirs="" srcdir="." destdir="${outdir-classes}" bootclasspath="${android-jar}"> <classpath> <fileset dir="${external-libs}" includes="*.jar"/> </classpath> </javac> </target> <!-- Convert this project\'s .class files into .dex files. --> <target name="dex" depends="compile"> <echo>Converting compiled files and external libraries into ${outdir}/${dex-file}...</echo> <apply executable="${dx}" failonerror="true" parallel="true"> <arg value="--dex" /> <arg value="--output=${intermediate-dex-ospath}" /> <arg path="${outdir-obfuscate-classes-ospath}" /> <fileset dir="${external-libs}" includes="*.jar"/> </apply> </target> <!-- Put the project\'s resources into the output package file. --> <target name="package-res-and-assets"> <echo>Packaging resources and assets...</echo> <exec executable="${aapt}" failonerror="true"> <arg value="package" /> <arg value="-f" /> <arg value="-M" /> <arg value="AndroidManifest.xml" /> <arg value="-S" /> <arg value="${resource-dir}" /> <arg value="-A" /> <arg value="${asset-dir}" /> <arg value="-I" /> <arg value="${android-jar}" /> <arg value="-F" /> <arg value="${resources-package}" /> </exec> </target> <!-- Same as package-res-and-assets, but without "-A ${asset-dir}" --> <target name="package-res-no-assets"> <echo>Packaging resources...</echo> <exec executable="${aapt}" failonerror="true"> <arg value="package" /> <arg value="-f" /> <arg value="-M" /> <arg value="AndroidManifest.xml" /> <arg value="-S" /> <arg value="${resource-dir}" /> <!-- No assets directory --> <arg value="-I" /> <arg value="${android-jar}" /> <arg value="-F" /> <arg value="${resources-package}" /> </exec> </target> <!-- Invoke the proper target depending on whether or not an assets directory is present. --> <!-- TODO: find a nicer way to include the "-A ${asset-dir}" argument only when the assets dir exists. --> <target name="package-res"> <available file="${asset-dir}" type="dir" property="res-target" value="and-assets" /> <property name="res-target" value="no-assets" /> <antcall target="package-res-${res-target}" /> </target> <!-- Package the application and sign it with a debug key. This is the default target when building. It is used for debug. --> <target name="debug" depends="dex, package-res"> <echo>Packaging ${out-debug-package}, and signing it with a debug key...</echo> <exec executable="${apk-builder}" failonerror="true"> <arg value="${out-debug-package-ospath}" /> <arg value="-z" /> <arg value="${resources-package-ospath}" /> <arg value="-f" /> <arg value="${intermediate-dex-ospath}" /> <arg value="-rf" /> <arg value="${srcdir-ospath}" /> <arg value="-rj" /> <arg value="${external-libs-ospath}" /> </exec> </target> <!-- Package the application without signing it. This allows for the application to be signed later with an official publishing key. --> <target name="package" depends="dex, package-res"> <echo>Packaging ${out-unsigned-package} for release...</echo> <exec executable="${apk-builder}" failonerror="true"> <arg value="${out-unsigned-package-ospath}" /> <arg value="-u" /> <arg value="-z" /> <arg value="${resources-package-ospath}" /> <arg value="-f" /> <arg value="${intermediate-dex-ospath}" /> <arg value="-rf" /> <arg value="${srcdir-ospath}" /> <arg value="-rj" /> <arg value="${external-libs-ospath}" /> </exec> <echo>It will need to be signed with jarsigner before being published.</echo> </target> <target name="jarsigner" depends="package"> <echo>Packaging ${out-unsigned-package} for release...</echo> <exec executable="${jarsigner}" failonerror="true"> <arg value="-verbose" /> <arg value="-storepass" /> <arg value="byread002" /> <arg value="-keypass" /> <arg value="byread002" /> <arg value="-keystore" /> <arg value="bbyread.keystore" /> <arg value="-signedjar" /> <arg value="${out-signed-package-ospath}" /> <arg value="${out-unsigned-package-ospath}" /> <arg value="byread" /> </exec> </target> <target name="release" depends="jarsigner"> <echo>release for release...</echo> </target> <!-- Install the package on the default emulator --> <target name="install" depends="debug"> <echo>Installing ${out-debug-package} onto default emulator...</echo> <exec executable="${adb}" failonerror="true"> <arg value="install" /> <arg value="${out-debug-package}" /> </exec> </target> <target name="reinstall" depends="debug"> <echo>Installing ${out-debug-package} onto default emulator...</echo> <exec executable="${adb}" failonerror="true"> <arg value="install" /> <arg value="-r" /> <arg value="${out-debug-package}" /> </exec> </target> <!-- Uinstall the package from the default emulator --> <target name="uninstall"> <echo>Uninstalling ${application-package} from the default emulator...</echo> <exec executable="${adb}" failonerror="true"> <arg value="uninstall" /> <arg value="${application-package}" /> </exec> </target> </project>
参考文献:
[1] http://www.cnblogs.com/qianxudetianxia/archive/2012/07/04/2573687.html
[2]