為新裝置新增模組

模組可為應用程式的原始碼、資源檔案和應用程式層級設定提供容器,例如模組層級建構檔案和 Android 資訊清單檔案。每個模組都可獨立建構、測試及偵錯。

Android Studio 透過模組輕鬆將專案新增至專案。只要按照 Android Studio 中的幾個簡單步驟操作,就能建立模組,納入特定裝置類型 (例如 Wear OS 或 Android TV) 專用的程式碼。Android Studio 會自動建立模組目錄 (例如來源和資源目錄),以及適用於裝置類型的預設 build.gradle 檔案。 此外,Android Studio 也會根據建議的建構設定建立裝置模組,例如使用 Android TV 模組的 Leanback 程式庫。

本頁面說明如何為特定裝置新增模組。

Android Studio 也可讓您在專案中輕鬆新增程式庫或 Google Cloud 模組。如要進一步瞭解如何建立程式庫模組,請參閱建立程式庫模組

建立新模組

如要在專案中為新的裝置新增模組,請按照下列步驟操作:

  1. 依序點選「File」>「New」>「New Module」
  2. 在隨即顯示的「Create New Module」視窗中,Android Studio 提供下列裝置模組:
    • 手機和平板電腦模組
    • Wear OS 模組
    • Android TV 模組
    • 玻璃模組
    選取所需的裝置模組,然後點選「Next」
  3. 在「設定新模組」表單中輸入下列詳細資料:
    • 應用程式名稱:這個名稱會用來當做新模組的應用程式啟動器圖示標題。
    • 模組名稱:系統會將這段文字做為原始碼和資源檔案所在的資料夾名稱。
    • Package Name:這是模組中程式碼的 Java 命名空間。該模組會新增至模組 Android 資訊清單檔案中的 package 屬性。
    • Minimum SDK:這項設定代表應用程式模組支援的最低 Android 平台版本。這個值會設定 build.gradle 檔案中的 minSdkVersion 屬性,您稍後可以編輯。

    然後點選「下一步」

  4. 視您選取的裝置模組而定,後續頁面會顯示一組合適的程式碼範本,讓您選擇要做為主要活動使用。請按一下您要開始活動的活動範本,然後點選「下一步」。如果您不需要活動,請依序點選「Add No Activity」和「Finish」完成作業。
  5. 如果選擇活動範本,請在「自訂活動」頁面中輸入活動的設定。大部分範本會要求設定「Activity Name」、「Layout Name」、「Title」和「Source Language」,但每個範本都有活動專屬的設定。按一下「Finish」。使用活動範本建立應用程式模組時,您可以立即執行並測試該模組。

Android Studio 會為新模組建立所有必要的檔案,並將專案與新的模組 Gradle 檔案同步處理。為新裝置新增模組時,也會將目標裝置的所有必要依附元件新增至模組的建構檔案中。

Gradle 專案同步處理完成後,新的模組會顯示在左側的「Project」視窗中。如果沒有看到新的模組資料夾,請確認該視窗顯示 Android 檢視畫面

匯入模組

如要將現有模組匯入專案,請按照下列步驟操作:

  1. 依序點選「File」>「New」>「Import Module」
  2. 在「Source directory」(來源目錄) 方塊中,輸入或選取要匯入的模組目錄:
    • 如果您要匯入一個模組,請指定其根目錄。
    • 如果要從專案匯入多個模組,請指定專案資料夾。資料夾內的每個模組會顯示一個方塊,並指出「來源位置」和「模組名稱」。確認您要匯入的每個模組都勾選了「匯入」 方塊。
    如果模組有其他依附元件,這些模組會列在「其他必要模組」下方即可匯入。
  3. 在「Module name」欄位中輸入所需模組名稱。
  4. 按一下「Finish」

模組匯入後,會顯示在左側的「專案 」視窗中。

後續步驟

新增模組後,您可以修改模組程式碼和資源、調整模組建構設定,以及建構模組。您也可以像執行其他應用程式一樣執行模組並進行偵錯。

此外,我們也建議您新增程式碼和資源,以妥善支援新裝置。如要進一步瞭解如何針對不同裝置類型開發應用程式模組,請參閱對應的說明文件:

開發新的模組時,您可以建立裝置獨立程式碼,已經與其他應用程式模組重複。請勿保留重複的程式碼,我們建議您將共用程式碼移至程式庫模組,並將程式庫新增為應用程式模組的依附元件。如要進一步瞭解如何建立程式庫模組並將其新增為依附元件,請參閱建立 Android 程式庫