CityPicker:3 行代码给 Android App 接上省市区三级联动选择器
2026/8/22 15:38:33 网站建设 项目流程

CityPicker:3 行代码给 Android App 接上省市区三级联动选择器

【免费下载链接】citypickercitypicker城市选择器,详细的省市区地址信息,支持仿iOS滚轮实现,仿京东样式,一级或者三级列表展示方式。项目地址: https://gitcode.com/gh_mirrors/ci/citypicker

CityPicker是开源作者crazyandcoder维护的 Android 省市区选择器组件,内置全国行政区划数据,专门解决三级联动选择器要自己造轮子的问题,适合想快速给 App 加地址、城市选择功能的新手和开发者。

为什么你需要一个省市区选择器

给 App 加收货地址页、做"选择城市"入口,省市区三级联动几乎必做。自己写的话,数据要自己找、要自己存,滚动交互和联动逻辑也要一套套搭起来,重复劳动不少。直接接入CityPicker这个现成的地址选择组件,把这些活儿都省了。

组件速览:内置数据,开箱即用

它用 Java 编写,核心就干一件事:把省市区 picker 封装好。当前版本6.0.2已把数据源更新为最新省市区行政数据,并优化了汉字转拼音的精度。

  • 内置行政区划数据 → 你不用自己下载、维护一份 CSV
  • 4 种展示样式(iOS 滚轮、京东列表、一级/三级城市列表)→ 按你的 UI 风格挑一个就行
  • 支持自定义数据源 → 公司有接口发地址数据时,可以直接换成自己的
  • 字体、颜色、背景等属性可调 → 界面跟你 App 的视觉风格对齐
  • 几行代码完成集成 → 接入成本低,不容易踩坑

如何 3 行代码接入 CityPicker

第 1 步,Project 级build.gradle加上 jitpack 仓库:

allprojects { repositories { maven { url 'https://jitpack.io' } } }

第 2 步,app 模块的build.gradle加入依赖:

implementation 'com.github.crazyandcoder:citypicker:6.0.2'

第 3 步,在 Activity 里 new 一个CityPickerView,设置好选中回调并弹出,三级联动就有了。

适合哪些业务场景

  • 电商:订单页填收货地址,用户逐级点选省市区
  • 本地服务:让用户快速定位到自己所在的区县
  • 社交应用:个人资料里选个所在城市
  • 数据分析:收集用户地域信息,做区域统计

样式与 UI 能改到什么程度

展示样式可在iOS 风格滚轮京东风格列表、一级城市列表和三级城市列表之间切换;数据源也能换成你自己的接口数据;字体大小、文字颜色、背景这些 UI 属性都提供自定义属性,想调整界面细节不用动源码。

动手试试

项目里附带示例工程和 wiki 文档,照着跑一遍就知道效果;有问题还可以进作者开的 QQ 交流群(417846442)提问。需要省市区三级联动的 App,3 行代码就能接上,值得先试一次。

【免费下载链接】citypickercitypicker城市选择器,详细的省市区地址信息,支持仿iOS滚轮实现,仿京东样式,一级或者三级列表展示方式。项目地址: https://gitcode.com/gh_mirrors/ci/citypicker

创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询