Android应用程序签名

概述

Android系统要求，所有的程序经过数字签名后才能安装。Android系统使用这个证书来识别应用程序的作者，并且建立程序间的信任关系。证书不是用于用户控制哪些程序可以安装。证书不需要授权中心来签名：Android应用程序上使用自己签名的证书是完全允许且普遍的。

理解Android应用程序签名有以下几个重要点：

·           所有的应用程序都必须签名。系统不会安装任何一个不签名的程序。

·           你可以使用自己的证书来签名。不需要任何授权中心。

·           当你要为最终用户发布你的应用程序的时候，你必须签入一个合适的密钥。你不可以发布程序的时候还使用SDK工具签入的Debug Key。

·           系统只在安装应用程序的时候检测证书的有效期。如果应用程序在安装之后证书失效了，那么，应用程序还是可以正常工作。

·           你可以使用标准工具——Keytool和Jarsigner——生成Key并签名apk文件。

·           一旦你为应用程序签名了，一定要使用zipalign工具来优化最终的APK包。

Android系统不会安装和运行没有正确签名的应用程序。这条规则适用于任何运行Android系统的地方，不管是真机还是模拟器。正是由于这个原因，你必须在模拟器或真机上运行/调试程序之前对程序进行签名。

当你调试应用程序时，Android SDK工具替你对应用程序进行了签名。Eclipse的ADT插件和Ant编译工具都提供了两种签名模式——Debug模式和Release模式。

·           当开发和测试时，你可以使用Debug模式。在Debug模式下，编译工具使用内嵌在JDK中的Keytool工具来创建一个keystore和一个key（包含公认的名字和密码）。在每次编译的时候，使用这个Debug Key来为apk文件签名。由于密码是公认的，在每次编译的时候，也不需要提示你输入keystore和key密码。

·           当你的程序准备发布时，你必须在Release模式下，使用密钥来为apk文件签名。有以下两种方式可以做到：

o    命令行中使用Keytool和Jarsigner。在这个方法中，首先需要编译出一个未签名的apk。然后使用Jarsigner（或相似的工具），用你的密钥为apk手动签名。如果你没有合适的密钥，你可以运行Keytool来手动生成自己的keystore/key。

o    使用ADT导出向导。如果你使用Eclipse/ADT插件进行开发，你可以使用导出向导来编译程序，生成密钥（如果需要），并为apk签名，所有这些操作都在导出向导中。一旦你的程序签名了，别忘了运行zipalign来为apk进行额外的优化。

签名策略

应用程序签名的某些方面可能会影响应用程序的开发，特别是你打算一起发布多个应用程序的时候。

一般来说，推荐的策略是在整个应用程序寿命内，所有的程序签上相同的证书。以下有几个应该这么做的原因：

·         应用程序升级——当你对应用程序进行升级时，如果你想用户平稳的升级，那么，你就需要签上相同的证书。当系统安装一个升级应用程序时，如果新版本的证书与老版本的证书有匹配的话，那么，系统才会允许进行升级。如果你没有为版本签上合适的证书，当你安装时，你需要给应用程序指定一个新的包名——在这种情况下，用户安装的新版本，被当作是一个全新的应用程序。

·         应用程序模块化——如果应用程序请求的话，Android系统允许签有相同证书的应用程序运行在相同的进程里，这样，系统就会把它们看作是一个单一的应用程序。用这种方法配置应用程序，用户可以选择更新每个独立的模块。

·         代码/数据权限共享——Android系统提供了基于签名的权限检查，因此，如果应用程序间签有特定的证书，那么，它们之间可以共享功能。通过多个程序签有相同的证书并且使用基于签名的权限检查，你的程序可以以一种安全的方式共享代码和数据。

还有一个决定签名策略的重要因素是：如何设定key的有效期。

·         如果你计划支持单个应用程序的升级，你需要确保你的key拥有一个超过期望的应用程序生命周期的有效期。推荐使用25年或更多的有效期。当你的key过期了，用户也就不能平稳的更新到新版本了。

·         如果你想给多个无关的应用程序签上相同的key，那么，你必须确保key的有效期超过所有应用程序所有版本的生命周期，包括将来有可能添加到这一阵营的程序。

·         如果你想在Android Market上发布你的程序，key的有效期必须在2033.10.22以后。Market服务器强制这一要求，目前是保证用户可以平稳的更新他们的程序。

当你设计应用程序时，一定要把这些点记在脑子里，并且使用一个合适的证书来为应用程序签名。

签名的基本设定

