Android Developers:在命令行构建和运行

使用Ant构建脚本构建你的应用程序有两种方式：一种用于测试/调试你的引用程序—debug模式—另一种用于构建你最终发布的包-release模式。无论你使用哪种方式构建你的应用程序，它必须在安装在模拟器或者设备之前被签名—当以debug模式构建的时候使用debug key，当以release模式构建的时候使用你自己的private key。 

 

无论你使用debug模式或者release模式构建，你需要使用Ant工具来编译和构建你的项目。这将创建你能安装在模拟器或者设备上的.apk文件。当你以debug模式构建的时候，.apk文件自动通过SDK工具使用debug key签名，所以立即能安装在模拟器或者附加的开发设备中。当你以release模式构建的时候，这个.apk文件是没有被签名的，所以你必须运用Keytool和Jarsinger，使用你自己的private key手工签名。 

 

你阅读并理解Signing Your Applications是非常重要的，尤其是一旦你准备发布你的应用程序和终端用户共享它的时候。那个文档讲述了生成private key和使用它签名你的.apk文件的过程。如果你仅仅是刚开始，可是，你能在模拟器或者你自己的开发设备上，通过以debug模式构建，快速运行你的应用程序。 

 

如果你没有Ant，你能从Apache Ant官网上获取它。安装它并确保它在你的可执行PATH。在你调用Ant之前，你需要声明JAVA_HOME环境变量来指定JDK被安装的路径。 

 

注意：当你在Windows中安装JDK的时候，默认是安装在“Program File”目录中。因为空格，这个位置将会导致ant失败。为了解决这个问题，你能像这样指定JAVA_HOME环境变量： 

 

  1. set JAVA_HOME=c:\Progra~1\Java\<jdkdir>   

 

最简单的解决办法，那就是，在一个没有空格目录下安装JDK，例如： 

 

  1. c:\java\jdk1.6.0_02   

 

 

在Debug模式构建 

————————————————————————————————————————————————————————————— 

为了立刻测试和调试应用程序，你可以在debug模式下构建你的应用程序，并且立即在模拟器上安装。在debug模式中，构建工具使用debug key自动签名你的应用程序，并且使用zipalign优化包。 

 

在debug模式下构建： 

  1. 打开命令行，导航到你的项目的根目录。 

  2. 使用Ant在debug模式编译你的应用程序： 

 

  1. ant debug   

 

这在项目的bin/目录中创建你的调试.apk文件，名字为<your_project_name>-debug.apk，这个文件已经使用debug key签名，并且zipalign优化。 

 

每次你改变一个源文件或者资源，你必须再次运行Ant为了打包你的应用程序的最新版本。 

 

为了在模拟器上安装和运行你的应用程序，阅读下面的章节Running on the the Emulator。 

 

在Release模式构建 

————————————————————————————————————————————————————————————— 

当你准备向终端用户分发你的应用程序的时候，你必须以release模式构建你的应用程序。一旦你完成在release模式的构建，建议对最终的.apk文件进行附加的测试和调试。 

 

在你开始以release模式构建你的应用程序之前，注意你必须使用private key签名你的最后应用程序包，然后使用zipalign工具优化它。以release构建这里有两种方式：在release模式构建一个为签名的包，然后手工签名并优化这个包，或者使用构建脚本签名并优化你的包。 

 

未签名构建 

如果你未签名构建你的应用程序，然后你将需要手工签名和优化这个包。 

 

为了以release模式构建一个未签名的.apk文件： 

  1. 打开命令行，导航至你的项目的根目录。 

  2. 使用Ant在release模式下编译你的项目： 

 

  1. ant release   

 

这样在这个项目的bin/目录下创建了你的Andorid应用的.apk文件，名字为<your_project_name>-unsigned.apk。 

 

注意：注意在这个时候这个.apk文件是未签名的，并且直到你使用你的private key签名前不能被安装。 

 

一旦你创建了未签名的.apk文件，你的下一步是使用你的private key签名这个.apk文件，然后使用zipalign优化它。为了完成这个步骤，阅读Signing Your Applicaitons。 

 

当你的apk文件已经被签名和优化的时候，它已经可以被发布给终端用户。你应该在不同的设备或者AVD测试这个最终的构建，来确保它在不同的平台顺畅运行。 

 

签名和优化构建 

如果你想，你可以配置Android构建脚本来自动签名和优化你的应用程序包。如果这样做，你必须在你的项目的ant.properties文件中提供你的keystore路径和你的key别名名称。使用提供的这些信息，当你以release模式构建的时候，构建脚本将提示你输入你的keystore和别名密码，并产生你应用程序最终的包，它已经可以发布。 

 

当心：当以Ant的方式处理输入的时候，在构建的过程中你输入的密码将可见。如果你担心你的keystore和别名密码在屏幕中可见，那么你可能更愿意使用Jarsinger（或者相似的工具）执行手工签名应用程序。为了执行手工的执行签名过程，未签名构建，然后跟着Signing Your Applications继续。 

 

