Android Studio 实例教程：从零开始构建你的第一个 App

本教程将带你完成以下步骤：

1. 环境准备：安装 Android Studio 和配置 SDK。
2. 创建项目：创建一个新的 Android 项目。
3. 认识界面：熟悉 Android Studio 的主要窗口和功能。
4. 编写代码：修改默认的 "Hello World!" 文本。
5. 运行应用：在模拟器或真机上运行你的 App。
6. 添加交互：通过按钮点击改变文本内容。
7. 添加图片资源：为 App 添加一个图标。
8. 总结与下一步。

第一步：环境准备

在开始之前,你需要确保你的电脑上安装了必要的软件。

安装 Java Development Kit (JDK)

Android 应用主要使用 Java 或 Kotlin 语言开发，它们都需要 JDK 来编译代码。

• 检查是否已安装：打开终端或命令提示符，输入 java -version，如果显示了版本号,说明已安装。
• 下载安装：如果没有安装，请从 Oracle 官网下载并安装最新版本的 JDK，对于新手，LTS (长期支持) 版本是最佳选择。

安装 Android Studio

Android Studio 是 Google 官方推荐的 Android 开发 IDE（集成开发环境）。

• 下载：访问 Android Studio 官网 下载适合你操作系统的版本。
• 安装：按照安装向导的提示进行安装，在安装过程中，它会自动下载 Android SDK（软件开发工具包），这是开发 Android 应用所必需的。

第二步：创建你的第一个项目

安装完成后，启动 Android Studio。

1. 欢迎界面：首次启动时，你会看到一个欢迎界面，点击 "New Project" (新建项目)。

2. 选择模板：Android Studio 提供了多种项目模板，对于初学者，选择 "Empty Views Activity" (空视图活动)，然后点击 "Next"。

   • 说明：这是一个最基础的模板，只包含一个屏幕（Activity）,非常适合我们学习。

3. 配置项目：

   • Name：给你的应用起个名字，MyFirstApp。
   • Package name：应用的唯一标识符，通常采用反向域名格式，如 com.example.myfirstapp,通常保持默认即可。
   • Save location：选择项目在电脑上的保存位置。
   • Language：选择编程语言。推荐选择 Kotlin，它是 Google 主推的、更现代、更安全的 Android 开发语言，如果你熟悉 Java，也可以选择 Java。
   • Minimum SDK：设置你的应用能运行的最低 Android 系统版本,默认值通常就很好。
   • 点击 "Finish"。

4. 等待 Gradle 同步：Android Studio 会开始下载和同步项目的依赖库（这个过程叫做 Gradle Sync），这可能会花费几分钟时间，请耐心等待，完成后,你会看到项目代码编辑界面。

   
   （图片来源网络，侵删）

第三步：认识 Android Studio 界面

打开项目后,你会看到几个主要窗口：

• 工具栏：包含常用的操作，如运行、调试、Git 版本控制等。
• 导航栏：可以快速切换项目文件、结构、Git 日志等视图。
• 项目/文件浏览器：在左侧，显示你的项目文件结构，常见的目录有：
  • app/：包含你的应用源代码、资源文件等。
  • build/：存放编译后生成的文件,通常不需要手动修改。
  • gradle/：Gradle 构建脚本。
• 代码编辑器：中间最大的区域,用于编写和修改代码。
• 工具窗口栏：底部和右侧，包含各种工具，如 Logcat（日志输出）、设备管理器、Gradle 任务等,你可以通过拖动来调整它们的位置和大小。

第四步：修改 "Hello World!" 文本

让我们来修改 App 显示的欢迎文字。

1. 找到布局文件：在左侧的 app/src/main/res/layout/ 目录下，找到 activity_main.xml 文件,双击打开它。

2. 选择编辑模式：打开 activity_main.xml 后，默认可能是 "Split"（分屏）或 "Code"（代码）视图，新手推荐使用 "Design"（设计）视图,它是一个可视化编辑器。

3. 修改文本：

   • 在设计视图中，你会看到一个手机屏幕的预览，上面写着 "Hello World!"。
   • 点击这个文本，右侧会出现 "Attributes"（属性）窗口。
   • 在属性窗口中找到 text 属性，将它的值从 Hello World! 修改为你想要的任何文字，你好，Android！。
   • 修改后,你会看到预览中的文字也立刻更新了。

4. 保存文件：按 Ctrl + S (Windows/Linux) 或 Cmd + S (macOS) 保存文件。

第五步：运行你的 App

激动人心的时刻到了！让我们看看我们的 App 运行起来是什么样子。

1. 选择运行目标：

   • 在 Android Studio 顶部工具栏的运行设备下拉菜单中,选择一个设备。
   • 选项 A (推荐)：AVD (Android Virtual Device)：点击旁边的下拉菜单，选择 "Create Virtual Device"，选择一个手机型号（如 Pixel 4），然后下载并选择一个系统镜像（推荐选择最新的稳定版，如 API Level 33），创建完成后,选择这个虚拟设备。
   • 选项 B：真机：将你的 Android 手机通过 USB 连接到电脑，并在手机上开启“开发者选项”和“USB 调试”,在设备列表中选择你的手机。

2. 点击运行按钮：点击工具栏上的绿色 "Run 'app'" 按钮（一个三角图标）。

3. 等待安装和启动：Android Studio 会编译你的 App，并将其安装到选定的设备上，然后启动它，几秒钟后，你应该能看到模拟器或你的手机屏幕上显示着你刚刚修改的文字 你好，Android！。

第六步：添加交互（按钮点击事件）

