CityPicker:Android 省市区城市选择器搭建指南 📅 发布时间:2026/8/22 18:22:13 👁 浏览次数: CityPickerAndroid 省市区城市选择器搭建指南【免费下载链接】citypickercitypicker城市选择器详细的省市区地址信息支持仿iOS滚轮实现仿京东样式一级或者三级列表展示方式。项目地址: https://gitcode.com/gh_mirrors/ci/citypicker做 Android 应用需要省市区地址选择时常见做法无非两种从博客复制一套滚轮代码或者让后端提供省市区接口。都挺麻烦。CityPicker把全国省市区数据和几种现成的展示样式直接打进了库里加一行 gradle 依赖就能弹出城市选择。它能帮你解决什么问题CityPicker是一个面向 Android 应用的城市选择开源库。核心是一份内置的china_city_data.json数据基于国家县以上行政区划代码覆盖省、市、区三级不需要自己准备或请求数据。库内提供四种现成样式仿 iOS 三列滚轮、仿京东左右三列、一级城市列表带拼音索引、三级列表产品侧只要选个城市的需求基本可以拿来就用。快速开始集成路径和普通 jitpack 依赖一样项目级build.gradle中加入 jitpack 仓库地址然后在 app 模块添加依赖dependencies { implementation com.github.crazyandcoder:citypicker:6.0.2 }之后在 Activity 中创建对应样式的 PickerView如CityPickerView用CityConfig配置标题、默认值等属性通过setOnCityItemClickListener监听回调即可拿到选中结果。 四种样式各自的 API 细节仓库 README 和 wiki 有专门页面仓库里的app模块就是演示工程跑起来可以逐一体验每种样式。核心亮点四种样式仿 iOS 滚轮、仿京东样式、一级城市列表、三级列表按设计稿选用内置数据源自带全国省市区 JSON不用对接接口、不用自己维护行政区划数据自定义数据源业务只需要部分城市如可配送范围时可通过CustomCityData换成自己的数据拼音索引列表样式支持汉字转拼音排序和右侧索引条长列表也能快速定位展示属性可配标题文案、默认选中、可见项数、循环滚动、半透明背景等均可配置依赖轻量仅依赖 androidx、gson、recyclerview 等常见库最低支持 Android 5.0适合谁用电商、零售类 App 开发者收货地址填写、门店服务地选择滚轮样式贴合移动端主流交互本地生活、配送类 App 开发者按城市筛选内容或服务一级城市列表加拼音索引比三级滚轮更快社交、签到类 App 开发者用自定义数据源实现从业务支持的城市里选而不是全量行政区划常见问题数据是否最新数据源以国家县以上行政区划代码为基础V6.0.22021 年更新过一版数据并优化了汉字转拼音逻辑。若你需要的区划调整晚于库内数据可替换自定义数据源或等库更新。必须用全量数据吗不用。提供自定义数据源接口传入自己定义的城市列表即可UI 与全量模式一致。会不会有依赖冲突库只引入 gson、recyclerview 等常见依赖冲突概率低代码混淆的配置在 README 中有专门说明。CityPicker功能面不大但把城市选择这件事做得比较完整。如果你的 Android 应用需要省市区选择建议先看一遍app演示工程确认样式再通过 gradle 依赖集成API 细节以仓库 README 和 wiki 为准。作者另有一个专属 QQ 交流群集成中遇到问题可以直接去问。【免费下载链接】citypickercitypicker城市选择器详细的省市区地址信息支持仿iOS滚轮实现仿京东样式一级或者三级列表展示方式。项目地址: https://gitcode.com/gh_mirrors/ci/citypicker创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考