# § Installation & Use
## 1. 安裝 JDK
* 檢查 JDK 路徑
至預設安裝目錄 C:\Program Files\Java
確認是否已經安裝 JDK
> e.g. C:\Program Files\Java\jdk-21
* 若尚未安裝 JDK:
[JDKs 載點](https://www.oracle.com/java/technologies/downloads/) or [JDK 21](https://www.oracle.com/java/technologies/downloads/#java21)
> 截至 2024-02-08 最新版本為 JDK 21
> Installation Steps --- example:
> (1) Select Windows
> (2) Select x64 Installer (`jdk-21_windows-x64_bin.exe`)
> (3) Next
> (4) Next (不更改路徑下，安裝到預設路徑 `C:\Program Files\Java\jdk-21`)
> (5) Close
* [JDK 21 Documentation](https://docs.oracle.com/en/java/javase/21/index.html)

## 2. 確認 Java 版本（系統主要版本）
* 開啟 cmd
* cd 到 家目錄 (`C:/Users/user`) 或 `C:/`
* 輸入 `java -version` (或: `java --version`)
* Case-1: 若顯示正確的 Java 版本，不需自行設定環境變數


JDK 安裝過程中已經自動設定好了
可以在 `環境變數 > 系統環境變數 > Path 最上方` 找到 `C:\Program Files\Common Files\Oracle\Java\javapath`
（Oracle 在 JDK 21 安裝時，自動設定的環境變數路徑）

* Case-2: 若無顯示 Java 版本，或抓到其它版本，需自行設定環境變數

W11: 在 工具列＞搜尋欄：輸入【**環境變數 (environment variable)**】＞【編輯系統環境變數】


複製【JDK 安裝路徑】底下【子資料夾 bin】的路徑
在 系統變數 找到變數 `Path`
➡️ 編輯
➡️ 新增 (值)：貼上 bin 路徑 (e.g. `C:\Program Files\Java\jdk-21\bin`)
➡️ 上移到 ⭐最上方⭐
➡️ 確認、確認、確認
> 若有多個 JDKs 都在 Path 設定了環境變數
> 會以【順序在上】的 path 優先認定為 Java path
>
> 有可能犯錯的地方是：
> 之前將其它版本的 JDK path 放在 Path 清單內較上方處
> 使系統把其它版本的 JDK 路徑當作主要的 Java path
> 而【抓錯 JDK 版本】！！！
>
> 可在 cmd 輸入 `java --version`
> 檢查 JDK 版本是否正確
> 

* 補充: 設定環境變數的用意是
讓可執行檔 (.exe) 能在命令列 (Command Line) 中被執行

## 3. 編譯並執行 Java 程式
* 隨便選個喜歡的路徑，新增程式 `Test.java`
* 編輯 Java 程式碼:

class Test {
  public static void main(String arr[]) {
    System.out.println("Hello 尼豪");
  }
}

* 開啟 cmd，cd 到上述路徑
* 執行 `javac Test.java`，會編譯出一個 Test.class
* 執行 `java Test.java`，會在 cmd 印出字串 `Hello 尼豪`

## 4. 安裝 Android Studio
* [載點](https://developer.android.com/studio?hl=zh-tw)
> e.g. `android-studio-2023.1.1.28-windows.exe` (安裝於 2024-02-08)
> 預設安裝路徑: `C:\Program Files\Android\Android Studio`
* Install type
Case-1: 選 Standard （C槽空間還夠，較方便）

Case-2: 選 Custom（硬碟空間考量）
↓

`安卓 SDK` 預設安裝在 `C:\`
但是如果

最好自行設定 `安卓 SDK` 安裝路徑
例如: `D:\Adroid_Sdk`
注意: 路徑【不可含有空白】！！！（如 `Program Files`）
↓　
Emulator Settings
↓
Hypervisor Driver
補充: [簡介 Windows 10 上的 Hyper-V](https://learn.microsoft.com/zh-tw/virtualization/hyper-v-on-windows/about/)
↓
↓
↓

↓
安裝過程前面都挺順利
後面出現兩排紅字
Preparing "Install Android Emulator v.33.1.24".
Downloading https://dl.google.com/android/repository/emulator-windows_x64-11237101.zip
"Install Android Emulator v.33.1.24" ready.
Installing Android Emulator in D:\Android_Sdk\emulator
"Install Android Emulator v.33.1.24" complete.
"Install Android Emulator v.33.1.24" finished.
Preparing "Install Google APIs Intel x86_64 Atom System Image API 34 (revision 12)".
Downloading https://dl.google.com/android/repository/sys-img/google_apis/x86_64-34_r12.zip
"Install Google APIs Intel x86_64 Atom System Image API 34 (revision 12)" ready.
Installing Google APIs Intel x86_64 Atom System Image in D:\Android_Sdk\system-images\android-34\google_apis\x86_64
"Install Google APIs Intel x86_64 Atom System Image API 34 (revision 12)" complete.
"Install Google APIs Intel x86_64 Atom System Image API 34 (revision 12)" finished.
Preparing "Install Android Emulator hypervisor driver (installer) v.2.0.0".
Downloading https://dl.google.com/android/repository/gvm-windows_v2_0_0.zip
"Install Android Emulator hypervisor driver (installer) v.2.0.0" ready.
Installing Android Emulator hypervisor driver (installer) in D:\Android_Sdk\extras\google\Android_Emulator_Hypervisor_Driver
"Install Android Emulator hypervisor driver (installer) v.2.0.0" complete.
"Install Android Emulator hypervisor driver (installer) v.2.0.0" finished.
Preparing "Install Intel x86 Emulator Accelerator (HAXM installer) - Deprecated v.7.6.5".
Downloading https://dl.google.com/android/repository/extras/intel/haxm-windows_v7_6_5.zip
"Install Intel x86 Emulator Accelerator (HAXM installer) - Deprecated v.7.6.5" ready.
Installing Intel x86 Emulator Accelerator (HAXM installer) - Deprecated in D:\Android_Sdk\extras\intel\Hardware_Accelerated_Execution_Manager
"Install Intel x86 Emulator Accelerator (HAXM installer) - Deprecated v.7.6.5" complete.
"Install Intel x86 Emulator Accelerator (HAXM installer) - Deprecated v.7.6.5" finished.
Preparing "Install Sources for Android 34 (revision 2)".
Downloading https://dl.google.com/android/repository/sources-34_r01.zip
"Install Sources for Android 34 (revision 2)" ready.
Installing Sources for Android 34 in D:\Android_Sdk\sources\android-34
"Install Sources for Android 34 (revision 2)" complete.
"Install Sources for Android 34 (revision 2)" finished.
Preparing "Install Android SDK Platform 34 (revision 2)".
Downloading https://dl.google.com/android/repository/platform-34-ext7_r02.zip
"Install Android SDK Platform 34 (revision 2)" ready.
Installing Android SDK Platform 34 in D:\Android_Sdk\platforms\android-34
"Install Android SDK Platform 34 (revision 2)" complete.
"Install Android SDK Platform 34 (revision 2)" finished.
Preparing "Install Android SDK Build-Tools 34 v.34.0.0".
Downloading https://dl.google.com/android/repository/build-tools_r34-windows.zip
"Install Android SDK Build-Tools 34 v.34.0.0" ready.
Installing Android SDK Build-Tools 34 in D:\Android_Sdk\build-tools\34.0.0
"Install Android SDK Build-Tools 34 v.34.0.0" complete.
"Install Android SDK Build-Tools 34 v.34.0.0" finished.
Preparing "Install Android SDK Platform-Tools v.34.0.5".
Downloading https://dl.google.com/android/repository/platform-tools_r34.0.5-windows.zip
"Install Android SDK Platform-Tools v.34.0.5" ready.
Installing Android SDK Platform-Tools in D:\Android_Sdk\platform-tools
"Install Android SDK Platform-Tools v.34.0.5" complete.
"Install Android SDK Platform-Tools v.34.0.5" finished.
Parsing D:\Android_Sdk\build-tools\34.0.0\package.xml
Parsing D:\Android_Sdk\emulator\package.xml
Parsing D:\Android_Sdk\extras\google\Android_Emulator_Hypervisor_Driver\package.xml
Parsing D:\Android_Sdk\extras\intel\Hardware_Accelerated_Execution_Manager\package.xml
Parsing D:\Android_Sdk\platform-tools\package.xml
Parsing D:\Android_Sdk\platforms\android-34\package.xml
Parsing D:\Android_Sdk\sources\android-34\package.xml
Parsing D:\Android_Sdk\system-images\android-34\google_apis\x86_64\package.xml
Android SDK is up to date.

【Running Intel® HAXM installer
Intel® HAXM installation failed. To install Intel® HAXM follow the instructions found at: https://github.com/intel/haxm/wiki/Installation-Instructions-on-Windows】

【Running Android Emulator hypervisor driver installer
Android Emulator hypervisor driver installation failed. To install Android Emulator hypervisor driver follow the instructions found at: https://github.com/google/android-emulator-hypervisor-driver】

Creating Android virtual device
Android virtual device Pixel_3a_API_34_extension_level_7_x86_64 was successfully created
↓
參考 [CSDN blog](https://blog.csdn.net/entouger/article/details/119011393)
至 https://github.com/intel/haxm/releases
安裝 `haxm-windows_v7_8_0.zip`
↓
開啟 Hyper-V

勾選【虛擬機器平台】

讓子彈飛一會兒（大約 20 秒）

完成後，Restart!

## 5. 建立 Android 專案
* Welcome page: New Project
* Empty Views Activity > Next
* Project settings
Location: `D:\MyPrograms\AndroidStudio_Java_Projects\Ex1`


## 6. Android Emulator (模擬器)
* 在 Android Studio 右上方找到 （or "Tools > Device Manager"）

* 按  ：Create Virtual Device

* 選擇裝置設定後，Next > Next > Finsih

* 在　Device Manager 視窗：按下 Start ，開啟 Emulator
> PS: 會有幾秒鐘的時間顯示以下畫面，之後才載入模擬器
>
> 

* 在工具列：按下 Start ，Run 'App'
* Emulator 視窗大小: Minimize, Maximize, or Dock（停駐）

 
* 測試: 改一改 label 顯示的預設文字


* Run app ➡️ no problem


# § Android Project
## 1. 幾種建立專案的方式
* 建立新專案: `File > New > New Project`
* 開啟舊專案: `File > Open > Select location > OK`
> [專案資料夾] 左側會有小綠人圖示
>
> 
* 匯入他人的專案: `File > New > Import Project`
> 使用此方式，可能遇到【SDK 路徑缺失】的問題
> SDK 預設路徑: `C:\Users\USER\AppData\Local\Android\Sdk`
> 查看方式:
> Android Studio 最右上角 > Setting (齒輪圖示) > Android SDK > Android SDK Location
* 匯入官方的 Sample: `File > New > Import Sample`
> 使用此方式，可能遇到 Configuration problems

## 2. 在真實手機上執行 App
* 手機 > 設定 > 安全性 > 未知的來源 > 打勾
* 手機 > 設定 > 開發人員選項 > USB 偵錯 > 打勾
* Android Studio > 右側選單 >  > 展開 Device Manager 視窗
* 拿一條 USB 線連接電腦
等待大約 30 秒~一分鐘
直到：手機跳出【開啟USB偵錯】的選項 > 打勾
Device Manager 視窗才會讀取到手機
* 上方選擇測試手機的裝置型號 > Run App0

## 3. UI 設定 > 更換背景顏色
* 實用工具-1: [RGB hex list](https://www.rapidtables.com/web/color/RGB_Color.html)
* 實用工具-2: [Color name finder](https://colors.artyclick.com/color-name-finder/)
* res > values > colors.xml

<?xml version="1.0" encoding="utf-8"?>
<resources>
    <color name="black">#00000000</color>
    <color name="white">#FFFFFF</color>
    <color name="crystal_blue">#66B2FF</color>
</resources>

* res > layout > activity_main.xml > part 1

<TextView 
    android:textColor="@color/black"
    ... 
/>

> 標籤的字體設為黑色 (RGB hex: #00000)

* res > layout > activity_main.xml > part 2

    android:background="@color/white"

> UI 背景設為白色

## 4. 專案資料夾
* app > manifests: 專案屬性
`android:label` ➡️ app 名稱
`android:icon` ➡️ app 圖示

* app > java (generated): 自動產生的 Java 程式碼
* app > java: 專案的 Java 程式碼
Android Studio 的路徑:
`app > java > com.OO.XX` > MainActivity

真實路徑:
`app\src\main\java\com\OO\XX\MainActivity.java`
* app > res: 素材庫
真實路徑: app\src\main\res

(1) `app > res > mipmap` : app 外部圖示 (icon) 的圖片
(2) `app > res > drawable` : app 內部會用到的圖片
(3) `app > res > drawable` : app 內部會用到的圖片
(4) `app > res > layout` : UI 佈局
(5) `app > res > values` : 參數設定
* Gradle Scripts: 專案建構的屬性
(1) `local.properties` : SDK 路徑
(2) `build.gradle` : app 版本資訊
`versionCode 1`, `versionName "1.0"` : 版本號
`compileSdk 33` : 編譯 SDK
`minSdk 24` : 最小 SDK
`targetSdk 33` : 目標 SDK