CityPicker城市选择器:快速搭建Android省市区地址选择组件

发布时间:2026/8/22 14:53:29
CityPicker城市选择器:快速搭建Android省市区地址选择组件 CityPicker城市选择器快速搭建Android省市区地址选择组件【免费下载链接】citypickercitypicker城市选择器详细的省市区地址信息支持仿iOS滚轮实现仿京东样式一级或者三级列表展示方式。项目地址: https://gitcode.com/gh_mirrors/ci/citypickerCityPicker是一款面向Android应用的开源城市选择器组件内置省市区行政数据支持滚轮、京东样式、城市列表等多种展示形式。接入后无需再自行整理地址数据或手写三级联动逻辑适合需要收货地址、定位选区等页面的新手开发者。什么时候需要现成的城市选择组件开发Android应用时收货地址填写、门店所在城市、个人资料所在地这类页面几乎都会用到省市区选择。自己实现通常会遇到两个麻烦行政区域数据不好找且要自己整理成省、市、区对应的结构三级联动、滚动、默认值回显等交互逻辑要反复写项目之间只能复制粘贴。如果你不需要自己维护地址接口只想要一个拿来就能用的选择界面CityPicker可以帮你减少这部分重复工作。CityPicker能帮你做什么多种展示样式仿iOS滚轮、仿京东界面、仅显示城市的一级列表、省市区三级列表可按页面形态挑选数据开箱即用仓库assets目录下已内置全国省市区数据china_city_data.json引用后直接加载不用另配数据源属性可定制标题、默认省市、滚轮是否循环滚动、每列可见项数、字体颜色等都可以通过构建器调整支持自定义数据业务只涉及部分城市时可用自己的城市数据替代内置数据源上手成本低滚轮样式下初始化、配置、弹出选择器大约只需几行代码。CityPicker怎么引入在Project级别的build.gradle中先添加jitpack仓库allprojects { repositories { maven { url https://jitpack.io } } }再在App模块的build.gradle中添加依赖dependencies { implementation com.github.crazyandcoder:citypicker:6.0.2 }如果本地拉取仓库源码可以使用镜像地址git clone https://gitcode.com/gh_mirrors/ci/citypicker三步弹出城市滚轮以最常用的仿iOS滚轮为例核心流程只有三步初始化、配置、弹出。CityPickerView pickerView new CityPickerView(); pickView.init(this); // 需在Activity中提前调用 CityConfig config new CityConfig.Builder() .title(选择城市) .province(江苏).city(常州).district(新北区) .provinceCyclic(true).cityCyclic(true).districtCyclic(true) .build(); pickView.setConfig(config); pickView.setOnCityItemClickListener(new OnCityItemClickListener() { Override public void onSelected(ProvinceBean province, CityBean city, DistrictBean district) { // 在这里拿到省、市、区的名称和编码 } Override public void onCancel() {} }); pickView.showCityPicker();选中的省份、城市、区县会以ProvinceBean、CityBean、DistrictBean三个对象回调给你其中包含名称和行政区划编码可直接用于后续提交表单。自定义与使用注意事项调整层级滚轮可通过setCityWheelType切换只显示省、省加市或完整三级不同页面按需选择换用自有数据仿iOS样式支持传入自定义数据源适合只展示部分城市的场景仓库中的CityPickerCustomeDataActivity可作参考数据时效当前内置数据基于2018年的全国行政区划若你关注的地区有区划调整建议先核对再使用或切换到自定义数据方案混淆配置正式打包前请补充ProGuard保留规则具体条目可在仓库README中查看权限与兼容组件本身不申请定位权限纯UI选择遇到编译或运行问题先对照官方文档排查更省事。接下来可以看什么项目采用Apache 2.0许可可自由用于商业项目。仓库里的app模块是完整示例五种样式各对应一个Activity直接运行即可看到每种效果更多API细节和更新记录建议参考仓库README及作者的官方文档社区QQ群号417846442也写在README中遇到问题可以在群里交流。【免费下载链接】citypickercitypicker城市选择器详细的省市区地址信息支持仿iOS滚轮实现仿京东样式一级或者三级列表展示方式。项目地址: https://gitcode.com/gh_mirrors/ci/citypicker创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考