在你开始之前，你必须保证Keytool对SDK编译工具来说是可利用的。多数情况下，你可以通过设置JAVA_HOME环境变量来告诉SDK编译工具如何找到Keytool。另外，你还可以添加JDK中Keytool的路径到PATH的变量里。

如果你在Linux上开发，并且使用GNU编译器来编译Java，那么，请确保系统是使用JDK中的Keytool，而不是gcj。如果Keytool已经在你的PATH中，它有可能是对/usr/bin/keytool的符号链接。在这种情况下，检查符号链接的目标，确保它是指向JDK中的Keytool。

如果你打算对公众释放你的应用程序，你还需要Jarsigner工具。Jarsigner和Keytool都包含在JDK中。

Debug模式下签名

Android编译工具提供了Debug签名模式，使得开发和调试应用程序更加容易，而且还满足Android系统的签名要求。当使用Debug模式编译你的app时，SDK工具会调用Keytool工具自动创建一个Debug的keystore和key。然后，这个Debug key会自动用于apk的签名，这样，你不需要使用你自己的key来为应用程序包签名。

SDK工具使用预先定义好的名字/密码来创建Debug keystore/key：

·         Keystore名字：“debug.keysotre”

·         Keystore密码：“android”

·         Key别名：“androiddebugkey”

·         Key密码：“android”

·         CN：“CN=Android Debug,O=Android,C=US”

如果需要的话，你可以改变Debug keystore/key的位置和名字，或者提供一个自定义的Debug keysotre/key。然而，任何自定义的Debug keystore/key必须使用和默认Debug key（上面描述的）相同的名字和密码。（在Eclipse/ADT中，操作Windows>Preferences>Android>Build实现。）

注意： 你不能将签有Debug证书的应用程序发布给公众。

 

Eclipse 用户

如果你在Eclipse/ADT下开发（并且已经按照上面描述的“签名的基本设定”配置了Keytool），Debug模式下签名默认是开启的。当你运行或是调试应用程序时，ADT会使用Debug证书进行签名，并运行zipalign，然后安装到选择的模拟器或是连接上的设备。整个过程不需要你参与，前提是ADT能访问Keytool。

Ant 用户

如果你使用Ant来编译你的apk文件，需要在ant命令中添加debug选项来开启Debug签名模式（假设你正在使用由android工具生成build.xml文件）。当你运行ant debug来编译你的程序时，编译脚本会生成一个keystore/key，并为apk进行签名。然后脚本会使用zipalign工具对apk进行对齐处理。整个过程不需要你参与。阅读“其它IDE下开发：Debug模式编译”来了解更多的信息。

Debug证书过期

Debug模式下签名用的证书（默认是Eclipse/ADT和Ant编译）自从它创建之日起，1年后就会失效。

当证书失效时，你会得到一个编译错误，在Ant编译上，错误如下：

debug:
[echo] Packaging bin/samples-debug.apk, and signing it with a debug key...
[exec] Debug Certificate expired on 8/4/08 3:43 PM

在Eclipse/ADT中，Android控制台上你将会看到一个相似的错误。

为了解决这个问题，只需要删掉debug.keystore文件即可。AVD默认存储的位置在：~/.android/avd（OS X和Linux），C:\Documents and Settings\\.android\（Windows XP），C:\Users\\.android\（Windows Vista）。

当下一次编译的时候，编译工具会重新生成一个新的keystore和Debug key。

Release模式下签名

当你的程序准备好释放给其它用户时，你必须：

1.   获取一个合适的密钥

2.      在Release模式下编译程序

3.      使用密钥签名程序

4.      对齐APK包

如果你是使用Eclipse/ADT插件开发，你可以使用导出向导来完成编译、签名和对齐等操作。在整个过程中，导出向导甚至还可以生成一个新的keystore和密钥。因此，如果你使用Eclipse，你可以直接跳到“使用Eclipse ADT编译和签名”。

1. 获取一个合适的密钥

为了进行程序的签名，首先，你必须有一个合适的密钥。密钥指：

·         个人持有。

·         代表个人、公司或组织实体的身份。

·         拥有一个有效期。有效期推荐超过25年。

如果你在Android Market上发布你的程序，需要注意一点的是：程序的有效期需要在2033.10.22之后。你不能上传一个应用程序，而它的key的有效期是在这个日期之前。

·         不是由Android SDK工具生成的Debug key。

如果你没有一个合适的key，你一定要使用Keytool来生成一个。如“基本设定”中描述的，确保Keytool可用。

为了用Keytool生成一个key，使用keytool命令并传入一些可选参数，如下表所示。

警告: 确保密钥的安全。一定要阅读“安全储存你的密钥”中讨论如何确保你的密钥的安全以及这对你和用户为何如此重要。尤其是，当你生成你的密钥时，一定要为keystore和key使用强密码。

 

 

 

 

