無規矩不成方圓，是吧。。哈哈~~

很慶幸，本人剛學java程式設計的時候，就被老師灌輸了程式設計規範的相關知識，並且一直在遵守。

有過團隊開發經驗的人都知道，如果沒有一定的規範可行，那麼程式碼看起來將是苦不堪言，甚至是亂七八糟。

下面就介紹一下，我個人編碼過程中使用到的規範，供大家參考~~

命名規範

命名規範要望文知義，簡單明瞭。
命名規範定製太多，就會讓人心煩，反而沒人遵守了。
                         ---《APP研發錄》

先介紹兩種命名規則：

• 駝峰命名法：又稱小駝峰命名法。除了首個單詞首字母小寫除外，其餘所有單詞所有首字母都要大寫。

• 帕斯卡命名法

  ：又稱大駝峰命名法。所有單詞首字母大寫。

包的命名規範

包名一律小寫

建議採用如下規則：【com】.【公司名/組織名】.【專案名稱】.【模組名】

比如：com.jacksen.mvp.demo。然後在這個目錄下根據業務邏輯進行分層。

常見的包分層結構如下：

• com.xxx.xxx.view –> 自定義view 或者是View介面

• com.xxx.xxx.activities –> activity類

• com.xxx.xxx.fragments –> fragment類

• com.xxx.xxx.adapter –> 介面卡相關

• com.xxx.xxx.utils –> 公共工具類

• com.xxx.xxx.bean –> 實體類

• com.xxx.xxx.service –> service服務

• com.xxx.xxx.broadcast –> 廣播接收器

• com.xxx.xxx.db –> 資料庫操作類

• com.xxx.xxx.persenter –> 中間物件

• com.xxx.xxx.model –> 資料處理類

類的命名規範

Android中類的命名與JAVA開發採用一致的規範即可。

大駝峰命名法，即所有單詞首字母大寫。

• Activity –> xxxActivity.java

• Application –> xxxApplication.java

• Fragment –> xxxFragment.java

• Service –> xxxService.java

• BroadcastReceiver –> xxxBroReceiver.java

• ContentProvider –> xxxProvider.java

• Adapter –> xxxAdapter.java

• Handler –> xxxHandler.java

• 介面 –> xxxInter.java

• 介面實現類 –> xxxImpl.java

• Persenter –> xxxPersenter.java

• 公共父類 –> BaseActivity.java、BaseFragment.java、- BaseAdapter.java等

• util類 –> LogUtil.java

• 資料庫類 –> BaseSQLiteDBHelper.java

變數的命名規範

採用駝峰命名規則。

Java普通變數：

• resultString

• userBean

• loginPresenter

Android控制元件變數：

• loginBtn

• inputPwdEt

• showNameTv

有些人建議採用【控制元件縮寫】+【控制元件邏輯名稱】的方式，比如btnLogin。不過我個人比較習慣反過來寫，比如loginBtn。與類的命名類似，把邏輯名稱寫在前面。

常用控制元件的縮寫

常見單詞的縮寫：

常量命名：
全部單詞采用大寫，每個單詞之間用“_”分割。

例如：

public static final String API_URL = "http://apis.baidu.com/heweather/weather/free";

方法的命名規範

與java開發類似，採用駝峰命名規則。首單詞首字母小寫，其餘單詞首字母大寫。儘量不要使用下劃線。

舉例：

• setxxx()

• getxxx()

• loginxxx()

• onCreate()

• onDestory()

• isxxx() –> 返回值是boolean型別

• checkxxx()

方法的命名規範

全部採用小寫，單詞之間使用下劃線分割。

佈局檔案：

• activity_login.xml

• fragment_first_tab.xml

• item_choose_city.xml

• dialog_choose_city.xml

• common_footer.xml

• popup_xxx.xml

控制元件ID：

上面【常用控制元件的縮寫】表格中基本列出了常用控制元件的ID寫法。

• login_btn

• input_phone_et

• input_pwd_et

• login_pbar

drawable目錄下的命名規範

全部單詞小寫，單詞之間採用下劃線分割。

• 圖示 – > ic_xxx.png –> ic_logo.png

• 背景圖 –> bg_xxx.jpg –> bg_splash.jpg

• selector –> selector_login_btn.xml

• shape –> shape_login_btn.xml

• 圖片狀態 –> bg_login_btn_pressed.jpg & - bg_login_btn_unpressed.jpg

anim目錄下的命名規範

單詞全部小寫，單詞之間採用下劃線分割。

• fade_in.xml

• fade_out.xml

• slide_in_from_left.xml

• slide_in_from_top.xml

• slide_out_to_right.xml

• slide_out_to_bottom.xml

編碼規範

• 程式碼中儘量不要出現中文。註釋和除外。程式碼中通過strings.xml引用來顯示中文。

• 控制元件宣告放在activity級別，這樣在activity其他地方可以使用。

• 在一個View.OnClickListener中處理所有的點選事件邏輯，這樣看起來很集中和直觀。

• strings.xml中使用%1sd等實現字串的通配。

• 佈局檔案中的字型大小，都定義在dimens.xml中。

• 有關margin和padding的值也都放在dimens.xml中。

• 介面之間傳值儘量使用intent方式。少用全域性變數。

• 不建議在佈局檔案中新增點選事件。

• 資料型別轉換一定要校驗。

• 使用常量代替列舉。

• 實體不要在不同模組間共享，但是可以在統一模組下的不同頁面共享。

• 建議採用左括號與方法名稱在同一行的程式碼格式來進行程式碼的編寫和格式化。貌似左括號在下一行是C#的形式。

• 業務稍微複雜一些，都有可能提煉一個BaseActivity或BaseFragment出來做為公共父類。

• 類註釋一定要寫，管家的方法也要寫方法註釋。常量儘量寫註釋。

專案中的命名規範和編碼規範，是一個專案Leader前期需要準備的，也是一項必備技能。

制定好了規範，就要遵守，有了統一的規範，專案才好維護，相互之間才好review程式碼，便於開發與維護。

參考

《APP研發錄》

介紹完畢，歡迎指教~~