Android租房信息发布平台开发实践与打包全攻略

简介基于 Android 的租房信息发布平台毕业设计项目面向高校 Android 课程设计、毕业设计场景围绕管理员、房东及 VIP/普通租户等角色展开帮助读者理解用户权限管理、房屋信息发布与检索、预约排序、租房申请等核心业务流程。包内共 1055 个文件以 152 个 java 源码、192 个 xml 布局配置、239 个 class 编译文件为主体另含 242 张 png、78 张 jpg 图片及 jar 依赖包并配套数据库 sql 脚本整体 13.14MB结构清晰便于对照源码理解 Android 与后端交互。已有 522 人学习下载适合需要完整项目参考或快速搭建毕设框架的学生与开发者。项目覆盖管理员审核房源、房东发布图文信息、普通租户条件搜索、VIP 租户预约优先等典型逻辑利用 sql 脚本可快速还原数据节省从零设计架构的时间是一份实践参考价值较高的 Android 毕业设计资源。1. 毕业设计做租房信息发布平台先想清这三件事“基于 Android 的租房信息发布平台”经常出现在毕业设计选题里也确实是能把客户端、服务端、数据库、权限、网络串起来的完整练手项目。这里说的平台核心是两条主链路租客查房源、房东发房源。围绕这两条链路还要处理图片上传、价格筛选、收藏、状态管理。学生答辩时最常被问的不是功能多不多而是“数据怎么设计的、权限怎么处理的、打包之后会不会崩”。所以这篇博文按一条可复现的路径来讲从数据模型和架构选型入手到用 Android Studio 把列表和发布流程跑通再讲签名打包与真机调试。无论你已经写了几个页面还是刚建工程都能在里面找到对应的参数和坑位。2. 租房信息的数据模型与架构选型决定后面省不省事2.1 房源信息最少要有三张表做租房平台核心对象是“用户”和“房源”。我一般不会在一开始就设计十张表先把最简单的关系立住用户表、房源表、收藏表。用户与房源是一对多用户与收藏是多对多这一层想清楚后面的查询语句就不容易乱。2.1.1 给房源表建一个最小可用的结构如果本地直接采用 SQLite表结构可以写成CREATE TABLE user ( id INTEGER PRIMARY KEY AUTOINCREMENT, phone TEXT NOT NULL UNIQUE, nickname TEXT, avatar TEXT, created_at INTEGER NOT NULL ); CREATE TABLE rental_house ( id INTEGER PRIMARY KEY AUTOINCREMENT, user_id INTEGER NOT NULL, title TEXT NOT NULL, price REAL NOT NULL, area REAL, address TEXT NOT NULL, images TEXT, status INTEGER NOT NULL DEFAULT 0, create_time INTEGER NOT NULL, FOREIGN KEY(user_id) REFERENCES user(id) ); CREATE TABLE favorite ( id INTEGER PRIMARY KEY AUTOINCREMENT, user_id INTEGER NOT NULL, house_id INTEGER NOT NULL, create_time INTEGER NOT NULL, UNIQUE(user_id, house_id) );这段 SQL 里images字段直接用字符串存放图片 URL 的 JSON 数组这样本地表结构最简单等接入网络图片时也方便。status用整数表示房源状态0 待审核、1 已上架、2 已下架、3 已被租。用整数而不是字符串是为了后面做筛选时能直接走索引也避免中文状态在不同版本设备上出现编码问题。2.1.2 用 Room 改写后的字段说明如果项目里用了 Room这也是毕业设计里比较讨喜的做法实体类可以写成这样Entity(tableName rental_house) data class RentalHouse( PrimaryKey(autoGenerate true) val id: Int 0, ColumnInfo(name user_id) val userId: Int, val title: String, val price: Double, val area: Double, val address: String, val images: String, val status: Int 0, ColumnInfo(name create_time) val createTime: Long System.currentTimeMillis() )这张表对应到页面展示核心字段可以汇总成下面这样字段类型校验/说明titleString标题 10~30 字发布前裁剪首尾空格priceDouble月租金允许 0~99999避免 0 元房源刷屏areaDouble面积保留一位小数前端用Math.round(value * 10) / 10.0addressString定位后填充最多 100 字imagesString存 JSON 数组如[url1,url2]statusInt管理后台改客户端按状态切换 UI这个字段设计不复杂但足够撑起一个毕业设计的核心页面列表、详情、发布表单、收藏、我的房源。2.2 为什么选 Room 而不是直接用 SQLiteOpenHelper很多人写 Android 数据库还是用最原始的SQLiteOpenHelper写起来麻烦每次改表结构还要手动改版本号。Room 会在编译期检查 SQL 语句表字段和实体类不一致时直接编译报错这对毕业设计来说等于多了一层保障。另一个理由是 Room Flow 返回的FlowListRentalHouse可以自动感知数据变化收藏后回到列表不需要手动notifyDataSetChanged这是演示时很加分的点。数据库升级我这里给一个常用方案版本从 1 开始每次改动都加MIGRATION_n。例如给表加一个is_top字段val MIGRATION_1_2 object : Migration(1, 2) { override fun migrate(db: SupportSQLiteDatabase) { db.execSQL(ALTER TABLE rental_house ADD COLUMN is_top INTEGER NOT NULL DEFAULT 0) } } Room.databaseBuilder(context, AppDatabase::class.java, rental.db) .addMigrations(MIGRATION_1_2) .build()这里要注意的是如果你在CREATE TABLE里已经写了is_top但版本号没有从 1 改成 2Room 会在启动时抛出IllegalStateException。实际开发里这种问题比业务逻辑崩溃更常见所以每次动表结构必须同步改版本号并提供迁移脚本。2.3 网络层的三个必调参数客户端只做演示时数据可以全部走本地。但既然平台要“发布”通常还是对接一个后端接口。网络层我会用 Retrofit Moshi三个参数别漏connectTimeout设 15 秒上传图片接口要单独放宽到 60 秒addInterceptor(HttpLoggingInterceptor)只在 debug 包打开release 包不要带明文日志响应体里的code、message、data要单独包装不要直接解析 JsonObject。val retrofit Retrofit.Builder() .baseUrl(https://api.example.com/) .client( OkHttpClient.Builder() .connectTimeout(15, TimeUnit.SECONDS) .addInterceptor(HttpLoggingInterceptor().apply { level if (BuildConfig.DEBUG) HttpLoggingInterceptor.Level.BODY else HttpLoggingInterceptor.Level.NONE }) .build() ) .addConverterFactory(MoshiConverterFactory.create()) .build()HttpLoggingInterceptor.Level.BODY会把整个响应体打印出来方便直接看后端返回的 status 字段。release 包继续打印会拖慢请求所以BuildConfig.DEBUG判断必须保留。3. 用 Android Studio 把列表页跑起来注意这几个配置3.1 新建项目的依赖版本怎么选毕业设计不太需要追最新版 Android Studio。我一般建议用稳定版Gradle JDK 用 17compileSdk选 33 或 34minSdk设 24。这样既能用上androidx.appcompat的新特性又不用担心旧手机兼容性。viewBinding这个开关一定要打开它可以省掉大量findViewById。android { namespace com.example.rent compileSdk 34 defaultConfig { applicationId com.example.rent minSdk 24 targetSdk 34 versionCode 1 versionName 1.0.0 } buildFeatures { viewBinding true } }minSdk24 意味着覆盖 Android 7.0 及以上设备市面上的模拟器一般都能跑起来同时 Room 在低版本上不需要额外做兼容。versionCode必须是整数且每次发布递增versionName是给用户看的版本号。3.2 列表页用 RecyclerView CardView 搭骨架房东发布后租客看到的第一屏通常是“房源列表”。用 RecyclerView 而不直接写 ScrollView是为了应对房源数量变多时的回收复用。每个房源卡片用 CardView 包一层自带圆角和阴影视觉效果比手工写背景好代码量也少。class HouseAdapter( private val onClick: (RentalHouse) - Unit ) : ListAdapterRentalHouse, HouseAdapter.HouseViewHolder(DiffCallback) { override fun onCreateViewHolder(parent: ViewGroup, viewType: Int): HouseViewHolder { val binding ItemHouseBinding.inflate( LayoutInflater.from(parent.context), parent, false ) return HouseViewHolder(binding) } override fun onBindViewHolder(holder: HouseViewHolder, position: Int) { holder.bind(getItem(position)) } companion object DiffCallback : DiffUtil.ItemCallbackRentalHouse() { override fun areItemsTheSame(oldItem: RentalHouse, newItem: RentalHouse) oldItem.id newItem.id override fun areContentsTheSame(oldItem: RentalHouse, newItem: RentalHouse) oldItem newItem } }使用ListAdapter而不是普通 Adapter是因为它内置了AsyncListDiffer每次更新数据时只刷新真正变化的 item滑动不丢帧。这里的DiffCallback是必须写的areItemsTheSame判断是否是同一条数据areContentsTheSame判断内容是否有变化两者不一致时 DiffUtil 才能精确做局部刷新。3.3 图片加载和 Banner 轮播的三个坑房源卡片上的缩略图推荐用 Coil 或 Glide。Coil 基于 Kotlin 协程依赖体积小Glide 在图片加载失败时的占位图处理更成熟。两者都能一行加载 URL真正容易出问题的是后面三点。第一RecyclerView 里图片尺寸不要固定写死 200dp。不同屏幕密度下显示效果差异很大我一般会在加载时指定placeholder和error尺寸用override(400, 300)避免大图直接塞进内存。binding.ivCover.load(house.coverUrl) { placeholder(R.drawable.img_placeholder) error(R.drawable.img_error) crossfade(true) }第二如果首页用了CoordinatorLayoutAppBarLayoutBannerBanner 的指示器在自动轮播时要处理好生命周期。我习惯在onStart里启动轮播、onStop里停止否则 Fragment 切到后台后 Handler 还在无限运行。这个看似不起眼的问题调试日志里会反复出现Cant create handler inside a thread that has not called Looper.prepare()。第三Android 13 及以上读取图片需要申请READ_MEDIA_IMAGES而不是READ_EXTERNAL_STORAGE。如果项目只用“相册选择”而不用“直接读取文件”更推荐PickVisualMedia和PhotoPicker这样完全不用申请存储权限答辩演示时不容易因为权限弹窗被卡住。4. 发布房源的完整流程表单校验、图片选择与上传进度条4.1 发布表单校验不只做非空判断发布页面是用户画像最重的页面。标题非空只是最底线我一般还会对价格、面积、联系方式做规则校验。例如房价只能是数字且大于 0面积不能超过 10000手机号用正则^1[3-9]\\d{9}$。这些校验不能只在布局文件里用android:inputType限制因为软键盘类型可以被绕过真正要判断的是输入内容。private fun validateForm(): Boolean { val title binding.etTitle.text.toString().trim() val price binding.etPrice.text.toString().toDoubleOrNull() if (title.length 4 || title.length 30) { showSnack(标题长度需在 4 到 30 字之间) return false } if (price null || price 0) { showSnack(租金必须是大于 0 的数字) return false } return true }这段校验里toDoubleOrNull()会把空字符串、非法字符直接转换成null所以不需要单独再写isEmpty判断。校验不通过时用 Snackbar 提示比 Toast 柔和也不遮住输入框。4.2 图片选择与 FileProvider 路径坑多图上传是发布流程中最容易崩的一环。用ACTION_PICK或ACTION_GET_CONTENT得到的不是真实文件路径而是content://形式的 Uri。如果把 Uri 直接传给后端对方拿不到文件如果拿去getPath()得到的是一串带编号的怪异路径它不是文件路径而是 ContentProvider 暴露的标识。正确做法是用contentResolver.openInputStream(uri)读取字节流再压缩后转成 Fileval input contentResolver.openInputStream(uri) val bitmap BitmapFactory.decodeStream(input) // 压缩到宽高不超过 1600px质量 80% val scaled scaleDown(bitmap, 1600f) val file File(cacheDir, house_${System.currentTimeMillis()}.jpg) FileOutputStream(file).use { scaled.compress(Bitmap.CompressFormat.JPEG, 80, it) }这里有两个参数值得注意宽高上限 1600px 是手机屏幕常见宽度80% 的 JPEG 质量在清晰度和体积之间比较平衡单张图片一般能控制在 300KB 以内。如果图片尺寸过大上传等待时间长而且很多后端接口默认限制 2MB。由于 Bitmap 会占内存压缩前最好先通过BitmapFactory.Options.inSampleSize采样读取避免大图直接解码造成 OOM。如果相机拍照返回的也是content://Uri那就要在 AndroidManifest 里注册 FileProviderprovider android:nameandroidx.core.content.FileProvider android:authorities${applicationId}.fileprovider android:exportedfalse android:grantUriPermissionstrue meta-data android:nameandroid.support.FILE_PROVIDER_PATHS android:resourcexml/file_paths / /providerfile_paths里至少要配置cache-path否则相机写入应用私有缓存目录时系统会报Failed to find configured root。我一般会写成cache-path namehouse_images pathhouse_images/ /注意path不需要带斜杠开头否则部分厂商 ROM 上会匹配不到。4.3 上传进度条不推荐 ProgressDialog 写法以前很多人用ProgressDialog显示上传进度现在ProgressDialog在较新 API 上已经过时还会在旋转屏幕时泄漏窗口。我会用Dialog包一个只包含ProgressBar和文字状态的布局或者直接在页面底部使用LinearProgressIndicator。binding.progressIndicator.visibility View.VISIBLE viewModel.upload(payload, onProgress { percent - runOnUiThread { binding.tvProgress.text 已上传 $percent% binding.progressIndicator.progress percent } })上传模块的进度回调在子线程必须在runOnUiThread里更新 UI。如果直接操作进度条会抛CalledFromWrongThreadException。这个异常在毕业设计答辩现场十分常见评委一定会注意调试日志里是否出现这个关键词。上传使用 OkHttp 时需要写一个ProgressRequestBody包装文件流否则ProgressBar永远只会从 0 直接跳到 100class ProgressRequestBody( private val file: File, private val callback: (Float) - Unit ) : RequestBody() { override fun contentType(): MediaType image/jpeg.toMediaType() override fun contentLength(): Long file.length() override fun writeTo(sink: BufferedSink) { var uploaded 0L val bufferSize 8192 val buffer ByteArray(bufferSize) file.inputStream().use { input - var read: Int while (input.read(buffer).also { read it } ! -1) { sink.write(buffer, 0, read) uploaded read callback(uploaded * 1.0f / file.length()) } } } }这里的bufferSize用 8192 字节也就是 8KB是 OkHttp 写入网络的常见缓冲区大小。调太大容易占用内存调太小会让进度回调非常频繁。file.length()返回的是字节数所以在回调里除出来是 0 到 1 的浮点页面端再乘 100 显示百分比。发布成功后业务上还应该做一件事把本地房源状态改成“待审核”并清空发布页表单。我之前见过只提示“发布成功”列表里却仍然用旧缓存数据导致新发布的房源一直不显示的 bug。如果在 ViewModel 里用 Room 做本地缓存发布成功后要更新或重新查询rental_house表而不是依赖上一个页面传过来的旧对象。5. 签名打包与真机调试答辩前最容易扣分的四个坑5.1 生成签名文件与 Gradle 签名配置干净生成的 debug APK 可以直接安装但答辩前通常要出一个签名 release 包。生成签名文件用 Android Studio 菜单里的 Build Generate Signed Bundle / APK 向导也可以直接用命令行生成keytool -genkeypair -alias rent -keyalg RSA -keysize 2048 -validity 3650 -keystore rent.jks-validity 3650表示签名有效期 3650 天也就是约 10 年。如果填得太短比如 30 天应用在有效期结束后升级时会提示签名不匹配毕业设计打包后基本就废了。生成后把rent.jks复制到工程根目录下不要提交到 Git。Gradle 里按下面的方式配置签名注意不要直接明文写在仓库里本地演示可以这样signingConfigs { release { storeFile file(../rent.jks) storePassword 123456 keyAlias rent keyPassword 123456 } } buildTypes { release { signingConfig signingConfigs.release minifyEnabled true shrinkResources true proguardFiles getDefaultProguardFile(proguard-android-optimize.txt), proguard-rules.pro } }minifyEnabled true会移除未使用的代码shrinkResources true会移除未使用的资源。这两个开关对毕业设计影响不大但可以缩小 APK 体积。真正的风险是代码里通过反射调用的类会被移除所以如果接入了第三方 SDK需要观察 release 包运行时日志。5.2 targetSdk 与权限变化targetSdk高于 23 时危险权限必须在运行时动态申请高于 30 时旧的地点权限需要区分前台和后台高于 34 时部分隐式 Intent 会被限制。毕业设计不需要刻意追求最新但我建议targetSdk保持在 33 或 34不要为了省事降回 28因为新手机厂商在安装低 targetSdk 包时会给用户弹警告。另一个容易忽略的是android:exported。在 Android 12 及以上如果应用有带intent-filter的 Activity、Service 或 Receiver就必须显式设置android:exportedactivity android:name.MainActivity android:exportedtrue intent-filter action android:nameandroid.intent.action.MAIN / category android:nameandroid.intent.category.LAUNCHER / /intent-filter /activity主入口必须是exportedtrue否则桌面图标点击后无法启动。第三方登录或分享的回调页建议设置成exportedfalse避免被外部应用直接拉起。5.3 发布前自查清单打包前我一般会按下面几项过一遍每一项都能对应一个真实崩溃案例检查项验证方法新手机 Android 13 安装检查相册权限是否走 PhotoPicker杀进程后点击通知判断是否还持有已销毁的 Activity 引用后台时上传图片确认 Service 或 WorkManager 没有在子线程直接更新 UIrelease 包网络请求观察 JSON 返回字段是否被混淆改名为 a/b/c签名 APK 生成后建议用apkanalyzer或aapt dump badging看一眼版本号和权限列表然后装到一台没有开发环境的手机上做一轮主流程回归。把 release APK 装到真机后重点检查相册读取、发布表单、房源列表滑动三处确认没有闪退后再去打印答辩用的演示材料。本文还有配套的精品资源点击获取