Android項目結構搭建詳解

在搭建Android開發環境及簡單地建立一個HelloWorld項目後，本篇將通過HelloWorld項目來介紹Android項目的目錄結構。本文的主要主題如下：

1、HelloWorld項目的目錄結構

• 1.1、src文件夾
• 1.2、gen文件夾
• 1.3、Android 2.1文件夾
• 1.4、assets
• 1.5、res文件夾
• 1.6、AndroidManifest.xml
• 1.7、default.properties

圖1、HelloWorld項目目錄結構

下面將分節介紹上面的各級目錄結構。

1.1、src文件夾

顧名思義（src, source code）該文件夾是放項目的源代碼的。打開HelloWorld.java文件會看到如下代碼：

package helloworld.test;

import android.app.Activity;
import android.os.Bundle;

public class HelloWorld extends Activity {
    /** Called when the activity is first created. */
    @Override
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.main);
    }
}

可以知道：我們新建一個簡單的HelloWorld項目，系統爲我們生成了一個HelloWorld.java文 件。他導入了兩個類android.app.Activity和android.os.Bundle，HelloWorld類繼承自Activity且重 寫了onCreate方法。

以下說明針對沒有學過Java或者Java基礎薄弱的人

@Override

在重寫父類的onCreate時，在方法前面加上@Override 系統可以幫你檢查方法的正確性。
例如，public void onCreate(Bundle savedInstanceState){…….}這種寫法是正確的，
如果你寫成public void oncreate(Bundle savedInstanceState){…….}這樣編譯器回報如下錯誤——
The method oncreate(Bundle) of type HelloWorld must override or implement a supertype method，
以確保你正確重寫onCreate方法。（因爲oncreate應該爲onCreate）

而如果你不加@Override，則編譯器將不會檢測出錯誤，而是會認爲你新定義了一個方法oncreate。

android.app.Activity類：因爲幾乎所有的活動 （activities）都是與用戶交互的，所以Activity類關注創建窗口，你可以用方法setContentView(View)將自己的UI放 到裏面。然而活動通常以全屏的方式展示給用戶，也可以以浮動窗口或嵌入在另外一個活動中。有兩個方法是幾乎所有的Activity子類都實現的：

• onCreate(Bundle)： 初始化你的活動（Activity），比如完成一些圖形的繪製。最重要的是，在這個方法裏你通常將用佈局資源（layout resource）調用setContentView(int)方法定義你的UI，和用findViewById(int)在你的UI中檢索你需要編程地 交互的小部件（widgets）。setContentView指定由哪個文件指定佈局（main.xml），可以將這個界面顯示出來，然後我們進行相關 操作，我們的操作會被包裝成爲一個意圖，然後這個意圖對應有相關的activity進行處理。
• onPause()：處理當離開你的活動時要做的事情。最重要的是，用戶做的所有改變應該在這裏提交（通常ContentProvider保存數據）。

更多的關於Activity類的詳細信息此係列以後的文章將做介紹，如果你想了解更多請參閱相關文檔。

android.os.Bundle 類：從字符串值映射各種可打包的（Parcelable）類型（Bundle單詞就是捆綁的意思，所有這個類很好理解和記憶）。如該類提供了公有方法—— public boolean containKey(String key)，如果給定的key包含在Bundle的映射中返回true，否則返回false。該類實現了Parceable和Cloneable接口，所以 它具有這兩者的特性。

1.2、gen文件夾

該 文件夾下面有個R.java文件，R.java是在建立項目時自動生成的，這個文件是隻讀模式的，不能更改。R.java文件中定義了一個類——R，R類 中包含很多靜態類，且靜態類的名字都與res中的一個名字對應，即R類定義該項目所有資源的索引。看我們的HelloWorld項目是不是如此，如下圖：

圖2、R.java對應res

通過R.java我們可以很快地查找我們需要的資源，另外編繹器也會檢查R.java列表中的資源是否被使用到，沒有被使用到的資源不會編繹進軟件中，這樣可以減少應用在手機佔用的空間。

1.3、Android 2.1文件夾

該 文件夾下包含android.jar文件，這是一個Java 歸檔文件，其中包含構建應用程序所需的所有的Android SDK 庫（如Views、Controls）和APIs。通過android.jar將自己的應用程序綁定到Android SDK和Android Emulator，這允許你使用所有Android的庫和包，且使你的應用程序在適當的環境中調試。例如上面的HelloWorld.java源文件中 的：

import android.app.Activity;
import android.os.Bundle;

這裏兩行代碼就是從android.jar導入包。

1.4、assets

包含應用系統需要使用到的諸如mp3、視頻類的文件。

1.5、res文件夾

資源目錄，包含你項目中的資源文件並將編譯進應用程序。向此目錄添加資源時，會被R.java自動記錄。新建一個項目，res目錄下會有三個子目錄：drawabel、layout、values。

• drawabel-?dpi：包含一些你的應用程序可以用的圖標文件(*.png、*.jpg)
• layout：界面佈局文件(main.xml)與WEB應用中的HTML類同，沒修改過的main.xml文件如下（HelloWorld的就沒有修改過）：

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:orientation="vertical"
    android:layout_width="fill_parent"
    android:layout_height="fill_parent"
    >
<TextView
    android:layout_width="fill_parent"
    android:layout_height="wrap_content"
    android:text="@string/hello"
    />
</LinearLayout>

• values：軟件上所需要顯示的各種文字。可以存放多個*.xml文件，還可以存放不同類型的數據。比如arrays.xml、colors.xml、dimens.xml、styles.xml
• 1.6、AndroidManifest.xml

  項目的總配置文件，記錄應用中所使用的各種組件。這個文件列出了應用程序所提供的功能，在這個文件中，你可以指定應用程序使用到的服務(如電話服務、互聯網 服務、短信服務、GPS服務等等)。另外當你新添加一個Activity的時候，也需要在這個文件中進行相應配置，只有配置好後，才能調用此 Activity。AndroidManifest.xml將包含如下設置：application permissions、Activities、intent filters等。

HelloWorld項目的AndroidManifest.xml如下所示：

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
      package="helloworld.test"
      android:versionCode="1"
      android:versionName="1.0">
    <application android:icon="@drawable/icon" android:label="@string/app_name">
        <activity android:name=".HelloWorld"
                  android:label="@string/app_name">
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />
                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>
    </application>
</manifest>

關於AndroidManifest.xml現在就講這麼多，此係列後面的文章將單獨詳細介紹。

1.7、 default.properties

記錄項目中所需要的環境信息，比如Android的版本等。

HelloWorld的default.properties文件代碼如下所示，代碼中的註釋已經把default.properties解釋得很清楚了：

# This file is automatically generated by Android Tools.
# Do not modify this file -- YOUR CHANGES WILL BE ERASED!
#
# This file must be checked in Version Control Systems.
#
# To customize properties used by the Ant build system use,
# "build.properties", and override values to adapt the script to your
# project structure.
 
# Indicates whether an apk should be generated for each density.
split.density=false
# Project target.
target=android-7