加入範本中的程式碼

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

Android Studio 提供遵循 Android 設計與開發做法的程式碼範本,能幫助您打造好看又實用的應用程式。您可以使用範本建立新的應用程式模組、個別作業或其他特定 Android 專案元件。

某些範本會提供常用情境的程式碼範例,例如導覽匣或登入畫面。不論您是首次創建專案在現有專案中新增應用程式模組,或是在一應用程式模組中新增活動,都能從這些模組及作業範本之中選取所需。

除了一些作業之外,您也可以將其他 Android 專案元件的範本新增至現有應用程式。這些範本包含程式碼元件,例如服務和程式碼片段;以及非程式碼元件,例如資料夾和 XML 檔案。

本頁會說明如何將 Android 專案元件 (例如活動) 加入您的專案,並介紹 Android Studio 中常用的作業範本。請注意,大多數範本著重的使用者介面原則皆以質感設計概念為基礎,參考於 Android 支援資料庫

新增專案元件

圖 1.依序選擇「檔案」>「新增」,或在「專案」視窗中點一下滑鼠右鍵,即可開啟範本選單。

Android Studio 中提供的範本數量仍在不斷增加。Android Studio 會根據新增的元件類型來將範本分組,例如「作業」或「XML」檔案,並如圖 1 所示。

如要利用範本來新增 Android 專案元件,請用「專案」視窗 。在您要新增元件的資料夾上按一下滑鼠右鍵,然後選取「新增」。在您點選特定資料夾後,將會看到一列範本清單。範本的類型取決於可新增至該資料夾的元件種類,如圖 1 所示。

當您選取要新增的範本時,系統會跳出對應的精靈視窗來詢問欲設定的元件資訊,例如範本名稱。輸入設定資訊後,Android Studio 會建立並開啟新元件的檔案。也會執行 Gradle 建置來同步專案。

您可以在 Android Studio 的選單中依序點選「檔案」>「新增」,來建立新的 Android 專案元件。然而透過「專案」視窗來導向目標資料夾,可確保您在適當的位置建立元件。

選取作業範本

範本的常見用途之一,是在現有的應用程式模組中新增作業。舉例來說,如果要為應用程式的使用者建立登入畫面,請利用「登入活動」範本來新增作業。

本節將說明手機和平板電腦應用程式常用的作業範本。Android Studio 也提供了範本給多樣化類型的應用程式模組,包括 Wear OS、Android TV 和 Cloud App Engine。您可以在建立應用程式模組時,檢視這些不同模組類型的範本。也存在一些範本專屬於特定 API 的模組和作業,例如 Google AdMob 廣告和 Google 地圖。

下列手機和平板電腦的範本,可針對特定使用情境提供程式碼元件,例如登入帳戶、呈現清單及各項目詳細資料,或迅速瀏覽一長串的文字。兩者都可以當做一整個應用程式模組或一項個別作業。

基礎作業

這個範本透過應用程式工具列和懸浮操作按鈕來建立簡易的應用程式。提供常用的 UI 元件,來做為您專案的起始點。

這個範本包括:

底部導覽作業

這個範本為一作業提供了標準的底部導覽列,方便使用者輕觸一下就能查詢並在數個頂層檢視項目間切換。如果您的應用程式頂層選單有三到五個項目,請使用這個範本。詳情請參閱底部導覽元件設計指南。

這個範本包括:

  • AppBar
  • 有適用於底部導覽樣式的單一版面配置檔案

空白作業

這個範本會建立空白作業及包含文字範例的單一版面配置檔案。可讓您從頭開始建構應用程式模組或作業。

這個範本包括:

  • 含文字內容的單一版面配置檔案

全螢幕作業

這個範本建立的應用程式,能在一般的全螢幕檢視與標準使用者介面 (UI) 控制之間切換。全螢幕檢視為預設值,然而使用者可以輕觸裝置螢幕來啟用標準檢視模式。

這個範本包括:

  • 導入觸碰事件監聽器設計來隱藏標準檢視元素
  • 在標準檢視畫面中顯示,但不具備功能的按鈕
  • 標準檢視的AppBar
  • 單一版面配置檔案,提供全螢幕檢視、標準檢視元素的框架配置兩個選項

登入活動

這個範本會建立標準登入畫面。使用者介面包括電子郵件、密碼兩欄位,以及登入按鈕。相較於應用程式模板,它更常做為作業範本來使用。

這個範本包括:

  • 安裝啟用 AsyncTask,來分開處理網路作業與主要使用者介面執行緒
  • 網路作業期間的進度指標
  • 採用預設登入使用者介面的單一版面配置檔案:
    • 電子郵件和密碼輸入欄位
    • 登入按鈕

主要/細部流程 (已在 4.2 Canary 第 8 版中重新命名並更新)

這個範本建立的應用程式,可以選擇呈現項目清單整體或是個別項目的詳細資料。按一下清單畫面上的項目,即可檢視該項目的詳細資料畫面。兩個呈現方式的版面配置,會因執行應用程式的裝置而異。

這個範本也能提供 API 虛設常式,來處理特定的滑鼠和鍵盤輸入法,例如對著清單項目按一下滑鼠右鍵、常用鍵盤快速鍵。

這個範本包括:

這個範本會以導覽匣選單建立「基礎作業」。導覽列會從應用程式左側或右側展開,與一般的應用程式列一併顯示。

這個範本包括:

  • 導覽匣安裝啟用作業。透過 DrawerLayout、相應的事件處理常式和選單中的範例來達成
  • AppBar
  • FloatingActionButton
  • 導覽匣及其標題的版面配置檔,以及「基礎作業」範本中的檔案

滾動頁面作業

這個範本建立的應用程式會包含收合工具列,並能滾動頁面來檢視長篇文字內容。當您向下滾動頁面時,工具列將會自動壓縮成剩下標題,而懸浮操作按鈕也會消失。

這個範本包括:

設定作業

這個範本建立的作業,會呈現對於一個應用程式使用者的偏好或程式本身的設定。它擴充了 PreferenceActivity 的類別,且相較於應用程式模板,更常被當做作業範本來使用。

這個範本包括:

  • PreferenceActivity 延伸出的作業
  • XML 類檔案 (位於專案的 res/xml/ 目錄中) 用於定義顯示的設定值。

分頁式作業

這個範本建立的應用程式,將包含多個分段、滑動瀏覽,及一個應用程式列。將這些不同分段定義為片段,透過左右滑動頁面即可一一瀏覽。

這個範本包括:

  • AppBar
  • 擴充 FragmentPagerAdapter 的介面卡,能在每個分段都建立一個片段
  • ViewPager 實例,可管理不同分段間滑動的版面配置
  • 兩個版面配置檔案:一個用於作業,另一個用於個別片段