建立及執行第一個 Android 應用程式

在本程式碼研究室中，您會使用 Android Studio 提供的基本應用程式，從範本建立第一個 Android 應用程式 (生日快樂)。此外，您會對 Android 專案有大致的瞭解，以及瞭解如何在 Android Studio 中使用不同的視窗。

必要條件

• 熟悉如何設定及使用應用程式，例如文書處理軟體或試算表

課程內容

• 如何使用範本為 Android 應用程式建立 Android Studio 專案。

建構項目

• 範本中的基本 Android 應用程式

軟硬體需求

• 已安裝 Android Studio 的電腦

在這項工作中，您將使用 Android Studio 提供的專案範本建立 Android 應用程式。

專案範本

在 Android Studio 中，專案範本是 Android 應用程式，具備所有必要的功能，但功能並不多。此應用程式的目的是協助您更快上手，為您省去一些工作。Android Studio 中的範本包括具備地圖的應用程式，以及具備多個螢幕的應用程式。

建立空白活動專案

您將在以下步驟中，使用新應用程式的空白活動專案範本建立新的 Android Studio 專案。

1. 按一下 Android Studio 圖示 來啟動 Android Studio (如果尚未開啟)。

「歡迎使用 Android Studio」視窗隨即顯示。

2. 在「歡迎使用 Android Studio」視窗中，按一下 [+ 建立新的 Android Studio 專案]。

「Create New Project」(建立新專案) 視窗隨即開啟，其中顯示 Android Studio 提供的範本清單。

3. 按一下頂端的分頁標籤並瀏覽範本，瞭解提供哪些功能！我們為多種不同類型的裝置 (例如手機、平板電腦和智慧手錶) 以及不同類型的應用程式 (可捲動畫面的應用程式、內含地圖的應用程式及時尚導覽應用程式) 提供範本。
4. 在視窗的左上方，按一下 [手機和平板電腦] 分頁標籤。
5. 按一下最上排的「空白活動」範本，以選取該範本做為專案的範本。

「空白活動」範本最簡單的範本，可用於建立應用程式。這個範本只有一個畫面，上面顯示了簡單一句「Hello World!」訊息。

6. 按一下視窗底部的「下一步」(Next)。「Create New Project」對話方塊會隨即開啟。

請按以下方式設定專案：

7. 「Name」(名稱) 是應用程式的名稱。在「Name」(名稱) 下方的方塊中輸入 Happy Birthday 做為專案名稱。
8. Package name 是 Android 系統用於識別您應用程式的名稱。一般來說，這會預設為貴機構的名稱，後面加上應用程式名稱，皆以小寫字母顯示 (在本例中為「com.example.happybirthday」)。
9. 「Save location」(儲存位置) 是儲存與專案相關的所有檔案的地方。請記下這些檔案在電腦的位置，以便尋找檔案。你也可以暫時將儲存位置保持原樣。
10. 「Language」(語言) 定義了專案要使用的程式設計語言。確認語言是 Kotlin。
11. 「Minimum SDK」(SDK 最低版本) 代表可執行應用程式的 Android 最低版本。請從下拉式清單選取 API 19: Android 4.4 (KitKat)。

注意：Android 作業系統有多種版本，各版本在發布時都會按字母順序命名。

12. 請留意在「Minimum SDK」(SDK 最低版本) 下方的說明，其中指出您的應用程式在所選 API 級別中可執行的相應裝置數量。如果您有興趣，請按一下 Help me choose 連結，以查看不同 Android 版本的清單 (如下所示)。然後返回「New Project」(新增專案) 視窗。

13. 在「Create New Project」視窗中，確認已取消勾選 [Uselegacy android.support Libraries]。如果您想進一步瞭解相關資訊，請按一下問號。
14. 按一下 [Finish]，

Android Studio 會開啟專案及其所有檔案。

初次開啟 Android Studio 時，您會看到三個視窗：

(1)「Project」(專案) 視窗會顯示專案的檔案和資料夾。

(2) 「編輯」視窗適用於編輯程式碼。

(3) 「新功能」視窗會顯示新聞和實用提示。

Android Studio 的右下角會顯示進度列或訊息，指出 Android Studio 是否仍在設定專案。例如：

15. 請等待 Android Studio 完成專案設定。系統會在專案完成時顯示下方訊息，如下所示 (如下所示)。

在這項工作中，您會使用 Android 虛擬裝置 (AVD) 管理員建立行動裝置的軟體版本 (模擬器)，並在電腦上執行這個程式。虛擬裝置或模擬器會模擬特定 Android 裝置類型 (例如手機) 的設定。此裝置可以是任何執行所選 Android 系統版本的手機或平板電腦。然後，您會使用虛擬裝置執行透過「空白活動」範本建立的應用程式。

注意：Android Emulator 是用來設定虛擬裝置的獨立應用程式，且有專屬的系統需求。虛擬裝置可能會占用大量磁碟空間。如果您遇到任何問題，請參閱在 Android 模擬器上執行應用程式。

建立 Android 虛擬裝置 (AVD)

如要在電腦上執行模擬器，第一步是為虛擬裝置建立設定。

1. 在 Android Studio 選單列中，選取 [Tools > AVD Manager]。

提示：您也可以點選工具列中的圖示 ，開啟 AVD 管理員。

「你的虛擬裝置」對話方塊如下所示。(如果您先前已經建立虛擬裝置，就會顯示在這裡。)

2. 按一下 [+ 建立虛擬裝置]。

「Select Hardware」(選取硬體) 視窗會隨即顯示。

「Select Hardware」視窗會顯示符合「Category」分類且預先設定的裝置的清單。表格會針對每個裝置，提供螢幕大小 (大小)、螢幕解析度 (像素) 和像素密度 (密度)。

