适用读者:零基础编程新手、对 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,并亲眼看到它运行在模拟器或真机上。

本文将 手把手、无跳跃、零省略 地带你完成以下全过程:

  1. 安装 Android Studio 并配置开发环境
  2. 创建一个全新的 Android 项目
  3. 理解项目结构与核心文件作用
  4. 编写最简 UI 与逻辑代码
  5. 在模拟器或真实手机上运行应用
  6. 打包 APK 并分享给他人

无论你是否写过代码,只要按步骤操作,都能成功!


一、开发环境搭建:安装 Android Studio

1.1 下载官方安装包

访问 Android Studio 官方网站,点击绿色大按钮 Download Android Studio。页面会自动识别你的操作系统(Windows / macOS / Linux),提供对应版本。

安全提示:请务必从官网下载,避免第三方渠道带来的安全风险。

1.2 安装过程详解(以 Windows 为例)

  1. 双击下载的 .exe 文件(如 android-studio-2023.2.1.23-windows.exe)。
  2. 在安装向导中,建议选择 Standard(标准) 安装类型,它会自动包含:
    • Android SDK(软件开发工具包)
    • Android Virtual Device(AVD,即模拟器组件)
    • Android SDK Platform-Tools(adb、fastboot 等调试工具)
  3. 选择主题(Light 或 Dark),点击 Next
  4. 确认安装路径(默认即可),点击 Install
  5. 等待安装完成(通常 5–15 分钟,取决于网速和硬盘性能)。

首次启动时,Android Studio 会自动下载缺失的 SDK 组件(如 Build-Tools、Platform API 等),请保持网络畅通。若在中国大陆,可考虑配置阿里云镜像加速(文末附链接)。


二、创建你的第一个 Android 项目

2.1 启动 Android Studio 并新建项目

  1. 打开 Android Studio。
  2. 在欢迎界面点击 New Project(新建项目)。
  3. 在模板选择页,找到并点击 Empty Activity(空 Activity)。这是最干净、最基础的模板,适合学习。
  4. 点击 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)
  1. 点击顶部工具栏的 AVD Manager 图标(小手机+安卓机器人)。
  2. 点击 Create Virtual Device
  3. 选择硬件配置(如 Pixel 5),点击 Next
  4. 选择系统镜像:
    • 推荐选择 Tiramisu (API 33)UpsideDownCake (API 34)
    • 若未下载,点击 Download 下载(需联网)。
  5. 点击 Next > Finish 完成创建。
步骤 2:运行项目
  1. 确保顶部工具栏的运行目标(Run Configurations)选择的是你的 AVD。
  2. 点击绿色 ▶️ 按钮(或按 Shift + F10)。
  3. 首次启动模拟器可能较慢(1–3 分钟),之后会缓存加速。
  4. 应用安装后自动启动,屏幕上将显示居中的蓝色文字:“Hello, CSDN!”。

5.2 方式二:连接真实 Android 手机

准备工作:
  1. 手机开启 开发者选项
    • 进入【设置】→【关于手机】→连续点击【版本号】7 次。
  2. 返回设置,进入【开发者选项】,开启 USB 调试
  3. 用 USB 数据线连接电脑。
运行:
  1. 在 Android Studio 顶部设备选择器中,应能看到你的手机型号(如 “SM-G998B”)。
  2. 点击 ▶️ 运行,手机会弹出“允许 USB 调试吗?”对话框,勾选“始终允许”并点击确定。
  3. 应用将自动安装并启动。

注意:部分品牌手机(如华为、小米)需额外开启“USB 安装”或“MIUI 优化关闭”才能调试,请查阅对应厂商文档。


六、打包 APK 并分享给朋友

想把你的第一个 App 发给朋友体验?可以生成 APK 文件。

步骤:

  1. 点击菜单栏 Build > Build Bundle(s) / APK(s) > Build APK(s)
  2. 构建完成后,右下角会弹出通知:“APK(s) generated successfully”。
  3. 点击 locate,打开文件夹,找到 app-debug.apk
  4. 将此文件通过微信、QQ 或邮件发送给他人。
  5. 对方在 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-xAMD-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 框架)

学习资源推荐


结语

每一个伟大的 App,都始于一行简单的 “Hello World”。今天,你不仅写出了代码,更迈出了成为 Android 开发者的坚实一步。不要小看这个只有几行代码的应用——它是你未来作品的种子。

坚持动手实践,保持好奇心,你终将能开发出属于自己的社交、电商、游戏或工具类应用!


如果本文对你有帮助,请点赞 + 收藏 + 关注!
欢迎在评论区留言你的运行截图或遇到的问题,我会一一解答。
让我们一起,从 Hello World 走向世界!

Logo

有“AI”的1024 = 2048,欢迎大家加入2048 AI社区

更多推荐