当前位置：首页 > 资讯 > 技术文档

浅谈Android编码规范及命名规范

时间：2020-11-21 00:31 编辑：来源：阅读：
扫一扫，手机访问

摘要：浅谈Android编码规范及命名规范

[b]前言：[/b] 　　目前工作负责两个医疗APP项目的开发，同时使用LeanCloud进行云端配合开发，完全单挑。　　现大框架已经完成，正在进行细节模块上的开发　　抽空总结一下Android项目的开发规范：1、编码规范 2、命名规范　　　　注：个人经验，经供参考 [b]一、Android编码规范[/b] 　　[b]1、学会使用string.xml文件[/b] 　　在我看来，当一个文本信息出现的次数大于一次的时候就必须要使用string.xml 　　比如一个保存按钮，不规范写法：

 <Button
  android:id="@+id/editinfo_btn_save"
  android:layout_width="wrap_content"
  android:layout_height="wrap_content" 
  android:text="保存"
 />

这里给它的文本内容设置为"保存"，那么一个app中所有的保存按钮都这样写。当有一天要修改需求了，要求把“保存”文字改成“提交”，那么我们只能去一个个布局文件中修改，　　岂不浪费大量时间又可能会存在漏掉修改的情况。　　规范写法：

 <Button
  android:id="@+id/editinfo_btn_save"
  android:layout_width="wrap_content"
  android:layout_height="wrap_content" 
  android:text="@string/save"
 />

而在string.xml文件中： [code]<string name="save">保存</string>[/code] 　　这种写法，往后需要修改，只需要在string.xml文件中修改一行代码便实现了整个APP的该文本内容修改。　　[b]2、学会使用color.xml ,dimens.xml文件的使用[/b] 　　同string.xml使用一致，同学们应该都懂的，切勿因为一时的懒，导致后期的迭代费时费力。　　[b]3、团队协同确定一套标准Activity的onCreate()方法中代码执行流程[/b] 　　其实刚接触Android的时候，我的不规范代码是这样的：

 private Button scan;  //扫描按钮
 private Button create;  //创建按钮
 private ArrayList<Object> datas; //数据源
 @Override
 protected void onCreate(Bundle savedInstanceState) {
 super.onCreate(savedInstanceState);
 setContentView(R.layout.activity_main);
 create = (Button) findViewById(R.id.create);
 scan = (Button) findViewById(R.id.scan);
 scan.setOnClickListener(this);
 create.setOnClickListener(this);
 datas = new ArrayList<>();
 datas.add(new Integer(1));
 datas.add(new Integer(2));
 datas.add(new Integer(3));
 datas.add(new Integer(4));
 }

什么都不管，所有的操作代码都写在onCreate()方法中，包括find控件。设置监听事件，加载数据源等等。　　可以看到现在就2个控件一个数据源，代码就这么多了，如果一个界面有10多个控件呢，那onCreate()方法中的代码量就成倍数的多起来了。　　所以所有的Activity都要设定一个统一的规范。　　我们都知道，一个Activity中有基本都有的操作：　　　　①、初始化变量　　　　②、初始化控件　　　　③、设置监听事件　　　　④、加载网络数据并显示　　那么就可以将以上的代码分门别类的放在这几个方法中　　比如一段规范代码：

public class MainActivity extends AppCompatActivity implements View.OnClickListener {
 private Button btn_scan;  //扫描按钮
 private Button btn_create;  //创建按钮
 private ArrayList<Object> datas; //数据源
 @Override
 protected void onCreate(Bundle savedInstanceState) {
 super.onCreate(savedInstanceState);
 setContentView(R.layout.activity_main);
 initVariables();
 initView();
 initEvent();
 loadData();
 }
 //初始化变量，比如 上一个Activity传来的Intent的数据 本Activity中一些标记变量等
 private void initVariables() {

 }
 //加载数据源
 private void loadData() {
 }
 //注册监听事件
 private void initEvent() {
 btn_scan.setOnClickListener(this);
 btn_create.setOnClickListener(this);
 }
 //初始化控件
 private void initView() {
 btn_create = (Button) findViewById(R.id.create);
 btn_scan = (Button) findViewById(R.id.scan);
 }
 //设置点击事件
 @Override
 public void onClick(View v) {
 switch (v.getId()){
  case R.id.btn_scan:
  //扫描二维码
  startActivity(new Intent(this,ScanActivity.class));
  break;
  case R.id.btn_create:
  //生成二维码
  startActivity(new Intent(this,CreateActivity.class));
  break;
 }
 }
}

可以看到，onCreate()中就那么几个方法了，我们需要找问题的时候在相应的方法中去找即可，既方便又清晰。其实这种操作我们可以写一个BaseActivity作为它的的抽象方法，然后让Activity继承这个BaseActivity基类重写方法即可，涉及到架构，这个往后再说。　　[b]4、团队协同确定一种控件的点击事件OnClickListener()[/b] 　　　 Android给我们提供5种给控件设置OnClick的方法，个人觉得项目中用的最多的就是　　 ①、参数this 然后Activity 实现 View.OnClickListener接口重写 onClick()方法 [code] btn_create.setOnClickListener(this);[/code] 　　 ②、直接参数new OnclickListener()的

 btn_create.setOnClickListener(new View.OnClickListener() {
  @Override
  public void onClick(View v) { 
  }
 });