3. 選取「Phone」(電話) 做為類別。
4. 選取手機 (例如 Pixel 3 XL)，然後按一下「Next」(下一步)。您可以選擇任何手機，但在本程式碼研究室中，請選擇較新的裝置。

系統會隨即顯示「System Image」(系統映像檔) 視窗。在這個視窗中，請選擇要在虛擬裝置上執行的 Android 系統版本。這可讓您在不同的 Android 系統版本上測試應用程式。

5. 在「Recommended」(推薦) 分頁標籤中，選擇 Q 做為虛擬裝置上執行的 Android 系統版本。截至本文撰寫時間為止，這已是 Android 的最新版，但您也可以選擇任何較新的穩定版本。如需穩定版本清單，請參閱這個網頁。

注意：如果您在要使用的系統映像檔旁邊看到 [下載] 連結，表示您的電腦未安裝該映像檔。您必須先安裝映像檔，才能設定虛擬裝置。

如要安裝系統映像檔，請按一下「Download」(下載) 連結。請注意，視網際網路連線狀態而定，下載作業可能需要較長的時間。下載完成後，請按一下「Finish」(完成)。

重要事項：這些 Android 系統映像檔會占用大量磁碟空間，因此您原先安裝的映像檔只占一小部分。「Recommended」(推薦) 分頁標籤只顯示部分 Android 系統版本，除此之外還有更多版本可供使用。如要查看更多資訊，請查看「x86 Images」(x86 映像檔) 和「其他映像檔」(Other Images) 分頁標籤。

5. 按一下 [繼續]，

「Android Virtual Device (AVD)」視窗會隨即顯示，讓您選擇裝置的其他設定詳細資料。

6. 在「AVD Name」(AVD 名稱) 欄位中，請輸入 Android 虛擬裝置的名稱。其餘設定請保持不變。
7. 按一下 [完成]。

新的虛擬裝置隨即會顯示在「您的虛擬裝置」視窗中，供您立即使用。

8. 關閉「Your Virtual Device」視窗。

在虛擬裝置上執行應用程式

1. 如果尚未將 Android Studio 置於前景，請先進行設定。
2. 在 Android Studio 工具列中，從工具列尋找虛擬裝置下拉式選單 (類似下方的範例)，然後從下拉式清單中選取您所建立的虛擬裝置。 (或依序點選「Run」(執行) > 「Select Device..」(選取裝置..)，然後從彈出式視窗中的可用裝置選取虛擬裝置)。
3. 在 Android Studio 中，選取 Run > Run app，或按一下工具列上的Run 圖示 。
   虛擬裝置會以實體裝置啟動及啟動。視電腦速度而定，啟動時可能需要一些時間。

應用程式準備就緒後，就會在虛擬裝置上開啟，如下所示。

做得好！您的虛擬裝置現已啟動並開始運作。請注意，應用程式現在名為「Happy Birthday」，而畫面上會顯示「Hello World!」。

設定專案時，Android Studio 會在電腦上為所有 Android 專案建立一個名為 AndroidStudioProjects 的資料夾。在 AndroidStudioProjects 資料夾中，Android Studio 也會建立與您的應用程式相同的資料夾 (在本範例中為 HappyBirthday)。

HappyBirthday 資料夾是您的專案資料夾。Android Studio 會將您建立的檔案以及由 Android Studio 建立的檔案一併儲存在專案資料夾中。

1. 在 Android Studio 中，查看左側的「Project」(專案) 視窗。「Project」(專案) 視窗會顯示專案的檔案和資料夾。

「Project」(專案) 視窗中的檔案已經過整理，方便您在編寫程式碼時輕鬆瀏覽專案檔案。不過，如果您在檔案瀏覽器 (例如 Finder 或 Windows Explorer) 中查看檔案，檔案階層的分類方式會大不相同。

在這項工作中，您會瞭解專案資料夾階層的兩種不同檢視畫面。

2. 在 Android Studio 的「Project」(專案) 視窗中，從左上角的下拉式選單中選取 [Android]。

畫面上應會顯示類似下圖所示的檔案清單：

您在檢視專案的程式碼時，這種檢視方式和檔案的整理方式相當實用。

您也可以用檔案瀏覽器 (例如 Finder (macOS) 或 Explorer (適用於 Windows)) 查看檔案。

3. 在「專案」視窗中的下拉式選單中，選取 [專案來源檔案]。

請注意，標題會變更為儲存專案檔案的資料夾。

現在，您可以以與任何檔案總管相同的方式瀏覽檔案。

4. 如要切換回上一個檢視畫面，請在「Project」(專案) 視窗中再次選取「Android」。

太好了！您現在可以從範本建立及執行應用程式，也可以找到您的專案檔案。

• 如要建立新專案，請開啟 Android Studio，然後按一下「+ Start a new Android Studio project」(+ 開始新的 Android Studio 專案)，輸入專案名稱，選擇範本並填入詳細資料。
• 如要建立 Android 虛擬裝置 (模擬器) 以執行您的應用程式，請選擇 [Tools > AVD Manager]，然後使用 AVD Manager 選取硬體裝置和系統映像檔。
• 如要在虛擬裝置上執行應用程式，請確認您已建立裝置，然後從工具列的下拉式選單中選取裝置，然後按一下工具列上的「執行」圖示 來執行應用程式。
• 如要找出專案檔案，請在「Project」(專案) 視窗中，從下拉式選單選取「Project Source Files」(專案來源檔案)。

• 認識 Android Studio
• 專案總覽
• 建立專案
• 加入範本中的程式碼
• 建立並執行應用程式
• 在 Android Emulator 上執行應用程式