intl-tel-input 18.2.1 → 18.3.0

package/third_party/libphonenumber/java/build.xml

@@ -11,6 +11,8 @@
   <property name="prefixmapper.test.dir" value="internal/prefixmapper/test"/>
   <property name="build.dir" value="build"/>
   <property name="classes.dir" value="${build.dir}/classes"/>
+  <property name="script.dir" value="script"/>
+  <property name="script.name" value="download-junit-jars.sh"/>
   <property name="jar.dir" value="${build.dir}/jar"/>
   <property name="lib.dir" value="lib"/>
   <property name="report.dir" value="${build.dir}/junitreport"/>
@@ -31,6 +33,13 @@
     </fileset>
   </path>
 
+  <target name="download-jars">
+    <!-- Execute the shell script to download junit and mockito jars -->
+    <exec executable="sh" dir="${script.dir}">
+      <arg value="${script.name}"/>
+    </exec>
+  </target>
+
   <target name="build-phone-metadata">
     <exec executable="java">
       <arg value="-jar" />
@@ -186,7 +195,7 @@
   </target>
 
   <target name="compile" description="Compile Java source."
-          depends="build-phone-metadata,build-short-metadata,build-alternate-metadata,build-carrier-data,build-geo-data,build-timezones-data">
+          depends="download-jars,build-phone-metadata,build-short-metadata,build-alternate-metadata,build-carrier-data,build-geo-data,build-timezones-data">
     <mkdir dir="${classes.dir}"/>
     <javac srcdir="${libphonenumber.src.dir};${carrier.src.dir};${geocoder.src.dir};${prefixmapper.src.dir}"
            destdir="${classes.dir}" classpathref="classpath" includeAntRuntime="false" encoding="UTF-8"/>

package/third_party/libphonenumber/java/carrier/pom.xml

@@ -3,14 +3,14 @@
   <modelVersion>4.0.0</modelVersion>
   <groupId>com.googlecode.libphonenumber</groupId>
   <artifactId>carrier</artifactId>
-  <version>1.199</version>
+  <version>1.210</version>
   <packaging>jar</packaging>
   <url>https://github.com/google/libphonenumber/</url>
 
   <parent>
     <groupId>com.googlecode.libphonenumber</groupId>
     <artifactId>libphonenumber-parent</artifactId>
-    <version>8.13.15</version>
+    <version>8.13.26</version>
   </parent>
 
   <build>
@@ -32,7 +32,7 @@
       <plugin>
         <groupId>org.apache.felix</groupId>
         <artifactId>maven-bundle-plugin</artifactId>
-        <version>3.2.0</version>
+        <version>5.1.9</version>
         <configuration>
           <instructions>
           	<Fragment-Host>com.googlecode.libphonenumber</Fragment-Host>
@@ -41,7 +41,7 @@
       </plugin>
       <plugin>
         <artifactId>maven-jar-plugin</artifactId>
-        <version>3.0.2</version>
+        <version>3.3.0</version>
         <executions>
           <execution>
             <id>default-jar</id>
@@ -79,12 +79,12 @@
     <dependency>
       <groupId>com.googlecode.libphonenumber</groupId>
       <artifactId>libphonenumber</artifactId>
-      <version>8.13.15</version>
+      <version>8.13.26</version>
     </dependency>
     <dependency>
       <groupId>com.googlecode.libphonenumber</groupId>
       <artifactId>prefixmapper</artifactId>
-      <version>2.209</version>
+      <version>2.220</version>
     </dependency>
   </dependencies>
 

package/third_party/libphonenumber/java/demo/pom.xml

@@ -3,13 +3,13 @@
   <modelVersion>4.0.0</modelVersion>
   <groupId>com.googlecode.libphonenumber</groupId>
   <artifactId>demo</artifactId>
-  <version>8.13.15</version>
+  <version>8.13.26</version>
   <packaging>war</packaging>
   <url>https://github.com/google/libphonenumber/</url>
   <parent>
     <groupId>com.googlecode.libphonenumber</groupId>
     <artifactId>libphonenumber-parent</artifactId>
-    <version>8.13.15</version>
+    <version>8.13.26</version>
   </parent>
 
   <properties>
@@ -53,12 +53,12 @@
     <dependency>
       <groupId>commons-io</groupId>
       <artifactId>commons-io</artifactId>
-      <version>2.7</version>
+      <version>2.13.0</version>
     </dependency>
     <dependency>
       <groupId>commons-fileupload</groupId>
       <artifactId>commons-fileupload</artifactId>
