Produktneuheiten

Kontaktauswahl: Datenschutzorientierte Freigabe von Kontakten

Lesezeit: 4 Minuten
Roxanna Aliabadi Walker
Product Manager

Datenschutz und Nutzerkontrolle bleiben das Herzstück von Android. So wie die Fotogalerie die Freigabe von Medien sicher und einfach gemacht hat, bieten wir jetzt dasselbe Maß an Datenschutz, Einfachheit und Nutzerfreundlichkeit für die Auswahl von Kontakten.

Ein neuer Standard für den Datenschutz von Kontakten

Bisher haben Apps, die Zugriff auf die Kontakte eines bestimmten Nutzers benötigten, auf die umfassende Berechtigung READ_CONTACTS zurückgegriffen. Dieser Ansatz war zwar funktional, gewährte Apps aber oft mehr Daten als nötig. Die neue Android-Kontaktauswahl, die in Android 17 eingeführt wurde, ändert dies, indem sie eine standardisierte, sichere und durchsuchbare Oberfläche für die Auswahl von Kontakten bietet.

Mit dieser Funktion können Nutzer Apps nur Zugriff auf die von ihnen ausgewählten Kontakte gewähren. Das entspricht dem Android-Grundsatz der Datentransparenz und der Minimierung von Berechtigungen.

selection.png
picker.png

Funktionsweise

Entwickler können die Kontaktauswahl mit dem Intent Intent.ACTION_PICK_CONTACTS einbinden. Diese aktualisierte API bietet mehrere leistungsstarke Funktionen:

  • Granulare Datenanfragen:Apps können genau angeben, welche Felder sie benötigen, z. B. Telefonnummern oder E‑Mail-Adressen, anstatt den gesamten Kontaktdatensatz zu erhalten.
  • Unterstützung der Mehrfachauswahl:Die Auswahl unterstützt sowohl die Auswahl einzelner als auch mehrerer Kontakte, was Entwicklern mehr Flexibilität für Funktionen wie Gruppeneinladungen bietet.
  • Auswahlbeschränkungen:Entwickler können benutzerdefinierte Beschränkungen für die Anzahl der Kontakte festlegen, die ein Nutzer gleichzeitig auswählen kann.
  • Temporärer Zugriff:Nach der Auswahl gibt das System einen Sitzungs-URI zurück, der temporären Lesezugriff auf die angeforderten Daten ermöglicht. So wird sichergestellt, dass der Zugriff nicht länger als nötig besteht.
  • Zugriff auf andere Profile : Wenn Nutzer diesen neuen Intent verwenden, können sie in der Benutzeroberfläche Inhalte aus anderen Nutzerprofilen wie einem Arbeitsprofil, einem geklonten Profil oder einem privaten Bereich auswählen.
  • Optimierte Leistung : Die Kontaktauswahl gibt einen einzelnen URI zurück, der das kollektive Abfragen von Ergebnissen ermöglicht. Dadurch ist es nicht mehr erforderlich, einzelne Kontakt-URIs separat abzufragen, wie es bei ACTION_PICK der Fall ist. Durch diese Effizienz wird der Systemaufwand weiter reduziert, da nur eine einzige Binder-Transaktion verwendet wird.

Abwärtskompatibilität und Implementierung

Bei Geräten mit Android 17 oder höher werden Legacy-ACTION_PICK-Intents, die Kontaktdatentypen angeben, automatisch auf die neue, sicherere Schnittstelle aktualisiert. Um jedoch alle Vorteile der erweiterten Funktionen wie der Mehrfachauswahl nutzen zu können, sollten Entwickler ihren Implementierungscode aktualisieren und den zurückgegebenen Sitzungs-URI mit ContentResolver abfragen.


Kontaktauswahl integrierenEntwickler verwenden den Intent ACTION_PICK_CONTACTS, um die Kontaktauswahl zu integrieren. Unten sehen Sie ein Codebeispiel, das zeigt, wie Sie die Auswahl starten und bestimmte Datenfelder wie E-Mail-Adressen und Telefonnummern anfordern.

  // State to hold the list of selected contacts
