寫在前面:
不論是哪種語(yǔ)言虫碉,規(guī)范的編碼總能準(zhǔn)確描述表達(dá)的含義贾惦,讓人較容易明白,好的代碼規(guī)范能夠省去很多注釋,提高同事之間的工作效率须板。
下面就總結(jié)一下我平時(shí)用到的代碼規(guī)范碰镜。
先介紹兩種命名規(guī)則:
駝峰命名法:又稱小駝峰命名法。除了首個(gè)單詞首字母小寫除外习瑰,其余所有單詞所有首字母都要大寫绪颖。
帕斯卡命名法:又稱大駝峰命名法。所有單詞首字母大寫甜奄。
1柠横、包的命名規(guī)范
所有單詞小寫,只能包含a-z字母课兄,或有含義的阿拉伯?dāng)?shù)字如4代替for,2代替to
建議采用如下規(guī)則:【com】.【公司名/組織名】.【項(xiàng)目名稱】.【模塊名】
常見(jiàn)的包分層結(jié)構(gòu)如下:
com.xxx.xxx.view –> 自定義view 或者是View接口
com.xxx.xxx.activities –> activity類
com.xxx.xxx.fragments –> fragment類
com.xxx.xxx.adapter –> 適配器相關(guān)
com.xxx.xxx.utils –> 公共工具類
com.xxx.xxx.bean –> 實(shí)體類
com.xxx.xxx.service –> service服務(wù)
com.xxx.xxx.broadcast –> 廣播接收器
com.xxx.xxx.db –>數(shù)據(jù)庫(kù)操作類
com.xxx.xxx.persenter –> 中間對(duì)象
com.xxx.xxx.model –> 數(shù)據(jù)處理類
2滓鸠、類的命名規(guī)范
首字母大寫,大駝峰命名法第喳,使用名詞糜俗。
Activity ? ? ? ? ? ? ? ? ? ? ? ?類Activity為后綴標(biāo)識(shí) ? ? ? ? ? ? ? ?
Adapter類 ? ? ? ? ? ? ? ? ? ?Adapter 為后綴標(biāo)識(shí) ? ? ? ? ? ? ?
解析類 ? ? ? ? ? ? ? ? ? ? ? ? Parser為后綴標(biāo)識(shí) ? ? ? ? ? ? ? ? ??
工具方法類 ? ? ? ? ? ? ? ? ?Util或Manager為后綴標(biāo)識(shí) ? ? ?
管理類 ? ? ? ? ? ? ? ? ? ? ? ? Manager為后綴標(biāo)識(shí) ? ? ? ? ? ? ? ??
Service類 ? ? ? ? ? ? ? ? ? ?以Service為后綴標(biāo)識(shí)?
Receiver類 ? ? ? ? ? ? ? ? ?以Receiver為后綴標(biāo)識(shí)
ContentProvider ? ? ? ? ?以Provider為后綴標(biāo)識(shí)
自定義基類 ? ? ? ? ? ? ? ? ?以Base開(kāi)頭
自定義view ? ? ? ? ? ? ? ? ?功能描述 + View
自定義widget ? ? ? ? ? ? ? 模塊名 + 類型(List/Info) + Widget
3、常量命名
所有單詞大寫曲饱,單詞間以”_“分隔
4悠抹、變量命名
駝峰命名。成員變量以m開(kāi)頭扩淀;靜態(tài)變量以s開(kāi)頭
5楔敌、方法命名
與java開(kāi)發(fā)類似,采用駝峰命名規(guī)則驻谆。首單詞首字母小寫卵凑,其余單詞首字母大寫。盡量不要使用下劃線胜臊。
6勺卢、資源文件
1)布局文件
Activity-------------------activity_
Fragment-------------------fragment_
Dialog-------------------dialog_
PopupWindow-------------------popup_
Menu-------------------menu_
Adapter-------------------layout_item_
(2)圖片
bg_xxx-------------------背景圖片
btn_xx-------------------按鈕
ic_xxx-------------------單個(gè)圖標(biāo)
bg _ 描述 _ 狀態(tài)-------------------控件上的不同狀態(tài)
btn _ 描述 _ 狀態(tài)-------------------按鈕上的不同狀態(tài)
chx _ 描述 _ 狀態(tài)-------------------選擇框,一般2態(tài)或4態(tài)
(3)anim目錄下的命名規(guī)范
單詞全部小寫象对,單詞之間采用下劃線分割黑忱。
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
目前收集到的結(jié)合平時(shí)自己的使用習(xí)慣大概就這些,好的命名規(guī)范是一項(xiàng)重要的技能勒魔,可以在團(tuán)隊(duì)合作中可以很大限度減少溝通成本甫煞。無(wú)規(guī)范不成方圓。