Country Code Picker Library

If you are looking for an android library for Country Selector or Country Spinner or Country Phone Code selector, this is the perfect place for you.

Country Code Picker (CCP) or is an android library which provides an easy way to search and select country or country phone code for the telephone number.

Introduction

Give a professional touch to your well designed form like login screen, sign up screen, edit profile screen with CCP. When used as phone code picker, it helps by removing confusion about how to add phone number and making view more understandable.
With CCP you can get following views easily without boilerplate code. (Left: Phone code selector. Right: Country Selector)
Tapping on CCP will open a dialog to search and select country (Left: Phone code selector. Right: Country Selector) -

How to add to your project

Add this to your gradle file and sync. See CHANGELOG for detailed list of changes.

        dependencies {
          implementation 'com.hbb20:ccp:2.3.8'
        }

If you are using version lower than 2.0.0 then please read update guide before upgrading to v2.0.0. or above*
Version 2.3.1 and above uses AndroidX

Features

If you prefer experience along with explanations, an demo android app is available that demonstrates all the features of this library. Click below button to download from Playstore.

Super easy to integrate
Full Number Support
- Auto-Formatting
- Number Validation
- Validity Change Listener
- Read / Load full number
Use as Country Selector / Country Spinner
Country preference
Custom master list
Country Selection Change Listener
Multi-language support
Customizable CCP theme and Dialog Theme
Auto detect Country
Auto detect Language
Remembers last selection
Fast Scroller

Available XML properties

To check all xml properties available for CCP and CCP Selection ppDialog, please visit the wiki page.

Credits

Fast Scroller library by Future Minds
Optimized Android port of libphonenumber by Michael Rozumyanskiy
Hebrew translation by David Brownstone
Chinese translation by KENNETH2008
Indonesia translation by Maulana Firdaus
Spanish translation by Armando Gomez
Turkish translation by Ugurcan Yildirim
Ukrainian language support by VyacheslavMartynenko
Italian language support by Fabrizio Gueli
Korean language support by kduhyun
Portuguese translation corrections by Elifázio Bernardes da Silva
Flag border color option by Maulana Firdaus
Dutch language support by Bozintan Iuliana
Punjabi language support by Dhruv Bhakta
Arabic translation corrections by Ahmed Wahdan
Swedish language support by Tobias Hillén
Addition of Kosovo Country by Aleksei Kliuev
Uzbek language support by Mirmuhsin
Afrikaans language support by marilie
Czech language support by Jakub Begera
Greek language support by khanboy1989
Danish language support by porkyhead
Vietnamese language support by Ricardo Markiewicz
Urdu language support by Hamza Ahmed Khan
Kazakh language support by Zhanbolat Raimbekov
Marathi language support by Kaustubh Kulkarni
Slovenian language support by pastafarianGit

Contribution

To add a new country, follow the guide to add new country.
To add a new Language support, follow the guide to add new language support.

License

Apache Version 2.0

Copyright (C) 2016 Harsh Bhakta

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

   http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

krokers/CountryCodePickerProject