Mengintegrasikan Pengelola Kredensial dengan isi otomatis

Mulai Android 15 Beta 2, yang disambungkan dengan androidx.credentials:1.5.0-alpha01, developer dapat menautkan tampilan tertentu seperti kolom nama pengguna atau sandi dengan permintaan Pengelola Kredensial. Saat pengguna berfokus pada salah satu tampilan ini, permintaan yang sesuai akan dikirim ke Pengelola Kredensial. Kredensial yang dihasilkan digabungkan di seluruh penyedia dan ditampilkan di UI isi otomatis, seperti saran inline keyboard, atau saran drop-down. Fitur ini dapat digunakan sebagai penggantian saat pengguna tidak sengaja menutup pemilih akun Pengelola Kredensial, lalu mengetuk kolom yang relevan.

Library Jetpack androidx.credentials adalah endpoint pilihan bagi developer untuk digunakan untuk fitur ini.

Ilustrasi yang menampilkan kredensial di hasil isi otomatis
Gambar 1: Hasil isi otomatis dengan kredensial menggunakan sandi, kunci sandi, dan Login dengan Google.

Implementasi

Untuk menggunakan Pengelola Kredensial guna menampilkan kredensial dalam hasil isi otomatis, gunakan implementasi standar untuk membuat GetCredentialRequest, lalu tetapkan ke tampilan yang relevan. Penanganan responsnya sama, baik respons berasal dari panggilan API getCredential maupun PendingGetCredentialRequest, seperti yang ditunjukkan dalam contoh berikut.

Pertama, buat GetCredentialRequest:

Kotlin

// Retrieves the user's saved password for your app.
val getPasswordOption = GetPasswordOption()

// Get a passkey from the user's public key credential provider.
val getPublicKeyCredentialOption = GetPublicKeyCredentialOption(
    requestJson = requestJson
)

val getCredRequest = GetCredentialRequest(
    listOf(getPasswordOption, getPublicKeyCredentialOption)
)

Java

// Retrieves the user's saved password for your app.
GetPasswordOption getPasswordOption = new GetPasswordOption();

// Get a passkey from the user's public key credential provider.
GetPublicKeyCredentialOption getPublicKeyCredentialOption =
    new GetPublicKeyCredentialOption(requestJson);

GetCredentialRequest getCredRequest = new GetCredentialRequest(
    Arrays.asList(getPasswordOption, getPublicKeyCredentialOption)
);

Selanjutnya, panggil API getCredential. Tindakan ini akan menampilkan pemilih Pengelola Kredensial.

Kotlin

coroutineScope.launch {
    try {
        val result = credentialManager.getCredential(
            context = activityContext, // Use an activity-based context.
            request = getCredRequest
        )
        handleSignIn(result);
    } catch (GetCredentialException e) {
        handleFailure(e);
    }
}

Java

coroutineScope.launch(new CoroutineScopeRunnable() {
    @Override
    public void run(@NonNull CoroutineScope scope) {
        try {
            GetCredentialResponse result = credentialManager.getCredential(
                activityContext, // Use an activity-based context.
                getCredRequest
            );
            handleSignIn(result);
        } catch (GetCredentialException e) {
            handleFailure(e);
        }
    }
});

Terakhir, aktifkan pengalaman isi otomatis. Tetapkan getCredRequest ke tampilan yang relevan (seperti username, password) untuk mengaktifkan hasil kredensial dalam isi otomatis saat pengguna berinteraksi dengan tampilan ini.

Kotlin

import androidx.credentials.PendingGetCredentialRequest

usernameEditText.pendingGetCredentialRequest = PendingGetCredentialRequest(
    getCredRequest) { response -> handleSignIn(response)
}

passwordEditText.pendingGetCredentialRequest = PendingGetCredentialRequest(
    getCredRequest) { response -> handleSignIn(response)
}

Java

import androidx.credentials.CredentialManagerViewHandler;
import androidx.credentials.PendingGetCredentialRequest;

CredentialManagerViewHandler.setPendingGetCredentialRequest(
               usernameEditText, new PendingGetCredentialRequest(
                       getCredRequest, result -> {
                           handleSignIn(result);
                           return null;
                       }
               )

CredentialManagerViewHandler.setPendingGetCredentialRequest(
               passwordEditText, new PendingGetCredentialRequest(
                       getCredRequest, result -> {
                           handleSignIn(result);
                           return null;
                       }
               )