仰天大笑出门去,我辈岂是蓬蒿人。这篇文章主要讲述Android开发必备:命名规范相关的知识,希望能为你提供帮助。
标识符命名法最要有四种:
- Camel(骆驼)命名法:除首单词外,其余所有单词的第一个字母大写,如:fooBar;
- Pascal命名法:所有单词的第一个字母大写,如:FooBar;
- 下划线命名法:单词与单词间用下划线做间隔,如:foo_bar;
- 匈牙利命名法:广泛应用于微软编程环境中,在以Pascal命名法的变量,首字母小写说明该变量的类型。 量的取名方式为:scope_ prefix_qualifier 范围前缀,类型前缀,限定词,如:g_foo_bar;
缩写在命名是必须的,遵循下面规则:
- 较短的单词可通过去掉“元音”形成缩写,如icon-> ic;
- 较长的单词可取单词的头几个字母形成缩写,如:average-> avg;
- 此外还有一些约定成俗的英文单词缩写,如 Internationalization-> I18N;
- 程序中不要用缩写,除非该缩写是约定俗成的。
【Android开发必备(命名规范)】包(packages): 采用反域名命名规则,全部使用小写字母。一级包名为地顶级域名如com,二级包名为xx(可以是公司或则个人的随便),三级包名根据应用进行命名,四级包名为模块名或层级名; 如 com.tinyx.myapp.activities;
类(classes):用Pascal命名法,尽量避免缩写,如:MyActivity;缩写是众所周知的,如html,URL;类名称中包含单词缩写,则单词缩写的每个字母均应大写,如:PublicHTML,CommonURL。
接口(interface):与类一样用Pascal命名法,多以able或ible结尾,多用作表示行为,如Runnable,Accessible;
方法(methods):动词或动名词,采用Camel命名法,如:onCreate(),run();下面是一些建议:
- 初始化相关方法,使用init为前缀标识,如:初始化布局initView();
- boolean型使用is或check为前缀标识, 如:checkValue()、isValidate();
- 返回某个值的方法,使用get为前缀标识,如:getName();
- 数据进行处理相关,尽量使用process为前缀标识,如:processUpdate();
- 保存数据相关,使用save为前缀标识,如:saveData();
- 对数据重置的,使用reset前缀标识,如:resetData();
- 清除数据相关,使用clear前缀标识,如:clearData();
- 移除某些项目,使用remove前缀标识,如:removeItem();
- 绘制数据或效果相关的,使用draw前缀标识,如:drawCircle();
- 模型类变量默认以上规则
1 public class User { 2public String name; 3public String phone; 4public int sex; //1,男 2,女 5 6public User() { 7this.name = "myname"; 8this.phone = "123“ 9this.sex = 0; 10} 11 }
- 非模型类全局参数建议加上小写m开头;
1 public class TestActivity extends Activity{ 2private ZoomableImageView mZoomableView; 3private TabLayout mTabLayout; 4private int mItemsCount; 5 6@Override 7protected void onCreate(Bundle savedInstanceState) { 8super.onCreate(savedInstanceState); 9setContentView(R.layout.test_activity); 10} 11 }
常量(constants): 全部大写,采用下划线命名法.如下:
1 public static final int MAX_ITEMS= 10; 2 public static final String TAG = User.class.getSimpleName();
资源文件命名(resources):采用下划线命名法,全部小写,针对不同资源,建议用下面的命名方法;
- drawable资源,加前缀命名:前缀_功能_模块_说明.xml/png/
说明 | 命名范例 |
---|---|
图标:建议格式 ic_xxx; | ic_appicon.png |
背景:建议格式 bg_xxx; | bg_normal_button_default.xml,bg_normal_button_press.xml |
- layout 资源文件,前缀命名:类型_模块_功能_说明.xml,举一些常用的例子如下:
说明 | 命名范例 |
---|---|
Activity布局文件 | activity_main.xml |
Fragment布局文件 | fragment_main.xml |
局部布局View文件 | view_main_header.xml,view_main_bottom.xml |
自定义提示对话框 | dialog_alert.xml |
列表项等 | fragment_user_list_item.xml |
- 动画anim资源文件(anim只有一种资源,所以不必加前缀区分):模块_功能_动画_方向.xml
说明 | 命名范例 |
---|---|
淡入 | main_button_fade_in.xml |
淡出 | main_button_fade_out.xml |
从下方推入 | button_push_down_in.xml |
从下方推出 | main_button_push_down_out.xml |
- menu菜单资源文件(menu只有一种资源,所以不必加前缀区分),模块_功能_说明.xml
说明 | 命名范例 |
---|---|
主界面菜单 | main_activity.xml |
Fragment界面菜单 | user_fragment.xml |
- values资源,这个主要分下面几种资源:
说明 | 命名范例 |
---|---|
布局和子控件(ViewGroup,自定义View) | view_main_topnav |
TextView | tv_main_title |
Button | btn_user_add |
ImageButton | imgbtn_user_del |
ImageView | img_thumb |
CheckBox | cb_sex |
RadioButton | rbtn_answer |
EditText | et_username |
ToggleButton | toggle_funtion |
ProgressBar | pb_download |
SeekBar | sb_progress |
ProgressBar | pb_download |
VideoView | vv_course |
WebView | wv_download |
RantingBar | rb_download |
Spinner | sp_cities |
ScollView | sv_main |
TextSwitch | sp_cities |
ListView/ExpandListView/RecyclerView | lv_cities |
MapView | mv_location |
3、attrs/colors/ids的属性和名称使用 Camel命名法; styles的属性使用Camel命名法,名称使用Pascal命名法;如下面:
1 < !--attrs--> 2 < attr name="text" format="string" /> 3 < attr name="itemIcon" format="reference" /> 4 < attr name="showToggle" format="boolean" /> 5 < attr name="showVersion" format="boolean" /> 6 < style name="Theme.AppCompat.Light.NoActionBar"> 7< item name="windowActionBar"> false< /item> 8< item name="windowNoTitle"> true< /item> 9 < /style> 10 11< !--colors--> 12< color name="colorPrimary"> #009688< /color> 13< color name="colorPrimaryDark"> #00796b< /color> 14< color name="colorAccent"> #cddc39< /color> 15 16< !--ids--> 17< item name="tabLayout" type="id"/> 18< item name="viewPager" type="id"/> 19< item name="viewContainer" type="id"/>
转自http://blog.tinyx.cc/android-naming.html
推荐阅读
- Android 解决手机unauthorized错误
- android调试工具adb命令大全
- Android(组件大全)
- Android学习笔记---自定义TextView实现阴影效果
- Android6.0 Home定制
- Android基础(常用布局和数据存储)
- .net平台借助第三方推送服务在推送Android消息(极光推送)
- Android Studio 开发JNI应用
- 使用极光推送(www.jpush.cn)向安卓手机推送消息服务端向客户端主送推送C#语言