Android Kotlin 基礎知識 01.4：瞭解如何自行利用相關資源

這個程式碼研究室是 Android Kotlin 基礎知識課程的一部分。如果您按部就班完成程式碼研究室，就能充分體驗到本課程的價值。所有課程程式碼研究室都列在 Android Kotlin 基礎知識程式碼研究室到達網頁。

簡介

在本程式碼研究室中，您將瞭解對 Kotlin Android 開發人員有幫助的資源，包括範本、說明文件、影片和範例應用程式。

必備知識

  • Android Studio 的基本工作流程。
  • 如何使用 Android Studio 中的版面配置編輯器。

課程內容

  • 如何尋找 Kotlin 和 Android 開發人員資訊與資源。
  • 如何變更應用程式的啟動器圖示。
  • 瞭解如何在使用 Kotlin 建構 Android 應用程式時尋求協助。

學習內容

  • 瞭解 Kotlin Android 開發人員可用的資源，無論程度如何都適用。
  • 下載並探索 Kotlin Android 範例應用程式。
  • 變更應用程式的啟動器圖示。

在本程式碼研究室中，您將瞭解 Kotlin Android 開發人員可用的範本、範例、說明文件和其他資源。

首先，您會使用 Android Studio 範本建立簡單的應用程式，並修改該應用程式。接著，您會下載並探索 Android Sunflower 範例應用程式。您會將範例應用程式的啟動器圖示 (向日葵) 換成 Android Studio 提供的剪貼畫圖像資產 (笑臉)。

Android Studio 提供常見和建議的應用程式與活動設計範本。內建範本可節省時間，並協助您遵循設計最佳做法。

每個範本都包含架構活動和使用者介面。在本課程中，您已使用「空白活動」範本。「基礎活動」範本的功能較多，並納入建議的應用程式功能，例如 Android 裝置應用程式列中顯示的選項選單。

步驟 1：瞭解 Basic Activity 架構

  1. 在 Android Studio 中建立專案。
  2. 在「Choose your project」對話方塊中，選取「Basic Activity」範本，然後按一下「Next」。
  3. 在「設定專案」對話方塊中，為應用程式命名。選取「Kotlin」做為語言，然後選取「Use AndroidX artifacts」核取方塊。按一下「完成」。
  4. 建構應用程式，並在模擬器或 Android 裝置上執行。
  5. 請參閱下圖和表格，瞭解標示的零件。在裝置或模擬器畫面上找出對應的按鈕。檢查表格中說明的對應 Kotlin 程式碼和 XML 檔案。

熟悉 Kotlin 原始碼和 XML 檔案，有助於根據自身需求擴充及自訂 Basic Activity 範本。

Basic Activity 範本的架構

#

UI 說明

程式碼參考

1

狀態列，由 Android 系統提供及控制。

範本程式碼中不會顯示狀態列，但您可以從活動存取狀態列。舉例來說，您可以在 MainActivity.kt 中新增程式碼，視需要隱藏狀態列。

2

應用程式列 (又稱 動作列) 提供視覺結構、標準化視覺元素和導覽功能。

在 activity_main.xml 中，尋找「工具列」

AppBarLayout 元素內。為確保回溯相容性，範本中的 AppBarLayout 會嵌入 Toolbar，其功能與 ActionBar 相同。

如要變更應用程式列的外觀，請變更工具列屬性。如需應用程式列教學課程，請參閱「新增應用程式列」。

3

應用程式名稱最初是從套件名稱衍生而來，但您可以變更為任何名稱。

在「AndroidManifest.xml」中，尋找

android:label="@string/app_name"。

在 strings.xml 中指定 app_name 字串。

4

選項選單溢位按鈕會保留活動的選單項目。溢位按鈕也會保留應用程式的「搜尋」和「設定」等全域選單選項。應用程式選單項目會進入這個選單。

在 MainActivity.kt 中，

onOptionsItemSelected() 方法會實作使用者選取選單項目時發生的情況。

如要查看選項選單項目，請開啟 res/menu/menu_main.xml

檔案。這個範本只指定「設定」選單項目。

5

CoordinatorLayout ViewGroup 是一種版面配置，可提供 UI 元素互動的機制。應用程式的 UI 會放在 content_main.xml 檔案中，而該檔案會包含在 ViewGroup 內。

在 activity_main.xml 中尋找 include layout 指令。這個版面配置未指定任何檢視區塊，而是包含 content_main 版面配置，其中指定了應用程式的檢視區塊。系統檢視畫面與應用程式專屬的檢視畫面會分開顯示。

