环境配置

本章节将指导你安装和配置 Android 开发环境，包括 Android Studio、Android SDK、模拟器等必要工具。

系统要求

在开始之前，请确保你的电脑满足以下最低要求：

配置项	最低要求	推荐配置
操作系统	Windows 10 64位 / macOS 10.14 / Linux	Windows 11 / macOS 13 / 最新 Linux
内存	8 GB	16 GB 或更多
磁盘空间	8 GB	20 GB 或更多（SSD）
分辨率	1280 x 800	1920 x 1080 或更高

安装 Android Studio

Android Studio 是 Google 官方提供的集成开发环境（IDE），基于 IntelliJ IDEA，是开发 Android 应用的首选工具。

Windows 安装步骤

下载 Android Studio

访问 Android Studio 官网，点击下载按钮。
运行安装程序

双击下载的 .exe 文件，按照向导提示进行安装。建议使用默认安装路径。
选择组件

安装向导会询问要安装的组件，建议全部选择：
- Android Studio
- Android SDK
- Android Virtual Device（模拟器）
完成安装

安装完成后，启动 Android Studio，会自动下载必要的 SDK 组件。

macOS 安装步骤

下载 Android Studio

访问官网下载 .dmg 文件。
安装应用

打开 dmg 文件，将 Android Studio 拖拽到 Applications 文件夹。
首次启动

打开 Applications 中的 Android Studio，首次启动会完成初始化配置。

Linux 安装步骤

下载压缩包

下载 .tar.gz 压缩包。

解压到目标目录

sudo tar -xzf android-studio-*.tar.gz -C /opt/

启动 Android Studio
```
/opt/android-studio/bin/studio.sh
```

配置向导

首次启动 Android Studio 时，会运行配置向导：

1. 选择安装类型

Standard：推荐，自动安装最常用的组件
Custom：自定义，可以选择安装路径和组件

建议选择 Standard，点击 Next 继续。

2. 选择 UI 主题

可以选择 Darcula（深色）或 Light（浅色）主题。根据个人喜好选择即可。

3. 下载组件

配置向导会自动下载以下组件：

Android SDK
Android SDK Platform
Android Virtual Device

下载过程可能需要较长时间，取决于网络状况。

Android SDK 管理

Android SDK（Software Development Kit）包含了开发 Android 应用所需的工具和 API。

打开 SDK Manager

在 Android Studio 中，通过以下方式打开 SDK Manager：

菜单：Tools → SDK Manager
快捷键：Ctrl + Alt + S（Windows/Linux），Cmd + ,（macOS）

SDK 平台

在 SDK Platforms 标签页，可以下载不同版本的 Android 平台：

版本	API Level	说明
Android 14	34	最新稳定版
Android 13	33	广泛使用
Android 12	31	较新版本

建议至少下载最新的稳定版和一个较旧版本，以便测试兼容性。

SDK 工具

在 SDK Tools 标签页，可以管理开发工具：

Android SDK Build-Tools：编译应用所需的工具
Android Emulator：模拟器
Android SDK Platform-Tools：adb 等调试工具
Android SDK Command-line Tools：命令行工具

创建模拟器

Android 模拟器（AVD，Android Virtual Device）允许你在电脑上运行 Android 系统，无需真机即可测试应用。

创建新模拟器

打开 AVD Manager：Tools → Device Manager
点击 "Create Device"
选择设备类型（推荐 Pixel 6）
选择系统镜像（推荐最新的稳定版）
配置 AVD 名称和高级设置
点击 Finish 完成

模拟器配置建议

配置项	推荐设置
RAM	2048 MB 或更多
VM heap	256 MB
Graphics	Hardware - GLES 2.0

模拟器快捷键

功能	Windows/Linux	macOS
旋转屏幕	Ctrl + →/←	Cmd + →/←
返回	Esc	Esc
主页	Home	Home
电源	F7	F7
音量增大	Ctrl + F5	Cmd + F5
音量减小	Ctrl + F6	Cmd + F6

创建第一个项目

环境配置完成后，让我们创建第一个 Android 项目：

1. 新建项目

启动 Android Studio
选择 "New Project"
选择模板：选择 "Empty Views Activity"（传统 XML 布局）或 "Empty Activity"（Jetpack Compose）
点击 Next

2. 配置项目

配置项	说明	示例
Name	应用名称	MyFirstApp
Package name	包名（唯一标识）	com.example.myfirstapp
Save location	项目保存位置	D:\Projects\MyFirstApp
Language	编程语言	Kotlin
Minimum SDK	最低支持的 Android 版本	API 24 (Android 7.0)

3. 项目结构

创建完成后，项目结构如下：

