1 xml文件
xml是Extensible Markup Language即可扩展标记语言的缩写。xml文件就是用xml语言编写的文件,用来存储数据、携带数据和交换数据。Android Studio中的xml文件用于定义资源,如布局、图片、字符串、颜色和风格等。
2 手动添加注释
在xml文件中手动添加“<!--注释内容-->”,即可将注释写入到“注释内容”的位置上,如图1所示。
图1 手动添加注释
3 自动添加注释
可以通过菜单栏或者快捷按键自动添加注释
3.1 菜单栏添加注释
3.1.1 单行注释
对于单行的注释,在xml文件中选中要注释的内容,选择菜单栏“Code->Comment with Line Comment”,完成单行注释,如图2①所示。
3.1.2 多行注释
对于多行的注释,在xml文件中选中要注释的内容,选择菜单栏“Code->Comment with Block Comment”,完成单行注释,如图2②所示。
图2 菜单栏添加注释
3.2 快捷按键注释
选中要注释的内容,“Ctrl+/”为单行注释的快捷按键,“Ctrl+Shift+/”为多行注释的快捷按键。
4 添加注释的位置
注释必须要添加到标签的外部,而不能添加到标签的内部,因为标签中含有“<”和“>”,如果将注释添加到标签内容,则注释中的“<”和“>”和标签中的“<”和“>”会形成闭合范围,导致意想不到的错误,如图3所示。
图3 添加注释的位置
从图3中可以看出,①和③的注释在标签内容,此时会引起标签闭合范围会乱,产生错误,而注释②的位置是正确的。