本教程面向有一定編程基礎的開發者,涵蓋 Android 開發全流程:JDK/SDK/IDE 安裝、項目創建、UI 佈局、業務邏輯、真機調試、簽名打包、發布上架。以 IntelliJ IDEA / Android Studio 為主 IDE,採用現代化最佳實踐。
JAVA_HOME = JDK 安裝目錄Path 添加 %JAVA_HOME%\binjava -version、javac -version
HelloAndroidcom.example.helloandroid
HelloAndroid/
├── .gradle/ # Gradle 緩存
├── .idea/ # IDEA 配置
├── app/ # 主應用模塊
│ ├── src/
│ │ ├── main/
│ │ │ ├── java/com/example/helloandroid/
│ │ │ │ └── MainActivity.kt
│ │ │ ├── res/
│ │ │ │ ├── layout/activity_main.xml
│ │ │ │ ├── values/strings.xml, colors.xml, themes.xml
│ │ │ │ ├── drawable/, mipmap/
│ │ │ │ └── xml/ (backup rules, network security)
│ │ │ └── AndroidManifest.xml
│ │ ├── test/ # 單元測試 (JVM)
│ │ └── androidTest/ # 儀器測試 (設備)
│ ├── build.gradle.kts # 模塊構建腳本
│ └── proguard-rules.pro # 混淆規則
├── gradle/
│ └── wrapper/ # Gradle Wrapper
├── build.gradle.kts # 項目級構建腳本
├── settings.gradle.kts # 模塊聲明
├── gradle.properties # 全局屬性 (JVM 參數、版本號)
└── local.properties # 本機 SDK/NDK 路徑 (不提交 Git)
res/layout/activity_main.xml)<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="https://schemas.android.com/apk/res/android"
xmlns:tools="https://schemas.android.com/tools"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:orientation="vertical"
android:gravity="center"
android:padding="24dp"
tools:context=".MainActivity">
<TextView
android:id="@+id/tvMessage"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:text="@string/initial_message"
android:textSize="24sp"
android:textColor="@color/primary_dark"
android:gravity="center" />
<Button
android:id="@+id/btnClick"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_marginTop="24dp"
android:text="@string/button_click"
android:paddingHorizontal="32dp"
android:paddingVertical="12dp" />
</LinearLayout>
res/values/strings.xml)<resources>
<string name="app_name">HelloAndroid</string>
<string name="initial_message">點擊下方按鈕查看魔法✨</string>
<string name="button_click">點擊我</string>
<string name="clicked_message">🎉 成功觸發點擊事件!</string>
<string name="toast_clicked">按鈕被點擊了!</string>
</resources>
MainActivity.kt)package com.example.helloandroid
import android.os.Bundle
import android.widget.Button
import android.widget.TextView
import android.widget.Toast
import androidx.appcompat.app.AppCompatActivity
class MainActivity : AppCompatActivity() {
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
setContentView(R.layout.activity_main)
val tvMessage = findViewById(R.id.tvMessage)
val btnClick = findViewById
adb devices
# List of devices attached
# XXXXXXXXXX device ← 顯示 device 即連接成功
./gradlew installDebug
# 命令行生成 (推薦,可存入版本庫 .gitignore)
keytool -genkeypair -v -keystore release.keystore -alias release_key \
-keyalg RSA -keysize 2048 -validity 10000 \
-storepass -keypass \
-dname "CN=Your Name, OU=Engineering, O=Your Company, L=City, S=State, C=CN"
# 或 Android Studio: Build → Generate Signed Bundle/APK → Create new

android {
// ...
signingConfigs {
create("release") {
storeFile = file("../release.keystore") // 相對路徑
storePassword = System.getenv("KEYSTORE_PASSWORD") // 從環境變量讀取,勿硬編碼
keyAlias = "release_key"
keyPassword = System.getenv("KEY_PASSWORD")
}
}
buildTypes {
release {
isMinifyEnabled = true // 啟用 R8 混淆
isShrinkResources = true // 移除無用資源
signingConfig = signingConfigs.getByName("release")
proguardFiles(
getDefaultProguardFile("proguard-android-optimize.txt"),
"proguard-rules.pro"
)
}
}
}

基礎語法 (Kotlin)
→ 四大組件 + Intent + 生命週期
→ Jetpack (ViewModel, LiveData, Room, Navigation, WorkManager)
→ Compose 聲明式 UI (替代 XML + ViewBinding)
→ 架構 (MVI/MVVM + Clean + Repository + Hilt)
→ 專項 (性能、多媒體、圖形、安全、跨平台 KMP)
→ 工程化 (模塊化、CI/CD、自動化測試、發布流程)
| 現象 | 原因 | 解決 |
|---|---|---|
| R 文件找不到/報紅 | 資源文件命名錯誤、Gradle 同步失敗 | 檢查命名規範 (小寫_下劃線)、File → Sync Project with Gradle Files |
| 真機無法安裝 | 簽名衝突、版本號未遞增、未啟用 USB 安裝 | 卸載舊版、遞增 versionCode、開啟 USB 安裝 |
| 網路請求失敗 | 缺權限、明文流量、域名配置 | Manifest 添加 INTERNET、network_security_config、HTTPS |
| 構建緩慢 | 未啟用配置緩存、守護進程、並行構建 | gradle.properties 開啟 org.gradle.parallel/caching、配置 JVM 參數 |
恭喜!您已完成從 0 到 1 的 Android 應用構建。這只是起點,真正的工程之路在於持續構建、重構、優化、分享。建議建立個人技術博客,記錄每個踩坑與突破,教會別人是檢驗掌握程度的最佳方式。