MyFirstApp/
├── app/
│   ├── src/
│   │   ├── main/
│   │   │   ├── java/          # Kotlin/Java 源代码
│   │   │   ├── res/           # 资源文件
│   │   │   │   ├── layout/    # 布局文件
│   │   │   │   ├── values/    # 字符串、颜色等
│   │   │   │   ├── drawable/  # 图片资源
│   │   │   │   └── mipmap/    # 应用图标
│   │   │   └── AndroidManifest.xml  # 应用清单
│   │   ├── test/              # 单元测试
│   │   └── androidTest/       # UI 测试
│   └── build.gradle.kts       # 模块级构建配置
├── gradle/                    # Gradle 包装器
├── build.gradle.kts           # 项目级构建配置
└── settings.gradle.kts        # 项目设置

4. 运行项目

点击工具栏的运行按钮（绿色三角形）
选择目标设备（模拟器或真机）
等待编译完成，应用会自动安装并启动

连接真机调试

使用真机调试可以获得更真实的测试体验：

1. 开启开发者选项

打开手机的"设置"
找到"关于手机"
连续点击"版本号"7次，直到提示"已开启开发者选项"

2. 开启 USB 调试

返回设置，找到"开发者选项"
开启"USB 调试"
用 USB 线连接电脑

3. 授权调试

连接后，手机会弹出授权对话框，勾选"始终允许"，点击"确定"。

4. 验证连接

在 Android Studio 的设备下拉列表中，应该能看到你的手机。

Gradle 构建系统

Android 项目使用 Gradle 作为构建系统，采用 Kotlin DSL（.kts）或 Groovy DSL（.gradle）进行配置。

项目级 build.gradle.kts

plugins {
    id("com.android.application") version "8.2.0" apply false
    id("org.jetbrains.kotlin.android") version "1.9.0" apply false
}

模块级 build.gradle.kts

plugins {
    id("com.android.application")
    id("org.jetbrains.kotlin.android")
}

android {
    namespace = "com.example.myfirstapp"
    compileSdk = 34

    defaultConfig {
        applicationId = "com.example.myfirstapp"
        minSdk = 24
        targetSdk = 34
        versionCode = 1
        versionName = "1.0"
    }

    buildTypes {
        release {
            isMinifyEnabled = false
            proguardFiles(
                getDefaultProguardFile("proguard-android-optimize.txt"),
                "proguard-rules.pro"
            )
        }
    }
    
    compileOptions {
        sourceCompatibility = JavaVersion.VERSION_1_8
        targetCompatibility = JavaVersion.VERSION_1_8
    }
    
    kotlinOptions {
        jvmTarget = "1.8"
    }
}

dependencies {
    implementation("androidx.core:core-ktx:1.12.0")
    implementation("androidx.appcompat:appcompat:1.6.1")
    implementation("com.google.android.material:material:1.11.0")
    implementation("androidx.constraintlayout:constraintlayout:2.1.4")
    
    testImplementation("junit:junit:4.13.2")
    androidTestImplementation("androidx.test.ext:junit:1.1.5")
    androidTestImplementation("androidx.test.espresso:espresso-core:3.5.1")
}

关键配置说明

compileSdk：编译时使用的 SDK 版本
minSdk：应用支持的最低 Android 版本
targetSdk：目标优化版本，影响系统行为
versionCode：版本号（整数），用于更新判断
versionName：版本名称（字符串），显示给用户

常见问题

1. Gradle 同步失败

检查网络连接，可能需要配置代理或使用国内镜像源。

在 settings.gradle.kts 中添加阿里云镜像：

dependencyResolutionManagement {
    repositories {
        maven { url = uri("https://maven.aliyun.com/repository/google") }
        maven { url = uri("https://maven.aliyun.com/repository/public") }
        google()
        mavenCentral()
    }
}

2. 模拟器启动失败

确保电脑支持虚拟化技术（VT-x / AMD-V）
在 BIOS 中开启虚拟化
更新显卡驱动

3. HAXM 安装失败

macOS 和新版 Windows 使用 Hypervisor，不需要 HAXM。旧版 Windows 可能需要手动安装 HAXM。

小结

本章介绍了 Android 开发环境的完整配置过程：

安装 Android Studio IDE
配置 Android SDK
创建和管理模拟器
创建第一个项目
连接真机调试
理解 Gradle 构建系统

下一章将深入学习 Activity 组件，理解 Android 应用的核心概念。

系统要求​

安装 Android Studio​

Windows 安装步骤​

macOS 安装步骤​

Linux 安装步骤​

配置向导​

1. 选择安装类型​

2. 选择 UI 主题​

3. 下载组件​

Android SDK 管理​

打开 SDK Manager​

SDK 平台​

SDK 工具​

创建模拟器​

创建新模拟器​

模拟器配置建议​

模拟器快捷键​

创建第一个项目​

1. 新建项目​

2. 配置项目​

3. 项目结构​

4. 运行项目​

连接真机调试​

1. 开启开发者选项​

2. 开启 USB 调试​

3. 授权调试​

4. 验证连接​

Gradle 构建系统​

项目级 build.gradle.kts​

模块级 build.gradle.kts​

关键配置说明​

常见问题​

1. Gradle 同步失败​

2. 模拟器启动失败​

3. HAXM 安装失败​

小结​