-      <version>1.4</version>
+      <version>1.5</version>
     </dependency>
     <dependency>
       <groupId>commons-lang</groupId>
@@ -68,17 +68,17 @@
     <dependency>
       <groupId>com.googlecode.libphonenumber</groupId>
       <artifactId>libphonenumber</artifactId>
-      <version>8.13.15</version>
+      <version>8.13.26</version>
     </dependency>
     <dependency>
       <groupId>com.googlecode.libphonenumber</groupId>
       <artifactId>geocoder</artifactId>
-      <version>2.209</version>
+      <version>2.220</version>
     </dependency>
     <dependency>
       <groupId>com.googlecode.libphonenumber</groupId>
       <artifactId>carrier</artifactId>
-      <version>1.199</version>
+      <version>1.210</version>
     </dependency>
   </dependencies>
 
@@ -104,7 +104,7 @@
       <plugin>
         <groupId>org.apache.maven.plugins</groupId>
         <artifactId>maven-war-plugin</artifactId>
-        <version>3.3.1</version>
+        <version>3.4.0</version>
       </plugin>
       <plugin>
         <groupId>org.codehaus.mojo</groupId>
@@ -164,7 +164,7 @@
       <plugin>
         <groupId>org.apache.maven.plugins</groupId>
         <artifactId>maven-javadoc-plugin</artifactId>
-        <version>3.4.1</version>
+        <version>3.5.0</version>
         <configuration>
           <!-- SoyInfoParser does not generate valid javadoc and
           <excludePackageNames> does not work for /generated-sources for

package/third_party/libphonenumber/java/demoapp/README.md

