# 使用Android Studio创建你的第一个Android应用

作者：吉祥法师

## 一、开发环境准备与前置要求

在开始创建你的第一个Android应用之前，你需要确保开发环境已经准备就绪。首先，需要确认你的计算机上已经安装了最新版本的Android Studio，这是Google官方推出的Android应用开发集成开发环境（IDE）。如果你尚未安装，可以访问Android Studio的官方下载页面，获取适用于你操作系统的安装包。

安装过程中需要特别注意的是，你的计算机必须满足Android Studio运行所需的系统要求。这些要求通常包括足够的内存空间、处理器性能和磁盘存储空间，具体配置说明可以在下载页面底部查看。对于安装过程中可能遇到的任何疑问，建议查阅官方提供的详细安装指南，即"如何下载并安装Android Studio"的codelab教程，其中包含了完整的安装流程说明。

此外，在开始本教程之前，你应当具备Kotlin编程语言的基础知识。Kotlin是现代Android开发的首选语言，了解其基本语法、变量定义、函数使用等概念将有助于你更好地理解本教程的内容。

## 二、创建新项目与选择模板

当你准备好开发环境后，就可以开始创建你的第一个Android应用了。本教程将引导你使用Empty Activity项目模板，该模板是Android Studio提供的多种预定义模板之一，专为Jetpack Compose应用开发设计。项目模板本质上是一种标准的项目结构蓝图，它预先配置好了必要的文件和目录结构，使Android Studio能够直接编译运行你的项目。

启动Android Studio后，在欢迎界面点击"New Project"选项，系统将打开新建项目窗口，展示所有可用的项目模板列表。在模板选择界面，确保左侧的"Phone and Tablet"选项卡处于选中状态，然后点击"Empty Activity"模板。这个模板创建的项目包含一个简单的界面，默认显示"Hello Android!"文本，非常适合作为学习起点。

点击"Next"进入项目配置窗口后，需要对项目进行一系列设置。在"Name"字段中输入项目名称，本教程中我们将项目命名为"Greeting Card"（问候卡片）。"Package name"字段会自动根据项目名称生成，默认值为"com.example.greetingcard"，它用于在文件系统中组织项目代码，保持默认即可。"Save location"字段指定了项目文件的存储位置，建议记住这个路径，以便后续需要手动查找项目文件时使用。最后，在"Minimum SDK"下拉菜单中选择"API 24: Android 7.0 (Nougat)"，这表示你的应用将支持Android 7.0及以上版本的设备。

完成所有配置后，点击"Finish"按钮，Android Studio将开始创建并配置项目。这个过程可能需要一些时间，请耐心等待。期间你可能看到进度条显示项目配置状态，还可能出现"What's New"窗口展示Android Studio的新功能，可以暂时关闭它。

## 三、熟悉开发界面与项目结构

项目创建完成后，你会看到Android Studio的主界面。在窗口右上角，有三个视图切换按钮：Code（代码视图）、Split（分屏视图）和Design（设计视图）。建议点击"Split"按钮，这样你可以同时看到代码和设计预览，便于理解二者之间的对应关系。

在Split视图中，界面被划分为三个主要区域：

1. **项目视图（Project面板）**：位于左侧或顶部，显示项目的所有文件和文件夹结构。默认显示为"Android"视图模式，这是针对Android开发优化的文件组织结构，能够让你快速访问常用的项目文件。

2. **代码视图**：位于中间区域，展示当前选中文件的源代码，你可以在此编辑代码。

3. **设计视图**：位于右侧或底部，实时预览应用界面的效果。初次打开时可能显示空白并提示点击"Build & Refresh"按钮，点击后等待编译完成，预览窗口将显示默认的"Hello Android!"文本。

项目文件结构采用包（Package）的概念来组织代码，这些包本质上是存放代码的文件夹。在Android视图中，你可以展开各个目录查看项目的组成结构。如果切换到"Project Source Files"视图模式，你将看到文件在操作系统中的实际存储层级，这与在文件管理器中的浏览方式一致。

## 四、理解核心代码与更新文本

接下来，我们深入分析应用的核心代码文件MainActivity.kt。在代码视图中打开该文件，你会看到系统自动生成了一些函数，其中最重要的是`onCreate()`和`setContent()`函数。

`onCreate()`函数是Android应用的生命周期入口点，类似于Kotlin程序中的`main()`函数。当应用启动时，系统会首先调用这个函数。在`onCreate()`中调用`setContent()`函数，用于定义和构建应用的用户界面。`setContent()`接受一个可组合函数作为参数，这个函数描述了界面的结构。

在Kotlin中，所有标注了`@Composable`注解的函数都称为可组合函数，它们是构建Jetpack Compose界面的基本单元。`@Composable`注解告诉Kotlin编译器，这个函数用于生成用户界面。可组合函数有以下特点：

- 函数名称通常以大写字母开头，以区分普通函数
- 函数前必须有`@Composable`注解
- 可组合函数本身不返回任何值，而是直接描述如何绘制界面

在代码中，你会看到`Greeting()`函数，它是一个可组合函数，接受`name`参数，并在界面上显示问候文本。初始代码为`Text(text = "Hello $name!")`，其中`$name`使用了Kotlin的字符串模板特性，会将`name`变量的值插入到字符串中。

让我们修改这个函数，使其显示个性化的问候语。将文本内容改为：

```kotlin
@Composable
fun Greeting(name: String, modifier: Modifier = Modifier) {
    Text(
        text = "Hi, my name is $name!",
        modifier = modifier
    )
}
```

