Improve contact sync for individual contacts.

contacts/app/src/main/AndroidManifest.xml

@@ -20,7 +20,11 @@
         </activity>
 
         <activity
-            android:name=".ContactsActivity"
+            android:name=".ContactListActivity"
+            android:exported="false" />
+
+        <activity
+            android:name=".ContactLookupActivity"
             android:exported="false" />
 
         <service

contacts/app/src/main/java/org/signal/contactstest/ContactListActivity.kt

@@ -0,0 +1,31 @@
+package org.signal.contactstest
+
+import android.content.Intent
+import android.os.Bundle
+import androidx.activity.viewModels
+import androidx.appcompat.app.AppCompatActivity
+import androidx.recyclerview.widget.LinearLayoutManager
+import androidx.recyclerview.widget.RecyclerView
+
+class ContactListActivity : AppCompatActivity() {
+  override fun onCreate(savedInstanceState: Bundle?) {
+    super.onCreate(savedInstanceState)
+
+    setContentView(R.layout.activity_contact_list)
+
+    val list: RecyclerView = findViewById(R.id.list)
+    val adapter = ContactsAdapter { uri ->
+      startActivity(
+        Intent(Intent.ACTION_VIEW).apply {
+          data = uri
+        }
+      )
+    }
+
+    list.layoutManager = LinearLayoutManager(this)
+    list.adapter = adapter
+
+    val viewModel: ContactListViewModel by viewModels()
+    viewModel.contacts.observe(this) { adapter.submitList(it) }
+  }
+}

contacts/app/src/main/java/org/signal/contactstest/ContactListViewModel.kt

@@ -2,6 +2,7 @@ package org.signal.contactstest
 
 import android.accounts.Account
 import android.app.Application
+import android.telephony.PhoneNumberUtils
 import androidx.lifecycle.AndroidViewModel
 import androidx.lifecycle.LiveData
 import androidx.lifecycle.MutableLiveData
@@ -11,10 +12,10 @@ import org.signal.contacts.SystemContactsRepository.ContactIterator
 import org.signal.core.util.concurrent.SignalExecutors
 import org.signal.core.util.logging.Log
 
-class ContactsViewModel(application: Application) : AndroidViewModel(application) {
+class ContactListViewModel(application: Application) : AndroidViewModel(application) {
 
   companion object {
-    private val TAG = Log.tag(ContactsViewModel::class.java)
+    private val TAG = Log.tag(ContactListViewModel::class.java)
   }
 
   private val _contacts: MutableLiveData<List<ContactDetails>> = MutableLiveData()
@@ -30,16 +31,20 @@ class ContactsViewModel(application: Application) : AndroidViewModel(application
         accountDisplayName = "Test"
       )
 
+      val startTime: Long = System.currentTimeMillis()
+
       if (account != null) {
         val contactList: List<ContactDetails> = SystemContactsRepository.getAllSystemContacts(
           context = application,
-          e164Formatter = { number -> number }
+          e164Formatter = { number -> PhoneNumberUtils.formatNumberToE164(number, "US") ?: number }
         ).use { it.toList() }
 
         _contacts.postValue(contactList)
       } else {
         Log.w(TAG, "Failed to create an account!")
       }
+
+      Log.d(TAG, "Took ${System.currentTimeMillis() - startTime} ms to fetch contacts.")
     }
   }
 

contacts/app/src/main/java/org/signal/contactstest/ContactLookupActivity.kt

@@ -0,0 +1,40 @@
+package org.signal.contactstest
+
+import android.content.Intent
+import android.os.Bundle
+import android.widget.Button
+import android.widget.TextView
+import androidx.activity.viewModels
+import androidx.appcompat.app.AppCompatActivity
+import androidx.recyclerview.widget.LinearLayoutManager
+import androidx.recyclerview.widget.RecyclerView
+
+class ContactLookupActivity : AppCompatActivity() {
+  override fun onCreate(savedInstanceState: Bundle?) {
+    super.onCreate(savedInstanceState)
+
+    setContentView(R.layout.activity_contact_lookup)
+
+    val list: RecyclerView = findViewById(R.id.list)
+    val adapter = ContactsAdapter { uri ->
+      startActivity(
+        Intent(Intent.ACTION_VIEW).apply {
+          data = uri
+        }
+      )
+    }
+
+    list.layoutManager = LinearLayoutManager(this)
+    list.adapter = adapter
+
+    val viewModel: ContactLookupViewModel by viewModels()
+    viewModel.contacts.observe(this) { adapter.submitList(it) }
+
+    val lookupText: TextView = findViewById(R.id.lookup_text)
+    val lookupButton: Button = findViewById(R.id.lookup_button)
+
+    lookupButton.setOnClickListener {
+      viewModel.onLookup(lookupText.text.toString())
+    }
+  }
+}

contacts/app/src/main/java/org/signal/contactstest/ContactLookupViewModel.kt

