Android – 專案的建立與結構

NewProjectAndProjectStructure
Android – 專案的建立與結構

想要開發 Android APP 就得要啟動一個專案,而專案要怎麼建立?專案的目錄結構有哪些?請待下回分解…咦!不是!是請往下繼續觀之…

在用 Eclipse 建構 Android 的開發環境的步驟都完成後,這樣就可以開始撰寫 Android 的 APP 了。

每個工程師都該有的一支程式

[hr width=”100%” border_width=”1px” ]

嗯~放在這裡,不會有別支程式,就是程式界頂頂大名的 Hello World ,順便查詢了一下,沒想到這支程式連 Wiki 百科都有耶!真是驚訝XD

既然這麼偉大,那我們也不能等閒視之啦,那就慎重其事的踏出我們的第一步~打開 Eclipse…(喂!)

咳…
本篇好像從頭開始就不是很正常,我絕對不會說我只是在混字數…

開啟一個專案可以由三個地方進行,而這三個地方不侷限於 Android,若是您是 PHP 開發者,有跟著之前的介紹打造一個可以帶著走的 PHP IDE,也是可以這麼做,當然其他語言的專案亦是 。這三個地方分別是,

  1. 文字工具列的 File > New > Other
  2. 專案管理視窗 滑鼠右鍵 > New > Other
  3. 圖示工具列的(NEW)
開啟新專案
開啟新專案的視窗

以一個開發程式的角色來說,常會用到的選項從到到下有:

  • Android Activity
    新增一個 Activity。
  • Android Application Project
    新增一個專案 ,本篇的主角。
  • Android Project from Existing Code
    在專案管理列表中,加入一個既有的程式專案。
  • Android Test Project
    建立測試專案。
  • Android XML File
    建立 Android 的資源檔,如:畫面(Layout)、圖片(Drawable)…等。
  • Android XML Layout File
    這個算是上一個選項的收斂,選擇這個就是直接新增一個 Android 的畫面檔。

這邊就選擇 Android Application Project ,可以看到下面這個建立專案的畫面,

CreateAndroidProject
建立一個新的 Android 專案

從上而下的欄位分別為:

  • Application Name
    應用程式名稱,這邊輸入 HelloWorld
  • Project Name
    專案名稱,系統會自動在這個欄位帶入我們在 Application Name 所輸入的名稱,因此,若有需要者,可以自行修改哦!
    這個欄位會影響到的是我們在專案列表視窗看到的名稱,以及預設的目錄名稱。
  • Package Name
    套件名稱,這個就是 JAVA 的 命名空間 (源自C++,只是 JAVA Package Name 稱之),目的都在為了對我們的專案程式的類別(class) 進行分類。而這個欄位在未做修改前,系統都會自動用 com.example.全小寫的應用程式名稱 帶入,而原則上這邊我們自己要修改之,也最好是保持著兩層以上的命名。而一般習慣的層級命名是這樣 類型.提供者名稱.專案名稱... ,類型通常就是商業用的 com 為多,那這裡因為是試範用的,我們就這麼命名之 demo.mosil.helloworld 。
  • Build SDK
    建立這個專案要用哪個 SDK 版本,每個版本號原則上都有兩個選項可以選擇,原生的 Android 4.1 (API 16) 以及帶有 Google API 的  Google APIs (Google Inc.) (API 16) ,這邊就看個別的需求了,而這裡只是很單純的 “Hello World”,那就直接選擇 Android 4.1 (API 16) 即可。
  • Minimum Required SDK
    這個專案所要支援的最低版本,使用預設的 API 8: Android 2.2 (Froyo) 即可,這是目前 Android 市場上所有的裝置中,所佔比例最高的一個版本。
  • Create custom launcher icon
    是否要建立客製化啟動用的圖示, 勾選 。
  • Mark this project as a library
    是否要將本專案做為函式庫,若是沒有特殊需求,這邊就不用選嘍。
  • Create Project in Workspace
    將專案建立在我們所設定的 Workspace 目錄中,若是勾選之,系統就會幫我們在 Workspace 的路徑下,建立一個和 Project Name 同名之目錄。

當今天我們有勾選建立客製化啟動圖示時,執行 Next 後,會進到 Configure Launcher Icon 的視窗,若是沒有勾選,這個步驟就會被省略。

ConfigureLauncherIcon
建立啟動用的圖示

