萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> Android 開發

Android APP 開發入門完整教程:從環境搭建到上架發布

本教程面向有一定編程基礎的開發者,涵蓋 Android 開發全流程:JDK/SDK/IDE 安裝、項目創建、UI 佈局、業務邏輯、真機調試、簽名打包、發布上架。以 IntelliJ IDEA / Android Studio 為主 IDE,採用現代化最佳實踐。

一、開發環境搭建 (預計 30 分鐘)

1. JDK 安裝 (關鍵:JDK 17/21)

  • 下載:Eclipse Temurin (OpenJDK 建議) 或 Oracle JDK
  • 安裝並配置環境變量:
    • JAVA_HOME = JDK 安裝目錄
    • Path 添加 %JAVA_HOME%\bin
  • 驗證:java -version、javac -version

2. Android Studio 安裝 (一站式)

  • 下載:官網最新穩定版 (含 SDK、模擬器、Gradle、NDK、Platform Tools)
  • 安裝向導選擇 Standard,自動下載 SDK Platform (API 34)、Build Tools、Emulator 系統鏡像
  • 首次啟動配置:主題 (Darcula 暗色)、插件市場 (Key Promoter X、Rainbow Brackets、Json Parser)

3. SDK 管理 (按需安裝)

  • SDK Platforms:API 34 (最新)、API 33、API 29 (最低兼容建議)、API 24 (歷史兼容)
  • SDK Tools:Android SDK Build-Tools (最新)、Platform Tools、Emulator、Layout Inspector、Command Line Tools
  • 系統鏡像:Google Play ARM64 (真機環境)、Google APIs x86_64 (舊 Intel 電腦)
SDK Manager 界面

二、創建第一個項目 (Empty Views Activity)

1. 新建項目向導

  • File → New → New Project → Empty Views Activity (傳統 XML) 或 Empty Activity (Compose)
  • 配置項:
    • Name: HelloAndroid
    • Package name: com.example.helloandroid
    • Save location: 非中文路徑
    • Language: Kotlin (推薦) / Java
    • Minimum SDK: API 24 (Android 7.0) 覆蓋 95%+ 設備
    • Build configuration language: Kotlin DSL (.kts)
新建項目配置

2. 項目結構解析 (Gradle 模塊化)

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)

三、編寫第一個功能:點擊按鈕更新文本 + Toast

1. 佈局文件 (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>

2. 字符串資源 (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>

3. 主邏輯 (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

四、真機調試 (比模擬器更真實)

1. 手機端設置

  1. 開發者選項:設置 → 關於手機 → 連續點擊版本號 7 次
  2. USB 調試:開發者選項 → 開啟 USB 調試、USB 安裝、檢查應用
  3. 數據線:支持數據傳輸 (非僅充電線)

2. 電腦端驅動

  • Windows:安裝廠商 USB 驅動或通用 Zadig 安裝 WinUSB
  • macOS/Linux:免驅動,直接識別

3. 連接驗證

adb devices
# List of devices attached
# XXXXXXXXXX    device   ← 顯示 device 即連接成功

4. 運行應用

  • Android Studio 工具欄選擇真機設備 → 點擊綠色 ▶ Run
  • 或命令行:./gradlew installDebug
真機運行效果

五、應用打包發布 (Release APK/AAB)

1. 生成簽名密鑰庫 (僅首次)

# 命令行生成 (推薦,可存入版本庫 .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
創建密鑰庫向導

2. 配置簽名 (app/build.gradle.kts)

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"
            )
        }
    }
}

3. 構建發布包

  • APK (側載分發):Build → Build Bundle(s)/APK(s) → Build APK(s)
  • AAB (Google Play 上架必備):Build → Generate Signed Bundle/APK → Android App Bundle
簽名配置向導

4. 上架 Google Play 流程

  1. Play Console 創建應用 → 填寫商店信息 (標題、描述、截圖、隱私政策)
  2. 上傳 AAB → 內測/封閉/開放測試 → 生產發布
  3. 審核通過後全球用戶可下載

六、進階學習路線圖

基礎語法 (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 應用構建。這只是起點,真正的工程之路在於持續構建、重構、優化、分享。建議建立個人技術博客,記錄每個踩坑與突破,教會別人是檢驗掌握程度的最佳方式。

copyright © 萬盛學電腦網 all rights reserved