第一步:安装 Android Studio(推荐 IDE)
Android Studio 是官方推荐的 Android 开发集成开发环境(IDE),内置对 Kotlin 的完整支持。
1. 下载 Android Studio
前往官网下载:
https://developer.android.com/studio
选择适合你操作系统的版本:
- Windows
- macOS
- Linux
2. 安装 Android Studio
安装过程非常简单,一路点击“Next”即可。安装器会自动帮你安装:
- Android SDK(开发工具包)
- Android SDK Platform-Tools(adb、fastboot)
- Android SDK Build-Tools
- 模拟器(Android Emulator)
安装过程中建议使用默认设置,避免出错。
第二步:启动 Android Studio 并创建新项目(编辑版本不同,布局略微不同,但是不影响)
1. 打开 Android Studio
首次启动会进入欢迎界面。
2. 创建新项目
点击:"New Project"(新建项目)
然后选择模板: 选择 "Empty Activity"(空活动) 这是最简单的起点。
点击 Next
3. 配置项目信息
填写以下内容:
字段 | 示例值 | 说明 |
Name | MyFirstApp | 项目名称 |
Package name | com.example.myfirstapp | 应用唯一标识(反向域名) |
Save location | 选择保存路径 | 如:C:\Users\你的名字\AndroidStudioProjects |
Language | Kotlin | 一定要选 Kotlin! |
Minimum API | API 21 (Android 5.0) 或更高 | 兼容大多数设备 |
点击 Finish
第一次创建项目会下载 Gradle 和依赖库,可能需要几分钟(请保持网络畅通)。
第三步:项目结构简介
项目创建完成后,你会看到如下关键文件:
app/src/main/java/com/example/myfirstapp/MainActivity.kt
app/src/main/res/layout/activity_main.xml- MainActivity.kt:主界面的 Kotlin 代码
- activity_main.xml:界面布局文件(XML)
第四步:运行你的第一个应用
1. 准备设备
你可以选择:
- 使用模拟器(推荐新手)
- 连接真机(需开启开发者模式和 USB 调试)
使用模拟器:
在 Android Studio 顶部菜单选择:
Device Manager → Create Device → 选择一个手机型号(如 Pixel 4)→ 安装系统镜像 → 启动
2. 运行应用
点击顶部绿色三角按钮 或菜单 Run > Run 'app'
Gradle 会编译项目,并在模拟器或真机上安装并启动应用。
你会看到一个空白页面,上面写着 "Hello, World!" 或 "Hello, Android!"
恭喜!你的第一个 Kotlin Android 应用已成功运行!
第五步:修改应用(简单示例)
让我们把文字从 “Hello” 改成 “你好,Kotlin!”
编辑布局文件:activity_main.xml
- 打开 res/layout/activity_main.xml
- 找到 <TextView> 标签
- 修改 android:text 属性:
<TextView
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:text="你好,Kotlin!"
... />重新运行应用
你会看到界面上的文字已经变成中文啦!
第六步:了解核心代码(Kotlin + Android)
MainActivity.kt示例代码:
package com.example.myfirstapp
import android.os.Bundle
import androidx.appcompat.app.AppCompatActivity
class MainActivity : AppCompatActivity() {
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
setContentView(R.layout.activity_main) // 绑定布局文件
}
}关键点:
- onCreate() 是 Activity 的入口方法
- setContentView() 指定要显示的布局
- 所有逻辑都可以在这里用 Kotlin 编写
常见问题与解决
问题 | 解决方法 |
Gradle 同步失败 | 检查网络,尝试使用国内镜像(如阿里云) |
模拟器启动慢 | 使用 Quick Boot 或考虑真机调试 |
中文乱码 | 在 TextView 中正常显示中文,无需额外设置 |
提示“Unfortunately, app has stopped” | 检查 Logcat 日志,通常是代码或资源错误 |
下一步学习建议
你现在可以继续学习:
- Kotlin 基础语法(变量、函数、类)
- Android UI 组件:Button、EditText、Toast
- 点击事件处理:给按钮添加点击响应
- Intent 跳转页面
小项目建议:做一个“点击按钮弹出消息”的 App!
button.setOnClickListener {
Toast.makeText(this, "你点击了按钮!", Toast.LENGTH_SHORT).show()
}总结:从零到第一个 Kotlin Android App 的步骤
步骤 | 内容 |
1 | 下载并安装 Android Studio |
2 | 创建新项目,选择 Kotlin 语言 |
3 | 使用模拟器或真机 运行应用 |
4 | 修改布局文件,体验 Kotlin + XML 开发 |
5 | 开始学习交互逻辑,迈向完整 App 开发 |