你不可不看的Android開發命名規範

来源:http://www.cnblogs.com/valenhua/archive/2017/08/11/7348247.html
-Advertisement-
Play Games

標識符命名法最要有四種: Camel(駱駝)命名法:除首單詞外,其餘所有單詞的第一個字母大寫,如:fooBar; Pascal命名法:所有單詞的第一個字母大寫,如:FooBar; 下劃線命名法:單詞與單詞間用下劃線做間隔,如:foo_bar; 匈牙利命名法:廣泛應用於微軟編程環境中,在以Pascal ...


 標識符命名法最要有四種:

  • Camel(駱駝)命名法:除首單詞外,其餘所有單詞的第一個字母大寫,如:fooBar;
  • Pascal命名法:所有單詞的第一個字母大寫,如:FooBar;
  • 下劃線命名法:單詞與單詞間用下劃線做間隔,如:foo_bar;
  • 匈牙利命名法:廣泛應用於微軟編程環境中,在以Pascal命名法的變數,首字母小寫說明該變數的類型。 量的取名方式為:scope_ prefix_qualifier 範圍首碼,類型首碼,限定詞,如:g_foo_bar;

安卓App層開發主要是Java語言,所以基本使用除了匈牙利命名法外的命名方式;

縮寫在命名是必須的,遵循下麵規則:

  • 較短的單詞可通過去掉“母音”形成縮寫,如icon->ic;
  • 較長的單詞可取單詞的頭幾個字母形成縮寫,如:average->avg;
  • 此外還有一些約定成俗的英文單詞縮寫,如 Internationalization->I18N;
  • 程式中不要用縮寫,除非該縮寫是約定俗成的。

命名規範:

  • 包(packages): 採用反功能變數名稱命名規則,全部使用小寫字母。一級包名為地頂級功能變數名稱如com,二級包名為xx(可以是公司或則個人的隨便),三級包名根據應用進行命名,四級包名為模塊名或層級名; 如 com.tinyx.myapp.activities;
  • 類(classes):用Pascal命名法,儘量避免縮寫,如:MyActivity;縮寫是眾所周知的,如HTML,URL;類名稱中包含單詞縮寫,則單詞縮寫的每個字母均應大寫,如:PublicHTML,CommonURL。
  • 介面(interface):與類一樣用Pascal命名法,多以able或ible結尾,多用作表示行為,如Runnable,Accessible;
  • 方法(methods):動詞或動名詞,採用Camel命名法,如:onCreate(),run();下麵是一些建議:

    • 初始化相關方法,使用init為首碼標識,如:初始化佈局initView();
    • boolean型使用is或check為首碼標識, 如:checkValue()、isValidate();
    • 返回某個值的方法,使用get為首碼標識,如:getName();
    • 數據進行處理相關,儘量使用process為首碼標識,如:processUpdate();
    • 保存數據相關,使用save為首碼標識,如:saveData();
    • 對數據重置的,使用reset首碼標識,如:resetData();
    • 清除數據相關,使用clear首碼標識,如:clearData();
    • 移除某些項目,使用remove首碼標識,如:removeItem();
    • 繪製數據或效果相關的,使用draw首碼標識,如:drawCircle();
  • 變數(variables):採用Pascal命名法,建議採用有意義的命名如:firstName,lastName; 模型類變數預設以上規則
public class User {
    public String name;
    public String phone;
    public int sex; //1,男 2,女

   public User() {
         this.name = "myname";
        this.phone = "123“
        this.sex = 0;
    }
}
  • 非模型類全局參數建議加上小寫m開頭;
public class TestActivity extends Activity{
    private ZoomableImageView mZoomableView;
    private TabLayout mTabLayout;
    private int mItemsCount;

   @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.test_activity);
    }
}

常量(constants): 全部大寫,採用下劃線命名法.如下:

public static final int MAX_ITEMS= 10;
public static final String TAG = User.class.getSimpleName();

 資源文件命名(resources):採用下劃線命名法,全部小寫,針對不同資源,建議用下麵的命名方法;

  • drawable資源,加首碼命名:首碼_功能_模塊_說明.xml/png/
說明命名範例
圖標:建議格式 ic_xxx; ic_appicon.png
背景:建議格式 bg_xxx; bg_normal_button_default.xml,bg_normal_button_press.xml

 

  • layout 資源文件,首碼命名:類型_模塊_功能_說明.xml,舉一些常用的例子如下:
說明命名範例
Activity佈局文件 activity_main.xml
Fragment佈局文件 fragment_main.xml
局部佈局View文件 view_main_header.xml,view_main_bottom.xml
自定義提示對話框 dialog_alert.xml
列表項等 fragment_user_list_item.xml
  • 動畫anim資源文件(anim只有一種資源,所以不必加首碼區分):模塊_功能_動畫_方向.xml
說明命名範例
淡入 main_button_fade_in.xml
淡出 main_button_fade_out.xml
從下方推入 button_push_down_in.xml
從下方推出 main_button_push_down_out.xml
  • menu菜單資源文件(menu只有一種資源,所以不必加首碼區分),模塊_功能_說明.xml
說明命名範例
主界面菜單 main_activity.xml
Fragment界面菜單 user_fragment.xml
  • values資源,這個主要分下麵幾種資源:

1、 ids資源,主要存放是界面控制項的id值,用下劃線小寫命名法,首碼方式:首碼_模塊_功能_說明,常用界面控制項命名如下:

說明命名範例
佈局和子控制項(ViewGroup,自定義View) view_main_topnav
TextView tv_main_title
Button btn_user_add
ImageButton imgbtn_user_del
ImageView img_thumb
CheckBox cb_sex
RadioButton rbtn_answer
EditText et_username
ToggleButton toggle_funtion
ProgressBar pb_download
SeekBar sb_progress
ProgressBar pb_download
VideoView vv_course
WebView wv_download
RantingBar rb_download
Spinner sp_cities
ScollView sv_main
TextSwitch sp_cities
ListView/ExpandListView/RecyclerView lv_cities
MapView mv_location

2、strings/arrays/dimens資源,用下劃線小寫命名法,不加任何前尾碼,格式,模塊_功能_說明

3、attrs/colors/ids的屬性和名稱使用 Camel命名法; styles的屬性使用Camel命名法,名稱使用Pascal命名法;如下麵:

<!--attrs-->
<attr name="text" format="string" />
<attr name="itemIcon" format="reference" />
<attr name="showToggle" format="boolean" />
<attr name="showVersion" format="boolean" />
<style name="Theme.AppCompat.Light.NoActionBar">
        <item name="windowActionBar">false</item>
        <item name="windowNoTitle">true</item>
</style>

 <!--colors-->
 <color name="colorPrimary">#009688</color>
 <color name="colorPrimaryDark">#00796b</color>
 <color name="colorAccent">#cddc39</color>

 <!--ids-->
 <item name="tabLayout" type="id"/>
 <item name="viewPager" type="id"/>
 <item name="viewContainer" type="id"/>
有問題歡迎留言,寫信([email protected])或者關註我的微信公眾號:
您的分享是我們最大的動力!

