# AndroidPicker

**Repository Path**: wenhao555/AndroidPicker

## Basic Information

- **Project Name**: AndroidPicker
- **Description**: 安卓选择器类库，包括日期及时间选择器（可用于出生日期、营业时间等）、单项选择器（可用于性别、民族、职业、学历、星座等）、二三级联动选择器（可用于车牌号、基金定投日期等）、城市地址选择器（分省级、地市级及区县级）、数字选择器（可用于年龄、身高、体重、温度等）、日历选日期择器（可用于酒店及机票预定日期）、颜色选择器、文件及目录选择器、图片选择器等……
- **Primary Language**: Android
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: https://github.com/gzu-liyujiang/AndroidPicker
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 203
- **Created**: 2021-08-06
- **Last Updated**: 2021-08-06

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# AndroidPicker

[![API 19+](https://img.shields.io/badge/API-19%2B-green.svg)](https://github.com/gzu-liyujiang/AndroidPicker)
![Release APK](https://github.com/gzu-liyujiang/AndroidPicker/workflows/Release%20APK/badge.svg)

安卓选择器类库，包括日期及时间选择器（可用于出生日期、营业时间等）、单项选择器（可用于性别、民族、职业、学历、星座等）、二三级联动选择器（可用于车牌号、基金定投日期等）、城市地址选择器（分省级、地市级及区县级）、数字选择器（可用于年龄、身高、体重、温度等）、日历选日期择器（可用于酒店及机票预定日期）、颜色选择器、文件及目录选择器等……

欢迎大伙儿在[Issues](https://github.com/gzu-liyujiang/AndroidPicker/issues)提交你的意见或建议。欢迎 Fork & Pull requests 贡献您的代码，大家共同学习【[AndroidPicker 交流群 604235437](https://jq.qq.com/?_wv=1027&k=42bKOeD)】。

- GitHub：https://github.com/gzu-liyujiang/AndroidPicker
- 码云(GitEE)：https://gitee.com/li_yu_jiang/AndroidPicker

## 接入指引

最新版本：[![jitpack](https://jitpack.io/v/gzu-liyujiang/AndroidPicker.svg)](https://jitpack.io/#gzu-liyujiang/AndroidPicker) （[更新日志](/ChangeLog.md)）

### 注意事项

- 3.0.0 开始完全重构了底层代码，改进了性能，对 XML 布局更友好， 3.x 版本 的 API 和 1.x 及 2.x 版本的不大一样，**请谨慎升级**。
- [1.x Support 版本封存分支](https://github.com/gzu-liyujiang/AndroidPicker/tree/1.x-support)
- [2.0 androidx 版本封存分支](https://github.com/gzu-liyujiang/AndroidPicker/tree/2.0-androidx)

### 依赖配置

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

所有选择器的基础窗体：

```groovy
dependencies {
   implementation 'com.github.gzu-liyujiang.AndroidPicker:Common:<version>'
}
```

滚轮选择器的滚轮控件：

```groovy
dependencies {
   implementation 'com.github.gzu-liyujiang.AndroidPicker:WheelView:<version>'
}
```

单项/数字、二三级联动、日期/时间等滚轮选择器：

```groovy
dependencies {
    implementation 'com.github.gzu-liyujiang.AndroidPicker:WheelPicker:<version>'
}
```

省市区地址选择器：

```groovy
dependencies {
    implementation 'com.github.gzu-liyujiang.AndroidPicker:AddressPicker:<version>'
}
```

文件/目录选择器：

```groovy
dependencies {
    implementation 'com.github.gzu-liyujiang.AndroidPicker:FilePicker:<version>'
}
```

颜色选择器：

```groovy
dependencies {
    implementation 'com.github.gzu-liyujiang.AndroidPicker:ColorPicker:<version>'
}
```

日历日期选择器：

```groovy
dependencies {
    implementation 'com.github.gzu-liyujiang.AndroidPicker:CalendarPicker:<version>'
}
```

图片选择器（[README.md](/ImagePicker/README.md)）：

```groovy
dependencies {
    implementation 'com.github.gzu-liyujiang.AndroidPicker:ImagePicker:<version>'
}
```

旧版本 **AndroidX 稳定版本**：

```groovy
dependencies {
    implementation 'com.github.gzu-liyujiang.AndroidPicker:Common:2.0.0'
    implementation 'com.github.gzu-liyujiang.AndroidPicker:WheelPicker:2.0.0'
    implementation 'com.github.gzu-liyujiang.AndroidPicker:FilePicker:2.0.0'
    implementation 'com.github.gzu-liyujiang.AndroidPicker:ColorPicker:2.0.0'
}
```

旧版本 **Support 稳定版本**：

```groovy
dependencies {
    implementation 'com.github.gzu-liyujiang.AndroidPicker:Common:1.5.6.20181018'
    implementation 'com.github.gzu-liyujiang.AndroidPicker:WheelPicker:1.5.6.20181018'
    implementation 'com.github.gzu-liyujiang.AndroidPicker:FilePicker:1.5.6.20181018'
    implementation 'com.github.gzu-liyujiang.AndroidPicker:ColorPicker:1.5.6.20181018'
}
```

代码同时托管在`GitHub`及`GitEE`，因此`3.x及以上版本`的依赖项也可以将`com.github.gzu-liyujiang`换成`com.gitee.li_yu_jiang`，即：

```groovy
    implementation 'com.gitee.li_yu_jiang.AndroidPicker:Common:<version>'
    implementation 'com.gitee.li_yu_jiang.AndroidPicker:WheelView:<version>'
    implementation 'com.gitee.li_yu_jiang.AndroidPicker:WheelPicker:<version>'
    implementation 'com.gitee.li_yu_jiang.AndroidPicker:AddressPicker:<version>'
    implementation 'com.gitee.li_yu_jiang.AndroidPicker:ColorPicker:<version>'
    implementation 'com.gitee.li_yu_jiang.AndroidPicker:FilePicker:<version>'
    implementation 'com.gitee.li_yu_jiang.AndroidPicker:CalendarPicker:<version>'
    implementation 'com.gitee.li_yu_jiang.AndroidPicker:ImagePicker:<version>'
```

## 混淆规则

项目库混淆无需额外配置。

## 用法示例

常见用法请参阅 [demo](/app)，高级用法请细读[源码](/WheelPicker)。代码是最好的老师，强烈建议拉取代码运行，尝试修改 demo 对比查看实际效果以便加深理解。

### 在 Java 中

```groovy
        OptionPicker picker = new OptionPicker(this);
        picker.setBackgroundColor(true, 0xFFFFFFFF);
        picker.setData("测试", "很长很长很长很长很长很长很长很长很长很长很长很长很长很长");
        picker.setOnOptionPickedListener(this);
        picker.getTitleView().setText("这是标题");
        picker.getWheelView().setCyclicEnabled(true);
        picker.getWheelView().setCurvedEnabled(true);
        picker.getWheelView().setCurvedMaxAngle(60);
        picker.show();
```

```groovy
        DatePicker picker = new DatePicker(this);
        picker.setOnDatePickedListener(this);
        picker.setBodyWidth(240);
        picker.setBackgroundColor(0xEEDDDDDD);
        picker.getHeaderView().setBackgroundColor(0xFFCCCCCC);
        DateWheelLayout wheelLayout = picker.getWheelLayout();
        wheelLayout.setDateMode(DateMode.YEAR_MONTH_DAY);
        wheelLayout.setDateLabel("年", "月", "日");
        wheelLayout.setRange(DateEntity.today(), DateEntity.yearOnFuture(30), DateEntity.yearOnFuture(10));
        //wheelLayout.setRange(DateEntity.target(1930, 1, 1), DateEntity.today(), DateEntity.target(1999, 1, 1));
        wheelLayout.setCurtainEnabled(true);
        wheelLayout.setCurtainColor(0xFFCC0000);
        wheelLayout.setIndicatorEnabled(true);
        wheelLayout.setIndicatorColor(0xFFFF0000);
        wheelLayout.setIndicatorSize(view.getResources().getDisplayMetrics().density * 2);
        wheelLayout.setTextColor(0xCCCC0000);
        wheelLayout.setSelectedTextColor(0xFF00FF00);
        wheelLayout.getYearWheelView().setBackgroundColor(0x90CCCCCC);
        wheelLayout.getMonthWheelView().setBackgroundColor(0x90CCCCCC);
        wheelLayout.getDayWheelView().setBackgroundColor(0x90CCCCCC);
        picker.show();
```

```groovy
        AddressPicker picker = new AddressPicker(this);
        picker.setAddressMode(AddressMode.PROVINCE_CITY_COUNTY);
        picker.setDefaultValue("贵州省", "贵阳市", "观山湖区");
        picker.setOnAddressPickedListener(this);
        picker.show();
```

### 在 XML 中

```xml
            <com.github.gzuliyujiang.wheelview.widget.WheelView
                android:id="@+id/wheel_view"
                android:layout_width="117dp"
                android:layout_height="wrap_content"
                android:layout_gravity="center_horizontal"
                app:wheel_atmosphericEnabled="true"
                app:wheel_curvedEnabled="true"
                app:wheel_curvedIndicatorSpace="4dp"
                app:wheel_curvedMaxAngle="60"
                app:wheel_indicatorColor="#FF0081FF"
                app:wheel_itemSpace="50dp"
                app:wheel_itemTextColor="#FF474747"
                app:wheel_itemTextColorSelected="#FF0081FF"
                app:wheel_itemTextSize="20sp" />
```
```xml
        <LinearLayout
            android:layout_width="match_parent"
            android:layout_height="wrap_content"
            android:orientation="vertical">

            <com.github.gzuliyujiang.wheelpicker.widget.OptionWheelLayout
                android:id="@+id/wheel_option"
                android:layout_width="90dp"
                android:layout_height="150dp"
                android:layout_gravity="center_horizontal"
                app:wheel_itemTextAlign="center" />

            <com.github.gzuliyujiang.wheelpicker.widget.LinkageWheelLayout
                android:id="@+id/wheel_linkage"
                android:layout_width="match_parent"
                android:layout_height="150dp"
                app:wheel_curtainColor="#FFF1F1F1"
                app:wheel_curtainEnabled="true"
                app:wheel_indicatorEnabled="false" />

            <com.github.gzuliyujiang.wheelpicker.widget.NumberWheelLayout
                android:layout_width="90dp"
                android:layout_height="150dp"
                android:layout_gravity="center_horizontal"
                app:wheel_label="个"
                app:wheel_maxNumber="30"
                app:wheel_minNumber="10"
                app:wheel_stepNumber="5"
                app:wheel_visibleItemCount="7" />

            <com.github.gzuliyujiang.wheelpicker.widget.DatimeWheelLayout
                android:layout_width="match_parent"
                android:layout_height="150dp"
                app:wheel_dateMode="year_month_day"
                app:wheel_timeMode="hour_12_no_second" />

            <com.github.gzuliyujiang.wheelpicker.widget.DateWheelLayout
                android:layout_width="120dp"
                android:layout_height="150dp"
                android:layout_gravity="center_horizontal"
                app:wheel_dateMode="month_day"
                app:wheel_dayLabel="日"
                app:wheel_monthLabel="月" />

            <com.github.gzuliyujiang.wheelpicker.widget.TimeWheelLayout
                android:layout_width="95dp"
                android:layout_height="150dp"
                android:layout_gravity="center_horizontal"
                app:wheel_curvedEnabled="true"
                app:wheel_curvedMaxAngle="45"
                app:wheel_hourLabel=":"
                app:wheel_minuteLabel=":"
                app:wheel_timeMode="hour_24_has_second" />

        </LinearLayout>
```

## 效果预览

以下图片显示的效果可能已修改过，实际效果请运行 demo 查看。

- ![效果图](/screenshots/1.gif)
- ![效果图](/screenshots/2.gif)
- ![效果图](/screenshots/3.gif)
- ![效果图](/screenshots/4.gif)
- ![效果图](/screenshots/5.gif)
- ![效果图](/screenshots/6.gif)
- ![效果图](/screenshots/7.gif)
- ![效果图](/screenshots/8.gif)
- ![效果图](/screenshots/9.gif)

## 特别鸣谢

- [基于 View 的 WheelView](https://github.com/weidongjian/androidWheelView)
- [基于 ListView 的 WheelView](https://github.com/venshine/WheelView)
- [基于 ScrollView 的 WheelView](https://github.com/wangjiegulu/WheelView)
- [SingleDateAndTimePicker](https://github.com/florent37/SingleDateAndTimePicker)
- [China_Province_City](https://github.com/small-dream/China_Province_City)
- [Administrative-divisions-of-China](https://github.com/modood/Administrative-divisions-of-China)
- [AndroidColorPicker](https://github.com/jbruchanov/AndroidColorPicker)
- [calendar](https://github.com/oxsource/calendar)
- [Android-Image-Cropper](https://github.com/ArthurHub/Android-Image-Cropper)

## 许可协议

### 3.0.0 之后

```text
Copyright (c) 2020-2021 gzu-liyujiang <1032694760@qq.com>

The software is licensed under the Mulan PSL v2.
You can use this software according to the terms and conditions of the Mulan PSL v2.
You may obtain a copy of Mulan PSL v2 at:
    http://license.coscl.org.cn/MulanPSL2
THIS SOFTWARE IS PROVIDED ON AN "AS IS" BASIS, WITHOUT WARRANTIES OF ANY KIND, EITHER EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO NON-INFRINGEMENT, MERCHANTABILITY OR FIT FOR A PARTICULAR
PURPOSE.
See the Mulan PSL v2 for more details.
```

### 3.0.0 之前

```text
MIT License

Copyright (c) 穿青山魈人马<liyujiang_tk@yeah.net>

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
```