Android开发-创建、运行、调试App工程

一、创建新的 Android App 工程

1. 启动 Android Studio

打开已安装的 Android Studio，进入欢迎界面。

2. 创建新项目

点击 【New Project】。

3. 选择项目模板

在模板列表中，选择 【Empty Activity】 （空活动），这是最基础的 App 起点。点击 【Next】。

4. 配置项目信息

填写以下关键信息：

字段	示例值	说明
Name	`MyFirstApp`	你的 App 名称
Package name	`com.example.myfirstapp`	应用的唯一标识符（建议使用反向域名）
Save location	`C:\Users\YourName\AndroidStudioProjects`	项目保存路径
Language	`Kotlin`	推荐使用 Kotlin（现代、简洁）或 `Java`
Minimum API	`API 24: Android 7.0 (Nougat)`	最低支持的 Android 版本（选择能覆盖大部分用户的版本）

✅ 提示：Kotlin 是 Google 推荐的 Android 开发首选语言。

点击 【Finish】。

5. 等待项目同步

Android Studio 会自动下载所需的 Gradle 插件和依赖库。状态栏会显示 "Gradle build running..."。等待其完成（首次可能较慢）。

二、项目结构概览

创建完成后，你会看到 Android Studio 的主界面，主要包含以下部分：

Project 面板（左侧）：
- app/src/main/java/：存放 Kotlin/Java 源代码。
- app/src/main/res/：资源文件目录。
  - layout/：XML 布局文件（如 activity_main.xml）。
  - values/：字符串、颜色、样式等（如 strings.xml）。
- app/src/main/AndroidManifest.xml：应用的配置清单文件。
代码编辑器 （中央）：默认打开 MainActivity.kt 和 activity_main.xml。
预览窗口（右侧）：实时预览布局效果。

三、运行 App

方式一：使用 Android 模拟器（AVD）

创建虚拟设备：
- 点击顶部工具栏的 【Device Manager】 图标（手机形状）。
- 点击 【Create device】。
- 选择设备（如 Pixel 6），选择系统映像（如 Android 14, x86_64），点击 【Finish】。
启动模拟器：
- 在 Device Manager 中，点击你创建的设备旁边的绿色三角形 【启动】 按钮。
- 等待模拟器完全启动（可能需要1-2分钟）。
运行项目：
- 确保模拟器已运行。
- 在 Android Studio 中点击绿色的 【Run】 图标（▶️）。
- 选择你的模拟器设备，点击 【OK】。
- App 将自动安装并启动。

方式二：使用真实 Android 设备

启用开发者选项：
- 进入手机设置 -> 关于手机。
- 连续点击 版本号 7次，直到提示"您现在是开发者"。
启用 USB 调试：
- 返回设置，进入系统 -> 开发者选项。
- 打开 USB 调试。
连接设备：
- 使用 USB 数据线连接手机和电脑。
- 手机上可能会弹出"允许 USB 调试吗？"的对话框，点击 【允许】。
运行项目：
- 在 Android Studio 中点击 【Run】 图标（▶️）。
- 在设备选择列表中，你的手机应该会出现。
- 选择你的设备，点击 【OK】。
- App 将安装并运行在你的手机上。

四、调试 App

当 App 运行出错或行为不符合预期时，调试是必不可少的技能。

1. 使用 Logcat 查看日志

在 Android Studio 底部找到 【Logcat】 标签页。
它会显示 App 运行时的所有日志信息，包括 Log.d()（调试）、Log.e()（错误）等。
你可以通过包名、日志级别（Verbose, Debug, Info, Warn, Error）来过滤日志。

Kotlin 复制代码

// 在 MainActivity.kt 中添加日志
class MainActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)
        
        // 添加调试日志
        Log.d("MainActivity", "App started successfully!")
    }
}

2. 设置断点（Breakpoint）进行调试

设置断点：
- 在代码编辑器中，点击某行代码左侧的空白区域（如 setContentView 行），会出现一个红色圆点，表示断点已设置。
启动调试模式：
- 点击工具栏的 【Debug】 图标（🐞），而不是 【Run】。
- 选择目标设备。
进入调试界面：
- 当 App 运行到断点时，会自动暂停。
- 此时你可以：
  - 查看当前变量的值（在 Variables 窗口）。
  - 使用 Step Over (F8) 逐行执行。
  - 使用 Step Into (F7) 进入方法内部。
  - 使用 Step Out (Shift+F8) 跳出当前方法。
  - 使用 Resume Program (F9) 继续执行。

3. 处理常见错误

NullPointerException ：检查对象是否为 null，使用 ?. 安全调用或 !! 非空断言（谨慎使用）。
ClassNotFoundException ：检查 AndroidManifest.xml 中的 Activity 是否正确声明。
资源找不到 ：检查 res/ 目录下的文件名是否正确（只能包含小写字母、数字和下划线）。

五、总结

阶段	关键操作
创建	选择模板 -> 填写信息 -> 等待同步
运行	配置设备（模拟器/真机）-> 点击 Run
调试	查看 Logcat -> 设置断点 -> 使用 Debug 模式

掌握创建、运行和调试是 Android 开发的基石。通过不断实践，你会越来越熟练。

六、结语

感谢您的阅读！如果你有任何疑问或想要分享的经验，请在评论区留言交流！