var contacts by remember { mutableStateOf<List>(emptyList()) }
// Launcher for the Contact Picker intent
val pickContact = rememberLauncherForActivityResult(StartActivityForResult()) {
if (it.resultCode == Activity.RESULT_OK) {
val resultUri = it.data?.data ?: return@rememberLauncherForActivityResult
    // Process the result URI in a background thread
    coroutine.launch {
        contacts = processContactPickerResultUri(resultUri, context)
    }
}
}
// Define the specific contact data fields you need
val requestedFields = arrayListOf(
Email.CONTENT_ITEM_TYPE,
Phone.CONTENT_ITEM_TYPE,
)
// Set up the intent for the Contact Picker
val pickContactIntent = Intent(ACTION_PICK_CONTACTS).apply {
putExtra(EXTRA_PICK_CONTACTS_SELECTION_LIMIT, 5)
putStringArrayListExtra(
EXTRA_PICK_CONTACTS_REQUESTED_DATA_FIELDS,
requestedFields
)
putExtra(EXTRA_PICK_CONTACTS_MATCH_ALL_DATA_FIELDS, false)
}
// Launch the picker
pickContact.launch(pickContactIntent)

Nachdem der Nutzer eine Auswahl getroffen hat, verarbeitet die App das Ergebnis, indem sie die zurückgegebene Sitzungs-URI abfragt, um die angeforderten Kontaktdaten zu extrahieren.

  
// Data class representing a parsed Contact with selected details
data class Contact(val id: String, val name: String, val email: String?, val phone: String?)

// Helper function to query the content resolver with the URI returned by the Contact Picker.
// Parses the cursor to extract contact details such as name, email, and phone number
private suspend fun processContactPickerResultUri(
    sessionUri: Uri,
    context: Context
): List<Contact> = withContext(Dispatchers.IO) {
    // Define the columns we want to retrieve from the ContactPicker ContentProvider
    val projection = arrayOf(
        ContactsContract.Contacts._ID,
        ContactsContract.Contacts.DISPLAY_NAME_PRIMARY,
        ContactsContract.Data.MIMETYPE, // Type of data (e.g., email or phone)
        ContactsContract.Data.DATA1, // The actual data (Phone number / Email string)
    )

    val results = mutableListOf<Contact>()

    // Note: The Contact Picker Session Uri doesn't support custom selection & selectionArgs.
    context.contentResolver.query(sessionUri, projection, null, null, null)?.use { cursor ->
        // Get the column indices for our requested projection
        val contactIdIdx = cursor.getColumnIndex(ContactsContract.Contacts._ID)
        val mimeTypeIdx = cursor.getColumnIndex(ContactsContract.Data.MIMETYPE)
        val nameIdx = cursor.getColumnIndex(ContactsContract.Contacts.DISPLAY_NAME_PRIMARY)
        val data1Idx = cursor.getColumnIndex(ContactsContract.Data.DATA1)

        while (cursor.moveToNext()) {
            val contactId = cursor.getString(contactIdIdx)
            val mimeType = cursor.getString(mimeTypeIdx)
            val name = cursor.getString(nameIdx) ?: ""
            val data1 = cursor.getString(data1Idx) ?: ""

            // Determine if the current row represents an email or a phone number
            val email = if (mimeType == Email.CONTENT_ITEM_TYPE) data1 else null
            val phone = if (mimeType == Phone.CONTENT_ITEM_TYPE) data1 else null

            // Add the parsed contact to our results list
            results.add(Contact(contactId, name, email, phone))
        }
    }

    return@withContext results
}

Hier finden Sie die vollständige Dokumentation.

Best Practices für Entwickler

Für eine optimale Nutzererfahrung und hohe Sicherheitsstandards empfehlen wir Folgendes:

  • Datenminimierung:Fordern Sie nur die spezifischen Datenfelder (z.B. E-Mail-Adresse) an, die Ihre App benötigt.
  • Sofortige Persistenz:Speichern Sie ausgewählte Daten sofort, da der Zugriff auf den Sitzungs-URI nur vorübergehend ist.

Weiterlesen