Keytool选项	描述
-genkey	生成一个键对（公钥和密钥）
-v	日志输出
-keystore <keystore-name>.keystore	命名包含密钥的keystore
-storepass <password>	设定keystore的密码。 基于安全考虑，不要在命令行中包含这一选项，除非你在一个安全的计算机上。如果你不提供，Keytool会提示你输入。这样，你的密码就不会储存在shell记录中了。
-alias <alias_name>	设定key的别名
-keyalg <alg>	指定生成key时使用的加密算法。支持DSA和RSA。
-dname <name>	指定一个描述谁创建key的名字。该值将填入证书发行人的字段。 注意：你不需要在命令行中指明这些选项。如果不提供，Jarsigner会提示你输入每个字段（CN，OU等）。
-validity <valdays>	Key的有效期，天数。 注意：推荐使用10000或更大的数。
-keypass <password>	Key的密码。 基于安全考虑，不要在命令行中包含这一选项，除非你在一个安全的计算机上。如果你不提供，Keytool会提示你输入。这样，你的密码就不会储存在shell记录中了。

下面是使用Keytool命令生成密钥的例子：

$ keytool -genkey -v -keystore my-release-key.keystore 
-alias alias_name -keyalg RSA -validity 10000

运行上面的例子命令，Keytool会提示你输入keystore和key的密码，并且会提示你输入key中其它的字段。然后，它会生成一个叫做my-release-key.keystore的文件。keystore和key受你输入的密码保护。keystore中包含一个key，有效期为10000天。别名将在后面用到，在程序签名时指当前这个keystore。

了解更多关于Keytool的信息，请参考http://java.sun.com/j2se/1.5.0/docs/tooldocs/#security。

2. 在Release模式下编译程序

为了给用户释放程序，你必须在Release模式下编译程序。在Release模式下，编译程序不会进行默认签名，并且你需要使用密钥进行签名。

注意: 你不能释放未签名的程序，或签有Debug key的程序。

使用Eclipse

右击Package Explorer中的工程，选择Android Tools>Export Unsigned Application Package，导出一个未签名的apk。然后指定未签名apk的存储位置。（另外，你也可以在Eclipse中打开AndroidManifest.xml文件，打开Manifest Tab，然后点击Export an unsigned APK）。

注意：你也可以使用导出向导来完成编译和签名步骤，参考“使用Eclipse/ADT编译和签名”。

使用 Ant

如果你正在使用Ant，那么你可以在ant命令中加入release选项来开启Release模式。例如，如果你在包含build.xml文件的文件夹上运行Ant，命令可能看起来是这样：

ant release

一般，编译脚本在编译apk的时候不会进行签名。输出的文件位于工程的bin/文件夹中，名为<your_project_name>-unsigned.apk。由于apk文件还没有签名，所以你必须手动的使用密钥进行签名，然后使用zipalign进行对齐。

然而，Ant编译脚本也可以替你执行签名和对齐操作，前提是你在build.properties文件中提供了keystore的名字和key的别名。如果提供了这些信息，编译脚本在执行ant release命令时会提示你输入keystore和key的密码，对包进行签名并对齐。最后输出的文件位于工程的bin/文件夹中，名为<your_project_name>-release.apk。如果按照上述自动签名和对齐操作执行，那么，你就可以跳过下面的手动步骤（步骤3和4）。了解如何在build.properties文件中指定keystore和alias，请参考“其它IDE下开发：Release模式编译”。

3. 使用密钥签名程序

如果你已经准备好要签名的程序包的话，你可以使用Jarsigner工具进行签名。如“基本设定”中描述的，请确保Jarsigner工具可用。此外，确保包含密钥的keystore可用。

为了签名应用程序，你需要运行Jarsigner，并引用应用程序的apk及包含密钥的keystore。下表列出了你可能使用的选项。

Jarsigner选项	描述
-keystore <keystore-name>.keystore	指定包含密钥的keystore的名字
-verbose	日志输出
-storepass <password>	指定keystore的密码。 基于安全考虑，不要在命令行中包含这一选项，除非你在一个安全的计算机上。如果你不提供，Jarsigner会提示你输入。这样，你的密码就不会储存在shell记录中了
-keypass <password>	指定密钥的密码。 基于安全考虑，不要在命令行中包含这一选项，除非你在一个安全的计算机上。如果你不提供，Jarsigner会提示你输入。这样，你的密码就不会储存在shell记录中了

下面是一个使用Jarsigner对my_application.apk进行签名的例子，使用了上面创建的keystore。