@@ -0,0 +1,57 @@
+package org.signal.contactstest
+
+import android.accounts.Account
+import android.app.Application
+import android.telephony.PhoneNumberUtils
+import androidx.lifecycle.AndroidViewModel
+import androidx.lifecycle.LiveData
+import androidx.lifecycle.MutableLiveData
+import org.signal.contacts.SystemContactsRepository
+import org.signal.contacts.SystemContactsRepository.ContactDetails
+import org.signal.contacts.SystemContactsRepository.ContactIterator
+import org.signal.core.util.concurrent.SignalExecutors
+import org.signal.core.util.logging.Log
+
+class ContactLookupViewModel(application: Application) : AndroidViewModel(application) {
+
+  companion object {
+    private val TAG = Log.tag(ContactLookupViewModel::class.java)
+  }
+
+  private val _contacts: MutableLiveData<List<ContactDetails>> = MutableLiveData()
+
+  val contacts: LiveData<List<ContactDetails>>
+    get() = _contacts
+
+  fun onLookup(lookup: String) {
+    SignalExecutors.BOUNDED.execute {
+      val account: Account? = SystemContactsRepository.getOrCreateSystemAccount(
+        context = getApplication(),
+        applicationId = BuildConfig.APPLICATION_ID,
+        accountDisplayName = "Test"
+      )
+
+      val startTime: Long = System.currentTimeMillis()
+
+      if (account != null) {
+        val contactList: List<ContactDetails> = SystemContactsRepository.getContactDetailsByQueries(
+          context = getApplication(),
+          queries = listOf(lookup),
+          e164Formatter = { number -> PhoneNumberUtils.formatNumberToE164(number, "US") ?: number }
+        ).use { it.toList() }
+
+        _contacts.postValue(contactList)
+      } else {
+        Log.w(TAG, "Failed to create an account!")
+      }
+
+      Log.d(TAG, "Took ${System.currentTimeMillis() - startTime} ms to fetch contacts.")
+    }
+  }
+
+  private fun ContactIterator.toList(): List<ContactDetails> {
+    val list: MutableList<ContactDetails> = mutableListOf()
+    forEach { list += it }
+    return list
+  }
+}

contacts/app/src/main/java/org/signal/contactstest/ContactsActivity.kt

@@ -1,117 +0,0 @@
-package org.signal.contactstest
-
-import android.content.Intent
-import android.graphics.BitmapFactory
-import android.net.Uri
-import android.os.Bundle
-import android.provider.ContactsContract
-import android.view.LayoutInflater
-import android.view.View
-import android.view.ViewGroup
-import android.widget.ImageView
-import android.widget.TextView
-import androidx.activity.viewModels
-import androidx.appcompat.app.AppCompatActivity
-import androidx.recyclerview.widget.DiffUtil
-import androidx.recyclerview.widget.LinearLayoutManager
-import androidx.recyclerview.widget.ListAdapter
-import androidx.recyclerview.widget.RecyclerView
-import org.signal.contacts.SystemContactsRepository.ContactDetails
-import org.signal.contacts.SystemContactsRepository.ContactPhoneDetails
-
-class ContactsActivity : AppCompatActivity() {
-  override fun onCreate(savedInstanceState: Bundle?) {
-    super.onCreate(savedInstanceState)
-
-    setContentView(R.layout.activity_contacts)
-
-    val list: RecyclerView = findViewById(R.id.list)
-    val adapter = ContactsAdapter()
-
-    list.layoutManager = LinearLayoutManager(this)
-    list.adapter = adapter
-
-    val viewModel: ContactsViewModel by viewModels()
-    viewModel.contacts.observe(this) { adapter.submitList(it) }
-  }
-
-  private inner class ContactsAdapter : ListAdapter<ContactDetails, ContactViewHolder>(object : DiffUtil.ItemCallback<ContactDetails>() {
-    override fun areItemsTheSame(oldItem: ContactDetails, newItem: ContactDetails): Boolean {
-      return oldItem == newItem
-    }
-
-    override fun areContentsTheSame(oldItem: ContactDetails, newItem: ContactDetails): Boolean {
-      return oldItem == newItem
-    }
-  }) {
-
-    override fun onCreateViewHolder(parent: ViewGroup, viewType: Int): ContactViewHolder {
-      return ContactViewHolder(LayoutInflater.from(parent.context).inflate(R.layout.parent_item, parent, false))
-    }
-
-    override fun onBindViewHolder(holder: ContactViewHolder, position: Int) {
-      holder.bind(getItem(position))
-    }
-  }
-
-  private inner class ContactViewHolder(itemView: View) : RecyclerView.ViewHolder(itemView) {
-    val givenName: TextView = itemView.findViewById(R.id.given_name)
-    val familyName: TextView = itemView.findViewById(R.id.family_name)
-    val phoneAdapter: PhoneAdapter = PhoneAdapter()
-    val phoneList: RecyclerView = itemView.findViewById<RecyclerView?>(R.id.phone_list).apply {
-      layoutManager = LinearLayoutManager(itemView.context)
-      adapter = phoneAdapter
-    }
-
-    fun bind(contact: ContactDetails) {
-      givenName.text = "Given Name: ${contact.givenName}"
-      familyName.text = "Family Name: ${contact.familyName}"
-      phoneAdapter.submitList(contact.numbers)
-    }
-  }
-
-  private inner class PhoneAdapter : ListAdapter<ContactPhoneDetails, PhoneViewHolder>(object : DiffUtil.ItemCallback<ContactPhoneDetails>() {
-    override fun areItemsTheSame(oldItem: ContactPhoneDetails, newItem: ContactPhoneDetails): Boolean {
-      return oldItem == newItem
-    }
-
-    override fun areContentsTheSame(oldItem: ContactPhoneDetails, newItem: ContactPhoneDetails): Boolean {
-      return oldItem == newItem
-    }
-  }) {
-
-    override fun onCreateViewHolder(parent: ViewGroup, viewType: Int): PhoneViewHolder {
-      return PhoneViewHolder(LayoutInflater.from(parent.context).inflate(R.layout.child_item, parent, false))
-    }
-
-    override fun onBindViewHolder(holder: PhoneViewHolder, position: Int) {
-      holder.bind(getItem(position))
-    }
-  }
-
-  private inner class PhoneViewHolder(itemView: View) : RecyclerView.ViewHolder(itemView) {
-    val photo: ImageView = itemView.findViewById(R.id.contact_photo)
-    val displayName: TextView = itemView.findViewById(R.id.display_name)
-    val number: TextView = itemView.findViewById(R.id.number)
-    val type: TextView = itemView.findViewById(R.id.type)
-    val goButton: View = itemView.findViewById(R.id.go_button)
-
-    fun bind(details: ContactPhoneDetails) {
-      if (details.photoUri != null) {
-        photo.setImageBitmap(BitmapFactory.decodeStream(itemView.context.contentResolver.openInputStream(Uri.parse(details.photoUri))))
-      } else {
-        photo.setImageBitmap(null)
-      }
-      displayName.text = details.displayName
-      number.text = details.number
-      type.text = ContactsContract.CommonDataKinds.Phone.getTypeLabel(itemView.resources, details.type, details.label)
-      goButton.setOnClickListener {
-        startActivity(
-          Intent(Intent.ACTION_VIEW).apply {
-            data = details.contactUri
-          }
-        )
-      }
-    }
-  }
-}