6

範本會使用 TextView 顯示「Hello World」。您會將這個 TextView 替換成應用程式的 UI 元素。

「Hello World」文字檢視區塊位於 content_main.xml 檔案中。應用程式的所有 UI 元素都應在這個檔案中定義。

7

懸浮動作按鈕 (FAB)

在 activity_main.xml 中，尋找 FloatingActionButton 元素。FAB 是使用剪貼畫圖示定義的使用者介面元素。MainActivity.kt 包含 onCreate() 中的虛設常式，可為懸浮動作按鈕設定 onClick() 監聽器。

步驟 2：自訂範本產生的應用程式

變更 Basic Activity 範本產生的應用程式外觀。舉例來說，您可以變更應用程式列的顏色，使其與狀態列相符。(在某些裝置上，狀態列會使用與應用程式列相同的原色，但顏色較深)。

  1. 變更應用程式列顯示的應用程式名稱。如要這麼做，請將 res > values > strings.xml 檔案中的 app_name 字串資源變更為下列內容：
<string name="app_name">New Application</string>
  1. 在 res > layout > activity_main.xml 中，將 android:background 屬性變更為 "?attr/colorPrimaryDark"，即可變更應用程式列 (Toolbar) 的顏色。這個值會將應用程式列顏色設為與狀態列相符的深色原色：
android:background="?attr/colorPrimaryDark"
  1. 執行應用程式。狀態列會顯示應用程式的新名稱，應用程式列的背景顏色也會變深，並與狀態列的顏色相符。點選 FAB 時，系統會顯示快速鍵列，如下方螢幕截圖中的 1 所示。
  2. 變更零食列文字。如要這麼做，請開啟 MainActivity，並在 onCreate() 中尋找設定按鈕 onClick() 監聽器的虛設常式程式碼。將 "Replace with your own action" 變更為其他內容。例如：
fab.setOnClickListener { view ->
   Snackbar.make(view, "This FAB needs an action!", Snackbar.LENGTH_LONG)
       .setAction("Action", null).show()
}
  1. FAB 會使用應用程式的強調色，因此如要變更 FAB 的顏色，其中一種方法是變更強調色。如要變更強調色，請開啟 res > values > colors.xml 檔案，然後變更 colorAccent 屬性，如下所示。(如需選取顏色方面的協助，請參閱 Material Design 色彩系統)。
<color name="colorAccent">#1DE9B6</color>
  1. 執行應用程式。懸浮動作按鈕會使用新顏色，且快速鍵文字已變更。

步驟 3：瞭解如何使用範本新增活動

在目前為止的課程程式碼研究室中，您已使用「空白活動」和「基本活動」範本啟動新專案。專案建立完成後，您也可以在建立活動時使用活動範本。

  1. 建立應用程式專案或選擇現有專案。
  2. 在「Project > Android」窗格中，以滑鼠右鍵按一下「java」資料夾。
  3. 依序選取「New」>「Activity」>「Gallery」。
  4. 選取其中一個 Activity 範本，將活動新增至應用程式。舉例來說，選取「Navigation Drawer Activity」，即可新增含有導覽匣的 Activity。
  5. 如要在版面配置編輯器中顯示活動，請按兩下活動的版面配置檔案 (例如 activity_main2.xml)。使用「設計」分頁和「文字」分頁，即可在活動的版面配置預覽和版面配置程式碼之間切換。

GitHub 上的 Google 範例存放區提供 Kotlin Android 程式碼範例，方便您學習、複製及納入專案。

步驟 1：下載並執行 Kotlin Android 程式碼範例

  1. 在瀏覽器中前往 github.com/googlesamples。
  2. 在「Language」(語言) 中選取「Kotlin」。
  3. 選取最近修改過的 Kotlin Android 範例應用程式，然後下載應用程式的專案程式碼。在本範例中，請下載 android-sunflower 應用程式的 ZIP 檔案，該應用程式會示範部分 Android Jetpack 元件。
  4. 在 Android Studio 中開啟 android-sunflower-master 專案。
  5. 接受 Android Studio 建議的所有更新，然後在模擬器或 Android 裝置上執行應用程式。

步驟 2：探索 Kotlin Android 程式碼範例

