5 分钟跑通 CityPickerAndroid 省市区三级联动选择完整集成教程【免费下载链接】citypickercitypicker城市选择器详细的省市区地址信息支持仿iOS滚轮实现仿京东样式一级或者三级列表展示方式。项目地址: https://gitcode.com/gh_mirrors/ci/citypicker你在做电商或物流 App 时是不是遇到过这样的场景地址选择要省、市、区三级联动后端又没给接口只能自己造数据、造界面CityPicker 是一款轻量级的 Android 城市选择库内置省市区数据源几行代码就能用起来。它支持仿 iOS 滚轮、仿京东样式、一级城市列表、三级城市列表四种展示方式。⏱ 三步跑通 CityPicker 滚轮第 1 步加仓库源。在 Project 级 build.gradle 里加 jitpackallprojects { repositories { maven { url https://jitpack.io } } }第 2 步加依赖。app 模块 build.gradle 里加一行6.0.2 是最新版本implementation com.github.crazyandcoder:citypicker:6.0.2第 3 步调用滚轮选择。核心代码不到 20 行CityPickerView cityPickerView new CityPickerView(); cityPickerView.init(this); CityConfig cityConfig new CityConfig.Builder() .title(选择城市) .province(江苏) .city(常州) .district(新北区) .build(); cityPickerView.setConfig(cityConfig); cityPickerView.setOnCityItemClickListener(new OnCityItemClickListener() { Override public void onSelected(ProvinceBean province, CityBean city, DistrictBean district) { // 这里拿到选中的省、市、区 } Override public void onCancel() { } }); cityPickerView.showCityPicker();跑起来会弹出一个滚轮默认选中定位在江苏、常州、新北区。 进阶玩法换联动级别和样式自由切换联动级别给 Builder 传 WheelType就只展示对应的级数。只要省用PRO只要省市用PRO_CITYCityConfig cityConfig new CityConfig.Builder() .setCityWheelType(CityConfig.WheelType.PRO_CITY) .build();换仿京东样式类名换成 JDCityPicker布局变成左右两栏的省市列表。配置同样是 Builder用 ShowType 控制是否带区级JDCityPicker jdPicker new JDCityPicker(); jdPicker.init(this); jdPicker.setConfig(new JDCityConfig.Builder().build());用自己的数据源内置区划不满足业务时用 CustomCityPicker 传自己的 CustomCityData 列表滚轮里就只剩你的数据。⚠️ CityPicker 避坑清单4 个常见问题首次打开卡顿库在 init 时解析内置城市数据。选择器对象在 onCreate 里建一次、全页复用别在点击事件里反复 new。新合并的区县选不到数据源是 2018 年 12 月行政区划之后新设的区县不会更新。需要最新区划就用 CustomCityPicker 喂自己的数据。混淆后 release 包崩溃库内部有反射调用ProGuard 必须加对应的 keep 规则否则线上直接炸。结果里混进港澳台滚轮默认包含港澳台数据业务不需要的地方加.setShowGAT(false)就能隐藏。 延伸资源示例工程与源码位置示例工程app模块每种样式一个演示页参数可实时调整核心库源码citypickerview模块内置城市数据文件citypickerview/src/main/assets/china_city_data.json项目说明与更新记录README.md把滚轮搬进你自己的工程地址选择这块就算齐活了。【免费下载链接】citypickercitypicker城市选择器详细的省市区地址信息支持仿iOS滚轮实现仿京东样式一级或者三级列表展示方式。项目地址: https://gitcode.com/gh_mirrors/ci/citypicker创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考