專案總覽

透過集合功能整理內容 你可以依據偏好儲存及分類內容。

Android Studio 中的專案包含定義應用程式工作區的所有功能 (從原始碼和資產到測試程式碼和建構設定)。當您開始建立新專案時,Android Studio 會針對所有檔案建立必要的結構,並顯示於 IDE 左側的專案視窗中顯示 (按一下「View」>「Tool Windows」>「Project」)。本頁提供專案中主要要素的總覽。

模組

「模組」是一組來源檔案和建構設定,可讓您將專案分為不同的功能單元。您的專案可以有一或多個模組,而一個模組可能會將另一個模組做為依附元件。而每個模組都可單獨建構、測試及偵錯。

當您在自己的專案中建立程式碼程式庫、或是想為不同類型的裝置 (例如手機和穿戴式裝置) 建立不同的程式碼和資源組合,但想將所有檔案保留在相同的專案範疇並共用部分程式碼時,額外的模組會相當實用。

按一下「File」>「New」>「New Module」,在專案中新增模組。

Android Studio 提供幾種不同類型的模組:

Android 應用程式模組
提供應用程式原始碼、資源檔案和應用程式層級設定等容器,例如模組層級建構檔案和 Android 資訊清單檔案。建立新專案時,預設的模組名稱為「app」。

在「Create New Module」視窗中,Android Studio 提供以下類型的應用程式模組:

  • 手機和平板電腦模組
  • Wear OS 模組
  • Android TV 模組
  • 玻璃模組

每種模組都會提供適用於對應的應用程式或裝置類型的必要檔案和部分程式碼範本。

如要進一步瞭解如何新增模組,請參閱「為新裝置新增模組」。

功能模組
代表可使用 Play Feature Delivery 的應用程式模組化功能。舉例來說,透過功能模組,您可以依使用者的需求提供應用程式的特定功能,或是透過 Google Play 免安裝技術提供免安裝體驗。

詳情請參閱「新增 Play Feature Delivery 支援」。

程式庫模組
提供可重複使用程式碼的容器,可在其他應用程式模組中作為依附元件,或是匯入其他專案。在結構上,程式庫模組與應用程式模組相同,但是在建構時並不會產生 APK 黨,而是會建立程式碼封存檔,這種檔案無法安裝到裝置上。

在「Create New Module」視窗中,Android Studio 提供下列程式庫模組:

  • Android 程式庫:這類程式庫會包含 Android 專案支援的所有檔案類型,包括原始碼、資源和資訊清單檔案。建構的結果為一個 Android Archive (AAR) 檔案,可將其新增為 Android 應用程式模組的依附元件。
  • Java 程式庫:這類程式庫只能包含 Java 來源檔案。建構結果為一個 Java Archive (JAR) 檔案,可將其新增為 Android 應用程式模組或其他 Java 專案的依附元件。
Google Cloud 模組
提供 Google Cloud 後端程式碼的容器。這個模組具有 Java App Engine 後端所需的程式碼和依附元件,其使用簡單的 HTTP、Cloud Endpoints 和雲端通訊功能連線至您的應用程式。您可以開發後端來提供應用程式所需的雲端服務。

使用 Android Studio 開發 Google Cloud 模組,以便在同一項專案中管理應用程式程式碼和後端程式碼。您也可以在本機執行及測試後端程式碼,並使用 Android Studio 部署 Google Cloud 模組。

如要進一步瞭解如何執行及部署 Google Cloud 模組,請參閱「執行、測試及部署後端」。

部分使用者也將模組稱為「子專案」,這種說法也沒問題,因為 Gradle 也將模組稱為專案。舉例來說,如果您在建立程式庫模組時想要將其新增為 Android 應用程式模組的依附元件,則必須依照以下宣告:

Groovy

dependencies {
    implementation project(':my-library-module')
}

Kotlin

dependencies {
    implementation(project(":my-library-module"))
}

專案檔案

根據預設,Android Studio 會在 Android 檢視畫面中顯示專案檔案。這個檢視畫面並不會依照磁碟中實際的檔案階層呈現,而會按照模組和檔案類型來分類,以簡化專案主要來源檔案之間的瀏覽方式,並且隱藏某些不常使用的檔案或目錄。相較於磁碟結構,某些結構上的改變包括:

  • 在頂層「Gradle Script」群組中,顯示所有與專案建構相關的設定檔。
  • 顯示模組層級群組中每個模組的所有資訊清單檔案 (在不同變種版本和建構類型有不同的資訊清單檔案時)。
  • 顯示單一群組中的所有額外資源檔案,而非以每個資源限定詞的個別資料夾顯示。舉例來說,啟動器圖示的所有密度版本會並列顯示。