您已在 Android Studio 中開啟 Android Sunflower 範例應用程式，現在請瞭解這個應用程式並探索其專案檔案。

  1. 如要瞭解範例應用程式的用途，請前往 GitHub 上的應用程式 README 檔案。如需這個範例，請參閱 Android Sunflower README。
  2. 在 Android Studio 中開啟應用程式中的其中一個 Kotlin 活動檔案，例如 GardenActivity.kt。
  3. 在 GardenActivity.kt 中，找出您不熟悉的類別、型別或程序，然後在 Android 開發人員說明文件中查詢。舉例來說，如要進一步瞭解 setContentView() 方法，請在 developer.android.com 上搜尋 setContentView()。

步驟 3：變更啟動器圖示

在這個步驟中，您要變更 Android Sunflower 範例應用程式的啟動器圖示。您將新增剪貼畫圖片，並用來取代目前的 Android Sunflower 啟動器圖示。

啟動器圖示

您使用 Android Studio 建立的每個應用程式，都會以代表該應用程式的預設啟動器圖示做為開端。啟動器圖示有時也稱為「應用程式圖示」或「產品圖示」。

如果您在 Google Play 發布應用程式，應用程式的啟動器圖示會顯示在 Google Play 商店的應用程式資訊和搜尋結果中。

在 Android 裝置上安裝應用程式後，應用程式的啟動器圖示會顯示在裝置主畫面和裝置的其他位置。舉例來說，Android Sunflower 應用程式的啟動器圖示會顯示在裝置的「搜尋應用程式」視窗中，如下方螢幕截圖中的 1 所示。如圖 2 所示，您在 Android Studio 中建立的所有應用程式專案，一開始都會使用預設啟動器圖示。

變更啟動器圖示

變更啟動器圖示的過程，可讓您熟悉 Android Studio 的圖片素材資源功能。

在 Android Studio 中，請按照下列步驟變更 Android Sunflower 應用程式的啟動器圖示：

  1. 在「Project > Android」窗格中，在「res」資料夾上按一下滑鼠右鍵 (或按住 Ctrl 並按一下滑鼠)，依序選取「New」>「Image Asset」。系統隨即會顯示「設定圖片素材資源」對話方塊。

按一下啟動器圖示的「前景圖層」分頁標籤。

  1. 在「Icon Type」欄位中，選取「Launcher Icons (Adaptive & Legacy)」(如果尚未選取)。按一下「前景圖層」分頁標籤。
  2. 在「Asset Type」中選取「Clip Art」，如下方螢幕截圖中的 1 所示。

  3. 按一下「剪貼畫」欄位中的機器人圖示 (如上方螢幕截圖中的 2 所示)。系統會隨即顯示「Select Icon」對話方塊，內含 Material Design 圖示集。
  4. 瀏覽「選取圖示」對話方塊，或依名稱搜尋圖示。選取圖示，例如心情圖示，表示心情愉快。然後點選「OK」。

  1. 在「Configure Image Asset」對話方塊中，按一下「Background Layer」分頁標籤。在「素材資源類型」中，選取「顏色」。按一下色片，然後選取要做為圖示背景圖層的顏色。
  2. 按一下「舊版」分頁，然後查看預設設定。確認您要產生舊版、圓形和 Google Play 商店圖示。點選「下一步」。
  3. 畫面上會出現「Confirm Icon Path」對話方塊，顯示要新增及覆寫的圖示檔案位置。按一下「完成」。
  4. 在 AVD 模擬器或 Android 裝置上執行應用程式。

Android Studio 會自動將啟動器圖片新增至不同螢幕密度的「mipmap」目錄。Android Sunflower 應用程式現在會使用新的剪貼畫圖示做為啟動圖示。

  1. 再次執行應用程式。確認「搜尋應用程式」畫面中顯示新的啟動器圖示。

步驟 1：瀏覽官方 Android 說明文件

請瀏覽幾個最實用的 Android 說明文件網站，熟悉可用的資源：

  1. 前往 developer.android.com。這份 Android 開發人員官方說明文件由 Google 維護，內容會隨時更新。
  2. 前往 developer.android.com/design/。這個網站提供指南，說明如何設計高品質 Android 應用程式的外觀和功能。
  3. 前往 material.io，這是介紹 Material Design 的網站。Material Design 是一種概念設計哲學，說明所有應用程式 (不只是 Android 應用程式) 在行動裝置上的外觀和運作方式。點選連結，進一步瞭解 Material Design。舉例來說，如要瞭解如何使用顏色，請按一下「設計」分頁，然後選取「顏色」。
  4. 前往 developer.android.com/docs/，查看 API 資訊、參考說明文件、教學課程、工具指南和程式碼範例。
  5. 如要瞭解如何將應用程式發布至 Google Play，請前往 developer.android.com/distribute/。Google Play 是 Google 的數位發行系統，適用於使用 Android SDK 開發的應用程式。使用 Google Play 管理中心拓展客群，並開始賺取收益。