-Advertisement-
Play Games
更多相關文章
  • 創建對象 工廠模式 function createPerson(name, age, job){ var o = new Object(); o.name = name; o.age = age; o.job = job; o.sayName = function(){ alert(this.nam ...
  • Write less, do more. 這便是jQuery的宗旨!jQuery,一個高效、精簡並且功能豐富的 JavaScript 工具庫。 想必,對於每一個前端開發者,一定用過jQuery吧!俗話說,學會jQuery,打哪兒都不怕!(瞎說的。。) jQuery也是我接觸過的第一個JavaScri ...
  • 寫在開始 一開始將自己 部署到 ,結果發現打開頁面速度有點慢,然後又將其同時部署到 ,實現雙線路訪問,國內解析記錄到 ,國外解析到 ,這樣確實網站的速度能提高不少,但是國內訪問因為是經過 ,所以打開網站會有廣告,這點不能容忍,於是想到自己的伺服器也還空閑著,於是想到可以部署到自己的伺服器上,折騰開始 ...
  • 上一篇文章《一個基於ES5的vue小demo》我們講瞭如何用ES5,vue-router做一個小demo,接下來我們來把它變成基於ES6+webpack的demo。 一、環境搭建及代碼轉換 我們先搭建一下vue 的開發環境,根據我的一篇隨筆《Vue開發環境搭建及熱更新》,我們一步步搭建開發環境,pr ...
  • 一、前言: 我們在實際工作中,或者在面試找工作時,都會用到或者被問到一個問題,那就是“數組如何去重”。是的,這個問題有很多種解決方案,看看下麵的十種方式吧! 二、數組去重方式大彙總: Methods 1: 思路:定義一個新數組,並存放原數組的第一個元素,然後將元素組一一和新數組的元素對比,若不同則存 ...
  • JavaScript Date 對象 Date 對象用於處理日期與實際。 創建 Date 對象: var now = new Date(). <script type="text/javascript"> var span = document.getElementById("spandate"); ...
  • 今天看來情書寫的文章,研究了一下大佬寫的文章,自己做一點總結。 其實,今天我想把我近期遇到的坑都總結一下:1.goBack的跨頁面跳轉,又兩種方法,一可以像兔哥那樣修改navigation源碼,二可以用navigationActions 2.父子組件的傳值,一可以用callBack 二可以用pubs ...
  • 參考資料:http://blog.csdn.net/ElinaVampire/article/details/51813677 大家先看一張關於組件掛載的經典的圖片: 下麵一一說一下這幾個生命周期的意義: getDefaultProps object getDefaultProps() 執行過一次後 ...
一周排行
    -Advertisement-
    Play Games
  • 移動開發(一):使用.NET MAUI開發第一個安卓APP 對於工作多年的C#程式員來說,近來想嘗試開發一款安卓APP,考慮了很久最終選擇使用.NET MAUI這個微軟官方的框架來嘗試體驗開發安卓APP,畢竟是使用Visual Studio開發工具,使用起來也比較的順手,結合微軟官方的教程進行了安卓 ...
  • 前言 QuestPDF 是一個開源 .NET 庫,用於生成 PDF 文檔。使用了C# Fluent API方式可簡化開發、減少錯誤並提高工作效率。利用它可以輕鬆生成 PDF 報告、發票、導出文件等。 項目介紹 QuestPDF 是一個革命性的開源 .NET 庫,它徹底改變了我們生成 PDF 文檔的方 ...
  • 項目地址 項目後端地址: https://github.com/ZyPLJ/ZYTteeHole 項目前端頁面地址: ZyPLJ/TreeHoleVue (github.com) https://github.com/ZyPLJ/TreeHoleVue 目前項目測試訪問地址: http://tree ...
  • 話不多說,直接開乾 一.下載 1.官方鏈接下載: https://www.microsoft.com/zh-cn/sql-server/sql-server-downloads 2.在下載目錄中找到下麵這個小的安裝包 SQL2022-SSEI-Dev.exe,運行開始下載SQL server; 二. ...
  • 前言 隨著物聯網(IoT)技術的迅猛發展,MQTT(消息隊列遙測傳輸)協議憑藉其輕量級和高效性,已成為眾多物聯網應用的首選通信標準。 MQTTnet 作為一個高性能的 .NET 開源庫,為 .NET 平臺上的 MQTT 客戶端與伺服器開發提供了強大的支持。 本文將全面介紹 MQTTnet 的核心功能 ...
  • Serilog支持多種接收器用於日誌存儲,增強器用於添加屬性,LogContext管理動態屬性,支持多種輸出格式包括純文本、JSON及ExpressionTemplate。還提供了自定義格式化選項,適用於不同需求。 ...
  • 目錄簡介獲取 HTML 文檔解析 HTML 文檔測試參考文章 簡介 動態內容網站使用 JavaScript 腳本動態檢索和渲染數據,爬取信息時需要模擬瀏覽器行為,否則獲取到的源碼基本是空的。 本文使用的爬取步驟如下: 使用 Selenium 獲取渲染後的 HTML 文檔 使用 HtmlAgility ...
  • 1.前言 什麼是熱更新 游戲或者軟體更新時,無需重新下載客戶端進行安裝,而是在應用程式啟動的情況下,在內部進行資源或者代碼更新 Unity目前常用熱更新解決方案 HybridCLR,Xlua,ILRuntime等 Unity目前常用資源管理解決方案 AssetBundles,Addressable, ...
  • 本文章主要是在C# ASP.NET Core Web API框架實現向手機發送驗證碼簡訊功能。這裡我選擇是一個互億無線簡訊驗證碼平臺,其實像阿裡雲,騰訊雲上面也可以。 首先我們先去 互億無線 https://www.ihuyi.com/api/sms.html 去註冊一個賬號 註冊完成賬號後,它會送 ...
  • 通過以下方式可以高效,並保證數據同步的可靠性 1.API設計 使用RESTful設計,確保API端點明確,並使用適當的HTTP方法(如POST用於創建,PUT用於更新)。 設計清晰的請求和響應模型,以確保客戶端能夠理解預期格式。 2.數據驗證 在伺服器端進行嚴格的數據驗證,確保接收到的數據符合預期格 ...