contacts/app/src/main/java/org/signal/contactstest/ContactsAdapter.kt

@@ -0,0 +1,50 @@
+package org.signal.contactstest
+
+import android.net.Uri
+import android.view.LayoutInflater
+import android.view.View
+import android.view.ViewGroup
+import android.widget.TextView
+import androidx.recyclerview.widget.DiffUtil
+import androidx.recyclerview.widget.LinearLayoutManager
+import androidx.recyclerview.widget.ListAdapter
+import androidx.recyclerview.widget.RecyclerView
+import org.signal.contacts.SystemContactsRepository
+
+class ContactsAdapter(private val onContactClickedListener: (Uri) -> Unit) : ListAdapter<SystemContactsRepository.ContactDetails, ContactsAdapter.ContactViewHolder>(object : DiffUtil.ItemCallback<SystemContactsRepository.ContactDetails>() {
+  override fun areItemsTheSame(oldItem: SystemContactsRepository.ContactDetails, newItem: SystemContactsRepository.ContactDetails): Boolean {
+    return oldItem == newItem
+  }
+
+  override fun areContentsTheSame(oldItem: SystemContactsRepository.ContactDetails, newItem: SystemContactsRepository.ContactDetails): Boolean {
+    return oldItem == newItem
+  }
+}) {
+
+  override fun onCreateViewHolder(parent: ViewGroup, viewType: Int): ContactViewHolder {
+    return ContactViewHolder(LayoutInflater.from(parent.context).inflate(R.layout.parent_item, parent, false))
+  }
+
+  override fun onBindViewHolder(holder: ContactViewHolder, position: Int) {
+    holder.bind(getItem(position))
+  }
+
+  inner class ContactViewHolder(itemView: View) : RecyclerView.ViewHolder(itemView) {
+    private val givenName: TextView = itemView.findViewById(R.id.given_name)
+    private val familyName: TextView = itemView.findViewById(R.id.family_name)
+    private val phoneAdapter: PhoneAdapter = PhoneAdapter(onContactClickedListener)
+
+    init {
+      itemView.findViewById<RecyclerView?>(R.id.phone_list).apply {
+        layoutManager = LinearLayoutManager(itemView.context)
+        adapter = phoneAdapter
+      }
+    }
+
+    fun bind(contact: SystemContactsRepository.ContactDetails) {
+      givenName.text = "Given Name: ${contact.givenName}"
+      familyName.text = "Family Name: ${contact.familyName}"
+      phoneAdapter.submitList(contact.numbers)
+    }
+  }
+}

