简介：这是一份面向安卓开发学习者与进阶者的类大众点评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 Callback<List<Shop>>() { @Override public void onSuccess(List<Shop> 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. 地图 Key：AndroidManifest.xml 里 <meta-data android:name="com.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 Callback<ShopInfo> shopCallback = new Callback<ShopInfo>() { @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, List<File> 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 { // 只改排序，本地重排 List<Shop> sorted = SortUtil.sort(currentList, sortType); adapter.setData(sorted); } }sortType对应综合排序、距离最近、评分最高三种。本地重排的好处是响应快，不用等网络。但要注意，如果当前列表只有第一页数据，本地排序结果可能不是全局最优，这时候要么提示用户“加载更多后再排序”，要么直接走服务端。
5. 避坑与常见问题：定位、图片、接口联调
5.1 定位一直返回失败
现象：真机上打开首页，列表不加载，Logcat 里定位回调报errorCode=12或类似错误。原因通常是地图 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 先验证服务端返回，再回客户端调，否则两边一起改，出了问题根本分不清是谁的锅。
从那以后我每次拿到新源码，都强制先跑一遍“最小闭环”——只保留首页列表和详情页，把评价、搜索、发布全注释掉，确认网络和定位通了再逐步放开。这样能把问题范围缩到最小，不至于一上来就被一堆报错淹没。希望帮到你。
本文还有配套的精品资源，点击获取
