Country Code Picker (CCP) is an android library which provides an easy way to search and select country or international phone code. Also supports Android EditText phone mask and international phone validation.
Branch: master
Clone or download
Latest commit 2024df1 Jan 31, 2019

README.md

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.

AwesomeCCPLIbrary

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

        dependencies {
          implementation 'com.hbb20:ccp:2.2.4'
        }
  • If you are using version lower than 2.0.0 then please read update guide before upgrading to v2.0.0. or above*

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.

Available XML properties

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

Change log

Version 2.2.4 (January 20, 2019)
Version 2.2.3 (October 12, 2018)
Version 2.2.2 (June 24, 2018)
Version 2.2.0 (April 20, 2018)
  • Improved international phone formatting.
  • Removes intermediate solution for national phone hint (ccp_hintExampleNumberFormat is no longer supported).
  • Add/Correct some country flags.
  • Uses latest libphonenumber (Optimized for android) library.
  • FailureListener interface to listen to onCountryAutoDetectionFailed Issue#186.
Version 2.1.9 (March 21, 2018)

For earlier versions, check full log.


Credits

Contribution

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.