為新裝置新增模組

模組可為應用程式的原始碼、資源檔案和應用程式層級設定提供容器，例如模組層級建構檔案和 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 程式庫。