contacts/app/src/main/java/org/signal/contactstest/MainActivity.kt

@@ -30,8 +30,15 @@ class MainActivity : AppCompatActivity() {
 
     findViewById<Button>(R.id.contact_list_button).setOnClickListener { v ->
       if (hasPermission(Manifest.permission.READ_CONTACTS) && hasPermission(Manifest.permission.WRITE_CONTACTS)) {
-        startActivity(Intent(this, ContactsActivity::class.java))
-        finish()
+        startActivity(Intent(this, ContactListActivity::class.java))
+      } else {
+        ActivityCompat.requestPermissions(this, arrayOf(Manifest.permission.READ_CONTACTS, Manifest.permission.WRITE_CONTACTS), PERMISSION_CODE)
+      }
+    }
+
+    findViewById<Button>(R.id.contact_lookup_button).setOnClickListener { v ->
+      if (hasPermission(Manifest.permission.READ_CONTACTS) && hasPermission(Manifest.permission.WRITE_CONTACTS)) {
+        startActivity(Intent(this, ContactLookupActivity::class.java))
       } else {
         ActivityCompat.requestPermissions(this, arrayOf(Manifest.permission.READ_CONTACTS, Manifest.permission.WRITE_CONTACTS), PERMISSION_CODE)
       }
@@ -92,12 +99,13 @@ class MainActivity : AppCompatActivity() {
   override fun onRequestPermissionsResult(requestCode: Int, permissions: Array<out String>, grantResults: IntArray) {
     if (requestCode == PERMISSION_CODE) {
       if (grantResults.isNotEmpty() && grantResults.all { it == PackageManager.PERMISSION_GRANTED }) {
-        startActivity(Intent(this, ContactsActivity::class.java))
-        finish()
+        startActivity(Intent(this, ContactListActivity::class.java))
       } else {
         Toast.makeText(this, "You must provide permissions to continue.", Toast.LENGTH_SHORT).show()
       }
     }
+
+    super.onRequestPermissionsResult(requestCode, permissions, grantResults)
   }
 
   private fun hasPermission(permission: String): Boolean {

contacts/app/src/main/java/org/signal/contactstest/PhoneAdapter.kt

@@ -0,0 +1,53 @@
+package org.signal.contactstest
+
+import android.graphics.BitmapFactory
+import android.net.Uri
+import android.provider.ContactsContract
+import android.view.LayoutInflater
+import android.view.View
+import android.view.ViewGroup
+import android.widget.ImageView
+import android.widget.TextView
+import androidx.recyclerview.widget.DiffUtil
+import androidx.recyclerview.widget.ListAdapter
+import androidx.recyclerview.widget.RecyclerView
+import org.signal.contacts.SystemContactsRepository
+
+class PhoneAdapter(private val onContactClickedListener: (Uri) -> Unit) : ListAdapter<SystemContactsRepository.ContactPhoneDetails, PhoneAdapter.PhoneViewHolder>(object : DiffUtil.ItemCallback<SystemContactsRepository.ContactPhoneDetails>() {
+  override fun areItemsTheSame(oldItem: SystemContactsRepository.ContactPhoneDetails, newItem: SystemContactsRepository.ContactPhoneDetails): Boolean {
+    return oldItem == newItem
+  }
+
+  override fun areContentsTheSame(oldItem: SystemContactsRepository.ContactPhoneDetails, newItem: SystemContactsRepository.ContactPhoneDetails): Boolean {
+    return oldItem == newItem
+  }
+}) {
+
+  override fun onCreateViewHolder(parent: ViewGroup, viewType: Int): PhoneViewHolder {
+    return PhoneViewHolder(LayoutInflater.from(parent.context).inflate(R.layout.child_item, parent, false))
+  }
+
+  override fun onBindViewHolder(holder: PhoneViewHolder, position: Int) {
+    holder.bind(getItem(position))
+  }
+
+  inner class PhoneViewHolder(itemView: View) : RecyclerView.ViewHolder(itemView) {
+    private val photo: ImageView = itemView.findViewById(R.id.contact_photo)
+    private val displayName: TextView = itemView.findViewById(R.id.display_name)
+    private val number: TextView = itemView.findViewById(R.id.number)
+    private val type: TextView = itemView.findViewById(R.id.type)
+    private val goButton: View = itemView.findViewById(R.id.go_button)
+
+    fun bind(details: SystemContactsRepository.ContactPhoneDetails) {
+      if (details.photoUri != null) {
+        photo.setImageBitmap(BitmapFactory.decodeStream(itemView.context.contentResolver.openInputStream(Uri.parse(details.photoUri))))
+      } else {
+        photo.setImageBitmap(null)
+      }
+      displayName.text = details.displayName
+      number.text = details.number
+      type.text = ContactsContract.CommonDataKinds.Phone.getTypeLabel(itemView.resources, details.type, details.label)
+      goButton.setOnClickListener { onContactClickedListener(details.contactUri) }
+    }
+  }
+}

contacts/app/src/main/res/drawable-v24/ic_launcher_foreground.xml

@@ -1,31 +0,0 @@
-<vector
-    xmlns:android="http://schemas.android.com/apk/res/android"
-    xmlns:aapt="http://schemas.android.com/aapt"
-    android:width="108dp"
-    android:height="108dp"
-    android:viewportWidth="108"
-    android:viewportHeight="108">
-  <path android:pathData="M31,63.928c0,0 6.4,-11 12.1,-13.1c7.2,-2.6 26,-1.4 26,-1.4l38.1,38.1L107,108.928l-32,-1L31,63.928z">
-    <aapt:attr name="android:fillColor">
-      <gradient
-          android:endX="85.84757"
-          android:endY="92.4963"
-          android:startX="42.9492"
-          android:startY="49.59793"
-          android:type="linear">
-        <item
-            android:color="#44000000"
-            android:offset="0.0" />
-        <item
-            android:color="#00000000"
-            android:offset="1.0" />
-      </gradient>
-    </aapt:attr>
-  </path>
-  <path
-      android:fillColor="#FFFFFF"
-      android:fillType="nonZero"
-      android:pathData="M65.3,45.828l3.8,-6.6c0.2,-0.4 0.1,-0.9 -0.3,-1.1c-0.4,-0.2 -0.9,-0.1 -1.1,0.3l-3.9,6.7c-6.3,-2.8 -13.4,-2.8 -19.7,0l-3.9,-6.7c-0.2,-0.4 -0.7,-0.5 -1.1,-0.3C38.8,38.328 38.7,38.828 38.9,39.228l3.8,6.6C36.2,49.428 31.7,56.028 31,63.928h46C76.3,56.028 71.8,49.428 65.3,45.828zM43.4,57.328c-0.8,0 -1.5,-0.5 -1.8,-1.2c-0.3,-0.7 -0.1,-1.5 0.4,-2.1c0.5,-0.5 1.4,-0.7 2.1,-0.4c0.7,0.3 1.2,1 1.2,1.8C45.3,56.528 44.5,57.328 43.4,57.328L43.4,57.328zM64.6,57.328c-0.8,0 -1.5,-0.5 -1.8,-1.2s-0.1,-1.5 0.4,-2.1c0.5,-0.5 1.4,-0.7 2.1,-0.4c0.7,0.3 1.2,1 1.2,1.8C66.5,56.528 65.6,57.328 64.6,57.328L64.6,57.328z"
-      android:strokeWidth="1"
-      android:strokeColor="#00000000" />
-</vector>

contacts/app/src/main/res/drawable/ic_launcher_background.xml

@@ -1,171 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-<vector
-    xmlns:android="http://schemas.android.com/apk/res/android"
-    android:width="108dp"
-    android:height="108dp"
-    android:viewportWidth="108"
-    android:viewportHeight="108">
-  <path
-      android:fillColor="#3DDC84"
-      android:pathData="M0,0h108v108h-108z" />
-  <path
-      android:fillColor="#00000000"
-      android:pathData="M9,0L9,108"
-      android:strokeWidth="0.8"
-      android:strokeColor="#33FFFFFF" />
-  <path
-      android:fillColor="#00000000"
-      android:pathData="M19,0L19,108"
-      android:strokeWidth="0.8"
-      android:strokeColor="#33FFFFFF" />
-  <path
-      android:fillColor="#00000000"
-      android:pathData="M29,0L29,108"
-      android:strokeWidth="0.8"
-      android:strokeColor="#33FFFFFF" />
-  <path
-      android:fillColor="#00000000"
-      android:pathData="M39,0L39,108"
-      android:strokeWidth="0.8"
-      android:strokeColor="#33FFFFFF" />
-  <path
-      android:fillColor="#00000000"
-      android:pathData="M49,0L49,108"
-      android:strokeWidth="0.8"
-      android:strokeColor="#33FFFFFF" />
-  <path
-      android:fillColor="#00000000"
-      android:pathData="M59,0L59,108"
-      android:strokeWidth="0.8"
-      android:strokeColor="#33FFFFFF" />
-  <path
-      android:fillColor="#00000000"
-      android:pathData="M69,0L69,108"
-      android:strokeWidth="0.8"
-      android:strokeColor="#33FFFFFF" />
-  <path
-      android:fillColor="#00000000"
-      android:pathData="M79,0L79,108"
-      android:strokeWidth="0.8"
-      android:strokeColor="#33FFFFFF" />
-  <path
-      android:fillColor="#00000000"
-      android:pathData="M89,0L89,108"
-      android:strokeWidth="0.8"
-      android:strokeColor="#33FFFFFF" />
-  <path
-      android:fillColor="#00000000"
-      android:pathData="M99,0L99,108"
-      android:strokeWidth="0.8"
-      android:strokeColor="#33FFFFFF" />
-  <path
-      android:fillColor="#00000000"
-      android:pathData="M0,9L108,9"
-      android:strokeWidth="0.8"
-      android:strokeColor="#33FFFFFF" />
-  <path
-      android:fillColor="#00000000"
-      android:pathData="M0,19L108,19"
-      android:strokeWidth="0.8"
-      android:strokeColor="#33FFFFFF" />
-  <path
-      android:fillColor="#00000000"
-      android:pathData="M0,29L108,29"
-      android:strokeWidth="0.8"
-      android:strokeColor="#33FFFFFF" />
-  <path
-      android:fillColor="#00000000"
-      android:pathData="M0,39L108,39"
-      android:strokeWidth="0.8"
-      android:strokeColor="#33FFFFFF" />
-  <path
-      android:fillColor="#00000000"
-      android:pathData="M0,49L108,49"
-      android:strokeWidth="0.8"
-      android:strokeColor="#33FFFFFF" />
-  <path
-      android:fillColor="#00000000"
-      android:pathData="M0,59L108,59"
-      android:strokeWidth="0.8"
-      android:strokeColor="#33FFFFFF" />
-  <path
-      android:fillColor="#00000000"
-      android:pathData="M0,69L108,69"
-      android:strokeWidth="0.8"
-      android:strokeColor="#33FFFFFF" />
-  <path
-      android:fillColor="#00000000"
-      android:pathData="M0,79L108,79"
-      android:strokeWidth="0.8"
-      android:strokeColor="#33FFFFFF" />
-  <path
-      android:fillColor="#00000000"
-      android:pathData="M0,89L108,89"
-      android:strokeWidth="0.8"
-      android:strokeColor="#33FFFFFF" />
-  <path
-      android:fillColor="#00000000"
-      android:pathData="M0,99L108,99"
-      android:strokeWidth="0.8"
-      android:strokeColor="#33FFFFFF" />
-  <path
-      android:fillColor="#00000000"
-      android:pathData="M19,29L89,29"
-      android:strokeWidth="0.8"
-      android:strokeColor="#33FFFFFF" />
-  <path
-      android:fillColor="#00000000"
-      android:pathData="M19,39L89,39"
-      android:strokeWidth="0.8"
-      android:strokeColor="#33FFFFFF" />
-  <path
-      android:fillColor="#00000000"
-      android:pathData="M19,49L89,49"
-      android:strokeWidth="0.8"
-      android:strokeColor="#33FFFFFF" />
-  <path
-      android:fillColor="#00000000"
-      android:pathData="M19,59L89,59"
-      android:strokeWidth="0.8"
-      android:strokeColor="#33FFFFFF" />
-  <path
-      android:fillColor="#00000000"
-      android:pathData="M19,69L89,69"
-      android:strokeWidth="0.8"
-      android:strokeColor="#33FFFFFF" />
-  <path
-      android:fillColor="#00000000"
-      android:pathData="M19,79L89,79"
-      android:strokeWidth="0.8"
-      android:strokeColor="#33FFFFFF" />
-  <path
-      android:fillColor="#00000000"
-      android:pathData="M29,19L29,89"
-      android:strokeWidth="0.8"
-      android:strokeColor="#33FFFFFF" />
-  <path
-      android:fillColor="#00000000"
-      android:pathData="M39,19L39,89"
-      android:strokeWidth="0.8"
-      android:strokeColor="#33FFFFFF" />
-  <path
-      android:fillColor="#00000000"
-      android:pathData="M49,19L49,89"
-      android:strokeWidth="0.8"
-      android:strokeColor="#33FFFFFF" />
-  <path
-      android:fillColor="#00000000"
-      android:pathData="M59,19L59,89"
-      android:strokeWidth="0.8"
-      android:strokeColor="#33FFFFFF" />
-  <path
-      android:fillColor="#00000000"
-      android:pathData="M69,19L69,89"
-      android:strokeWidth="0.8"
-      android:strokeColor="#33FFFFFF" />
-  <path
-      android:fillColor="#00000000"
-      android:pathData="M79,19L79,89"
-      android:strokeWidth="0.8"
-      android:strokeColor="#33FFFFFF" />
-</vector>

contacts/app/src/main/res/drawable/ic_launcher_foreground.xml

@@ -0,0 +1,15 @@
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    android:width="108dp"
+    android:height="108dp"
+    android:viewportWidth="108"
+    android:viewportHeight="108"
+    android:tint="#FFFFFF">
+  <group android:scaleX="2.0097"
+      android:scaleY="2.0097"
+      android:translateX="29.8836"
+      android:translateY="29.8836">
+    <path
+        android:fillColor="@android:color/white"
+        android:pathData="M20,0L4,0v2h16L20,0zM4,24h16v-2L4,22v2zM20,4L4,4c-1.1,0 -2,0.9 -2,2v12c0,1.1 0.9,2 2,2h16c1.1,0 2,-0.9 2,-2L22,6c0,-1.1 -0.9,-2 -2,-2zM12,6.75c1.24,0 2.25,1.01 2.25,2.25s-1.01,2.25 -2.25,2.25S9.75,10.24 9.75,9 10.76,6.75 12,6.75zM17,17L7,17v-1.5c0,-1.67 3.33,-2.5 5,-2.5s5,0.83 5,2.5L17,17z"/>
+  </group>
+</vector>

contacts/app/src/main/res/layout/activity_contact_lookup.xml

@@ -0,0 +1,35 @@
+<?xml version="1.0" encoding="utf-8"?>
+<androidx.constraintlayout.widget.ConstraintLayout
+    xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:app="http://schemas.android.com/apk/res-auto"
+    xmlns:tools="http://schemas.android.com/tools"
+    android:layout_width="match_parent"
+    android:layout_height="match_parent"
+    tools:context=".MainActivity">
+
+  <EditText
+      android:id="@+id/lookup_text"
+      android:layout_width="0dp"
+      android:layout_height="wrap_content"
+      app:layout_constraintStart_toStartOf="parent"
+      app:layout_constraintEnd_toStartOf="@id/lookup_button"
+      app:layout_constraintTop_toTopOf="parent"/>
+
+  <Button
+      android:id="@+id/lookup_button"
+      android:layout_width="wrap_content"
+      android:layout_height="wrap_content"
+      android:text="Lookup"
+      app:layout_constraintEnd_toEndOf="parent"
+      app:layout_constraintTop_toTopOf="parent"/>
+
+  <androidx.recyclerview.widget.RecyclerView
+      android:id="@+id/list"
+      android:layout_width="match_parent"
+      android:layout_height="0dp"
+      android:clipToPadding="false"
+      android:clipChildren="false"
+      app:layout_constraintTop_toBottomOf="@id/lookup_text"
+      app:layout_constraintBottom_toBottomOf="parent"/>
+
+</androidx.constraintlayout.widget.ConstraintLayout>

contacts/app/src/main/res/layout/activity_main.xml

@@ -11,12 +11,23 @@
         android:layout_width="wrap_content"
         android:layout_height="wrap_content"
         android:text="Contact List"
-        app:layout_constraintBottom_toTopOf="@id/link_contacts_button"
+        app:layout_constraintBottom_toTopOf="@id/contact_lookup_button"
         app:layout_constraintEnd_toEndOf="parent"
         app:layout_constraintStart_toStartOf="parent"
         app:layout_constraintTop_toTopOf="parent"
         app:layout_constraintVertical_chainStyle="packed"/>
 
+    <Button
+        android:id="@+id/contact_lookup_button"
+        android:layout_width="wrap_content"
+        android:layout_height="wrap_content"
+        android:text="Contact Lookup"
+        app:layout_constraintBottom_toTopOf="@id/link_contacts_button"
+        app:layout_constraintEnd_toEndOf="parent"
+        app:layout_constraintStart_toStartOf="parent"
+        app:layout_constraintTop_toBottomOf="@id/contact_list_button"
+        app:layout_constraintVertical_chainStyle="packed"/>
+
     <Button
         android:id="@+id/link_contacts_button"
         android:layout_width="wrap_content"
@@ -25,7 +36,7 @@
         app:layout_constraintBottom_toTopOf="@id/unlink_contact_button"
         app:layout_constraintEnd_toEndOf="parent"
         app:layout_constraintStart_toStartOf="parent"
-        app:layout_constraintTop_toBottomOf="@id/contact_list_button" />
+        app:layout_constraintTop_toBottomOf="@id/contact_lookup_button" />
 
     <Button
         android:id="@+id/unlink_contact_button"

contacts/app/src/main/res/mipmap-anydpi-v26/ic_launcher.xml

@@ -1,6 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<adaptive-icon
-    xmlns:android="http://schemas.android.com/apk/res/android">
-  <background android:drawable="@drawable/ic_launcher_background" />
-  <foreground android:drawable="@drawable/ic_launcher_foreground" />
+<adaptive-icon xmlns:android="http://schemas.android.com/apk/res/android">
+    <background android:drawable="@color/ic_launcher_background"/>
+    <foreground android:drawable="@drawable/ic_launcher_foreground"/>
 </adaptive-icon>

contacts/app/src/main/res/mipmap-anydpi-v26/ic_launcher_round.xml

@@ -1,6 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<adaptive-icon
-    xmlns:android="http://schemas.android.com/apk/res/android">
-  <background android:drawable="@drawable/ic_launcher_background" />
-  <foreground android:drawable="@drawable/ic_launcher_foreground" />
+<adaptive-icon xmlns:android="http://schemas.android.com/apk/res/android">
+    <background android:drawable="@color/ic_launcher_background"/>
+    <foreground android:drawable="@drawable/ic_launcher_foreground"/>
 </adaptive-icon>

contacts/app/src/main/res/values/ic_launcher_background.xml

@@ -0,0 +1,4 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+    <color name="ic_launcher_background">#3A76F0</color>
+</resources>

contacts/app/src/main/res/values/themes.xml

@@ -2,8 +2,8 @@
   <!-- Base application theme. -->
   <style name="Theme.ContactsTest" parent="Theme.MaterialComponents.DayNight.DarkActionBar">
     <!-- Primary brand color. -->
-    <item name="colorPrimary">@color/purple_500</item>
-    <item name="colorPrimaryVariant">@color/purple_700</item>
+    <item name="colorPrimary">#2c6bed</item>
+    <item name="colorPrimaryVariant">#1851b4</item>
     <item name="colorOnPrimary">@color/white</item>
     <!-- Secondary brand color. -->
     <item name="colorSecondary">@color/teal_200</item>

contacts/lib/src/main/java/org/signal/contacts/SystemContactsRepository.kt

@@ -38,7 +38,7 @@ object SystemContactsRepository {
   @JvmStatic
   fun getAllSystemContacts(context: Context, e164Formatter: (String) -> String): ContactIterator {
     val uri = ContactsContract.Data.CONTENT_URI
-    val projection = SqlUtil.buildArgs(
+    val projection = arrayOf(
       ContactsContract.Data.MIMETYPE,
       ContactsContract.CommonDataKinds.Phone.NUMBER,
       ContactsContract.CommonDataKinds.Phone.DISPLAY_NAME,
@@ -59,6 +59,50 @@ object SystemContactsRepository {
     return CursorContactIterator(cursor, e164Formatter)
   }
 
+  @JvmStatic
+  fun getContactDetailsByQueries(context: Context, queries: List<String>, e164Formatter: (String) -> String): ContactIterator {
+    val lookupKeys: MutableSet<String> = mutableSetOf()
+
+    for (query in queries) {
+      val lookupKeyUri: Uri = Uri.withAppendedPath(ContactsContract.Contacts.CONTENT_FILTER_URI, Uri.encode(query))
+      context.contentResolver.query(lookupKeyUri, arrayOf(ContactsContract.CommonDataKinds.Phone.LOOKUP_KEY), null, null, null).use { cursor ->
+        while (cursor != null && cursor.moveToNext()) {
+          val lookup: String? = cursor.requireString(ContactsContract.CommonDataKinds.Phone.LOOKUP_KEY)
+          if (lookup != null) {
+            lookupKeys += lookup
+          }
+        }
+      }
+    }
+
+    if (lookupKeys.isEmpty()) {
+      return EmptyContactIterator()
+    }
+
+    val uri = ContactsContract.Data.CONTENT_URI
+    val projection = arrayOf(
+      ContactsContract.Data.MIMETYPE,
+      ContactsContract.CommonDataKinds.Phone.NUMBER,
+      ContactsContract.CommonDataKinds.Phone.DISPLAY_NAME,
+      ContactsContract.CommonDataKinds.Phone.LABEL,
+      ContactsContract.CommonDataKinds.Phone.PHOTO_URI,
+      ContactsContract.CommonDataKinds.Phone._ID,
+      ContactsContract.CommonDataKinds.Phone.LOOKUP_KEY,
+      ContactsContract.CommonDataKinds.Phone.TYPE,
+      ContactsContract.CommonDataKinds.StructuredName.GIVEN_NAME,
+      ContactsContract.CommonDataKinds.StructuredName.FAMILY_NAME
+    )
+
+    val lookupPlaceholder = lookupKeys.map { "?" }.joinToString(separator = ",")
+
+    val where = "${ContactsContract.CommonDataKinds.Phone.LOOKUP_KEY} IN ($lookupPlaceholder) AND ${ContactsContract.Data.MIMETYPE} IN (?, ?)"
+    val args = lookupKeys.toTypedArray() + SqlUtil.buildArgs(ContactsContract.CommonDataKinds.Phone.CONTENT_ITEM_TYPE, ContactsContract.CommonDataKinds.StructuredName.CONTENT_ITEM_TYPE)
+    val orderBy = "${ContactsContract.CommonDataKinds.Phone.LOOKUP_KEY} ASC, ${ContactsContract.Data.MIMETYPE} DESC, ${ContactsContract.CommonDataKinds.Phone._ID} DESC"
+
+    val cursor: Cursor = context.contentResolver.query(uri, projection, where, args, orderBy) ?: return EmptyContactIterator()
+    return CursorContactIterator(cursor, e164Formatter)
+  }
+
   /**
    * Retrieves all unique display numbers in the system contacts. (By display, we mean not-E164-formatted)
    */