为了指定你的keystore和alias，打开项目的ant.properties文件（在你的项目的跟目录中寻找），并输入key.store和key.alias实体。例如： 

 

  1. key.store=path/to/my.keystore   
  2. key.alias=mykeystore   

 

 

保存你的修改。现在你能在release模式构建签名的apk： 

  1. 打开命令行，导航至你的项目的根目录。 

  2. 使用Ant在release模式编译你的项目： 

 

  1. ant release   

 

  1. 当提示，输入你的keystore和alias密码。 

当心：如上面所描述的，你的密码将会在屏幕中可见。 

 

这样在项目的bin/目录中创建了你的Android应用程序的.apk文件，名字为<your_project_name>-release.apk。这个.apk文件已经使用了在ant.properties文件中指定的private key签名，并使用zipalign优化。它已经可以安装和发布。 

 

在release模式完成构建和签名 

一旦你使用private key完成对你的应用程序的签名，你在模拟器或者设备上安装并运行它。你也能尝试从web服务器上向设备上安装它。向网站上传这个签名的.apk文件，然后在你的Android网页浏览器中加载这个.apk的URL，来下载这个应用程序并开始安装。（在你的设备中，确保启动Settings>Applications>Unknown sources。） 

 

在模拟器上运行 

————————————————————————————————————————————————————————————— 

在你能在Android模拟器上运行你的应用程序之前，你必须Crate an AVD。 

 

为了运行你的应用程序： 

  1. 打开AVD Manager，并启动一个虚拟设备 

从你的SDK的platform-tools/目录，使用avd选项运行android工具： 

 

  1. android avd <span style="font-family:'Calibri Light',sans-serif; font-size:10pt; line-height:16px; background-color:transparent; color:windowtext"> </span>  

 

  1. 安装你的应用程序 

从你的SDK的tools/目录，在模拟器安装这个.apk: 

 

  1. adb install <path_to_your_bin>.apk   

 

在你构建你的应用程序之后，你的apk文件（使用release或者debug key签名）在你的项目bin/目录中。 

 

如果有超过一个模拟器在运行，你必须使用-s选项，使用它的serial number，指定在哪个模拟器安装这个应用程序。例如： 

 

  1. adb -s emulator-5554 install path/to/your/app.apk   

 

 

为了查看可用的设备serial number列表，执行adb devices。 

 

如果在模拟器上你没有看见你的应用程序，尝试关闭模拟器，从AVD Manager再次启动这个虚拟设备。某些时候，当你第一次安装应用程序，它不会出现在应用程序启动器中，或者访问其它应用程序。这时因为包管理器通常仅仅在模拟器启动的时候完整检测清单。 

 

一定要创建多个AVD来测试你的应用程序。你应该创建为每个平台和你的应用程序兼容的屏幕类型，创建一个AVD。例如，如果你的应用程序使用Android 4.0（API Level 14）平台编译，你应该为等于或大于4.0的每个平台和你支持的每个屏幕类型，创建一个AVD，然后在上面测试你的应用程序。 

 

提示：如果你仅仅有一个模拟器在运行，你可以仅仅一步就构建你的应用程序并在模拟器上安装它。导航到你的项目的根目录，使用Ant工具编译的install模式：ant install。这将构建你的应用程序， 

 

在设备上运行 

————————————————————————————————————————————————————————————— 

更多信息请阅读Setting up a Device for Developerment。 

 

一旦你的设备设置完成 

 

  1. adb -d install path/to/your/app.apk   

 

 

-d标识指定你想使用附加的设备（在你还有一个模拟器运行的情况）。 

 

更多关于上面使用的工具的信息，请查阅下面的文章： 

  • android Tool 

  • Android Emulator 

  • Android Debug Bridge(ADB) 

 

应用程序签名 

———————————————————————————————————————————————————————————— 

当你开始开发你的应用程序，明白在系统在模拟器或者设备上安装它们之前所有的Android应用程序必须数字化签名。这里有两种方式实现它：使用debug key（为了立即在模拟器或者开发设备上测试）或者使用private key（用于应用程序发布）。 

 

Android构建工具帮助你使用debug key在构件时自动签名你的apk文件。这意味这你能编译并且在模拟器上安装你的应用程序，并不需要生成一个你自己的private key。然而，请注意，如果你想发布你的应用程序，你必须使用你自己的private key签名你的应用程序，而不是通过SDK工具生成debug key。 

 

ADT插件帮助你在将它们安装到模拟器和开发设备之前，快速使用debug key签名你的apk文件。这意味着你能在没有生成你自己的private key之前，从Eclipse中快速运行你的应用程序。没有你需要具体执行的动作，提供的ADT已经访问了Keytool。然而，请注意如果你想发布你的应用程序，你必须使用你的private key签名你的应用程序，而不是使用SDK工具生成的debug key。 

 

请阅读Singing Your Applications，它为Android应用程序签名提供了一个全面的指南，和它对于一个Android开发人员意味着什么。这个文档也包含一个使用ADT的Export Wizard导出并签名你的应用程序指南。

posted @ 2013-10-29 19:13  安卓吧  阅读(910)  评论(0)  编辑  收藏  举报