Android 省市区三级联动城市选择器 CityPicker 完整集成指南

📅 2026/8/22 13:53:34
Android 省市区三级联动城市选择器 CityPicker 完整集成指南
Android 省市区三级联动城市选择器 CityPicker 完整集成指南【免费下载链接】citypickercitypicker城市选择器详细的省市区地址信息支持仿iOS滚轮实现仿京东样式一级或者三级列表展示方式。项目地址: https://gitcode.com/gh_mirrors/ci/citypicker每个 App 几乎都要做收货地址省市区三级联动地址选择往往是复制粘贴来的数据源还要自己维护。开源组件 CityPicker 省市区城市选择器把这个环节做成了开箱即用的方案。这个组件解决什么问题省市区选择通常要自己管行政数据、自己画滚轮和列表费时且容易出错。CityPicker 由开发者 crazyandcoder 封装内置最新省市区行政数据直接引入即可弹出选择器最大卖点是四种样式一套库搞定——仿iOS滚轮、仿京东样式、一级城市列表、三级城市列表还允许你换成自己的数据源。技术实现与核心能力纯 Java 实现基于 Gradle 多模块工程citypickerview是核心选择器库app是可运行的样式演示lib_citydata是配套的数据解析工具。省市区数据内置在 assets 的china_city_data.json中随库打包不依赖网络接口离线可用。滚轮WheelView为组件内自绘控件不额外引入第三方 UI 依赖体积轻、方便混淆。列表样式内置汉字转拼音逻辑按首字母排序、侧边栏快速跳字精度经过优化。CityPicker 支持哪些选择样式仿iOS滚轮底部弹出三列滚轮可配标题、循环滚动、可见行数、默认选中省市。仿京东样式左栏省份列表 右栏城市列表两级页面切换。一级城市列表只显示省级列表适合只选到大区/省份的场景。三级城市列表省→市→区逐页跳转每页带字母索引。四种样式共用回调接口返回的省市区对象带名称和行政区划 ID可直接入库。如何引入 CityPicker第一步在 Project 的build.gradle中添加 jitpack 仓库allprojects { repositories { maven { url https://jitpack.io } } }第二步在 app 的build.gradle中添加依赖implementation com.github.crazyandcoder:citypicker:6.0.2CityPicker 使用示例代码以仿iOS滚轮为例配置、监听、显示三步完成CityConfig config new CityConfig.Builder() .title(选择城市) .province(江苏).city(常州).district(新北区) .build(); CityPickerView view new CityPickerView(); view.setConfig(config); view.setOnCityItemClickListener(new OnCityItemClickListener() { Override public void onSelected(ProvinceBean p, CityBean c, DistrictBean d) { // 拿到省市区名称与行政区划ID } }); view.showCityPicker();字体大小、颜色、标题背景、自定义 item 布局等均可通过 Builder 链式配置不用改源码。适用场景哪里需要省市区选择电商订单页用户填写收货地址时选省市区。本地生活服务外卖、家政、同城配送按区域过滤和定价。社交与简历类应用个人资料中填写城市所在地。保险与物流下单按用户地址计算费率或运费。数据统计采集用户地域分布用于运营分析。数据更新、文档与社区支持组件会随版本更新行政数据6.0.2 已使用最新省市区数据并优化汉字转拼音逻辑并支持港澳台数据开关。官方 wiki 提供每种样式的接入教程和代码混淆方案app模块本身就是完整示例工程。项目基于 Apache 2.0 协议开源作者维护专属 QQ 群417846442答疑。省市区选择这块交给 CityPicker 就好。【免费下载链接】citypickercitypicker城市选择器详细的省市区地址信息支持仿iOS滚轮实现仿京东样式一级或者三级列表展示方式。项目地址: https://gitcode.com/gh_mirrors/ci/citypicker创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考