Android開發規範之------Android 資原始檔命名與使用
以下主要引用阿里巴巴 Android 開發手冊:
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 開頭
3.【推薦】 drawable 資源名稱以小寫單詞+下劃線的方式命名,根據解析度不同存放
在不同的 drawable 目錄下,建議只使用一套,例如 drawable-xhdpi。採用規則如下:
模組名業務功能描述控制元件描述_控制元件狀態限定詞
如:module_login_btn_pressed,module_tabs_icon_home_normal
4.【推薦】anim 資源名稱以小寫單詞+下劃線的方式命名,採用以下規則:
模組名邏輯名稱[方向|序號]
tween 動 畫 資 源 : 盡 可 能 以 通 用 的 動 畫 名 稱 命 名 , 如 module_fade_in ,
module_fade_out , module_push_down_in (動畫+方向);
frame 動畫資源:儘可能以模 塊+功能命名+序號。如:module_loading_grey_001
5.【推薦】 color 資源使用#AARRGGBB 格式,寫入 module_colors.xml 檔案中,命
名格式採用以下規則:
模組名邏輯名稱顏色
<color name="module_btn_bg_color">#33b5e5e5</color>
6.【推薦】dimen 資源以小寫單詞+下劃線方式命名,寫入 module_dimens.xml 檔案中,
採用以下規則:
模組名_描述資訊
如:
<dimen name="module_horizontal_line_height">1dp</dimen>
7.【推薦】style 資源採用小寫單詞+下劃線方式命名,寫入 module_styles.xml 檔案中,
採用以下規則:
父 style 名稱.當前 style 名稱
如:
<style name="ParentTheme.ThisActivityTheme">
…
</style>
8.【推薦】string資原始檔或者文字用到字元需要全部寫入module_strings.xml檔案中,
字串以小寫單詞+下劃線的方式命名,採用以下規則:
模組名_邏輯名稱
如:moudule_login_tips,module_homepage_notice_desc
9.【推薦】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
10.【推薦】大解析度圖片(單維度超過 1000)大解析度圖片建議統一放在 xxhdpi 目錄
下管理,否則將導致佔用記憶體成倍數增加。
說明:
為了支援多種螢幕尺寸和密度,Android 為多種螢幕提供不同的資源目錄進行適配。
為不同螢幕密度提供不同的點陣圖可繪製物件,可用於密度特定資源的配置限定符(在
下面詳述) 包括 ldpi(低)、mdpi(中)、 hdpi(高)、xhdpi(超高)、xxhdpi (超
超高)和 xxxhdpi(超超超高)。例如,高密度螢幕的點陣圖應使用 drawable-hdpi/。
根據當前的裝置螢幕尺寸和密度,將會尋找最匹配的資源,如果將高解析度圖片放
入低密度目錄,將會造成低端機載入過大圖片資源,又可能造成 OOM,同時也是資
源浪費,沒有必要在低端機使用大圖。
正例:
將 144*144 的應用圖示 PNG 檔案放在 drawable-xxhdpi 目錄
反例:
將 144*144 的應用圖示 PNG 檔案放在 drawable-mhdpi 目錄