Android教程網
  1. 首頁
  2. Android 技術
  3. Android 手機
  4. Android 系統教程
  5. Android 游戲
 Android教程網 >> Android技術 >> 關於Android編程 >> 最佳實踐之 Android代碼規范

最佳實踐之 Android代碼規范

編輯:關於Android編程

命名規范

包命名規范

采用反域名命名規則,包名全部小寫,連續的單詞只是簡單地連接起來,不使用下劃線,一級包名為com,二級包名為xxx(可以是公司域名或者個人命名),三級包名根據應用進行命名,四級包名為模塊名或層級名。如:

com.isa.crm.activity |
com.isa.crm.adapter

JAVA類命名規范

采用大駝峰式命名法,盡量避免縮寫,除非該縮寫是眾所周知的,比如HTML,URL,如果類名稱包含單詞縮寫,則單詞縮寫的每個字母均應大寫。如:

Product | ProductManager |
ProductListActivity | ProductListAdapter | JsonHTTPSRequest

接口命名規范

命名規則與類一樣采用大駝峰命名法,多以ableible結尾。例如:

interface Runable | interface Accessible

成員變量命名規范

采用小駝峰命名法

臨時變量命名

使用標准的Java命名方法,不推薦使用Google的m命名法。例如:

private String userName; 而不推薦使用 private String mUserName;

常量命名

常量使用全大寫字母加下劃線的方式命名。例如:

public static final String TAG = tag;

控件實例命名

類中控件名稱必須與xml布局id保持一致(可以去掉{module_name})。例如:

在布局文件中 Button 的id為: android:id=@+id/btn_pay

private Button btn_pay;

方法命名規范

動詞或動名詞,采用小駝峰命名法。例如:

run(); | onCreate(); | syncProducts();

布局文件(Layout)命名規范

全部小寫,采用下劃線命名法。其中{module_name}為業務模塊或是功能模塊等模塊化的名稱或簡稱。

activity layout{module_name}_activity_{名稱} 例如:

crm_activity_main.xml | crm_activity_shopping.xml

fragment layout:{module_name}_fragment_{名稱} 例如:

crm_fragment_main.xml | crm_fragment_shopping.xml

Dialog layout: {module_name}_dialog_{名稱} 例如:

crm_dialog_loading.xml

列表項布局命名{module_name}_list_item_{名稱} 例如:

crm_listitem_customer.xml

包含項布局命名include_{名稱} 例如:

include_head.xml

adapter的子布局{module_name}_item_{名稱} 例如:

qz_item_order.xml

widget layout{module_name}_widget_{名稱} 例如:

crm_widget_shopping_detail.xml

資源id命名規范

命名模式為:{view縮寫}_{module_name}_{view的邏輯名稱},如:

顧客管理CRM模塊布局 LinearLayout 的布局id –> ll_crm_content

模塊簡稱為qz的 ImageView 的布局id –> iv_qz_photo

常見控件View與其縮寫對照參考表如下:

這裡寫圖片描述

圖片資源文件命名規范

圖標命名{module_name}_ic_{名稱} 例如:

crm_ic_app.png

背景圖片命名{module_name}_bg_{名稱} 例如:

crm_bg_navbar_highlight_normal.9.png

按鈕Button命名{module_name}_btn_{名稱} 例如:

crm_btn_login_normal.9.png

按鈕checkbox圖片命名{module_name}_checkbox_{名稱} 例如:

crm_checkbox_cart_true.png

其他圖片命名{module_name}_icon_{名稱} 例如:

qz_icon_blue_circle.png

代碼風格

大括號問題

風格一

if (hasMoney())
{

}
else
{

}

風格二

if (hasMoney()) {

} else {

}

空格問題

if else | while | 運算符兩端 等後面需用空格隔開。例如:

規范的編寫方式:

if (hasMoney()) {

} else {

}


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

}

不規范的編寫方式:

if(hasMoney()){

}else{

}


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

}

方法參數

當方法參數數量過多時,需進行換行處理.

注釋

必須要對所有實例變量、類常量進行注釋說明 例如:

// 用戶姓名
private String userName

必須對所有的類、接口進行注釋說明 例如:

/**
* Activity基類
*
* @author [email protected]
*/
public class BaseActivity extends Activity
{

}

必須對所有的方法進行注釋說明 例如:

/**
* 請求
*
* @param path 路徑
* @param generalParams 基本參數
* @param businessParams 業務參數
* @return 請求結果
* @throws ApiException 請求錯誤則返回該異常
*/
public Map request (String path,
              Map generalParams,
              Map businessParams) throws ApiException {

   return null;
}

更多詳細也可以參考:
[Google Java編程風格指南](http://hawstein.com/posts/google-java-style.html)

駝峰式命名法(CamelCase)

大駝峰式命名法(UpperCamelCase):
每個單詞的第一個字母都大寫 如:XmlHttpRequest

小駝峰式命名法(lowerCamelCase):
除了第一個單詞,每個單詞的第一個字母都大寫 如:xmlHttpRequest

說明

該篇介紹為Android項目開發過程中的一些常用的命名規范|代碼編寫風格規范,該規范來源於個人資料整理(參考網絡技術博客)、個人項目實踐。參考這些規范有助於 項目的協同開發,項目代碼的風格統一、在項目的後期維護中更方便、快捷的查找、理解和修改別人的代碼。如朋友們有更好的規范要求、歡迎分享出來、一起討論。

 

 
  1. 上一頁:
  2. 下一頁:
熱門文章
閱讀排行版
Copyright © Android教程網 All Rights Reserved