Android資源文件命名規範學習手冊
【推薦】 資源文件需帶模塊前綴。
【推薦】 layout 文件的命名方式。
Activity 的 layout 以 module_activity 開頭 Fragment 的 layout 以 module_fragment 開頭 Dialog 的 layout 以 module_dialog 開頭 include 的 layout 以 module_include 開頭 ListView 的行 layout 以 module_list_item 開頭 RecyclerView 的 item layout 以 module_recycle_item 開頭 GridView 的行 layout 以 module_grid_item 開頭
【推薦】 drawable 資源名稱以小寫單詞+下劃線的方式命名,根據分辨率不同存放在不同的 drawable 目錄下,建議只使用一套,例如 drawable-xhdpi。
采用規則如下:
模塊名_業務功能描述_控件描述_控件狀態限定詞
如:module_login_btn_pressed,module_tabs_icon_home_normal
【推薦】 anim 資源名稱以小寫單詞+下劃線的方式命名,采用以下規則:
模塊名_邏輯名稱_[方向|序號] tween 動 畫 資 源 : 盡 可 能 以 通 用 的 動 畫 名 稱 命 名 , 如 module_fade_in , module_fade_out , module_push_down_in (動畫+方向); frame 動畫資源:盡可能以模 塊+功能命名+序號。如:module_loading_grey_001
【推薦】 color 資源使用#AARRGGBB 格式,寫入 module_colors.xml 文件中,命
名格式采用以下規則:
模塊名_邏輯名稱_顏色
如:
<color name="module_btn_bg_color">#33b5e5e5</color>
【推薦】dimen 資源以小寫單詞+下劃線方式命名,寫入 module_dimens.xml 文件中,
采用以下規則:
模塊名_描述信息
如:
<dimen name="module_horizontal_line_height">1dp</dimen>
【推薦】style 資源采用小寫單詞+下劃線方式命名,寫入 module_styles.xml 文件中,
采用以下規則:
父 style 名稱.當前 style 名稱 如: <style name="ParentTheme.ThisActivityTheme"> … </style>
【推薦】string資源文件或者文本用到字符需要全部寫入 module_strings.xml文件中,
字符串以小寫單詞+下劃線的方式命名,采用以下規則:?
模塊名_邏輯名稱
如:moudule_login_tips,module_homepage_notice_desc
【推薦】 Id 資源原則上以駝峰法命名,View 組件的資源 id 需要以 View 的縮寫作為
前綴。常用縮寫表如下:
控件 | 縮寫 |
LinearLayout | ll |
RelativeLayout | rl |
ConstraintLayout | cl |
ListView | lv |
ScollView | sv |
TextView | tv |
Button | btn |
ImageView | iv |
CheckBox | cb |
RadioButton | rb |
EditText | et |
其它控件的縮寫推薦使用小寫字母並用下劃線進行分割,例如:
ProgressBar 對應的縮寫為 progress_bar
DatePicker 對應的縮寫為 date_picker
【推薦】 大分辨率圖片(單維度超過 1000)大分辨率圖片建議統一放在 xxhdpi 目錄下管理,否則將導致占用內存成倍數增加。
說明:
為了支持多種屏幕尺寸和密度,Android 為多種屏幕提供不同的資源目錄進行適配。為不同屏幕密度提供不同的位圖可繪制對象,可用於密度特定資源的配置限定符(在下面詳述) 包括 ldpi(低)、 mdpi(中)、 hdpi(高)、 xhdpi(超高)、 xxhdpi (超超高)和 xxxhdpi(超超超高)。例如,高密度屏幕的位圖應使用 drawable-hdpi/。
根據當前的設備屏幕尺寸和密度,將會尋找最匹配的資源,如果將高分辨率圖片放入低密度目錄,將會造成低端機加載過大圖片資源,又可能造成 OOM,同時也是資源浪費,沒有必要在低端機使用大圖。
正例:將 144*144 的應用圖標 PNG 文件放在 drawable-xxhdpi 目錄
反例:將 144*144 的應用圖標 PNG 文件放在 drawable-mhdpi
目錄擴展參考:https://developer.android.com/guide/practices/screens_support
Android資源文件命名規範學習手冊