@@ -0,0 +1,51 @@
+# Demo App: E.164 Formatter
+
+## What is this?
+
+The E.164 Formatter is an Android App that reads all the phone numbers stored in
+the device's contacts and processes them using the
+[LibPhoneNumber](https://github.com/google/libphonenumber) Library.
+
+The purpose of this App is to show an example of how LPN can be used in a
+real-life situation, in this case specifically in an Android App using Java.
+
+## How can I install the app?
+
+You can use the source code to build the app yourself.
+
+## Where is the LPN code located?
+
+The code using LPN is located in
+[`PhoneNumberFormatting#formatPhoneNumberInApp(PhoneNumberInApp, String,
+boolean)`](app/src/main/java/com/google/phonenumbers/demoapp/phonenumbers/PhoneNumberFormatting.java#L31)
+.
+
+## How does the app work?
+
+On the start screen, the app asks the user for a country to later use when
+trying to convert the phone numbers to E.164. After the user starts the process
+and grants permission to read and write contacts, the app shows the user two
+lists in the UI.
+
+**List 1: Formattable**
+
+Contains all the phone number that are parsable by LPN, are not short numbers,
+and are valid numbers and can be reformatted to E.164 using the country selected
+on the start screen. In other words, valid locally formatted phone numbers of
+the selected country (e.g. `044 668 18 00` if the selected country is
+Switzerland).
+
+Each list item (= one phone number in the device's contacts) has a checkbox.
+With the click of the button "Update selected" under the list, the app replaces
+the phone numbers of the checked list elements in the contacts with the
+suggested E.164 replacements.
+
+**List 2: Not formattable**
+
+Shows all the phone number that do not fit the criteria of List 1, each tagged
+with one of the following errors:
+
+*   Parsing error
+*   Short number (e.g. `112`)
+*   Invalid number (e.g. `+41446681800123`)
+*   Already E.164 (e.g. `+41446681800`)

package/third_party/libphonenumber/java/demoapp/app/build.gradle

@@ -0,0 +1,45 @@
+plugins {
+    id 'com.android.application'
+}
+
+android {
+    namespace 'com.google.phonenumbers.demoapp'
+    compileSdk 33
+
+    defaultConfig {
+        applicationId "com.google.phonenumbers.demoapp"
+        minSdk 31
+        targetSdk 33
+        versionCode 1
+        versionName "1.0"
+
+        testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
+    }
+
+    buildTypes {
+        release {
+            debuggable false
+            minifyEnabled true
+            shrinkResources true
+            proguardFiles getDefaultProguardFile(
+                    'proguard-android-optimize.txt')
+        }
+
+        debug {
+            debuggable true
+        }
+    }
+
+    compileOptions {
+        sourceCompatibility JavaVersion.VERSION_1_8
+        targetCompatibility JavaVersion.VERSION_1_8
+    }
+}
+
+dependencies {
+    implementation 'androidx.appcompat:appcompat:1.6.1'
+    implementation 'androidx.constraintlayout:constraintlayout:2.1.4'
+    implementation 'com.google.android.material:material:1.8.0'
+    implementation 'com.googlecode.libphonenumber:libphonenumber:8.13.5'
+    testImplementation 'junit:junit:4.13.2'
+}

package/third_party/libphonenumber/java/demoapp/app/src/main/AndroidManifest.xml

@@ -0,0 +1,39 @@
+<?xml version="1.0" encoding="utf-8"?>
+<manifest xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:tools="http://schemas.android.com/tools">
+
+  <uses-permission android:name="android.permission.READ_CONTACTS" />
+  <uses-permission android:name="android.permission.WRITE_CONTACTS" />
+
+  <application
+      android:name=".MyApplication"
+      android:allowBackup="true"
+      android:icon="@mipmap/ic_launcher"
+      android:label="@string/app_name"
+      android:supportsRtl="true"
+      android:taskAffinity=""
+      android:theme="@style/AppTheme"
+      tools:targetApi="33">
+    <activity
+        android:name=".main.MainActivity"
+        android:exported="true">
+      <intent-filter>
+        <action android:name="android.intent.action.MAIN" />
+
+        <category android:name="android.intent.category.LAUNCHER" />
+      </intent-filter>
+
+      <meta-data
+          android:name="android.app.lib_name"
+          android:value="" />
+    </activity>
+    <activity
+        android:name=".result.ResultActivity"
+        android:exported="false">
+      <intent-filter>
+        <action android:name="android.intent.action.DEFAULT" />
+      </intent-filter>
+    </activity>
+  </application>
+
+</manifest>

package/third_party/libphonenumber/java/demoapp/app/src/main/java/com/google/phonenumbers/demoapp/MyApplication.java

@@ -0,0 +1,16 @@
+package com.google.phonenumbers.demoapp;
+
+import android.app.Application;
+import com.google.android.material.color.DynamicColors;
+
+/**
+ * Used instead of default {@link Application} instance. Only difference is that this implementation
+ * enabled Dynamic Colors for the app.
+ */
+public class MyApplication extends Application {
+  @Override
+  public void onCreate() {
+    super.onCreate();
+    DynamicColors.applyToActivitiesIfAvailable(this);
+  }
+}

package/third_party/libphonenumber/java/demoapp/app/src/main/java/com/google/phonenumbers/demoapp/contacts/ContactsPermissionManagement.java

@@ -0,0 +1,161 @@
+package com.google.phonenumbers.demoapp.contacts;
+
+import static android.content.Context.MODE_PRIVATE;
+
+import android.Manifest.permission;
+import android.app.Activity;
+import android.content.Context;
+import android.content.Intent;
+import android.content.SharedPreferences;
+import android.content.pm.PackageManager;
+import android.net.Uri;
+import androidx.core.app.ActivityCompat;
+import androidx.core.content.ContextCompat;
+
+/**
+ * Handles everything related to the contacts permissions ({@link permission#READ_CONTACTS} and
+ * {@link permission#WRITE_CONTACTS}) and the requesting process to grant the permissions.
+ */
+public class ContactsPermissionManagement {
+
+  public static final int CONTACTS_PERMISSION_REQUEST_CODE = 0;
+
+  private static final String SHARED_PREFS_NAME = "contacts-permission-management";
+  private static final String NUMBER_OF_CONTACTS_PERMISSION_DENIALS_KEY =
+      "NUMBER_OF_CONTACTS_PERMISSION_DENIALS";
+
+  private ContactsPermissionManagement() {}
+
+  /**
+   * Returns the current state of the permissions granting as {@link PermissionState}.
+   *
+   * @param activity Activity of the app
+   * @return {@link PermissionState} of the permissions granting
+   */
+  public static PermissionState getState(Activity activity) {
+    if (isGranted(activity.getApplicationContext())) {
+      return PermissionState.ALREADY_GRANTED;
+    }
+    if (!shouldPermissionBeRequestedInApp(activity.getApplicationContext())) {
+      return PermissionState.NEEDS_GRANT_IN_SETTINGS;
+    }
+    if (shouldShowRationale(activity)) {
+      return PermissionState.SHOW_RATIONALE;
+    }
+    return PermissionState.NEEDS_REQUEST;
+  }
+
+  /**
+   * Returns whether the contacts permissions ({@link permission#READ_CONTACTS} and {@link
+   * permission#WRITE_CONTACTS}) are granted for the param {@code context}.
+   *
+   * @param context Context of the app
+   * @return boolean whether contacts permissions are granted
+   */
+  public static boolean isGranted(Context context) {
+    if (ContextCompat.checkSelfPermission(context, permission.READ_CONTACTS)
+        == PackageManager.PERMISSION_DENIED) {
+      return false;
+    }
+    return ContextCompat.checkSelfPermission(context, permission.WRITE_CONTACTS)
+        != PackageManager.PERMISSION_DENIED;
+  }
+
+  /**
+   * Returns whether the permissions should be requested directly in the app or not. Specifically
+   * returns true if less than 2 denials happened since the app installation.
+   *
+   * @param context Context of the app
+   * @return boolean whether the permissions should be requested directly in the app
+   */
+  private static boolean shouldPermissionBeRequestedInApp(Context context) {
+    return getNumberOfDenials(context) < 2;
+  }
+
+  /**
+   * Returns the number of times the permission dialog has been denied since the app installation.
+   * Dismissing the permission dialog instead of answering is considered a denial.
+   *
+   * @param context Context of the app
+   * @return int number of times the permission has been denied
+   */
+  private static int getNumberOfDenials(Context context) {
+    SharedPreferences preferences = context.getSharedPreferences(SHARED_PREFS_NAME, MODE_PRIVATE);
+    return preferences.getInt(NUMBER_OF_CONTACTS_PERMISSION_DENIALS_KEY, 0);
+  }
+
+  /**
+   * Adds 1 to the number of denials since the app installation. Should be called every time the
+   * user denies the permission (in the dialog). Dismissing the permission dialog instead of
+   * answering is considered a denial.
+   *
+   * @param context Context of the app
+   */
+  public static void addOneToNumberOfDenials(Context context) {
+    SharedPreferences.Editor editor =
+        context.getSharedPreferences(SHARED_PREFS_NAME, MODE_PRIVATE).edit();
+    editor.putInt(NUMBER_OF_CONTACTS_PERMISSION_DENIALS_KEY, getNumberOfDenials(context) + 1);
+    editor.apply();
+  }
+
+  /**
+   * Returns whether a rational should be shown explaining why the app requests these permissions
+   * (before requesting them).
+   *
+   * @param activity Activity of the app
+   * @return boolean whether a rational should be shown
+   */
+  private static boolean shouldShowRationale(Activity activity) {
+    if (ActivityCompat.shouldShowRequestPermissionRationale(activity, permission.READ_CONTACTS)) {
+      return true;
+    }
+    return ActivityCompat.shouldShowRequestPermissionRationale(activity, permission.WRITE_CONTACTS);
+  }
+
+  /**
+   * Requests the contact permissions ({@link permission#READ_CONTACTS} and {@link
+   * permission#WRITE_CONTACTS}) in the param {@code activity} with the request code {@link
+   * ContactsPermissionManagement#CONTACTS_PERMISSION_REQUEST_CODE}.
+   *
+   * @param activity Activity of the app
+   */
+  public static void request(Activity activity) {
+    activity.requestPermissions(
+        new String[] {permission.READ_CONTACTS, permission.WRITE_CONTACTS},
+        CONTACTS_PERMISSION_REQUEST_CODE);
+  }
+
+  /**
+   * Opens the system settings (app details page) if the app can. Special cases that can not open
+   * the system settings are for example emulators without Play Store installed.
+   *
+   * @param activity Activity of the app
+   */
+  public static void openSystemSettings(Activity activity) {
+    Intent intent =
+        new Intent(
+            android.provider.Settings.ACTION_APPLICATION_DETAILS_SETTINGS,
+            Uri.parse("package:" + activity.getPackageName()));
+    activity.startActivity(intent);
+  }
+
+  /** Represents the different states the permissions granting process can be at. */
+  public enum PermissionState {
+    /** The permissions are already granted. The action requiring the permissions can be started. */
+    ALREADY_GRANTED,
+    /**
+     * The permissions are not granted, but can be requested directly (without showing a rationale).
+     */
+    NEEDS_REQUEST,
+    /**
+     * The permissions are not granted and a rationale should be shown explaining why the app
+     * requests the permissions before requesting them (directly in the app).
+     */
+    SHOW_RATIONALE,
+    /**
+     * The permissions are not granted and can not be granted directly in the app. The user has to
+     * grant permissions in the system settings instead.
+     */
+    NEEDS_GRANT_IN_SETTINGS
+  }
+}