前两天一个朋友问我我完全没写过代码能直接做手机App吗我反问他你是想先搞清楚那些抽象术语还是想亲手做一个能装进手机里跑起来的东西他说想要后者。那答案就很直接了——打开 Android Studio跟着下面的步骤走一遍你就能得到第一个真正属于你的手机端 App。这篇文章不会跟你讲编译原理也不会逼你背两个月的 Java 教材而是从零开始带你装好工具、创建工程、写一个能点击计数的界面跑上模拟器最后打包成 APK 塞进手机。全程用零基础视角来每个操作我都会解释“为什么这么做”你只要照着做就能跟上。1. 动手前先把这三件事想明白后面能省一半时间1.1 选 Kotlin 还是 Java别再纠结了很多零基础同学第一关就卡在语言选择上因为网上说法太多有人说 Java 稳有人说 Kotlin 是未来。我的建议非常直接新项目用 Kotlin不要犹豫。理由很简单现在的 Android Studio 默认新建项目就是 Kotlin官方模板、官方文档、社区新教程几乎全部默认 Kotlin。你跟着官方生态走遇到报错时搜到的答案是绝大多数匹配的学习阻力最小。这就好比你去一个新城市先学大家日常都说普通话而不是先研究冷门方言等方言学会了地方可能已经混熟了。Kotlin 还有个好处是它能直接调用所有 Java 库所以不用担心以后接触老项目或者别人写的 Java 代码看不懂。入门阶段选跟工具走得最近的那条路永远是最优策略。1.2 Android Studio 到底是什么为什么非它不可你可以把 Android Studio 理解成 Android 官方提供的一台“造车车间”。它不是一个单纯的文本编辑器而是一个把画界面、写代码、预览效果、连接手机、打包安装全都整合在一起的开发工具也就是所谓的 IDE。有些人会说我不装 Android Studio用命令行加 Gradle 也能写 App何必多装一个占内存的软件这话理论上没错但对新手来说官方工具已经把所有复杂流程都拧成了“点按钮操作”。你点一下运行它帮你构建、安装、启动你拖一个按钮它自动同步 XML。省下来的时间不是一点点。更重要的是大量新手报错其实是环境不一致造成的Android Studio 帮你把常用的构建环境统一了至少能挡掉一半“为什么我这里运行不了”的奇怪问题。1.3 电脑配置要什么级别才不会被劝退先给结论内存 8GB 能跑16GB 更稳固态硬盘必须有。Android Studio 本身加上 Gradle 构建、模拟器运行都属于吃内存大户。我以前用一台 4GB 内存的老笔记本第一次构建等了二十分钟屏幕一直转圈差点就卸载了。后来换了 16GB 内存的机器同一个工程一分钟内完成构建体验完全两回事。CPU 方面主流的 i5/R5 以上都够用CPU 只决定你等待时间长短不决定你能不能学。硬盘一定要用 SSD机械硬盘在构建时会有大量小文件读写速度差距非常明显。如果你电脑里之前装过别的 Java 环境安装 Android Studio 的时候也要注意版本冲突的问题这一点马上就会讲到。2. 环境搭建装好 Android Studio先别急着写代码卡住 90% 新手的是这一步2.1 别再手动装 JDK 了以前学 Android 需要先去官网下载 JDK再配置 JAVA_HOME 环境变量这套步骤在现在的新版本里已经过时了。现在 Android Studio 自身内置了 JBRJetBrains Runtime本质上是完整 JDK你直接安装 Android Studio它就会用内置版本完成编译不需要额外配置任何环境变量。不过有一种特殊情况要提醒你你自己以前装过 JDK而且设置过 JAVA_HOMEAndroid Studio 可能会检测到系统环境变量导致启动或者构建时版本对不上。我的建议是保持 Android Studio 默认不要自己去动环境变量如果确实发现构建报 JVM 相关的错再回头检查你系统里是不是装了版本冲突的 JDK而不是一上来就去折腾配置。2.2 安装的两大细节路径和组件下载安装包时根据你的操作系统选Windows 就下载 exemacOS 就下载 dmg。安装过程中大部分步骤一路 Next 就行但有两个细节我每次都要强调。第一安装路径要放到纯英文目录下比如D:\AndroidStudio。不要放在用户目录里面带着中文的名字里。你可能觉得中文路径无所谓的但 Gradle 脚本和 SDK 组件对路径非常敏感各种找不到目录、路径解析失败都会随之而来我见得太多了。第二安装过程中会有勾选项Android SDK、Android Virtual Device 这些组件一定要保持选中它们是后面跑模拟器和编译 App 的必需品。第一次安装完成后Android Studio 会自动下载 SDK 组件这个过程的耗时取决于网络环境耐心等待即可如果中间下载失败重启 Studio 再试一次通常能续上。2.3 创建模拟器给自己配一台“手机”打开 Android Studio 后先去 Device Manager设备管理器点加号创建虚拟设备。机型随便选一台 Pixel 系列就行重点在 System Image 这一步。新手很容易在这里犯迷糊看到一堆 API 版本不知道选什么。直接选稳定版本就好比如 API 34对应 Android 14。镜像架构一定要选 x86_64 的在 Windows 上速度和兼容性都远好于 ARM 镜像。如果你选错了架构模拟器启动会特别慢甚至直接黑屏。创建时给模拟器分配的内存不要低于 2GB我一般会调到 3GB。内存太低的模拟器虽然也能启动但运行起来卡到怀疑人生体验很差。模拟器启动后就像一台缩小版手机你可以用鼠标点击、滚动虽然手感比真机差一点但日常调试界面和交互完全够用。2.4 第一次构建前先给 Gradle 换个“源”这是新手最容易长时间卡住的环节我当年在这里干等过一个下午。Android 构建时依赖包默认从google()和mavenCentral()仓库下载当网络到这个仓库不够通畅时Gradle 就会一直转圈甚至报Could not resolve。与其干等不如在项目创建后直接把国内镜像仓库加到settings.gradle.kts里。pluginManagement { repositories { maven(https://maven.aliyun.com/repository/google) maven(https://maven.aliyun.com/repository/public) maven(https://maven.aliyun.com/repository/gradle-plugin) google() mavenCentral() } } dependencyResolutionManagement { repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS) repositories { maven(https://maven.aliyun.com/repository/google) maven(https://maven.aliyun.com/repository/public) google() mavenCentral() } }如果你项目里生成的脚本还是build.gradleGroovy 写法那只需要把maven(...)换成maven { url uri(...) }这种格式就行。改完点右上角的 Sync Now正常情况依赖会很快下载完成。我建议每一个新项目都先做这一步别等卡半天才想起来。镜像地址以实际可用为准如果某个地址失效换成其他公开镜像即可。注意不要擅自把镜像仓库插在原来仓库列表的中间然后又把括号改乱了。保持结构顺序只加仓库地址不要动其他配置。3. 创建项目之后先别急着写认路的功夫能让你后面三天不晕3.1 新建项目的模板到底选哪个打开 Android Studio 的欢迎界面点 New Project会看到一排模板。新手最容易看到什么选什么但第一次学的话我强烈建议选 Empty Views Activity而不是最新的 Empty Compose Activity。区别在于Empty Views Activity 用的是传统 XML 加 Activity 的方式界面写在一个 XML 文件里逻辑写在 Kotlin 类里概念非常直观。而 Compose 是声明式 UI所有界面都写在 Kotlin 代码里表面上看起来很简洁但对初学者来说少了一层“界面文件”和“逻辑文件”的对应关系反而容易糊涂。我的看法是第一次接触 Android先看明白 XML 布局和 Activity 之间的关系之后再学 Compose 会容易得多。否则你一上来直接看到一堆Modifier、setContent很容易觉得“这都啥跟啥”然后放弃。3.2 目录结构官方到底帮你生成了什么项目创建后左上角是 Project 视图。你主要关心四块内容manifests存放全局配置文件核心是 AndroidManifest.xml。java或kotlin存放所有 Kotlin/Java 源码。res存放界面布局、图片、字符串等资源。Gradle Scripts存放构建脚本和 Gradle 配置。我用一个生活化的比方来帮你记AndroidManifest.xml是 App 的户口本系统安装 App 时首先看它你的应用叫什么、有哪几个页面、需要哪些权限它都要交代清楚res是素材库所有图标、布局、文字、颜色都分门别类放好Gradle Scripts是后厨的菜谱告诉系统怎么把一堆代码和资源做成一个 APK。如果你想改某个页面的界面排版去res/layout找 XML想找某个页面的逻辑去java目录找对应的类工程跑不起来先看 Gradle 控制台输出。3.3 核心三件套AndroidManifest、MainActivity、activity_main有三个文件是你会频繁打交道的必须认识。第一个是AndroidManifest.xml。你每创建一个 Activity通常需要在application标签里用activity登记否则运行时一打开那个页面就崩并提示ActivityNotFoundException。后面讲页面跳转时会细说。第二个是MainActivity.kt这是 App 的入口页面。系统启动应用时会调用它的onCreate方法你所有的启动逻辑基本都在那里写。比如设置要显示哪个界面绑定哪些按钮事件。第三个是activity_main.xml它负责管理页面上的文字、按钮、输入框的位置。MainActivity会通过setContentView(R.layout.activity_main)把布局文件“贴”到这个页面。这三者的关系我一般给学员说manifest 是门牌号MainActivity 是客厅XML 是沙盘。沙盘上的家具要拿到代码里操作就必须给它们起 ID然后用findViewById找到。3.4 build.gradle 里的版本号看到别慌工程里通常有两个 build.gradle 文件一个是项目级一个是app模块级。项目级文件里主要是一些公共仓库和插件配置大多数情况下你不需要改它而app模块级里会看到compileSdk、minSdk、targetSdk这些概念。compileSdk表示编译时用的 API 等级翻译成大白话就是“我告诉编译器最新代码里用到的这些新接口它得能识别”minSdk则是你允许运行这个 App 的最低 Android 版本如果调太高老手机就装不上。新项目默认一般会给你一个比较合理的组合比如 compileSdk 35、minSdk 24这个阶段你不用去动它。版本最忌讳自己乱升级因为 AGP 版本要和 Gradle 版本匹配入门阶段跟着模板走稳是第一位。看到版本号不用慌它们不是让你背的。4. 写第一个能交互的“计数器”布局、控件和 Kotlin 逻辑4.1 先把界面折腾出来XML 里放一个 TextView 和一个 Button我们现在做一个最简单的功能屏幕中间一个数字下方一个按钮每点一次按钮数字加一。打开activity_main.xml默认的根布局可能是 ConstraintLayout但新手建议先换成 LinearLayout。原因是 LinearLayout 的方向、排列规则特别好猜页面从上到下依次排下去而 ConstraintLayout 的拖拽约束虽然强大但新手很容易被“为什么我拖过去的控件一运行就跑了”给搞蒙。把布局文件改成下面这样LinearLayout xmlns:androidhttp://schemas.android.com/apk/res/android android:layout_widthmatch_parent android:layout_heightmatch_parent android:orientationvertical android:gravitycenter TextView android:idid/tvCount android:layout_widthwrap_content android:layout_heightwrap_content android:text0 android:textSize42sp / Button android:idid/btnAdd android:layout_widthwrap_content android:layout_heightwrap_content android:text加一 / /LinearLayout这里你只需要记住三组概念wrap_content表示“包住内容多大就多大”match_parent表示“填满父容器”id/tvCount是给控件起一个 ID之后在代码里可以用R.id.tvCount找到它。TextView是显示文字的控件Button是按钮。sp和dp都是尺寸单位文字大小用sp控件大小和间距用dp。你不用刻意背用几次自然就分清了。4.2 让按钮有反应MainActivity 里的 Kotlin 代码打开MainActivity.kt把模板里的内容替换成下面这段。我会逐行解释。package com.example.myfirstapp import android.os.Bundle import android.widget.Button import android.widget.TextView import androidx.appcompat.app.AppCompatActivity class MainActivity : AppCompatActivity() { private var count 0 private lateinit var tvCount: TextView override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) setContentView(R.layout.activity_main) tvCount findViewById(R.id.tvCount) val btnAdd findViewByIdButton(R.id.btnAdd) btnAdd.setOnClickListener { count tvCount.text count.toString() } } }onCreate是这个页面被创建时第一个执行的方法你可以理解为 App 打开页面后的“起跑线”。setContentView把之前写的 XML 布局挂上来这样屏幕上才会出现你画好的按钮和数字。findViewById的作用是从布局里找到那个控件。注意R.id.tvCount必须和 XML 里的id/tvCount完全一致多一个字母或者改大小写都会编译失败。这是新手最容易犯的笔误。lateinit var tvCount表示这个变量先声明再赋值这是 Kotlin 为了避免空指针问题在一些“声明和初始化分离”的场景下的写法。按钮的点击事件通过setOnClickListener设置花括号里面的代码就是每次点击时要做的事。count让数字加一再通过tvCount.text把新数字写回到界面上。如果你以前接触过 Java不必担心这里的思路完全一样只是 Kotlin 的写法更简洁。4.3 第一次点击运行等待 Gradle 构建也是学习的一部分点击左上角的绿色三角形按钮Android Studio 会先弹出设备选择窗口选中你刚创建的模拟器然后开始 Gradle 构建。第一次构建通常最慢因为它要下载依赖、建立索引三到五分钟都是正常情况。我第一次在咖啡厅等首次构建咖啡凉了模拟器才亮起来。所谓“卡住了”其实很多时候不是死循环而是构建确实在进行。你仔细观察底部 Gradle 窗口如果任务一直在推进就说明它在干活等构建完成模拟器里会弹出你的 App。用鼠标点几下“加一”数字开始变化恭喜你的第一个 Android App 已经能跑了。5. 页面跳转与数据传递Intent 是基础中的基础5.1 为什么每个页面都要在 Manifest 里“报到”一个 App 很少只有一个页面页面之间的跳转是你写任何实际项目都要用到的高频操作。Android 里的页面通常对应一个Activity。从当前页面跳到另一个页面标准工具是Intent但在跳转之前必须先把目标页面登记到AndroidManifest.xml。你先创建一个新的 Kotlin 类名字叫SecondActivity继承AppCompatActivity。然后打开 manifest在application标签内部新增一行activity android:name.SecondActivity /这里的.SecondActivity是相对于包名的路径等价于com.example.myfirstapp.SecondActivity。如果你不写这一行运行点击跳转时一定会崩溃提示ActivityNotFoundException。很多新手第一次遇到闪退都不知道去哪查其实就是漏了登记。5.2 Intent 的定位作用把“地址”和“包裹”一起交给系统跳转的代码非常简单。比如我们想在计数器页面放一个按钮点击后跳到SecondActivity同时把当前的count数字带过去val intent Intent(this, SecondActivity::class.java) intent.putExtra(count, count) startActivity(intent)Intent这个词可以理解成“意图”它描述了你想要启动哪个页面以及要带过去的包裹数据。putExtra(count, count)是把count的值放入包裹Key 是count。在SecondActivity的onCreate里接收数据写法是val receivedCount intent.getIntExtra(count, 0)这里的0是默认值意思是如果count这个 Key 不存在至少返回 0不会让程序崩溃。putExtra和getIntExtra使用的 Key 必须完全一致哪怕大小写不同都会取不到值。我见过有人左边写count右边写Count排查了一下午。5.3 从新页面返回和回传数据现在都推荐 Activity Result API系统返回键可以直接把当前页面结束掉并回到上一页这个不用写逻辑。但如果你需要第二页填一个结果点按钮返回并把结果带回第一页那就要用setResult加上启动方注册回调。旧教程里会教你用startActivityForResult但这个方法已经被标记为废弃新项目不要学。现在更通用的做法是 Activity Result API大概流程是在接收方先声明一个 launcher再通过 Intent 跳转第二页返回时设置结果。初学阶段你不需要把整个 API 背下来但要养成一个习惯看到“已废弃”的 API别照抄老教程去搜最新写法。这个习惯能让你少踩很多老坑。6. 换成真机调试USB 调试、驱动和 Logcat 日志6.1 为什么我建议你的第二个 App 就开始用真机模拟器跑 UI 很方便但它替代不了真机。相机、震动、蓝牙、传感器、定位、不同屏幕尺寸以及一些第三方的登录支付 SDK都需要在真机上验证。更重要的是不少国产手机系统在后台管理、权限弹窗上有自己的逻辑很多你觉得没问题的功能装到真机上就是莫名其妙闪退。所以学会真机调试是从“能写”到“能调”的关键一步。6.2 一步步打开开发者选项和 USB 调试手机的第一步打开“设置”找到“关于手机”找到“版本号”连续点击七次系统会提示“你已进入开发者模式”。不同品牌的入口略有差异有的在“我的设备”里有的需要先点“全部参数”但核心都是找到版本号之后狂点。第二步进入“开发者选项”打开“USB 调试”。戴着壳或者用扩展坞的同学注意最好也把“仅充电模式下允许 ADB 调试”打开否则手机连接电脑后系统可能忽略调试指令。第三步用数据线连接电脑手机屏幕会弹出是否允许调试的窗口勾选“始终允许”点允许。这里有一个特别容易踩的坑数据线要能传数据而不能是只能充电的线。很多“只能充电”的数据线会让电脑一直无法识别设备我遇到不下三次。6.3 连接不上从这几个方向排查设备列表里一直看不到手机先别急着怀疑电脑按顺序排查在 Windows 的设备管理器里看有没有带黄色感叹号的 Android 设备有的话去手机厂商官网下载对应 USB 驱动安装装完重启。下拉手机状态栏把 USB 模式从“仅充电”切换到“文件传输”。在 Android Studio 里拔插一次数据线手机上重新点一次允许调试授权。这三步能解决绝大部分连接问题。真机比模拟器更贴近真实用户值得你花二十分钟把它调通。6.4 Logcat 崩溃日志红色的字不是吓唬人Android Studio 底部有一个 Logcat 窗口App 运行时打印的日志都会出现在这里。调试时最实用的动作是在关键代码处加一行日志Log.d(MainActivity, 按钮被点击了)然后你就可以在 Logcat 里过滤MainActivity这个 Tag看到日志有没有执行到那一行。如果 App 崩溃Logcat 里会刷出一堆红色栈信息。里面最经典的一行是Caused by:它通常是崩溃根源。比如你调用了没有在 manifest 注册的 Activity堆栈里会出现ActivityNotFoundException定位到具体类名后你就能回头检查注册。学会看这一行能省掉你 90% 的崩溃排查时间。7. 制作可安装的 APK签名、打包和安装的坑7.1 调试 APK 和正式 APK 的差别直接点运行安装到手机上的是 debug 包它默认用的是调试签名只能用来自己测试。如果你要把 App 发给朋友安装或者要上架应用商店必须生成 release 正式包。这里的“签名”指的是数字签名相当于 App 的防伪标记系统靠它判断这个安装包的来源和身份。旧项目更新升级时必须使用同一个签名的证书否则系统会拒绝覆盖安装提示“原签名不一致”。这就是为什么密钥库文件一定要当宝贝一样保存好。7.2 一步步创建密钥并生成签名 APK菜单栏选 Build —— Generate Signed Bundle / APK。这个弹窗会问你是输出 AAB 还是 APK如果只是想拿到一个 apk 文件直接发给别人安装选 APK。点 Next 之后选择 Create new keystore接着填一堆密码、别名和个人信息。这一步的关键是密钥库文件保存好密码和别名也一定要记录。我之前遇到过客户自己忘了密钥库密码结果应用只能用新签名重新上架老用户全部无法覆盖安装非常狼狈。证书就是 App 身份证丢了就得“重新做人”。创建完成后勾选 release点击 Finish。几分钟后工程目录下的app/release里会出现app-release.apk这就是可以传播安装的正式包。7.3 把 APK 装到手机上常见的三种问题拿着 APK 传到手机后用文件管理器安装容易遇到下面这些情况现象常见原因处理办法显示“解析包错误”文件下载不完整或手机系统版本低于 minSdk重新下载完整 APK检查系统版本显示“应用未安装”手机已有同应用但签名不同先卸载旧版本再安装或统一签名文件打不开聊天工具传输时把 APK 后缀改了重命名回 .apk或换安装包链接另外提醒一下应用市场的目标版本要求会随行业规范调整新上架应用尽量按官方最新要求设置targetSdk不是越高就越好也不是低了就可以永久不用改。这一块以当前官方和市场的实际要求为准。最后说一句我自己的体会第一次跑通 App 时很多人都会觉得神奇然后马上想加各种炫酷功能结果越改越乱。我建议你把教程里的例子亲手重做一遍比如给计数器再加一个清零按钮不要只靠重启来归零。这个过程只要自己完整走一遍那些知识点就会从“看过”变成“会写”。之后再去碰列表、网络请求、数据库会顺很多。先祝你的第一个 App 跑起来顺利。