原生移动开发 / 系统课时
创建并运行第一个应用
创建并运行第一个应用
本课从一个空白项目开始,创建可运行的 Android 应用,在模拟器或真机上启动它,并通过 Logcat 找到自己写入的启动日志。完成后,你会建立“创建项目—运行—观察日志”的最小开发闭环。
学习目标
- 使用 Android Studio 的 Empty Activity 模板创建应用项目
- 在模拟器或真机上构建并启动应用
- 使用 Logcat 过滤并确认应用启动日志
创建最小项目
在 Android Studio 欢迎页选择 New Project;若已经打开其他项目,则使用 File > New > New Project。选择 Phone and Tablet 下的 Empty Activity 模板,进入项目配置页后填写应用名称、包名、保存位置和最低 SDK,再创建项目并等待 Gradle 同步完成。
创建完成后,默认 app 模块已经包含可运行的 Activity 和构建配置。下面把 MainActivity.kt 改成一个最小 Compose 页面,并在 Activity 创建时写入一条日志。示例包名使用 com.example.firstapp,如果你的项目包名不同,需要同步修改第一行。
package com.example.firstapp
import android.os.Bundle
import android.util.Log
import androidx.activity.ComponentActivity
import androidx.activity.compose.setContent
import androidx.compose.material3.MaterialTheme
import androidx.compose.material3.Text
class MainActivity : ComponentActivity() {
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
// 用固定 Tag 便于稍后在 Logcat 中精确过滤。
Log.d("FirstApp", "MainActivity started")
setContent {
MaterialTheme {
Text(text = "Hello Android")
}
}
}
}预期结果:代码能够在由 Empty Activity 模板创建的 Compose 项目中通过编译,应用启动后页面显示 Hello Android,同时 Logcat 中会出现 Tag 为 FirstApp 的 DEBUG 日志。
选择设备并运行应用
先启动一个已创建的模拟器,或连接已经通过 ADB 验证的真机。在 Android Studio 顶部目标设备选择器中选中目标设备,然后点击 Run。第一次运行可能需要下载或编译依赖,因此耗时会比后续运行更长。
当构建成功后,Android Studio 会安装并启动应用。设备上应直接出现刚才的界面;如果只看到桌面,先检查 Run 窗口是否有构建或安装错误,再确认当前运行配置指向 app 模块。
用 Logcat 查看启动日志
打开 View > Tool Windows > Logcat,选择刚才运行应用的设备与进程。在查询框输入 package:mine tag:FirstApp,即可把当前项目的日志范围进一步缩小到示例 Tag。
预期输出可概括为:
<TIME> <PID> <TID> D FirstApp: MainActivity started<TIME>、<PID> 和 <TID> 都是动态值,实际内容会不同。真正需要确认的是日志级别为 DEBUG、Tag 为 FirstApp,消息为 MainActivity started。
遇到运行失败时先看哪里
若 Run 按钮后应用没有启动,不要先改业务代码。先看 Build 或 Run 窗口,确认失败发生在 Gradle 构建、APK 安装还是应用启动阶段;如果目标设备不可选,再执行 adb devices 检查连接状态。
如果应用能打开但 Logcat 没有目标日志,确认选择了正确设备和进程,并删除过窄的旧过滤条件。示例使用 Log.d,因此过滤级别不能高于 DEBUG。重新启动应用后,onCreate 会再次执行,目标日志也会再次出现。
能够在设备上看到 Hello Android,并在 Logcat 中定位到 FirstApp: MainActivity started,就说明从项目创建、代码编译、安装启动到日志观察的最小开发链路已经打通。