【Android学习】Android工程资源命名禁忌

在制作一个继续按钮时，将button的id设置为continue，发现报了错误，error: invalid symbol: 'continue'

一开始还以为是编码问题，后来百度之后才知道安卓Android项目中资源文件或者id都不能使用Java保留符号

原因是它们会被翻译成Java代码（R.java），使Dalvik VM可以解释。

所以顺便总结一下安卓工程中的命名禁忌，以免以后还犯这种错误

Android工程中，resdrawable 文件夹下所有的图片资源文件命名，不允许：

1. 大写字母

从Eclipse的这个报错可以知道资源文件的命名规则。

Invalid file name: must contain only [a-z0-9_.]

参考Android Issue 31。

2. "default.png"

不能生成 R.java，报错：

resdrawabledefault.png:0: error: invalid symbol: 'default'

出现这个错是因为类似default和continue等是Java的保留符号，而Android项目中资源文件（譬如drawable中的图片和strings.xml等）不能使用Java保留符号的原因是它们会被翻译成Java代码（R.java），使Dalvik VM可以解释。

例如strings.xml中的

<string name="continue">Continue</string>

可被翻译成

public final class R {
    public static final class string {
        public static final int continue=0x7f040000;
    }
}

Java的Keyword清单：http://docs.oracle.com/javase/tutorial/java/nutsandbolts/_keywords.html

3. 以下划线（"_"）开头

不能生成 R.java，报错Type是 "Android AAPT Problem"。

(skipping (null) file ...)

2009年提交的Android Issue 5343指出“Files in the assets folder starting with an underscore are omitted by the build script”，“Folders starting with an underscore are omitted without warning.”。更多信息都在5343这个issue detail里。

看上去，res/drawable里以下划线开头的文件也被aapt报错了。类似的还有人提到res/raw里的python脚本文件__init__.py。

4. 以数字加下划线（"[0-9]_"）开头

常见于图片资源。可以生成 R.java，但是 R.java 文件内报错：

Underscores can only be used with source level 1.7 or greater

这里涉及到两种情况。

Java标识符不能以数字开头，第一个字符应该是字母。
下划线。Java 7中引入了一个新特性“Underscores in Numeric Literals”。譬如1_000就是1000。

以数字开头的报错如下：

Syntax error on token "0xxx", delete this token

更多参考：Android 命名规范（提高代码可以读性）