explaingit

gzu-liyujiang/androidpicker

6,776JavaAudience · developerComplexity · 2/5Setup · moderate

TLDR

A Java Android library providing ready-made scroll-wheel picker dialogs for dates, addresses, numbers, colors, and more, distributed as separate JitPack modules so an app includes only what it needs.

Mindmap

mindmap
  root((repo))
    What it does
      Scroll-wheel pickers
      Android UI dialogs
      Modular packages
    Picker types
      Date and time
      Address three-tier
      Number and color
      File and image
    Distribution
      JitPack modules
      Per-picker imports
    Notes
      V3 broke old API
      Community maintained
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Things people build with this

USE CASE 1

Add a scroll-wheel date and time picker to an Android form for fields like birth date or appointment time.

USE CASE 2

Integrate the three-tier province-city-district address picker for a Chinese e-commerce checkout flow.

USE CASE 3

Add a number picker for numeric inputs like age, height, or weight with scroll-wheel interaction.

USE CASE 4

Let users pick a color from a palette inside an Android settings screen using the built-in color picker component.

Tech stack

JavaAndroidJitPack

Getting it running

Difficulty · moderate Time to first run · 30min

Requires adding the JitPack Maven repository to your Gradle config before the dependency resolves.

No license information was mentioned in the explanation.

In plain English

AndroidPicker is a Java library for Android apps that provides a collection of scroll-wheel style selection dialogs. When a mobile app needs a user to pick a value from a list, this library supplies ready-made UI components for many common scenarios so developers do not have to build them from scratch. The library covers a wide range of picker types. There is a date and time picker suitable for things like birth dates or business hours, a single-option picker for fields like gender, occupation, education level, or zodiac sign, and a linked multi-column picker where selecting one column filters the choices in the next, useful for things like vehicle license plate prefixes or fund purchase dates. There is also an address picker that handles the three-tier Chinese administrative hierarchy of province, city, and district, a number picker for numeric values like age, height, weight, or temperature, a calendar-style date picker suited to hotel or flight booking, a color picker, and pickers for files, directories, and images. Each picker type is distributed as a separate module on JitPack, so an app can include only the components it actually needs rather than pulling in the whole library. The address data is bundled as a JSON file that can be replaced with custom data if the default China address dataset does not fit the use case. Version 3.0 was a complete rewrite of the underlying code with improved performance and better XML layout compatibility, but it broke the API from versions 1.x and 2.x, so upgrading from older versions requires care. The older 1.x and 2.x branches are archived and still accessible. The author noted in the README that they stopped doing Android development in 2022 and can no longer contribute code themselves, so the project depends on community pull requests for continued maintenance. A demo APK is available in the repository for testing the pickers before integrating them.

Copy-paste prompts

Prompt 1
I want to add a birthday date picker to my Android app using androidpicker. Show me the Gradle dependency for JitPack and the minimal Java code to show the picker and read the selected date.
Prompt 2
I need a Chinese province-city-district address picker in my Android checkout screen. How do I add the address picker module from androidpicker and wire it up in an Activity?
Prompt 3
I upgraded from androidpicker v2 to v3 and my picker code no longer compiles. What are the main API changes I need to fix?
Prompt 4
How do I replace the default China address JSON in androidpicker with my own custom dataset for a different region?
Open on GitHub → Explain another repo

← gzu-liyujiang on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.