若是有自己的設計好的圖示,就直接在 Foreground 切換成 Image ,選擇圖示的那個區塊就會變成 Image File: 欄位,這時就能換成自己的圖示了。其餘的的選項與其在這裡說明,各位自己動手玩一玩會比較有感覺哦!接下來的兩個畫面都是在建立這個建案下的第一個 Activity,第一個是選擇基本樣式,第二個是 Activity 以及 Layout 檔案的名稱設定。

CreateActivity
建立 Activity

這邊的兩個選項,分別是 BlankActivity 以及 MasterDetailFlow ,而後者的最低要求是 API 11,也就是要在 Android 3.0 以上的版本才被支援。

NewBlankActivity
新的Activity

從上而下的欄位分別如下:

  • Activity Name
    這支 Activity 的檔案名稱。
  • Layout Name
    這個 Activity 所用之畫面的檔名。
  • Navigation Type
    導航類型,即是否要加入標籤或是切換頁之效果。這功能最低需求版本是 API 14,即 Android 4.0 以上的版本才有支援。
  • Hierarchical Parent
    父層級設定,雖然在新建專案時沒有提示發生,但實際在執行時會要求在 API 11,即 Android 3.0 以上版本才能執行。
  • Title
    標題,當今天發佈成 APP 時,若是以這個 Activity 為首時,要呈現的在列表中的名稱。

隨著預設值完成設定後,會進入如下面所示的新 Activity 的 Layout,

ANewHelloWorldProject
剛建立好的專案畫面

這時候,其實已經可以直接執行之了。

 

專案結構

[hr width=”100%” border_width=”1px” ]

新增完一個專案之後,所獲得的預設專案目錄結構就如下圖所示,

ProjectStructure
專案結構

這是 SDK r20.x 開始的預設目錄結構,但原則上還是就那幾個重要的目錄,以下說明之:

1./src

Android 的程式碼目錄,在這目錄下就會以 Package 的方式,將我們的程式碼分門別類的放置在專案列表裡。

2./gen

這裡是 Android SDK 自動產生檔案,是重要的心臟,在 r20.0.3 這個版本時,這裡面自動產生兩個檔案

  • R.java
    串連資源以及程式碼的心脈!
  • BuildConfig.java
    這是檔案是在 r17 這個版本新增的檔案,而這個檔案裡只有一個設定項 DEBUG 開關,這是讓我們在某些偵錯結構中可以放的設定,讓程式碼在非 DEBUG 時,省略偵錯時需拋出例外訊息的動作。

3./libs

外掛函式庫的存放目錄。

4./res

資源檔的放置,這裡放有這個 APP 所需要的 圖片(darwable) 、呈現 文字(string) 、 介面(layout) 、 風格(styles) …等。每設定一個資源,SDK 就會自動為我們加入相對應的配置在 R.java 裡面。這邊除了圖片外,其餘全是 xml 檔案格式。

圖片的檔案名稱所能使用的字元只有小寫英文字母 、數字0-9 以及底線_ 跟小數點. 兩個符號而已。

這裡預設的幾個項目分別是

  • drawable
    專案中所需要的圖片全部放置在此,從 4.0 開始之後分為四種大小, xhdpi 、 hdpi 、 ldpi 以及 mdpi ,至於要用到哪個大小的圖片,只要我們有提供,系統就會幫我們針對該裝置的最適大小目錄裡,取得最佳呈現的圖片哦!
  • layout
    供 Activity 呈現用之畫面。
  • menu
    選單項目,不過這個項目隨著 4.0 的釋出,官方也同時對裝置上做了些動作,將原本的四天王實體鍵,改為三個,已經不包括選單鍵了。
  • values
    這個目錄,預設放著 strings.xml 以及 styles.xml 兩個檔案,前者是 APP 所要用的文字,後者是呈現的整體風格或是元件風格,而製作多國語系也是在這個目錄對手腳哦!從 API 11 開始,到現在多了兩個分支, vaules-v11 以及 values-14 ,其實從目錄名稱上看來,也很容易理解,一個是針對 Android 3.x 版、另一個則是對 Android 4.x 版的設定。

5. AndroidManifest.xml

Android APP 的名片檔,這邊撰寫著未來上架時的發行版本、有哪些 Activity,還有使用到哪些特殊的功能等等。

Loading Facebook Comments ...

發表迴響

你的電子郵件位址並不會被公開。 必要欄位標記為 *