3 步搞定省市区联动:Android 城市选择器 CityPicker 快速上手 📅 发布时间:2026/8/22 10:19:12 👁 浏览次数: 3 步搞定省市区联动Android 城市选择器 CityPicker 快速上手【免费下载链接】citypickercitypicker城市选择器详细的省市区地址信息支持仿iOS滚轮实现仿京东样式一级或者三级列表展示方式。项目地址: https://gitcode.com/gh_mirrors/ci/citypicker地址页的省市区选择器换三个项目就抄了三次滚轮对不齐数据还得自己抓。CityPicker 省市区选择器是crazyandcoder封装的 Android 组件内置行政区划数据集成完直接弹出选择页。它到底解决了什么自己实现的话数据源、滚轮视图、拼音侧边栏、列表页各写一遍改个需求全得动。用了 CityPicker 省市区选择器这些数据文件和交互实现都是现成的你只挑样式、调配置。作者crazyandcoder把 2018 年 12 月的县以上行政区划数据打包进了 assets数据更新跟着 release 走不用自己找接口。核心能力速览能力一句话说明内置省市区数据基于 2018-12 县以上行政区划assets 自带 china_city_data.json不用另找数据源四套选择样式仿 iOS 滚轮、仿京东三级列表、一级城市列表、三级城市列表各对应独立入口样式与联动级别标题、可见行数、默认省市区、循环滚动、半透明背景、港澳台显隐、自定义 item 布局滚轮支持省/省市/省市区三档自定义数据源可换成 CustomCityData 驱动适配非行政区划的业务数据组件为 Android Library 模块citypickerviewJava 编写minSdkVersion 21。集成三步跑通 Android 城市选择器在项目 build.gradle 的 repositories 里加 jitpack 源allprojects { repositories { maven { url https://jitpack.io } } }在 app 模块声明依赖版本号与仓库 README 一致新 release 以仓库为准dependencies { implementation com.github.crazyandcoder:citypicker:6.0.2 }在 Activity 里初始化 CityPicker 省市区选择器设默认值后弹出最小示例参照 app 模块的 CitypickerWheelActivityCityPickerView cpv new CityPickerView(this); cpv.init(this); CityConfig config new CityConfig.Builder() .title(选择城市) .province(江苏).city(常州).district(新北区) .build(); cpv.setConfig(config); cpv.showCityPicker();哪些场景用得着电商 App 的收货地址页用户填地址时拨动三列滚轮直接锁到区县不用再手敲江苏省常州市新北区。本地服务类 App 的定位页用户从仿京东样式列表点选城市拼音首字母侧边栏让长列表也能秒跳。社交或表单类应用收集资料时个人所在地一按就出省市区联动选完回填省掉手动输入。技术栈 快速参考开发语言Java构建工具Gradle组件是 Android Library 模块 citypickerview平台要求minSdkVersion 21compileSdk / targetSdk 30数据文件citypickerview/src/main/assets/china_city_data.json完整示例app 模块的 5 个 Activity 对应 5 种样式入口README 里有各样式的用法说明LicenseApache 2.0见仓库 LICENSE 文件遇到问题去哪找答案优先翻仓库 Issue 区代码混淆、数据更新类的问题基本都有沉淀作者的 QQ 群 417846442 可以直接提问。想看源码或想把组件换成本地模块引用把仓库拉下来跑 app 模块最直接git clone https://gitcode.com/gh_mirrors/ci/citypicker先 clone 跑个 demo 再说别光收藏。【免费下载链接】citypickercitypicker城市选择器详细的省市区地址信息支持仿iOS滚轮实现仿京东样式一级或者三级列表展示方式。项目地址: https://gitcode.com/gh_mirrors/ci/citypicker创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考