修改完成后，设计预览会自动更新，显示"Hi, my name is Android!"。我们发现默认参数名是"Android"，接下来需要将其改为你自己的名字。

代码中还有一个`GreetingPreview()`函数，它同时带有`@Composable`和`@Preview`注解。`@Preview`注解告诉Android Studio，这个函数的内容应该在设计视图中显示预览，无需运行完整的应用。函数参数`showBackground = true`表示预览时显示背景，便于看清内容。修改这个函数中的`Greeting("YourName")`，将参数改为你的名字，例如：

```kotlin
@Preview(showBackground = true)
@Composable
fun GreetingPreview() {
    GreetingCardTheme {
        Greeting("Meghan")
    }
}
```

## 五、个性化界面颜色设置

当前的问候文本虽然已经个性化，但界面视觉效果较为朴素。我们将学习如何通过Surface容器来美化界面。Surface是Compose中一个重要的容器组件，它代表用户界面的一个部分，允许你自定义背景颜色、边框等外观属性。

将光标放在Text文本行，使用快捷键Alt+Enter（Windows）或Option+Enter（Mac），选择"Surround with widget"选项，然后选择"Surround with Container"。Compose默认提供的是Box容器，我们将其替换为Surface：

```kotlin
@Composable
fun Greeting(name: String, modifier: Modifier = Modifier) {
    Surface {
        Text(
            text = "Hi, my name is $name!",
            modifier = modifier
        )
    }
}
```

接下来，为Surface添加`color`参数并设置为某个具体颜色。当你输入`Color`时，编辑器可能显示红色提示，表示无法解析这个类型。此时需要导入相应的依赖包。在文件顶部的import区域，添加以下导入语句：

```kotlin
import androidx.compose.ui.graphics.Color
```

导入完成后，在`Surface(color = Color.Cyan)`中选择你喜欢的颜色。为了保持代码整洁，可以使用Android Studio的自动导入优化功能。打开顶部菜单Code > Optimize Imports，或者使用Help搜索功能找到该操作，系统会自动移除未使用的导入并按字母顺序排列，使导入区域更加规范。

选择颜色后，预览区域会立即显示效果。本教程示例使用Cyan（青色），你可以自由选择自己喜欢的颜色。

## 六、添加边距与填充效果

为了让界面更加美观，我们还需要为文本添加适当的内边距（Padding）。在Compose中，使用`Modifier`来修饰和增强可组合组件的显示效果。`Modifier.padding()`函数可以在组件周围添加指定大小的空间，使文本不会紧贴容器边缘。

在Greeting函数的文本修饰器上添加padding：

```kotlin
@Composable
fun Greeting(name: String, modifier: Modifier = Modifier) {
    Surface(color = Color.Cyan) {
        Text(
            text = "Hi, my name is $name!",
            modifier = modifier.padding(24.dp)
        )
    }
}
```

这里使用了`24.dp`作为填充大小，dy是指密度无关像素（Density Independent Pixels），是一种自适应屏幕密度的长度单位，能够在不同像素密度的设备上保持一致的可视尺寸。

同样，需要补充添加相应的导入语句：

```kotlin
import androidx.compose.foundation.layout.padding
import androidx.compose.ui.unit.dp
```

## 七、完整代码解析

完成上述所有步骤后，你的MainActivity.kt文件应当如下所示：

```kotlin
package com.example.greetingcard

import android.os.Bundle
import androidx.activity.ComponentActivity
import androidx.activity.compose.setContent
import androidx.compose.foundation.layout.fillMaxSize
import androidx.compose.foundation.layout.padding
import androidx.compose.material3.MaterialTheme
import androidx.compose.material3.Surface
import androidx.compose.material3.Text
import androidx.compose.runtime.Composable
import androidx.compose.ui.Modifier
import androidx.compose.ui.graphics.Color
import androidx.compose.ui.tooling.preview.Preview
import androidx.compose.ui.unit.dp
import com.example.greetingcard.ui.theme.GreetingCardTheme

class MainActivity : ComponentActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContent {
            GreetingCardTheme {
                Surface(
                    modifier = Modifier.fillMaxSize(),
                    color = MaterialTheme.colorScheme.background
                ) {
                    Greeting("Android")
                }
            }
        }
    }
}

@Composable
fun Greeting(name: String, modifier: Modifier = Modifier) {
    Surface(color = Color.Cyan) {
        Text(
            text = "Hi, my name is $name!",
            modifier = modifier.padding(24.dp)
        )
    }
}

@Preview(showBackground = true)
@Composable
fun GreetingPreview() {
    GreetingCardTheme {
        Greeting("Meghan")
    }
}
```

## 八、总结与后续学习

恭喜你！你已经成功使用Android Studio和Jetpack Compose创建了第一个Android应用，并实现了多项基本功能优化。在本次实践中，你掌握了一系列关键的Android开发技能：

1. **项目创建**：学会了通过模板快速创建新的Android项目，理解项目配置各项参数的含义
2. **界面预览**：利用Android Studio的预览功能，实时查看应用界面的构建效果，提高开发效率
3. **代码定制**：通过修改Kotlin代码自定义应用功能，包括更新TextView的内容和使用`@Preview`注解预览自定义效果
4. **界面美化**：学习使用Surface容器包裹内容并设置背景颜色，通过Modifier.padding()添加内边距

这些基础技能构成了现代Android开发的核心要素。本项目是Android Compose基础课程的一部分，如果你想进一步学习如何将应用部署到模拟器或实体设备上进行测试，建议继续学习配套的后续教程，一步步夯实你的Android开发基础。