在每個 Android 應用程式模組中,檔案會以下列群組顯示:

資訊清單
包含 AndroidManifest.xml 檔案。
java
包含 Java 原始碼檔案,並以套件名稱分隔,包括 JUnit 測試程式碼。
res
包含所有非程式碼資源,例如 XML 版面配置、UI 字串和點陣圖圖片,以對應的子目錄區分。如要進一步瞭解所有可能的資源類型,請參閱「提供資源」。

Android 專案檢視畫面

若要查看專案的實際檔案結構 (包括隱藏在 Android 檢視畫面中的所有檔案),請從「Project」頂端的下拉式選單中選取「Project」

當您選取「Project」檢視畫面時,即可看到更多檔案和目錄。最重要的是下列項目:

module-name/
build/
包含建構輸出內容。
libs/
包含私人程式庫。
src/
包含以下子目錄中模組的所有程式碼和資源檔案:
androidTest/
含有在 Android 裝置上執行檢測測試的程式碼。詳情請參閱「Android 測試說明文件」。
main/
包含「main」來源集檔案:所有建構變數共用的 Android 程式碼和資源 (用於其他建構變數的檔案則位於同層目錄中,例如用於偵錯建構類型的 src/debug/)。
AndroidManifest.xml
說明應用程式及其每個元件的性質。詳情請參閱「AndroidManifest.xml 說明文件」。
java/
包含 Java 程式碼來源。
jni/
包含使用 Java Native Interface (JNI) 的原生程式碼。詳情請參閱「Android NDK 說明文件」。
gen/
包含 Android Studio 產生的 Java 檔案,例如您的 R.java 檔案以及從 AIDL 檔案建立的介面。
res/
包含應用程式資源,例如可繪檔案、版面配置檔案和 UI 字串。詳情請參閱「應用程式資源」。
assets/
包含應依原樣編譯成 .apk 檔案的檔案。您可以使用 URI 以和一般檔案系統相同的方式瀏覽此目錄,並使用 AssetManager 以位元組串流讀取檔案。舉例來說,此為處理材質和遊戲資料的絕佳位置。
test/
包含在主機 JVM 上執行本機測試的程式碼。
build.gradle (模組)
此定義模組專屬的建構設定。
build.gradle (專案)
此定義適用於所有模組的建構設定。此檔案與專案密切相關,因此請確保其與所有其他原始碼做好修訂版本控管。

如要進一步瞭解其他建構檔案,請參閱「設定建構」。

專案結構設定

若要變更 Android Studio 專案的各項設定,請按一下「File」>「Project Structure」,開啟「Project Structure」對話方塊。其中包含以下部分:

  • SDK 位置:設定專案使用的 JDK、Android SDK 和 Android NDK 位置。
  • 專案:設定 Gradle 和 Gradle 適用的 Android 外掛程式的版本以及存放區位置名稱。
  • 模組:可讓您編輯特定模組的建構設定,包括目標和最少的 SDK、應用程式簽名,以及程式庫依附元件等。請參閱下方的「模組」一節。

模組

模組設定區段可讓您變更各個專案模組的設定選項。每個模組的設定頁面分成以下幾個分頁:

  • 屬性:指定 SDK 的版本,以及建立編譯模組所需的工具。
  • 簽署:指定用於簽署應用程式的憑證。
  • 變種版本:可讓您建立多個變種版本,每個變種版本會指定一組設定 (例如模組的最低和目標 SDK 版本),以及版本代碼和版本名稱。舉例來說,您可以定義一個最低 SDK 為 15 以及目標 SDK 為 21 的變種版本,以及另一個最低 SDK 為 19 與目標 SDK 為 23 的變種版本。
  • 建構類型:可讓您建立及修改建構設定,詳情請參閱「設定 Gradle 建構作業」。根據預設,每個模組都有偵錯發行建構類型,然而您可以視需要定義更多類型。
  • 依附元件:列出此模組的程式庫、檔案和模組依附元件。您可以在這個窗格中新增、修改及刪除依附元件。如要進一步瞭解模組依附元件,請參閱「設定 Gradle 建構作業」。