类大众点评APP源码解析：从零跑通本地生活服务客户端

简介这是一份面向安卓开发学习者与进阶者的类大众点评APP源程序基于Java语言与Eclipse开发环境构建适合希望理解生活服务类应用完整实现思路的开发者参考。资源包共245个文件约966KB包含101个png界面素材、67个xml布局与配置、50个class编译文件、18个java源码以及apk安装包、db数据库、properties配置等覆盖UI设计、数据管理、网络通信、异步线程、权限管理、地图定位、图片加载、评分评论、推送与支付集成等模块。已有634人学习下载。通过研读源码读者可掌握LinearLayout、RecyclerView等布局组件的实际运用SQLite与SharedPreferences的本地持久化方案HttpURLConnection或OkHttp、Retrofit配合Gson的请求解析链路以及AsyncTask、Handler等线程调度技巧从而建立从界面交互到后端数据获取的完整安卓项目认知提升实际开发与调试能力。1. 类大众点评APP源程序从零跑通一套本地生活服务客户端如果你手头正好有一套类大众点评的安卓源程序第一反应大概率不是“这界面挺像”而是“它到底能不能跑起来、数据从哪来、我能不能改成自己想要的”。这套源码的定位很明确一个覆盖商户列表、详情页、评价体系、定位附近、搜索筛选的本地生活服务客户端适合想学安卓完整业务流、想做垂直领域比如只做某类餐饮或某类服务二次开发的开发者。它把“附近有什么店、这家店怎么样、别人怎么评价”这条主线用安卓原生方式串了起来技术栈通常围绕 Java/Kotlin Retrofit/OkHttp RecyclerView 高德或百度定位 SDK 展开。拿到源码后最该先确认的是它有没有把服务端接口地址、地图 Key、图片加载库这三处配置暴露出来这决定了你是能十分钟跑通还是卡在启动页看日志。2. 工程结构与技术选型先看清模块边界再动手2.1 目录层级与职责划分拿到源码别急着点运行先把目录翻一遍。类大众点评这类项目结构上一般会按“页面 数据 工具”三层来切常见做法是app/ ├── src/main/java/com/example/dianping/ │ ├── ui/ # 页面层Activity、Fragment、Adapter │ │ ├── home/ # 首页商户列表 │ │ ├── detail/ # 商户详情 │ │ ├── review/ # 评价发布与列表 │ │ └── search/ # 搜索与筛选 │ ├── data/ # 数据层接口定义、仓库、本地缓存 │ │ ├── api/ # Retrofit 接口 │ │ ├── model/ # 实体类 │ │ └── repository/ # 数据仓库统一收口网络与缓存 │ ├── util/ # 定位、图片、时间格式化等工具 │ └── widget/ # 自定义控件比如评分条、筛选栏 └── src/main/res/ ├── layout/ # 页面布局 ├── drawable/ # 图标与背景 └── values/ # 颜色、字符串、主题这个划分不是摆设。ui层只负责展示和交互data层负责“从哪拿数据”util层负责“怎么把定位和图片处理好”。二次开发时你改得最多的是ui和data/api而util里的定位和图片加载通常只需要换 Key 和换库。如果源码里把网络请求直接写在 Activity 里那说明它是个偏 Demo 的写法改造时要先把请求抽到 repository否则后面加缓存、加登录态会非常痛苦。2.2 技术栈与依赖清单这类项目的依赖通常集中在app/build.gradle里核心几项跑不掉dependencies { // 网络请求Retrofit OkHttp Gson implementation com.squareup.retrofit2:retrofit:2.9.0 implementation com.squareup.retrofit2:converter-gson:2.9.0 implementation com.squareup.okhttp3:logging-interceptor:4.9.3 // 图片加载Glide 或 Coil implementation com.github.bumptech.glide:glide:4.12.0 // 列表与卡片RecyclerView CardView implementation androidx.recyclerview:recyclerview:1.2.1 implementation androidx.cardview:cardview:1.0.0 // 定位高德或百度二选一 implementation com.amap.api:location:5.2.0 // 下拉刷新 implementation androidx.swiperefreshlayout:swiperefreshlayout:1.1.0 }这里有几个点值得注意。Retrofit 的converter-gson决定了接口返回的 JSON 能不能自动转成实体类如果服务端字段名和实体类对不上就要么改实体类加SerializedName要么让服务端改字段。Glide 负责商户封面图的加载和缓存换 Coil 也能跑但要注意 Coil 默认用 Kotlin 协程Java 项目里替换成本略高。定位 SDK 是这类项目的“玄学重灾区”模拟器上经常定位不到真机又要动态申请权限后面避坑章节会细说。2.3 数据流一个商户列表是怎么出来的以首页商户列表为例完整链路是Activity 发起请求 → Repository 调 Retrofit 接口 → 拿到 JSON → Gson 转成Shop列表 → Adapter 绑定到 RecyclerView。核心代码通常长这样// HomeActivity.java 中触发加载 private void loadNearbyShops(double lat, double lng, int page) { // 通过 Repository 统一收口不直接在 Activity 里调 Retrofit shopRepository.getNearbyShops(lat, lng, page, new CallbackListShop() { Override public void onSuccess(ListShop shops) { // 第一页替换后续页追加 if (page 1) { adapter.setData(shops); } else { adapter.addData(shops); } swipeRefresh.setRefreshing(false); } Override public void onFailure(String msg) { Toast.makeText(HomeActivity.this, 加载失败 msg, Toast.LENGTH_SHORT).show(); swipeRefresh.setRefreshing(false); } }); }这段代码的关键在参数lat和lng来自定位回调page控制分页。onSuccess里区分第一页和后续页是为了避免下拉刷新时把旧数据冲掉。onFailure里一定要关掉刷新动画否则用户会看到转圈停不下来。很多新手改这里时容易犯一个错把page写死成 1结果上拉加载永远加载同一批数据看起来像“加载了但没变化”。3. 跑起来环境配置与首次启动的完整步骤3.1 环境准备与依赖同步先把 Android Studio 和 JDK 版本对齐。这类项目多数用 JDK 8 或 JDK 11 编译Gradle 版本在gradle-wrapper.properties里写死。常见做法是直接用 Android Studio 打开根目录等它自动同步 Gradle。如果同步失败先看报错是“找不到依赖”还是“JDK 版本不匹配”。前者多半是仓库地址问题在build.gradle里补上maven { url https://maven.aliyun.com/repository/public }这类镜像后者就在File → Project Structure里把 JDK 换成项目要求的版本。同步完成后检查local.properties里有没有sdk.dir没有就手动指向本机 Android SDK 路径。这一步不做编译会直接报“SDK location not found”。3.2 三处必须改的配置源码里通常有三处配置是留空的不改就跑不通// 1. 接口地址data/api/ApiConfig.java public static final String BASE_URL https://your-server.com/api/; // 2. 地图 KeyAndroidManifest.xml 里 meta-data android:namecom.amap.api.v2.apikey android:value你的高德Key / // 3. 图片占位与缓存路径util/ImageLoader.java public static final int PLACEHOLDER R.drawable.ic_shop_placeholder;BASE_URL必须以/结尾否则 Retrofit 拼接路径时会丢字段。地图 Key 要和AndroidManifest.xml里的包名一致不一致定位会返回错误码。图片占位图如果源码里没带就自己放一张到drawable里否则列表滑动时会出现白块。3.3 首次启动与权限处理装到真机后第一次打开会弹定位权限和存储权限。安卓 6.0 以上必须动态申请源码里一般会在HomeActivity的onCreate里调requestPermissions。如果没弹窗就去AndroidManifest.xml确认有没有声明ACCESS_FINE_LOCATION和READ_EXTERNAL_STORAGE。启动后如果首页一直空白按这个顺序排查先看 Logcat 有没有网络请求日志再看接口返回是不是 404最后看定位回调有没有拿到经纬度。定位没拿到时很多项目会默认用“城市中心点”兜底如果源码没写兜底逻辑就会一直转圈。我一般会在定位回调失败时手动塞一个默认经纬度保证列表能先出来。4. 核心模块拆解商户详情、评价与搜索筛选4.1 商户详情页的数据组装详情页比列表页复杂因为它要同时拿商户基本信息、评价列表、可能还有团购或优惠信息。常见做法是用一个DetailViewModel或DetailPresenter并发请求多个接口等全部回来再统一渲染// DetailPresenter.java public void loadDetail(String shopId) { // 并发请求基本信息 评价列表 api.getShopInfo(shopId).enqueue(shopCallback); api.getReviews(shopId, 1).enqueue(reviewCallback); } private CallbackShopInfo shopCallback new CallbackShopInfo() { Override public void onSuccess(ShopInfo info) { // 先渲染头部名称、评分、地址、电话 view.renderHeader(info); // 如果评价还没回来先显示骨架屏 if (!reviewLoaded) { view.showReviewSkeleton(); } } };这里的关键是“谁先回来谁先渲染”。如果等两个接口都回来再渲染用户会盯着白屏好几秒。评价列表单独用reviewLoaded标记避免头部渲染完但评价区还是空的。参数shopId从列表页通过 Intent 传过来传的时候注意别传整个对象传 ID 就够了否则序列化开销大。4.2 评价发布与图片上传评价模块是这类项目的“灵魂”也是最容易翻车的地方。发布评价通常要处理文字、评分、图片三样东西。图片上传一般走MultipartBody// ReviewRepository.java public void publishReview(String shopId, String content, float rating, ListFile images) { MultipartBody.Builder builder new MultipartBody.Builder() .setType(MultipartBody.FORM) .addFormDataPart(shopId, shopId) .addFormDataPart(content, content) .addFormDataPart(rating, String.valueOf(rating)); // 多张图片逐个添加 for (int i 0; i images.size(); i) { File file images.get(i); RequestBody body RequestBody.create(MediaType.parse(image/*), file); builder.addFormDataPart(image i, file.getName(), body); } api.publishReview(builder.build()).enqueue(callback); }参数说明shopId和content是普通表单字段rating转成字符串传图片用image0、image1这种下标命名服务端按顺序接收。注意MediaType.parse(image/*)要和服务端约定好有的服务端只认image/jpeg传错会返回 415。图片上传前最好压缩一下否则一张原图几 MB传三张就超时。4.3 搜索与筛选的本地实现搜索筛选通常有两种做法一种是每次改条件都请求服务端另一种是本地过滤已加载的数据。类大众点评这种场景常见做法是“关键词走服务端筛选条件走本地”// SearchActivity.java private void applyFilter() { String keyword etKeyword.getText().toString().trim(); int sortType rbSort.getCheckedRadioButtonId(); // 综合/距离/评分 if (!keyword.isEmpty()) { // 关键词变化重新请求服务端 searchRepository.search(keyword, sortType, page, callback); } else { // 只改排序本地重排 ListShop sorted SortUtil.sort(currentList, sortType); adapter.setData(sorted); } }sortType对应综合排序、距离最近、评分最高三种。本地重排的好处是响应快不用等网络。但要注意如果当前列表只有第一页数据本地排序结果可能不是全局最优这时候要么提示用户“加载更多后再排序”要么直接走服务端。5. 避坑与常见问题定位、图片、接口联调5.1 定位一直返回失败现象真机上打开首页列表不加载Logcat 里定位回调报errorCode12或类似错误。原因通常是地图 Key 和包名不匹配或者没在AndroidManifest.xml里声明定位 Service。解决先确认 Key 申请时填的包名和applicationId完全一致再检查有没有漏掉com.amap.api.location.APSService的声明。模拟器上定位失败是常态直接换真机测。5.2 图片加载出来是白块现象列表滑动时封面图位置一片白或者只显示占位图。原因多半是图片 URL 是相对路径而源码里没拼上BASE_URL。解决在 Adapter 绑定图片时判断 URL 是否以http开头不是就手动拼上域名。另外检查 Glide 有没有申请网络权限INTERNET权限漏了也会白块。5.3 接口返回 200 但列表是空的现象Logcat 显示请求成功但页面没数据。原因通常是 JSON 字段名和实体类对不上Gson 解析后字段全是 null。解决把接口返回的原始 JSON 打出来和实体类字段逐个比对对不上的加SerializedName(服务端字段名)。还有一种可能是服务端返回的数据包在data字段里而实体类直接按根对象解析这时候要加一层包装类。5.4 上拉加载重复数据现象滑到底部加载更多新数据和旧数据重复。原因一般是分页参数没递增或者服务端分页从 0 开始而客户端从 1 开始。解决在 Repository 里维护一个currentPage每次加载成功后currentPage加载失败时不递增。同时确认服务端分页起始值两边对齐。5.5 评价发布后详情页不刷新现象发布评价成功返回详情页还是旧列表。原因通常是详情页没有在onResume里重新拉数据或者用了缓存没失效。解决在发布成功后设置一个needRefresh标记详情页onResume时检查标记并重新请求。简单粗暴一点直接在发布成功后finish掉发布页回到详情页时强制刷新。6. 二次开发换领域、接后端与性能优化的实操思路拿到这套源码二次开发的方向通常有三个换垂直领域、接自己的后端、做性能优化。换领域最省事改文案、改图标、改分类字段就行比如把“美食”改成“健身”把“人均消费”改成“课时费”。接自己后端要动data/api里的接口定义和model里的实体类建议先写一个ApiConfig统一管理路径再把每个接口的请求参数和返回结构对照文档改一遍。性能优化优先做图片压缩和列表复用Glide 加override(300, 300)限制解码尺寸RecyclerView 的setHasFixedSize(true)和RecyclerView.RecycledViewPool能明显减少滑动卡顿。验证改造是否成功我一般会走一遍“冷启动 → 定位 → 列表 → 详情 → 评价 → 返回”的完整链路每一步都看 Logcat 有没有异常。如果只测单个页面很容易漏掉页面间传参和状态恢复的问题。另外改完接口后一定要用 Postman 或 curl 先验证服务端返回再回客户端调否则两边一起改出了问题根本分不清是谁的锅。从那以后我每次拿到新源码都强制先跑一遍“最小闭环”——只保留首页列表和详情页把评价、搜索、发布全注释掉确认网络和定位通了再逐步放开。这样能把问题范围缩到最小不至于一上来就被一堆报错淹没。希望帮到你。本文还有配套的精品资源点击获取