$ jarsigner -verbose -keystore my-release-key.keystore 
my_application.apk alias_name

运行上面的示例命令，Jarsigner会提示你输入keystore和key的密码。然后它会修改apk文件，意味着apk文件现在已经签上名了。注意：你可以使用不同的key对apk多次签名。

检验apk文件是否签名，可以使用下面的命令：

$ jarsigner -verify my_signed.apk

如果apk签名正确，Jarsigner输出“jar verified”。如果你想了解更多的细节，你可以尝试这些命令：

$ jarsigner -verify -verbose my_application.apk

或者

$ jarsigner -verify -verbose -certs my_application.apk

上面的命令，添加-certs选项，将会显示“CN=”行，描述谁创建了密钥。

注意: 如果你看到“CN=Android Debug”，这意味apk文件使用Android SDK生成的Debug key签的名。如果你想发布你的程序，你必须使用自己的密钥替换Debug key进行签名。

了解更多Jarsigner的信息，请参考http://java.sun.com/j2se/1.5.0/docs/tooldocs/#security。

4. 对齐APK包

一旦你对apk文件使用密钥进行签名后，一定要运行zipalign进行对齐。这个工具能做到让那些未压缩的数据以特定的字节对齐。以4字节对齐能优化性能。当对齐后，Android系统能通过mmap()阅读文件，即使它们包含二进制数据，而不是从包中拷贝所有的数据。好处是在运行程序时减少了随机读取内存的消耗。

zipalign由Android SDK提供，包含在tools/文件夹下。想对齐签名后的apk，执行：

zipalign -v 4 your_project_name-unaligned.apk your_project_name.apk

-v标志表示开始日志输出（可选）。4表示对齐的字节（不要使用非4的数字）。第一个文件参数是你的签名后apk（输入），第二个文件参数是目的apk文件（输出）。如果你想覆盖已经存在的apk，添加-f标志。

注意: 在你使用zipalign优化包之前，输入的apk必须是使用密钥签名后的。如果在zipalign操作之后再签名，那么对齐操作就白做了。

了解更多信息，请阅读“zipalign”工具的文档。

使用Eclipse/ADT编译和签名

如果你在使用Eclipse/ADT插件，你可以使用导出向导导出一个签名的apk（甚至可以创建一个新的keystore，如果需要的话）。导出向导替你做了所有与Keytool和Jarsigner交互的工作，并且使用GUI来签名应用程序，替代了上面提到的手动编译、签名和对齐的操作。一旦向导完成了编译和签名，也还会使用zipalign执行包的对齐操作。由于导出向导要使用Keytoo和Jarsigner。你应该确保它们是可用的，如“签名的基本设定”中描述的那样。

安全储存你的密钥

维护密钥的安全是极其重要的。如果你让其他人使用了你的key，或者你把keystore和密码放在一个不安全的地方以至于第三方人员找到并使用了的话，那么，你的授权认证和用户的信任都将受到连累。

如果第三方没有经过你的允许拿走了你的key，那个人就可以签名并发布应用程序，并恶意替换或攻击你的正版程序。这个人还可以签名并发布应用程序，利用你的名义来攻击其它程序或者系统自身，或者破坏、偷取用户数据。

开发者的名声依赖于正确的储存你的密钥，直到它过期。这里有几个安全储存密钥的提示：

·         为key和keystore设置强密码。

·         当你使用Keytool生成密钥的时候，不要再命令行中添加-storepass和-keypass选项。如果你这样做了，在shell记录中就可以获取你的密码。

·         相似的，当使用Jarsigner来签名程序时，也不要在命令行中添加-storepass和-keypass选项。

·         不要把密钥给别人或借给别人，不要让未授权的人知道你的keystore和key的密码。

总而言之，只要你在生成、使用和储存密钥时有安全意识的话，它还是很安全的。 

4、Android应用程序签名步骤
1）准备工作
      apk的签名工作可以通过两种方式来完成：
            1）通过ADT提供的图形化界面完成apk签名；
            2）完全通过DOS命令来完成apk签名
