从零开始:用 Android Studio 创建你的第一个手机端 App(超详细入门教程)
**摘要:Android 开发入门:零基础实现 Hello World 应用 本文面向零基础开发者,详细讲解如何在 Android Studio 中创建并运行第一个 Android 应用。主要内容包括: 环境搭建:从官网下载安装 Android Studio,配置标准开发环境(含 SDK 和模拟器组件) 项目创建:选择 Empty Activity 模板,配置应用基本信息(名称、包名、最低 API
适用读者:零基础编程新手、对 Android 开发感兴趣的初学者、高校计算机相关专业学生
开发环境:Android Studio Iguana(2023.2.1 或更高版本)
目标系统:Android 8.0(API 26)及以上
预计阅读时间:15–20 分钟
实践所需时间:约 10–25 分钟(视网络与设备性能而定)
前言:为什么从“Hello World”开始?
在软件工程领域,“Hello World” 不仅仅是一句问候,它象征着开发者与新平台的第一次成功对话。对于 Android 移动开发而言,创建一个能在手机上运行的最简应用,是理解整个开发生态系统的起点。
很多初学者面对 Android Studio 的复杂界面、Gradle 构建系统、XML 布局语言以及 Kotlin/Java 代码感到畏惧。但其实,只要掌握基本流程,你完全可以在 不到半小时内 完成自己的第一个 App,并亲眼看到它运行在模拟器或真机上。
本文将 手把手、无跳跃、零省略 地带你完成以下全过程:
- 安装 Android Studio 并配置开发环境
- 创建一个全新的 Android 项目
- 理解项目结构与核心文件作用
- 编写最简 UI 与逻辑代码
- 在模拟器或真实手机上运行应用
- 打包 APK 并分享给他人
无论你是否写过代码,只要按步骤操作,都能成功!
一、开发环境搭建:安装 Android Studio
1.1 下载官方安装包
访问 Android Studio 官方网站,点击绿色大按钮 Download Android Studio。页面会自动识别你的操作系统(Windows / macOS / Linux),提供对应版本。
安全提示:请务必从官网下载,避免第三方渠道带来的安全风险。
1.2 安装过程详解(以 Windows 为例)
- 双击下载的
.exe文件(如android-studio-2023.2.1.23-windows.exe)。 - 在安装向导中,建议选择 Standard(标准) 安装类型,它会自动包含:
- Android SDK(软件开发工具包)
- Android Virtual Device(AVD,即模拟器组件)
- Android SDK Platform-Tools(adb、fastboot 等调试工具)
- 选择主题(Light 或 Dark),点击 Next。
- 确认安装路径(默认即可),点击 Install。
- 等待安装完成(通常 5–15 分钟,取决于网速和硬盘性能)。
首次启动时,Android Studio 会自动下载缺失的 SDK 组件(如 Build-Tools、Platform API 等),请保持网络畅通。若在中国大陆,可考虑配置阿里云镜像加速(文末附链接)。
二、创建你的第一个 Android 项目
2.1 启动 Android Studio 并新建项目
- 打开 Android Studio。
- 在欢迎界面点击 New Project(新建项目)。
- 在模板选择页,找到并点击 Empty Activity(空 Activity)。这是最干净、最基础的模板,适合学习。
- 点击 Next。
2.2 配置项目基本信息
在弹出的配置窗口中,请按如下填写:
| 字段 | 推荐值 | 说明 |
|---|---|---|
| Name | HelloWorldApp |
应用名称,会显示在手机桌面上 |
| Package name | com.example.helloworldapp |
应用唯一标识符,不可重复 |
| Save location | 自定义路径(如 D:\AndroidProjects\HelloWorldApp) |
项目保存位置 |
| Language | Kotlin(推荐)或 Java | Kotlin 是 Google 官方推荐语言,更简洁安全 |
| Minimum API level | API 26: Android 8.0 (Oreo) | 覆盖超 90% 现役设备,平衡兼容性与功能 |
为什么选 API 26?
根据 Android 官方统计数据,截至 2026 年,Android 8.0 及以上设备占比超过 95%。选择此版本可使用现代 API(如通知渠道、后台限制等),同时避免低版本兼容性问题。
点击 Finish,等待项目构建完成。首次构建可能需要 2–10 分钟,请耐心等待 Gradle 同步结束(右下角进度条消失,顶部提示 “Gradle sync finished”)。
三、深入理解项目结构
项目创建成功后,左侧会出现 Project 面板。切换为 Android 视图(默认),你会看到如下关键目录:
app/
├── manifests/
│ └── AndroidManifest.xml ← 应用“身份证”,声明入口 Activity、权限等
├── java/
│ └── com.example.helloworldapp/
│ └── MainActivity.kt ← 主程序逻辑(Kotlin 文件)
├── res/
│ ├── layout/
│ │ └── activity_main.xml ← 主界面布局(XML 文件)
│ ├── values/
│ │ ├── strings.xml ← 字符串资源(支持多语言)
│ │ └── themes.xml ← 主题样式
│ └── drawable/ ← 图片资源(如 ic_launcher.png)
└── build.gradle (Module: app) ← 模块级构建配置
初学者只需关注三个文件:
MainActivity.kt:控制程序行为activity_main.xml:定义界面外观AndroidManifest.xml:注册组件
四、编写最简 App:Hello CSDN!
4.1 修改界面布局(XML)
双击打开 res/layout/activity_main.xml。默认使用 ConstraintLayout,但我们为了简化,改用更直观的 LinearLayout。
将整个文件内容替换为以下代码:
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout
xmlns:android="http://schemas.android.com/apk/res/android"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:gravity="center"
android:orientation="vertical"
android:background="#FFFFFF">
<TextView
android:id="@+id/textView"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:text="Hello, CSDN!"
android:textSize="28sp"
android:textColor="#2196F3"
android:fontFamily="sans-serif-medium" />
</LinearLayout>
代码解析:
LinearLayout:线性布局容器,orientation="vertical"表示垂直排列子元素。gravity="center":让内部内容整体居中。TextView:用于显示文本的控件。text="Hello, CSDN!":显示的文字内容。textSize="28sp":字体大小(sp 是可缩放像素,适配不同屏幕)。textColor="#2196F3":Material Design 蓝色,更美观。
小技巧:在 XML 中按住 Ctrl(Windows)或 Cmd(Mac)点击
@+id/textView,可跳转到该 ID 的引用处。
4.2 查看主逻辑代码(Kotlin)
打开 java/com.example.helloworldapp/MainActivity.kt,内容如下:
package com.example.helloworldapp
import androidx.appcompat.app.AppCompatActivity
import android.os.Bundle
class MainActivity : AppCompatActivity() {
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
setContentView(R.layout.activity_main)
}
}
关键点解释:
AppCompatActivity:兼容旧版 Android 的 Activity 基类。onCreate():Activity 生命周期的第一个回调方法,程序启动时执行。setContentView(R.layout.activity_main):将activity_main.xml布局“加载”到当前界面。
由于我们只展示静态文字,无需额外逻辑,因此此文件无需修改。
五、运行你的 App:模拟器 vs 真机
5.1 方式一:使用 Android 模拟器(推荐新手)
步骤 1:创建虚拟设备(AVD)
- 点击顶部工具栏的 AVD Manager 图标(小手机+安卓机器人)。
- 点击 Create Virtual Device。
- 选择硬件配置(如 Pixel 5),点击 Next。
- 选择系统镜像:
- 推荐选择 Tiramisu (API 33) 或 UpsideDownCake (API 34)。
- 若未下载,点击 Download 下载(需联网)。
- 点击 Next > Finish 完成创建。
步骤 2:运行项目
- 确保顶部工具栏的运行目标(Run Configurations)选择的是你的 AVD。
- 点击绿色 ▶️ 按钮(或按
Shift + F10)。 - 首次启动模拟器可能较慢(1–3 分钟),之后会缓存加速。
- 应用安装后自动启动,屏幕上将显示居中的蓝色文字:“Hello, CSDN!”。
5.2 方式二:连接真实 Android 手机
准备工作:
- 手机开启 开发者选项:
- 进入【设置】→【关于手机】→连续点击【版本号】7 次。
- 返回设置,进入【开发者选项】,开启 USB 调试。
- 用 USB 数据线连接电脑。
运行:
- 在 Android Studio 顶部设备选择器中,应能看到你的手机型号(如 “SM-G998B”)。
- 点击 ▶️ 运行,手机会弹出“允许 USB 调试吗?”对话框,勾选“始终允许”并点击确定。
- 应用将自动安装并启动。
注意:部分品牌手机(如华为、小米)需额外开启“USB 安装”或“MIUI 优化关闭”才能调试,请查阅对应厂商文档。
六、打包 APK 并分享给朋友
想把你的第一个 App 发给朋友体验?可以生成 APK 文件。
步骤:
- 点击菜单栏 Build > Build Bundle(s) / APK(s) > Build APK(s)。
- 构建完成后,右下角会弹出通知:“APK(s) generated successfully”。
- 点击 locate,打开文件夹,找到
app-debug.apk。 - 将此文件通过微信、QQ 或邮件发送给他人。
- 对方在 Android 手机上允许“未知来源安装”后,即可直接安装运行。
注意:
debug版本仅用于测试。正式发布需使用 Generate Signed Bundle / APK 并签名。
七、常见问题与解决方案(FAQ)
Q1:Gradle sync failed,提示网络错误?
A:在中国大陆,可配置国内镜像。在 gradle.properties 文件末尾添加:
systemProp.http.proxyHost=mirrors.cloud.tencent.com
systemProp.http.proxyPort=80
android.enableJetifier=true
android.useAndroidX=true
或使用阿里云 Maven 镜像(详见文末资源)。
Q2:模拟器卡顿、无法启动?
A:尝试以下方法:
- 在 BIOS 中启用 Intel VT-x 或 AMD-V 虚拟化技术。
- 使用 Windows Hypervisor Platform (WHPX)(Windows 10/11)。
- 改用 真机调试,速度更快、体验更真实。
Q3:TextView 文字不显示?
A:检查:
- 是否误删了
setContentView(R.layout.activity_main)? - XML 中是否拼写错误(如
textview小写)? - 是否在
onCreate之后才调用setContentView?
八、下一步学习建议
恭喜你完成了第一个 Android App!但这只是开始。接下来你可以尝试:
- 添加一个 Button,点击后改变 TextView 的文字
- 使用
ConstraintLayout实现响应式布局 - 学习 Activity 生命周期(onPause、onResume 等)
- 调用摄像头拍照、读取联系人、获取 GPS 位置
- 学习 Jetpack Compose(新一代声明式 UI 框架)
学习资源推荐:
- 官方文档:developer.android.com
- 免费课程:Google 的 Android Basics in Kotlin
- 中文社区:CSDN、掘金、鸿蒙开发者联盟
结语
每一个伟大的 App,都始于一行简单的 “Hello World”。今天,你不仅写出了代码,更迈出了成为 Android 开发者的坚实一步。不要小看这个只有几行代码的应用——它是你未来作品的种子。
坚持动手实践,保持好奇心,你终将能开发出属于自己的社交、电商、游戏或工具类应用!
如果本文对你有帮助,请点赞 + 收藏 + 关注!
欢迎在评论区留言你的运行截图或遇到的问题,我会一一解答。
让我们一起,从 Hello World 走向世界!
更多推荐


所有评论(0)