简介这份Android应用源码项目以高仿QQ登录界面为核心面向在校学生、个人开发者及企业技术人员可用于毕业设计选题、Android入门练手或公司项目中的登录模块技术参考。压缩包共70个文件整体约752KB其中44个png图片资源承担界面图标与背景素材22个xml文件负责布局与配置定义4个java文件实现登录逻辑与页面跳转结构紧凑、层次分明便于快速理解一个完整登录模块的组成方式。目前已有119人学习下载属于轻量级但实用性较强的参考案例。读者可从中获取登录界面的布局思路、资源组织方式与基础交互实现对照源码梳理Activity与布局文件的对应关系并在此基础上替换为自己的业务逻辑适合作为Android界面开发与项目结构学习的起步素材。1. 高仿 QQ 登录界面源码一份能直接跑起来的 Android 入门工程如果你正在找一份能直接导入 Android Studio、跑起来就能看到登录界面的源码这份高仿 QQ 登录的工程值得花半小时拆一遍。它解决的不是从零写一个 App的问题而是让你在一个结构完整、页面还原度较高的真实项目里看清登录页从布局到交互的完整链路。适合刚学完四大组件、想找一个有 UI 细节的练手项目的 Android 初学者也适合需要快速搭一个登录页壳子的开发者。源码包本身是 zip 格式解压后就是标准的 Android 工程目录用 Android Studio 打开即可编译。下面我按它是什么、怎么跑、代码怎么读、坑在哪的顺序把这份工程拆开讲清楚。2. 工程结构与技术栈先看清它用了什么再动手2.1 目录结构与 Gradle 配置拿到 zip 之后别急着点 import先解压看一眼目录。标准 Android 工程的结构大致是这样QQLogin/ ├── app/ │ ├── src/main/ │ │ ├── java/com/example/qqlogin/ │ │ │ ├── MainActivity.java │ │ │ └── ...其他 Activity │ │ ├── res/ │ │ │ ├── layout/ # 布局文件 │ │ │ ├── drawable/ # 图片与 shape 资源 │ │ │ ├── mipmap/ # 应用图标 │ │ │ └── values/ # colors.xml、strings.xml、styles.xml │ │ └── AndroidManifest.xml │ └── build.gradle ├── build.gradle ├── settings.gradle └── gradle.properties这个结构是 Android Studio 默认生成的没有用特殊的模块化拆分。app模块承载全部代码res目录下的layout和drawable是这份源码的重点——高仿 QQ 登录的视觉效果基本靠这两个目录撑起来。build.gradle里需要关注的是compileSdkVersion、minSdkVersion和targetSdkVersion三个值。老工程常见的问题是compileSdkVersion停留在 28 或 29而你本机装的是 Android Studio 新版本Gradle 插件版本对不上就会报错。常见做法是先把compileSdkVersion提到 33 或 34targetSdkVersion同步跟上minSdkVersion保持 21 左右即可这样兼容性和编译成功率都比较稳。提示如果build.gradle里用的是compile而不是implementation说明这是比较老的工程需要把compile全部替换成implementation否则新版 Gradle 直接报错。2.2 登录页用到的核心控件与布局思路QQ 登录页的视觉元素拆开看并不复杂主要是这几块顶部头像区域、中间两个输入框账号、密码、登录按钮、底部辅助入口注册、忘记密码。这份源码大概率用的是LinearLayout垂直排列 RelativeLayout做局部定位的组合而不是ConstraintLayout——因为老工程用约束布局的少。输入框部分通常用EditText配合自定义drawable背景来实现圆角边框效果。QQ 登录页的输入框是底部一条横线、上方无边框的样式实现方式一般是在drawable里写一个layer-list或者直接用带stroke的shape!-- res/drawable/bg_input_underline.xml -- layer-list xmlns:androidhttp://schemas.android.com/apk/res/android !-- 底层一条细线 -- item android:gravitybottom shape solid android:color#CCCCCC / size android:height1dp / /shape /item /layer-list这段 XML 定义了一个只有底部 1dp 灰线的背景把它设给EditText的android:background属性就能得到 QQ 那种下划线输入框的效果。逻辑很直白layer-list允许叠放多层 drawablegravitybottom把线压到底部size控制线的高度。参数上颜色值#CCCCCC是浅灰想更深就改成#999999线高1dp在多数屏幕上刚好改成2dp会显得粗。按钮部分通常是Button或TextView加shape背景。QQ 登录按钮是亮蓝色圆角矩形用shape的corners和solid就能实现!-- res/drawable/bg_login_button.xml -- shape xmlns:androidhttp://schemas.android.com/apk/res/android solid android:color#12B7F5 / !-- QQ 蓝 -- corners android:radius24dp / !-- 圆角半径 -- /shapecorners的radius设成高度的一半就能得到完全圆角的效果。如果按钮高度是 48dpradius给 24dp 就是胶囊形。这个值改小会变成圆角矩形改大会被系统截断成最大圆角。2.3 从 Manifest 看 Activity 注册与启动流程AndroidManifest.xml里注册了所有 Activity其中带LAUNCHERintent-filter 的那个就是启动页。高仿 QQ 登录工程一般会有两个 Activity一个启动页SplashActivity做短暂停留后跳转一个登录页LoginActivity承载主要交互。activity android:name.LoginActivity intent-filter action android:nameandroid.intent.action.MAIN / category android:nameandroid.intent.category.LAUNCHER / /intent-filter /activity这段注册的含义是LoginActivity作为应用入口桌面点击图标后第一个启动它。如果源码里还有SplashActivity那LAUNCHER应该挂在 Splash 上Login 通过startActivity(new Intent(this, LoginActivity.class))跳转过去。跳转逻辑通常在 Splash 的onCreate里用Handler().postDelayed()延迟 1.5 到 2 秒执行。参数上延迟时间别设太长超过 3 秒用户会觉得卡也别设 0那样 Splash 一闪而过没有意义。常见值是 1500 毫秒。3. 导入与运行从解压到看到界面的完整步骤3.1 用 Android Studio 导入并解决 Gradle 同步问题第一步解压 zip 到一个不含中文和空格的路径下。路径里有中文是 Gradle 报错的常见原因之一虽然新版工具链已经改善很多但老工程仍然容易翻车。第二步打开 Android Studio选择File → Open定位到解压后的工程根目录含settings.gradle的那一层点 OK。不要用Import Project那个入口是给 Eclipse 老工程用的。第三步等待 Gradle 同步。如果卡在 Gradle sync failed按下面的顺序排查# 查看 Gradle 版本要求 cat gradle/wrapper/gradle-wrapper.properties # 输出类似distributionUrlhttps\://services.gradle.org/distributions/gradle-6.7.1-all.zip这个文件告诉你工程期望的 Gradle 版本。如果本机没有对应版本Android Studio 会尝试下载。下载失败通常是网络问题可以手动下载对应版本放到~/.gradle/wrapper/dists/目录下。第四步如果同步报错提示compileSdkVersion相关打开app/build.gradle修改android { compileSdkVersion 34 // 改成你本机已安装的 SDK 版本 defaultConfig { minSdkVersion 21 // 最低支持 Android 5.0 targetSdkVersion 34 // 与 compileSdkVersion 保持一致 } }compileSdkVersion决定用哪个版本的 SDK 编译必须是你本机已安装的。minSdkVersion决定应用能装到多老的设备上21 对应 Android 5.0覆盖绝大多数设备。targetSdkVersion影响运行时权限等行为设成和 compile 一致最省事。第五步同步成功后点绿色三角运行。如果没有真机创建一个 AVD 模拟器选 API 30 以上的镜像。3.2 登录交互逻辑的代码走读登录按钮的点击事件是这份源码的核心交互。典型实现是在LoginActivity的onCreate里找到按钮控件并设置监听Button loginBtn findViewById(R.id.btn_login); final EditText etAccount findViewById(R.id.et_account); final EditText etPassword findViewById(R.id.et_password); loginBtn.setOnClickListener(new View.OnClickListener() { Override public void onClick(View v) { String account etAccount.getText().toString().trim(); String password etPassword.getText().toString().trim(); // 非空校验 if (account.isEmpty()) { Toast.makeText(LoginActivity.this, 请输入账号, Toast.LENGTH_SHORT).show(); return; } if (password.isEmpty()) { Toast.makeText(LoginActivity.this, 请输入密码, Toast.LENGTH_SHORT).show(); return; } // 模拟登录实际项目这里换成网络请求 if (admin.equals(account) 123456.equals(password)) { startActivity(new Intent(LoginActivity.this, MainActivity.class)); finish(); // 登录成功后销毁登录页防止返回键回到登录页 } else { Toast.makeText(LoginActivity.this, 账号或密码错误, Toast.LENGTH_SHORT).show(); } } });逐段说明findViewById通过布局里android:id的值拿到控件引用这是老写法新版可以用 ViewBinding 替代但这份源码大概率没用。getText().toString().trim()拿到输入内容并去掉首尾空格trim()很重要用户不小心输入空格时不做处理会导致校验失败。非空校验用isEmpty()判断失败时用Toast提示并return中断后续逻辑。登录成功后的finish()是容易被忽略的一步——不调用的话用户在主页按返回键会回到登录页体验上像没登录成功。密码输入框在布局里应该设置android:inputTypetextPassword这样输入内容会显示为圆点。如果源码里没设自己补上EditText android:idid/et_password android:layout_widthmatch_parent android:layout_heightwrap_content android:inputTypetextPassword android:hint请输入密码 /inputType除了控制显示方式还决定软键盘类型。textPassword会弹出普通文字键盘但内容掩码显示。如果设成numberPassword则只允许输入数字且掩码显示。3.3 资源文件与界面还原度的关系高仿 QQ 登录的高仿二字八成靠res/drawable里的图片资源和res/values/colors.xml里的颜色值。源码包里如果带了 QQ 的 logo 图片、背景图那还原度就高如果只有纯色背景加文字那只能算结构仿。colors.xml里通常会定义几个关键色值resources color nameqq_blue#12B7F5/color !-- QQ 品牌蓝 -- color nametext_primary#333333/color !-- 主文字色 -- color nametext_hint#999999/color !-- 提示文字色 -- color namedivider#E5E5E5/color !-- 分割线 -- /resources把这些色值抽到colors.xml而不是硬编码在布局里好处是改主题色时只改一处。#12B7F5是 QQ 的标志性蓝色如果你要做其他品牌的登录页改这一个值就能整体换色。布局文件里引用色值用color/qq_blue引用图片用drawable/xxx引用字符串用string/xxx。这种引用方式比直接写值更规范也是 Android 开发的基本习惯。4. 避坑与常见问题导入老工程最容易翻车的几个点4.1 Gradle 版本不兼容导致同步失败现象打开工程后 Gradle sync 直接报错提示 Minimum supported Gradle version is X.X 或 Could not find method compile()。原因工程使用的 Gradle 插件版本和你本机 Android Studio 自带的版本不匹配。老工程用compile关键字新版 Gradle 已移除该方法。解决打开根目录build.gradle把classpath com.android.tools.build:gradle:x.x.x改成你 Android Studio 版本对应的插件版本。同时把app/build.gradle里所有compile替换为implementationtestCompile替换为testImplementation。改完点 Sync Now。4.2 SDK 路径未配置导致编译中断现象同步通过但编译时报 SDK location not found。原因工程根目录缺少local.properties文件或者文件里的sdk.dir指向了不存在的路径。解决在工程根目录新建local.properties写入本机 SDK 路径# Windows 示例 sdk.dirC\:\\Users\\你的用户名\\AppData\\Local\\Android\\Sdk # macOS 示例 sdk.dir/Users/你的用户名/Library/Android/sdk注意 Windows 路径里的反斜杠要转义成\\冒号要转义成\:。这个文件不应该提交到版本控制它记录的是本机环境信息。4.3 模拟器上运行白屏或闪退现象应用装上了点开图标白屏几秒后闪退Logcat 里看到NullPointerException。原因常见的是findViewById返回 null即布局里没有对应 id 的控件或者setContentView加载的布局文件不对。另一个常见原因是图片资源过大导致OutOfMemoryError。解决先看 Logcat 里报错的行号定位到具体是哪一行findViewById出了问题然后去对应的布局文件里确认android:id是否拼写一致。如果是内存问题把drawable里的大图换成压缩过的版本或者放到drawable-nodpi目录下避免被缩放。4.4 输入框被软键盘遮挡现象点击密码框弹出键盘后登录按钮被顶出屏幕或者输入框被遮住。原因Activity 的windowSoftInputMode没有配置默认行为是adjustResize或adjustPan不同系统版本表现不一致。解决在AndroidManifest.xml对应的 Activity 标签里加上activity android:name.LoginActivity android:windowSoftInputModeadjustResize|stateHidden /adjustResize让布局整体上移保证输入框可见stateHidden让进入页面时不自动弹出键盘。如果布局外层是ScrollViewadjustResize配合滚动效果最好。4.5 登录成功后返回键仍回到登录页现象登录跳转到主页后按系统返回键又回到了登录页。原因跳转时没有调用finish()销毁登录页登录页还在返回栈里。解决在startActivity之后加一行finish()。如果希望更彻底可以在跳转 Intent 里加FLAG_ACTIVITY_CLEAR_TASK标志清除整个任务栈。但最简单的做法就是finish()一行搞定。5. 进阶改造把这份源码变成你自己的登录模块5.1 用 TextInputLayout 替换原生 EditText原生EditText的下划线样式需要自己写 drawable而 Material 组件库的TextInputLayout自带浮动标签和下划线效果代码更少、兼容性更好。改造步骤先在app/build.gradle里确认有 Material 依赖dependencies { implementation com.google.android.material:material:1.9.0 }然后把布局里的EditText包一层com.google.android.material.textfield.TextInputLayout android:layout_widthmatch_parent android:layout_heightwrap_content android:hint账号 app:boxBackgroundModefilled app:boxStrokeColorcolor/qq_blue com.google.android.material.textfield.TextInputEditText android:idid/et_account android:layout_widthmatch_parent android:layout_heightwrap_content android:inputTypetext / /com.google.android.material.textfield.TextInputLayoutboxBackgroundMode控制背景样式filled是填充式outline是描边式。boxStrokeColor控制聚焦时的下划线颜色。这样改完输入框获得焦点时标签会自动上浮比原生实现省事得多。代码里findViewById拿到的仍然是TextInputEditText类型改成TextInputEditText即可其他逻辑不变。5.2 加一个简单的本地校验与状态保存登录页有个容易被忽略的细节用户在输入账号后旋转屏幕输入内容会丢失。原因是 Activity 重建了。解决办法是在AndroidManifest.xml里给 Activity 加android:configChanges或者更规范地用onSaveInstanceState保存状态Override protected void onSaveInstanceState(Bundle outState) { super.onSaveInstanceState(outState); outState.putString(account, etAccount.getText().toString()); outState.putString(password, etPassword.getText().toString()); } Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_login); // ... findViewById 初始化 ... if (savedInstanceState ! null) { etAccount.setText(savedInstanceState.getString(account)); etPassword.setText(savedInstanceState.getString(password)); } }onSaveInstanceState在 Activity 即将被销毁前调用把需要保留的数据塞进 Bundle。onCreate里判断 Bundle 是否为空不为空就恢复。注意密码这种敏感信息在真实项目里不应该这样保存这里只是演示状态恢复的机制。5.3 验证改造是否成功的检查清单改完之后别急着说跑通了按下面几条过一遍检查项预期表现不通过时看哪里旋转屏幕输入内容不丢失onSaveInstanceState 是否被调用点击登录空账号Toast 提示请输入账号非空校验分支点击登录错误密码Toast 提示账号或密码错误模拟校验分支点击登录正确密码跳转主页返回键不回登录页finish() 是否调用点击密码框键盘弹出输入显示为圆点inputType 是否为 textPassword连续点击登录按钮不重复跳转是否加了防抖或 disable这张表里的最后一条连续点击是很多人会忽略的。用户手快连点两下startActivity执行两次就会打开两个主页实例。解决办法是在点击后立刻loginBtn.setEnabled(false)跳转失败或返回时再恢复。这个细节在真实项目里是必做的源码里如果没有自己补上。5.4 我踩过的一个坑第一次拆这类登录源码时我直接改了colors.xml里的品牌色结果发现按钮颜色没变。查了半天才意识到按钮背景用的是drawable里硬编码的色值而不是引用colors.xml。从那以后我每次改主题色都会全局搜索一遍色值字符串确认没有遗漏硬编码的地方。这个习惯帮我省了很多改了没生效的排查时间。希望帮到你。本文还有配套的精品资源点击获取