我比较喜欢第2）种方式，所以下面将讲解如何通过命令的方式完成apk签名。
      给apk签名一共要用到3个工具，或者说3个命令，分别是：keytool、jarsigner和zipalign，下面是对这3个工具的简单介绍：
            1）keytool：生成数字证书，即密钥，也就是上面说到的扩展名为.keystore的那类文件；
            2）jarsigner：使用数字证书给apk文件签名；
            3）zipalign：对签名后的apk进行优化，提高与Android系统交互的效率(Android SDK1.6版本开始包含此工具)
      从这3个工具的作用也可以看出，这3个工具的使用顺序。通常我们自己所开发的所有应用程序，都是使用同样的签名，即使用同一个数字证书，这就意味着：如果你是第一次做Android应用程序签名，上面的3个工具都将用到；但如果你已经有数字证书了，以后再给其它apk签名时，只需要用到jarsigner和zipalign就可以完成。
      为了方便使用上面3个命令，首先需要将上面3个工具所在路径添加到环境变量path中（我说的是为了方便使用，没有说必须要这么做）。怎么配置环境变量就不在此讲解了，这里需要说一下这3个工具默认所在的路径：
            1）keytool：该工具位于jdk安装路径的bin目录下；
            2）jarsigner：该工具位于jdk安装路径的bin目录下；
            3）zipalign：该工具位于android-sdk-windows/tools/目录下
      不知道大家是否注意到keytool和jarsigner两个工具是jdk自带的，也就意味着生成数字证书和文件签名不是Android的专利；另外从字面上理解jarsigner也能猜得出该工具主要是用来给jar文件签名的。
2）生成未经签名的apk文件
      既然我们要自己对apk进行签名，就不再需要ADT默认帮我们签名了。如何得到一个未经签名的apk文件呢？打开Eclipse，在Android工程名称上点击右键，依次选择“Android Tools” - “Export Unsigned Application Package ...”，然后选择一个存储位置保存即可。这样就得到了一个未经签名的apk文件。
3）使用keytool工具生成数字证书
      keytool -genkey -v -keystore liufeng.keystore -alias liufeng.keystore -keyalg RSA -validity 20000
说明：
      1）keytool是工具名称，-genkey意味着执行的是生成数字证书操作，-v表示将生成证书的详细信息打印出来，显示在dos窗口中；
      2）-keystore liufeng.keystore 表示生成的数字证书的文件名为“liufeng.keystore”；
      3）-alias liufeng.keystore 表示证书的别名为“liufeng.keystore”，当然可以不和上面的文件名一样；
      4）-keyalg RSA 表示生成密钥文件所采用的算法为RSA；
      5）-validity 20000 表示该数字证书的有效期为20000天，意味着20000天之后该证书将失效
在执行上面的命令生成数字证书文件时，会提示你输入一些信息，包括证书的密码，示例如下：

4）使用jarsigner工具为Android应用程序签名
      jarsigner -verbose -keystore liufeng.keystore -signedjar notepad_signed.apk notepad.apk liufeng.keystore
说明：
      1）jarsigner是工具名称，-verbose表示将签名过程中的详细信息打印出来，显示在dos窗口中；
      2）-keystore liufeng.keystore 表示签名所使用的数字证书所在位置，这里没有写路径，表示在当前目录下；
      3）-signedjar notepad_signed.apk notepad.apk 表示给notepad.apk文件签名，签名后的文件名称为notepad_signed.apk；
      4）最后面的liufeng.keystore 表示证书的别名，对应于生成数字证书时-alias参数后面的名称
5）使用zipalign工具优化已签名的apk（非必须但建议这么做）
      zipalign -v 4 notepad_signed.apk notepad_signed_aligned.apk
说明：
      1）zipalign是工具名称，-v表示在DOS窗口打印出详细的优化信息；
      2）notepad_signed.apk notepad_signed_aligned.apk 表示对已签名文件notepad_signed.apk进行优化，优化后的文件名为notepad_signed_aligned.apk

说明：如果你以前的程序是采用默认签名的方式（即debug签名），一旦换了新的签名应用将不能覆盖安装，必须将原先的程序卸载掉，才能安装上。因为程序覆盖安装主要检查两点：
      1）两个程序的入口Activity是否相同。两个程序如果包名不一样，即使其它所有代码完全一样，也不会被视为同一个程序的不同版本；
      2）两个程序所采用的签名是否相同。如果两个程序所采用的签名不同，即使包名相同，也不会被视为同一个程序的不同版本，不能覆盖安装。
      另外，可能有人可能会认为反正debug签名的应用程序也能安装使用，那也没有必要自己签名了嘛。千万不要这样想，debug签名的应用程序有这样两个限制，或者说风险：
      1）debug签名的应用程序不能在Android Market上架销售，它会强制你使用自己的签名；
      2）debug.keystore在不同的机器上所生成的可能都不一样，就意味着如果你换了机器进行apk版本升级，那么将会出现上面那种程序不能覆盖安装的问题。不要小视这个问题，如果你开发的程序只有你自己使用，当然无所谓，卸载再安装就可以了。但要是你的软件有很多使用客户，这就是大问题了，就相当于软件不具备升级功能！

一篇介绍比较详细的文档，Android应用签名