其他三个方法个人觉得尽量不要用。而这两种方法中第一种是更好的，因为我们可以通过switch--case 的方法区分不同控件的点击事件，代码更清晰简约。　　当然第二种方法也是可以的，但是切记同一个项目中最好只有一种方式，便于后期的维护。

//设置点击事件
 @Override
 public void onClick(View v) {
 switch (v.getId()){
  case R.id.scan:
  //扫描二维码
  startActivity(new Intent(this,ScanActivity.class));
  break;
  case R.id.create:
  //生成二维码
  startActivity(new Intent(this,CreateActivity.class));
  break;
 }
 }

[b] 5、尽量少用全局变量static进行传值操作[/b] 　　　 static的特性大家应该都是知道的，他会一直占用一部分内存，虽然很少，但是一个项目中成百上千个使用的话，对项目是非常不好的。　　　建议页面之间的传值还是用Intent ，实现没有好的解决方案的再用static ， PS ，我之前公司的项目就非常大量的使用了static 注：有些同学可能对Activity和Fragment的互相传值不大会，这里推荐一个解决方案：[url=http://www.1sucai.cn/article/99357.htm]浅谈EventBus [/url]，对我来说是项目必备，但是也要合理运用　[b]6、Activity中尽量不要使用内部类[/b] 　　　　这里以RecyclerView举例，一款非常棒的控件，有了它再也不用ListView了，[url=http://www.1sucai.cn/article/99358.htm]浅谈RecyclerView(完美替代ListView,GridView)[/url] 　　　　一个RecyclerView是配套一个Adapter和一个ViewHolder的。　　　　不规范做法：部分同学图省事（当然放在一个Activity中确实方便数据传输和item点击事件操作），把它们都写在一个Activity中，这样是不可取的，因为大大的增加了单个Activity的代码量，对维护来说很不方便。　　　　规范做法：　ViewHolder一个类，Adapter一个类，分工明确，避免一个类中代码量过多的问题。　　　　注：ListView，ViewPager 使用同上　　　　至于类的分类，有的同学喜欢一个功能模块放在一个包下，比如一个功能点的Activity ， Adapter ,ViewHolder都放在一个包下有的同学喜欢一种类的放在一个包下，比如将所有的Activity放在activitys包下，将所有的Adapter放在adapters包下。　　　　这都是后话，将来学习架构的时候再详谈　　[b]7、使用ArrayList代替HashMap[/b] 　　　据说，是据说，ArrayList使用的内存要低于HashMap，因为android手机参差不齐，所以开发过程中对内存还是非常重视的，能省则省。　　　　PS：我的项目中基本使用的ArrayList，除非是ArrayList代替不了的数据结构　　[b]8、团队规范统一的第三方[/b] 　　　现在方便又好用的第三方太多了，图片框架好几个优秀的，推送好几个优秀的，即时通讯好几个优秀的。　　　注意使用太多的第三方会导致程序过大，而且应用有一个最大方法数的限制，避免实现一种功能的第三方，团队成员使用的都是不一样的第三方。　　[b]9、统一代码格式[/b] 　　　　经典的就是for循环了，一种是左括号放在最后，一个是另起一行。统一下，界面看起来舒服，个人建议左括号放在最后的方式，别问我为啥，大学老师推荐的，理由：忘了。

 for (int i = 0; i < 10; i++) { 
 }
 for (int i = 0; i < 10; i++) 
 { 
 }

[b]10、不同功能代码之间要有一行空格分开[/b] 　　　　配合的写上注释，告诉维护的同学，哪一段代码是进行什么操作的　　　　为了代码清晰也为了维护的同学少长两根头发。。　[b]11、如果你是Android Studio开发[/b] 　　　　请频繁使用Ctrl+A --》 Ctrl +Alt + I -------------------------------------------------------------------------------------------------------------------------- [b]二、Android命名规范[/b] 　　命名规范:驼峰法,下划线分割法。　　[b]1、Java类文件[/b] 　　①、Activity：以Activity作为后缀，这个相信大家AS给你的都帮你做好了。　　②、Adapter: 以Adapter作为后缀　　③、ViewHolder: 以ViewHolder作为后缀　　④、实体类Entity：以Entity作为后缀　　如下，我是以功能模块分包，大神勿喷，个人喜好： [img]http://files.jb51.net/file_images/article/201612/2016120711304613.png[/img] 　 [b]2、xml文件[/b] 　　①、layout.xml 　　　　Activity的布局文件以activity_ 开头，AS提供的。　　　　列表项的布局文件listview 以 item_list_开头。　　②、控件的命名　　　　缩写，这个看个人了，　　　　我的经验，比如：　　　　LayoutView ---- lv 　　　　TextView ---- tv Button ---- btn 　　　　ImageView ---- img 　　切记，不要使用拼音命名，即使英文这么菜的博主我开发都开着有道词典。　　最后，编码一定要写注释，你命名的如果英文不是立马能看懂的，请一定要写上注释。

全部评论(0)

上一篇：Android应用启动速度优化
下一篇：基于Android AIDL进程间通信接口使用介绍

资讯排行榜
更多>>