简介这是一份基于Android Studio开发的简易安卓项目适合Android初学者作为入门实践也可供有经验开发者巩固基础。项目围绕用户登录、用户注册、数据存储、选项卡切换及信息表注册等常见功能展开涉及EditText、Button、SharedPreferences与SQLite、TabLayout与ViewPager、DatePickerDialog、RadioButton与CheckBox等核心组件覆盖Android应用开发中典型交互与数据管理场景。压缩包为zip格式大小约12.12MB内含完整项目源码与工程配置。已有1129人学习下载资源包含清晰的界面布局与逻辑实现可帮助读者快速理解应用层与数据层之间的协作方式学习如何利用Android Studio搭建可运行的应用骨架。通过阅读代码与自行调试能够掌握基本的Android开发流程和常用第三方库的接入思路。1. 用 Android Studio 写简易安卓项目为什么跑通一个 Hello 级应用才是第一道坎很多人第一次接触 Android Studio 时以为难点在写业务逻辑真动手才发现光把环境装对、让第一个项目编译通过就能卡掉一半人。这个标题下的简易安卓项目通常是一个单页应用一个输入框、一个按钮、一个文本显示区外加打包成 APK 装到手机上。它要解决的是「在 Android Studio 里把环境、工程、界面、事件、打包整条链路走通」这件事而不是业务复杂度。适合零基础学生、想从桌面端开发扩到移动端的工程师以及想快速验证点子的个人开发者。它不追求架构只追求从新建项目到真机亮屏这条路别再翻车。2. 搭建 Android Studio 开发环境从下载安装到第一个能编译的工程2.1 版本与 JDK别纠结新版本号先确认三件事Android Studio 的下载安装和老版本下载本身不复杂复杂的是装完之后的三个检查项JDK 对不对、SDK 路径对不对、Gradle 能不能把依赖拉下来。新版 Android Studio 自带 JetBrains RuntimeJBR你不需要手动安装 JDK 就能跑 IDE。但项目里的构建过程仍然需要一个可用 JDKAndroid Studio 默认指向自带的 JBR这个配置在File Project Structure SDK Location里查看。如果你之前装过 Oracle JDK且JAVA_HOME指向了 JDK 8而你的项目 compileSdk 是 34 或 35Gradle 很可能直接报Unsupported class file major version之类错误。常见做法是到 Project Structure 里把 Gradle JDK 手动切到 Android Studio 自带的 JBR而不是去改系统级 JAVA_HOME——改全局变量容易影响你机器上其他 Java 项目。第二项是 SDK。首次启动会引导下载 platform-tools、build-tools、platforms 三部分。这里有两个经验SDK 路径不要放在带空格的目录更不能是中文路径否则后面每次构建都可能出现诡异路径解析错误如果之前装过旧版 IDE默认 SDK 目录里可能残留旧平台版本建议直接清空再装避免出现 API level 对不上、编译期找不到android.jar的怪问题。第三项是 Gradle。第一次点同步会下载 Gradle 发行版和一堆依赖耗时取决于网络环境。这条在第 4 章会详细展开这里只提醒一个原则不要在同步中途强制关闭 Android Studio否则下次启动很可能遇到.gradle缓存目录损坏表现是 Gradle 反复失败且最快的解法是删除~/.gradle/caches下对应工程的缓存目录重来。注意命令行里的adb和emulator都来自 SDK 目录下的 platform-tools 和 emulator 子目录。把它们加进 PATH 能省很多事尤其后面要频繁用 adb 做安装和日志排查时。2.2 新建工程Empty Views Activity 与 Gradle 同步在干什么New Project模板选择的坑比想象中多。Android Studio 现在默认推荐Empty Views Activity而名字很像的Empty Activity是 Jetpack Compose 模板。如果你打算用传统 XML 布局加 Activity 的方式写简易项目选错模板会导致你对照教程截图时处处对不上。请选Empty Views Activity语言选 Kotlin最低 SDK 选 API 24 或 26 就够——覆盖绝大多数在用的手机且不用处理 Android 5/6 的兼容性边界问题。选完模板后Android Studio 会花几分钟做 Gradle Sync。这一步做了三件事下载对应版本的 Gradle 发行版、解析settings.gradle.kts里声明的插件与依赖、生成与 IDE 关联的项目模型。同步成功后项目里会多出.gradle目录和build目录这是正常构建产物。很多人第一次看到几十个文件会慌其实一个简易项目真正要碰的只有四个文件MainActivity.kt、activity_main.xml、模块级build.gradle.kts、AndroidManifest.xml。模块级构建配置长这样新建项目会帮你填好但你要知道每项在控制什么// 模块级 build.gradle.kts路径app/build.gradle.kts android { namespace com.example.simpleapp compileSdk 34 defaultConfig { applicationId com.example.simpleapp minSdk 24 targetSdk 34 versionCode 1 versionName 1.0 } } dependencies { implementation(androidx.core:core-ktx:1.12.0) implementation(androidx.appcompat:appcompat:1.6.1) implementation(com.google.android.material:material:1.10.0) implementation(androidx.constraintlayout:constraintlayout:2.1.4) }参数说明compileSdk是编译时使用的 API 级别一般保持 Android Studio 推荐值minSdk决定支持的最低系统版本API 24 对应 Android 7.0targetSdk表示针对哪个系统版本做过适配它影响系统运行时是否给你启用兼容行为例如 Android 12 以上的「近似位置」权限开关。这三项配混乱的典型表现是依赖库报requires compileSdk 34或者真机安装时报INSTALL_FAILED。另外versionCode是整数且每次发布必须递增versionName是给用户看的版本号两者都改才会被系统识别为新版本。2.3 AVD 模拟器与真机调试简易项目该走哪条路环境就绪后需要运行目标。Android Studio 自带的 AVD 跑简易项目够了但创建虚拟设备时有两个决定体验的选择。首先系统镜像选 x86_64 或 arm64-v8a 中带 Google APIs 的版本不要选不带 Google APIs 的纯 AOSP 镜像。带 Google APIs 的镜像包含完整系统服务很多应用在纯 AOSP 镜像上会闪退或弹「Google Play 服务已停止」。其次是存储配置默认 2GB 用户存储对一个会装多个 APK 的开发阶段来说偏小在 AVD 设置里把 Internal Storage 调到 4GB 以上再重启设备能避免「设备存储不足导致安装失败」的尴尬。真机调试其实比模拟器更省时间。打开手机设置里的开发者选项开启 USB 调试插线后手机上弹出授权确认勾选「始终允许」即可。Android Studio 顶部的运行设备下拉框会出现你的手机型号。这里有个误区很多人以为必须挂数据线其实 Android 11 及以上支持无线调试配对一次后可以脱离数据线跑。但简易项目用数据线调试已经足够别在无线调试上花时间除非你的数据线经常接触不良导致调试中断。模拟器联网的问题放到第 4 章写它是独立且高频的坑。这里先提一句如果在虚拟机或内网环境里跑 AVD网络异常通常表现为浏览器打不开但系统时间正常优先检查宿主机的网络和 DNS而不是去模拟器设置里乱改。3. 写出第一个能交互的界面XML 布局、Activity 与按钮事件3.1 布局文件LinearLayout 里放三个控件简易项目的界面一般长这样顶部标题文字中间输入框下方按钮点击后把输入内容回显到标题位置。用 XML 写布局核心是掌握LinearLayout与match_parent、wrap_content的组合。虽然 Android Studio 提供拖拽式布局编辑器但实际开发中手写 XML 更可控拖拽生成的约束和间距经常读不懂——这是很多教程不讲的真实体验。一个可直接用的布局如下它对应垂直排列的单页应用?xml version1.0 encodingutf-8? LinearLayout xmlns:androidhttp://schemas.android.com/apk/res/android android:layout_widthmatch_parent android:layout_heightmatch_parent android:orientationvertical android:padding16dp android:gravitycenter_horizontal TextView android:idid/tv_title android:layout_widthwrap_content android:layout_heightwrap_content android:text简易记事本 android:textSize20sp android:textStylebold / EditText android:idid/et_input android:layout_widthmatch_parent android:layout_heightwrap_content android:layout_marginTop16dp android:hint输入一段文字 android:inputTypetext / Button android:idid/btn_show android:layout_widthwrap_content android:layout_heightwrap_content android:layout_marginTop16dp android:text显示内容 / /LinearLayout这里有几个点值得展开。dp是密度无关像素适配不同屏幕密度sp是文字专用单位跟随系统字体缩放变化标题用sp是惯例不是规定。android:hint是占位提示不是默认值用户一打字就消失。id/xxx里的号表示「新建这个 id」同一个 id 在布局中只能定义一次重复会出现资源冲突。自定义组件在这个阶段不用碰。很多人一上来就研究自定义 View对一个简易项目来说本末倒置。先把系统控件的组合用熟遇到系统控件满足不了的交互时再学自定义组件上手路径会顺很多。3.2 ActivitysetContentView 与 findViewById 的配对关系界面写好后要让它出现在屏幕上需要在 Activity 里把它加载出来。MainActivity的onCreate中setContentView(R.layout.activity_main)把 XML 布局实例化为界面。这行之后才能通过findViewById找到布局里的控件顺序反了返回 null——这是新手翻车率最高的错误之一。// MainActivity.kt package com.example.simpleapp import android.os.Bundle import android.widget.Button import android.widget.EditText import android.widget.TextView import androidx.appcompat.app.AppCompatActivity class MainActivity : AppCompatActivity() { override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) setContentView(R.layout.activity_main) // setContentView 之后才能获取控件实例 val tvTitle: TextView findViewById(R.id.tv_title) val etInput: EditText findViewById(R.id.et_input) val btnShow: Button findViewById(R.id.btn_show) // 按钮点击后把输入框内容回显到标题 TextView btnShow.setOnClickListener { val input etInput.text.toString().trim() if (input.isNotEmpty()) { tvTitle.text input } } } }逻辑说明findViewById传入布局中定义的 id返回对应控件实例setOnClickListener接收一个点击回调Kotlin 用 lambda 简化了接口实现。:trim()去掉首尾空格避免用户只敲空格时把标题改成空白。tvTitle.text input是 Kotlin 对setText的简化写法等价于 Java 里的tvTitle.setText(input)。需注意老教程里的import kotlinx.android.synthetic已废弃新项目不要用。如果嫌findViewById啰嗦可以用 ViewBinding模块级配置加buildFeatures { viewBinding true }然后通过ActivityMainBinding.inflate(layoutInflater)获得类型安全的控件引用。简易项目两者皆可建议先把findViewById机制摸清再换 ViewBinding否则出错时你不知道是哪一层隐藏了类型。3.3 数据从界面到逻辑层EditText、Button 与 Toast 的最小闭环读输入、响应点击、给出反馈是简易项目里最重要的闭环。上一节已覆盖「读 EditText → 更新 TextView」这里补一个用户感知更强的反馈用 Toast 弹提示。它的作用不只是体验当点击按钮后界面无明显变化时Toast 能确认事件是否真的触发——这是最原始的调试手段。btnShow.setOnClickListener { val input etInput.text.toString().trim() if (input.isEmpty()) { // 输入为空时给出提示而不是让界面无反应 Toast.makeText(this, 内容不能为空, Toast.LENGTH_SHORT).show() returnsetOnClickListener } tvTitle.text input Toast.makeText(this, 已更新标题, Toast.LENGTH_SHORT).show() }参数说明Toast.makeText第一个参数传this没问题但如果写在匿名内部类或非 Activity 上下文中this会指向错误对象要换成外层 Activity 引用。Toast.LENGTH_SHORT约 2 秒LENGTH_LONG约 3.5 秒不要传其他整数值传了不生效。input.isEmpty()分支里必须returnsetOnClickListener它结束的是当前 lambda不写的话空输入也会继续执行更新逻辑。到这里简易项目核心链路已通布局描述界面Activity 绑定界面与逻辑按钮事件驱动数据流动。下一步要面对编译和运行阶段的真实报错这部分比写代码更磨人。4. Android Studio 简易项目踩坑记录5 个高频问题的现象、原因与处理4.1 R 文件标红找不到符号 R现象MainActivity.kt里R类被标红编译报Unresolved reference: R或者R.id.xxx提示无法解析。原因R由app/build/generated下的资源索引类生成Gradle 在资源解析阶段自动生成。它标红通常不是代码问题而是资源文件本身有问题布局 XML 里有非法字符、资源文件名用了大写或中文、drawable或mipmap目录下放进了不支持的图片格式。典型场景是网上下的图片改了名放进drawable实际格式带扩展名虽为 png、内容却是 WebP 或带 alpha 的异常编码。解决先看Build Rebuild Project的完整报错定位具体资源文件检查所有资源文件名是否小写字母、数字、下划线确认 XML 注释里没写--最后Build Clean Project清掉build目录重新编译。90% 的 R 文件问题这四步能解决剩下的通常是 Gradle 缓存删除对应工程的.gradle缓存后重开项目。4.2 Gradle 同步卡在下载依赖转圈几个小时不动现象新建项目后 Gradle Sync 一直运行进度条不动日志停在Downloading ... gradle-8.x-bin.zip。原因Gradle 要下载两样东西发行版本身和 Maven 仓库里的依赖库。默认仓库地址在某些网络环境下访问慢同步就卡住。这不是配置写错是依赖仓库地址可达性的问题。解决常见做法是把仓库地址换成下载速度更快的公共 Maven 仓库。在settings.gradle.kts的pluginManagement和dependencyResolutionManagement两个块里加上可用仓库// settings.gradle.kts pluginManagement { repositories { maven(url https://maven.aliyun.com/repository/google) maven(url https://maven.aliyun.com/repository/public) maven(url https://maven.aliyun.com/repository/gradle-plugin) google() mavenCentral() gradlePluginPortal() } } dependencyResolutionManagement { repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS) repositories { maven(url https://maven.aliyun.com/repository/google) maven(url https://maven.aliyun.com/repository/public) google() mavenCentral() } }仓库顺序有意义写在越前面的优先尝试。FAIL_ON_PROJECT_REPOS会让模块级单独声明的仓库直接报错防止「加了仓库还是失败」的混乱。如果是从别处拷来的工程还要同步核对gradle/wrapper/gradle-wrapper.properties里distributionUrl的 Gradle 版本与你的 Android Studio 不匹配时会报找不到对应发行版。4.3 模拟器联网失败浏览器打不开任何网页现象AVD 系统正常启动但浏览器一直加载应用里请求网络的代码超时。原因在非标准网络环境公司内网、虚拟机、无线桥接下模拟器默认网络模式可能拿不到正确 DNS。很多人先怀疑应用代码其实先在模拟器浏览器里试一次浏览器都不通就是系统网络问题。解决先确认宿主机网络正常。然后命令行启动模拟器并显式指定 DNSemulator -avd test_device -dns-server 8.8.8.8,114.114.114.114 -netspeed full -netdelay none参数说明-dns-server指定 DNS 服务器多个用逗号分隔-netspeed full用完整带宽-netdelay none不模拟网络延迟排查网络时先去掉这两个干扰项更好定位问题。另外Android 9 及以上默认禁止明文 HTTP 流量项目里用http://访问本地测试接口会报CLEARTEXT communication not permitted需要在AndroidManifest.xml的application上加android:usesCleartextTraffictrue或改用 https。这个现象常被误判成网络问题实际是明文流量策略。4.4 资源重复错误新建项目就报 duplicate resource现象编译报Duplicate resources指向 drawable 或 mipmap 目录下同名文件或某个布局文件里的定义重复。原因常见于从旧项目往新工程复制资源时同一文件被同时放进drawable/和drawable-v21/等限定符目录或ic_launcher图标被复制到多个密度目录且内容不同。Gradle 在资源合并阶段把同名但内容有差异的文件视为冲突。解决看完整报错给出的文件路径逐个删掉重复目录中的文件只保留一份。图标保留mipmap-anydpi-v26里的自适应图标 XML其他密度 PNG 可以统一删掉Android 8 以上优先使用自适应图标。如果确认没有重复文件仍报冲突检查res目录下是否混入values.xml这类构建生成物。处理完再Clean Project资源合并的增量缓存有时比想象的顽固。4.5 真机安装失败 INSTALL_FAILED签名、版本与空间三个方向现象点击 Run 时报INSTALL_FAILED_UPDATE_INCOMPATIBLE或INSTALL_FAILED_INSUFFICIENT_STORAGE手机提示应用未安装。原因UPDATE_INCOMPATIBLE是手机上已装了签名不同的同包名应用常见于之前用别的电脑或 keystore 打包调试。INSUFFICIENT_STORAGE是设备存储不足AVD 默认存储小也容易出现。解决签名不一致时最直接的后悔药是卸载手机上的旧应用再重新 Run开发阶段不用保留旧数据必须保留数据的话需要找到当时签名的 keystore 和密码重新打包。存储不足则清理手机空间或调大 AVD 存储后重启。安装到手机还需在开发者选项里开启「USB 安装」权限Android 11 及以上首次通过 adb 安装会要求手机确认一次不是卡住。调试期用 debug 签名要发出去再切 release 签名不要两个阶段混用一套不存在或记不清的 keystore。5. 打包 APK 的最后一公里构建、签名与真机验证APK 打包在 Android Studio 里有两条路径Debug 包用于自测Release 包用于分发。菜单路径是Build Build Bundle(s) / APK(s) Build APK(s)产物默认在app/build/outputs/apk/debug或release目录文件名一般是app-debug.apk。debug 包可直接装到手机Android Studio 自动用 debug keystore 签了名但图标可能带「调试」角标这是正常现象。要发出去的简易项目别直接用 debug 包——debug 签名的包无法覆盖安装到已有 release 签名应用的手机升级时会撞上 4.5 写的签名冲突。Release 签名在Build Generate Signed App Bundle or APK操作。选中 APK创建 keystore记住两个密码和一个 alias勾选签名版本。这里有个很多人的血泪坑keystore 文件一旦丢失或密码遗忘已有应用永远无法升级只能换包名重新上架。我现在的习惯是 keystore 文件备份到两个不同的存储位置密码写进项目目录下key.properties这个文件绝不提交到版本库团队协作时 key 由一人保管。打包完成后做最小验证。用adb install命令安装比在手机上点 APK 更能看到具体报错adb install -r app-release.apk-r表示覆盖安装验证新包能否替换旧包。报错的话用adb logcat搜AndroidRuntime或FATAL EXCEPTION查看闪退堆栈。装好后手动过一遍完整流程启动、输入文字、点击按钮、杀进程再启动确认界面状态正常。我早期做简易项目时总跳过签名直接拿 debug 包发人测试每次对方说装不上都要排查半天后来才意识到是签名问题。签名、版本号、渠道这类的「看不见的东西」才是简易项目升级为正式项目时真正吃人的地方。养成每次发布都核对versionCode、versionName并递增的习惯能省很多售后时间。希望帮到你。本文还有配套的精品资源点击获取