步驟 2：探索 Android 團隊和 Google 搜尋的內容

  1. 歡迎瀏覽 Android 開發人員 YouTube 頻道，這裡有許多實用教學課程和訣竅。
  2. 造訪 Android 官方網誌，查看 Android 團隊發布的最新消息和提示。
  3. 在 Google 搜尋中輸入問題後，Google 搜尋引擎會從各種資源收集相關結果。舉例來說，你可以使用 Google 搜尋詢問「印度最熱門的 Android 作業系統版本是什麼？」你甚至可以在 Google 搜尋中輸入錯誤訊息。

步驟 3：在 Stack Overflow 上搜尋

Stack Overflow 是由程式設計人員組成的社群，如果遇到問題，很可能已經有人發布解答。

  1. 請前往 Stack Overflow。
  2. 在搜尋框中輸入問題，例如「如何透過 Wi-Fi 設定及使用 ADB？」您不必註冊就能在 Stack Overflow 上搜尋，但如要發布新問題或回答問題，就必須註冊。
  3. 在搜尋框中輸入 [android]。[] 括號表示您要搜尋標示為與 Android 相關的貼文。
  4. 你可以結合標記和搜尋字詞，讓搜尋結果更精確。請嘗試搜尋下列內容：
  • [android] and [layout]
  • [android] "hello world"

步驟 4：使用 SDK Manager 安裝離線說明文件

安裝 Android Studio 時，系統會一併安裝 Android SDK 的必要元件。如要安裝其他可用的程式庫和說明文件，請使用 SDK 管理工具。

如要探索 SDK 管理工具並下載 SDK 說明文件，請按照下列步驟操作：

  1. 在 Android Studio 中，選取「Tools」>「SDK Manager」。SDK 管理工具隨即開啟。
  2. 在 SDK 管理工具的左欄中，選取「Android SDK」 (下圖中的 1)。
  3. 記下「Android SDK Location」欄位中的路徑 (下圖中的 2)。您稍後會使用這個路徑尋找安裝的項目。
  4. 在 SDK 管理工具中，按一下「SDK Platforms」分頁標籤。您可以在這裡安裝更多 Android 系統版本。
  5. 按一下「SDK Tools」分頁標籤。您可以在這裡安裝預設未安裝的 SDK 開發人員工具。您也可以安裝 Android 開發人員文件離線版。
  6. 按一下「SDK Update Sites」分頁標籤。Android Studio 會定期檢查所列和所選網站是否有更新。
  7. 返回「SDK Tools」分頁，然後選取「Documentation for Android SDK」核取方塊 (如果尚未選取)。按一下「套用」。

    系統會開啟確認對話方塊，顯示下載所需的磁碟空間。按一下「確定」。
  8. 安裝完成後，按一下「完成」。

如要尋找已安裝的文件，請按照下列步驟操作：

  1. 在電腦上前往 Android/sdk/ 目錄。(如要尋找目錄路徑，請參閱「Android SDK Location」欄位，如上方的螢幕截圖所示，標示為 2)。
  2. 開啟 docs/ 目錄。
  3. 找出 index.html 檔案，然後在瀏覽器中開啟。
  • 如需 Android 開發人員官方說明文件，請前往 developer.android.com。
  • Material Design 是一種概念設計哲學，說明應用程式在行動裝置上的外觀和運作方式。Material Design 不只適用於 Android 應用程式，如需 Material Design 指南，請前往 material.io。
  • Android Studio 提供常見和建議的應用程式與活動設計範本。這些範本提供常見用途的可用程式碼。
  • 建立專案時，您可以為第一個活動選擇範本。
  • 開發應用程式時，您可以使用內建範本建立活動和其他應用程式元件。
  • Google 範例包含程式碼範例，可供您研究、複製及納入專案。

Udacity 課程：

Android Studio 說明文件：

Android 開發人員說明文件：

程式碼範例：

影片：

其他資源：

開始下一個課程：2.1：使用版面配置編輯器進行線性版面配置

如要查看本課程其他程式碼研究室的連結，請參閱 Android Kotlin 基礎知識程式碼研究室登陸頁面。