一个静态的 App 没什么意思，现在我们来添加一个按钮,点击它就能改变文本。

1. 打开布局文件：再次打开 app/src/main/res/layout/activity_main.xml 文件。

2. 添加一个 Button：

   • 切换到 "Design" 视图。
   • 从左侧的 "Palette" (调色板) 中，找到 "Button" 组件。
   • 将 Button 拖拽到手机屏幕预览的下方。
   • 选中这个 Button，在右侧的 Attributes 窗口中，修改其 id 属性为 @+id/my_button，text 属性为 点击我。

3. 打开主 Activity 代码文件：

   • 在左侧项目浏览器中，找到 app/src/main/java/com/example/myfirstapp/ 目录。
   • 根据你选择的编程语言（Kotlin 或 Java），打开 MainActivity.kt 或 MainActivity.java 文件。

4. 编写 Kotlin 代码（推荐）：

   • 在 MainActivity.kt 文件中，我们需要完成三件事：
     1. 声明变量：将布局中的 TextView 和 Button 与代码关联起来。
     2. 视图：确保加载了 activity_main.xml 布局。
     3. 设置点击监听器：为 Button 添加点击事件。

   package com.example.myfirstapp
   import androidx.appcompat.app.AppCompatActivity
   import android.os.Bundle
   import android.widget.Button
   import android.widget.TextView
   class MainActivity : AppCompatActivity() {
       // 1. 声明变量
       private lateinit var myTextView: TextView
       private lateinit var myButton: Button
       override fun onCreate(savedInstanceState: Bundle?) {
           super.onCreate(savedInstanceState)
           // 2. 设置内容视图，加载布局文件
           setContentView(R.layout.activity_main)
           // 3. 通过 ID 找到布局中的视图
           myTextView = findViewById(R.id.my_text_view) // 假设 TextView 的 id 是 my_text_view
           myButton = findViewById(R.id.my_button)
           // 4. 为按钮设置点击监听器
           myButton.setOnClickListener {
               // 点击按钮时，执行这里的代码
               myTextView.text = "你点击了按钮！"
           }
       }
   }

   • 注意：在上面的代码中，我们假设 TextView 的 id 是 my_text_view，请在 activity_main.xml 中，选中那个文本，在属性窗口将其 id 修改为 @+id/my_text_view。

5. 编写 Java 代码：

   package com.example.myfirstapp;
   import androidx.appcompat.app.AppCompatActivity;
   import android.os.Bundle;
   import android.view.View;
   import android.widget.Button;
   import android.widget.TextView;
   public class MainActivity extends AppCompatActivity {
       // 1. 声明变量
       private TextView myTextView;
       private Button myButton;
       @Override
       protected void onCreate(Bundle savedInstanceState) {
           super.onCreate(savedInstanceState);
           // 2. 设置内容视图，加载布局文件
           setContentView(R.layout.activity_main);
           // 3. 通过 ID 找到布局中的视图
           myTextView = findViewById(R.id.my_text_view);
           myButton = findViewById(R.id.my_button);
           // 4. 为按钮设置点击监听器
           myButton.setOnClickListener(new View.OnClickListener() {
               @Override
               public void onClick(View v) {
                   // 点击按钮时，执行这里的代码
                   myTextView.setText("你点击了按钮！");
               }
           });
       }
   }

6. 重新运行 App：点击运行按钮，再次启动 App，当你点击 "点击我" 按钮时，上方的文字应该会变成 "你点击了按钮！"。

第七步：添加图片资源

让我们为按钮换一个漂亮的图标。

1. 添加图片文件：

   • 在左侧项目浏览器中，右键点击 app/src/main/res/ 目录。
   • 选择 New -> Image Asset。
   • 在打开的窗口中，你可以选择一个本地图片，或者使用内置的图标，点击 "Path" 旁边的图标，选择一张你准备好的图片（例如一个 PNG 格式的按钮图标）。
   • Icon Type 选择 "Action Bar and Tab Icons" 或 "Launcher Icons" 都可以,这里我们简单选择一个。
   • Name：给图标起个名字，ic_button_icon。
   • 点击 "Next"，"Finish"，Android Studio 会自动将图片适配到不同分辨率的文件夹中（drawable-mdpi, drawable-hdpi 等）。

2. 在布局中使用图片：

   • 打开 activity_main.xml 文件。
   • 选中 Button，在右侧的 Attributes 窗口中，找到 srcCompat 属性。
   • 点击下拉菜单，选择你刚刚创建的图标 ic_button_icon。

3. 重新运行 App：再次运行 App,你会看到按钮上现在显示了你添加的图标。

第八步：总结与下一步

恭喜你！你已经成功地完成了你的第一个 Android 应用,并学会了：

• 创建和配置 Android Studio 项目。
• 使用可视化编辑器修改 UI 布局。
• 在代码中获取 UI 组件并处理用户交互（点击事件）。
• 添加和管理图片资源。

接下来可以学习什么？

• 更多 UI 组件：学习 EditText（输入框）、ImageView（图片显示）、RecyclerView（列表）等。
• 数据存储：学习如何将数据保存到本地，如使用 SharedPreferences 或 Room 数据库。
• 网络请求：学习如何从网络获取数据，如使用 Retrofit + OkHttp 库。
• 页面跳转：学习如何从当前页面跳转到另一个新页面（Activity）。
• 项目结构：更深入地了解 manifests, java, res 等目录的作用。

Android 开发是一个广阔的领域，但你已经迈出了坚实的第一步，继续探索和实践，你会发现开发 App 的乐趣无穷！