Otomatik doldurma hizmetleri oluşturma

Otomatik doldurma hizmeti, diğer uygulamaların görünümlerine veri ekleyerek kullanıcıların formları daha kolay doldurmasını sağlayan bir uygulamadır. Otomatik doldurma hizmetleri, bir uygulamadaki görünümlerden kullanıcı verilerini alıp daha sonra kullanmak üzere saklayabilir. Otomatik doldurma hizmetleri genellikle şifre yöneticileri gibi kullanıcı verilerini yöneten uygulamalar tarafından sağlanır.

Android, Android 8.0 (API düzeyi 26) ve sonraki sürümlerde bulunan otomatik doldurma çerçevesiyle form doldurmayı kolaylaştırır. Kullanıcılar, otomatik doldurma özelliklerinden yalnızca cihazlarında otomatik doldurma hizmetleri sağlayan bir uygulama varsa yararlanabilir.

Bu sayfada, uygulamanıza otomatik doldurma hizmetini nasıl uygulayacağınız açıklanmaktadır. Bir hizmetin nasıl uygulanacağını gösteren kod örneği arıyorsanız Java veya Kotlin'deki AutofillFramework örneğine bakın. Otomatik doldurma hizmetlerinin işleyiş şekli hakkında daha fazla bilgi için AutofillService ve AutofillManager sınıflarının referans sayfalarına bakın.

Not: Android 11'den itibaren platform, klavyelerin ve diğer giriş yöntemi düzenleyicilerinin (IME'ler) açılır menü kullanmak yerine otomatik doldurma önerilerini satır içinde göstermesine olanak tanır. Otomatik doldurma hizmetinizin bu işlevi nasıl destekleyebileceği hakkında daha fazla bilgi için Otomatik doldurmayı klavyelerle entegre etme başlıklı makaleyi inceleyin.

Not: Otomatik doldurma hizmeti, öneri sunma dışındaki amaçlarla bilgi kullanmamalıdır.

Manifest beyanları ve izinleri

Otomatik doldurma hizmeti sunan uygulamalar, hizmetin uygulanışını açıklayan bir beyan içermelidir. Beyan etmek için uygulama manifest dosyasına bir <service> öğesi ekleyin. <service> öğesi aşağıdaki özellikleri ve öğeleri içermelidir:

• Hizmeti uygulayan uygulamada AutofillService alt sınıfını işaret eden android:name özelliği.
• BIND_AUTOFILL_SERVICE izinini beyan eden android:permission özelliği.
• Zorunlu <action> alt öğesi android.service.autofill.AutofillService işlemini belirten <intent-filter> öğesi.
• Hizmet için ek yapılandırma parametreleri sağlamak amacıyla kullanabileceğiniz isteğe bağlı <meta-data> öğesi.

Aşağıdaki örnekte bir otomatik doldurma hizmeti beyanı gösterilmektedir:

<service
    android:name=".MyAutofillService"
    android:label="My Autofill Service"
    android:permission="android.permission.BIND_AUTOFILL_SERVICE">
    <intent-filter>
        <action android:name="android.service.autofill.AutofillService" />
    </intent-filter>
    <meta-data
        android:name="android.autofill"
        android:resource="@xml/service_configuration" />
</service>

<meta-data> öğesi, hizmetle ilgili daha fazla ayrıntı içeren bir XML kaynağına işaret eden bir android:resource özelliği içerir. Önceki örnekteki service_configuration kaynağı, kullanıcıların hizmeti yapılandırmasına olanak tanıyan bir etkinlik belirtir. Aşağıdaki örnekte service_configuration XML kaynağı gösterilmektedir:

<autofill-service
  xmlns:android="http://schemas.android.com/apk/res/android"
  android:settingsActivity="com.example.android.SettingsActivity" />

XML kaynakları hakkında daha fazla bilgi için Uygulama kaynaklarına genel bakış başlıklı makaleyi inceleyin.

Hizmeti etkinleştirme istemi

Bir uygulama, BIND_AUTOFILL_SERVICE iznini beyan ettikten ve kullanıcı, cihaz ayarlarında bu uygulamayı etkinleştirdikten sonra otomatik doldurma hizmeti olarak kullanılır. Bir uygulama, AutofillManager sınıfının hasEnabledAutofillServices() yöntemini çağırarak şu anda etkin hizmetin kendisi olup olmadığını doğrulayabilir.

Uygulama, geçerli otomatik doldurma hizmeti değilse ACTION_REQUEST_SET_AUTOFILL_SERVICE intent'ini kullanarak kullanıcıdan otomatik doldurma ayarlarını değiştirmesini isteyebilir. Kullanıcı, arayanın paketiyle eşleşen bir otomatik doldurma hizmeti seçerse intent RESULT_OK değerini döndürür.

Not: Uygulamanızın oluşturduğu otomatik doldurma ayarlarını değiştirme isteklerinin sıklığına dikkat edin. Kullanıcıların uygulamanızla olan etkileşimlerini analiz edin ve ayarları yalnızca uygun senaryolarda değiştirmelerini isteyin.

Müşteri görüşlerini doldurma

Otomatik doldurma hizmeti, kullanıcı diğer uygulamalarla etkileşime geçtiğinde istemci görünümlerini doldurma istekleri alır. Otomatik doldurma hizmetinde isteği karşılayan kullanıcı verileri varsa verileri yanıtta gönderir. Android sistemi, 1. resimde gösterildiği gibi mevcut verileri içeren bir otomatik doldurma kullanıcı arayüzü gösterir:

Şekil 1. Bir veri kümesini gösteren otomatik doldurma kullanıcı arayüzü.

Otomatik doldurma çerçevesi, Android sisteminin otomatik doldurma hizmetine bağlı olduğu süreyi en aza indirmek için tasarlanmış, görünümleri doldurmaya yönelik bir iş akışı tanımlar. Android sistemi her istekte onFillRequest() yöntemini çağırarak hizmete bir AssistStructure nesnesi gönderir.

Otomatik doldurma hizmeti, isteği daha önce depoladığı kullanıcı verileriyle karşılayıp karşılayamayacağını kontrol eder. İsteği karşılayabiliyorsa hizmet, verileri Dataset nesnelerinde paketler. Hizmet, Dataset nesnelerini içeren bir FillResponse nesnesini ileterek onSuccess() yöntemini çağırır. Hizmet, isteği karşılayacak verilere sahip değilse null değerini onSuccess() yöntemine iletir.

İstek işlenirken bir hata oluşursa hizmet bunun yerine onFailure() yöntemini çağırır. İş akışının ayrıntılı açıklaması için AutofillService referans sayfasındaki açıklamaya göz atın.

Not: Android 10'dan itibaren, bir otomatik doldurma isteğinin uyumluluk modu aracılığıyla oluşturulup oluşturulmadığını belirlemek için FillRequest.FLAG_COMPATIBILITY_MODE_REQUEST işaretini kullanabilirsiniz.

Aşağıdaki kodda onFillRequest() yönteminin bir örneği gösterilmektedir:

Kotlin

override fun onFillRequest(
    request: FillRequest,
    cancellationSignal: CancellationSignal,
    callback: FillCallback
) {
    // Get the structure from the request
    val context: List<FillContext> = request.fillContexts
    val structure: AssistStructure = context[context.size - 1].structure

    // Traverse the structure looking for nodes to fill out
    val parsedStructure: ParsedStructure = parseStructure(structure)

    // Fetch user data that matches the fields
    val (username: String, password: String) = fetchUserData(parsedStructure)

    // Build the presentation of the datasets
    val usernamePresentation = RemoteViews(packageName, android.R.layout.simple_list_item_1)
    usernamePresentation.setTextViewText(android.R.id.text1, "my_username")
    val passwordPresentation = RemoteViews(packageName, android.R.layout.simple_list_item_1)
    passwordPresentation.setTextViewText(android.R.id.text1, "Password for my_username")

    // Add a dataset to the response
    val fillResponse: FillResponse = FillResponse.Builder()
            .addDataset(Dataset.Builder()
                    .setValue(
                            parsedStructure.usernameId,
                            AutofillValue.forText(username),
                            usernamePresentation
                    )
                    .setValue(
                            parsedStructure.passwordId,
                            AutofillValue.forText(password),
                            passwordPresentation
                    )
                    .build())
            .build()

    // If there are no errors, call onSuccess() and pass the response
    callback.onSuccess(fillResponse)
}

data class ParsedStructure(var usernameId: AutofillId, var passwordId: AutofillId)

data class UserData(var username: String, var password: String)

Java

@Override
public void onFillRequest(FillRequest request, CancellationSignal cancellationSignal, FillCallback callback) {
    // Get the structure from the request
    List<FillContext> context = request.getFillContexts();
    AssistStructure structure = context.get(context.size() - 1).getStructure();

    // Traverse the structure looking for nodes to fill out
    ParsedStructure parsedStructure = parseStructure(structure);

    // Fetch user data that matches the fields
    UserData userData = fetchUserData(parsedStructure);

    // Build the presentation of the datasets
    RemoteViews usernamePresentation = new RemoteViews(getPackageName(), android.R.layout.simple_list_item_1);
    usernamePresentation.setTextViewText(android.R.id.text1, "my_username");
    RemoteViews passwordPresentation = new RemoteViews(getPackageName(), android.R.layout.simple_list_item_1);
    passwordPresentation.setTextViewText(android.R.id.text1, "Password for my_username");

    // Add a dataset to the response
    FillResponse fillResponse = new FillResponse.Builder()
            .addDataset(new Dataset.Builder()
                    .setValue(parsedStructure.usernameId,
                            AutofillValue.forText(userData.username), usernamePresentation)
                    .setValue(parsedStructure.passwordId,
                            AutofillValue.forText(userData.password), passwordPresentation)
                    .build())
            .build();

    // If there are no errors, call onSuccess() and pass the response
    callback.onSuccess(fillResponse);
}

class ParsedStructure {
    AutofillId usernameId;
    AutofillId passwordId;
}

class UserData {
    String username;
    String password;
}

Bir hizmetin, isteği karşılayan birden fazla veri kümesi olabilir. Bu durumda Android sistemi, otomatik doldurma kullanıcı arayüzünde her veri kümesi için bir tane olmak üzere birden fazla seçenek gösterir. Aşağıdaki kod örneğinde, bir yanıtta birden fazla veri kümesinin nasıl sağlanacağı gösterilmektedir:

Kotlin

// Add multiple datasets to the response
val fillResponse: FillResponse = FillResponse.Builder()
        .addDataset(Dataset.Builder()
                .setValue(parsedStructure.usernameId,
                        AutofillValue.forText(user1Data.username), username1Presentation)
                .setValue(parsedStructure.passwordId,
                        AutofillValue.forText(user1Data.password), password1Presentation)
                .build())
        .addDataset(Dataset.Builder()
                .setValue(parsedStructure.usernameId,
                        AutofillValue.forText(user2Data.username), username2Presentation)
                .setValue(parsedStructure.passwordId,
                        AutofillValue.forText(user2Data.password), password2Presentation)
                .build())
        .build()

Java

// Add multiple datasets to the response
FillResponse fillResponse = new FillResponse.Builder()
        .addDataset(new Dataset.Builder()
                .setValue(parsedStructure.usernameId,
                        AutofillValue.forText(user1Data.username), username1Presentation)
                .setValue(parsedStructure.passwordId,
                        AutofillValue.forText(user1Data.password), password1Presentation)
                .build())
        .addDataset(new Dataset.Builder()
                .setValue(parsedStructure.usernameId,
                        AutofillValue.forText(user2Data.username), username2Presentation)
                .setValue(parsedStructure.passwordId,
                        AutofillValue.forText(user2Data.password), password2Presentation)
                .build())
        .build();

Otomatik doldurma hizmetleri, isteği yerine getirmek için gereken otomatik doldurma verilerini almak üzere AssistStructure içindeki ViewNode nesnelerinde gezinebilir. Bir hizmet, ViewNode sınıfının getAutofillId() gibi yöntemlerini kullanarak otomatik doldurma verilerini alabilir.

Bir hizmet, isteği karşılayıp karşılayamayacağını kontrol etmek için bir görünümün içeriğini tanımlayabilmelidir. Bir hizmetin, görünümün içeriğini açıklamak için kullanması gereken ilk yaklaşım autofillHints özelliğini kullanmaktır. Ancak istemci uygulamaları, bu özelliği hizmette kullanıma sunulmadan önce görünümlerinde açıkça sağlamalıdır.

Bir istemci uygulaması autofillHints özelliğini sağlamazsa hizmet, içerikleri tanımlamak için kendi sezgisel yaklaşımlarını kullanmalıdır. Hizmet, görünümün içeriği hakkında bilgi edinmek için getText() veya getHint() gibi diğer sınıflardaki yöntemleri kullanabilir. Daha fazla bilgi için Otomatik doldurma için ipucu sağlama başlıklı makaleyi inceleyin.

Aşağıdaki örnekte, AssistStructure öğesinin nasıl taranacağı ve bir ViewNode nesnesinden otomatik doldurma verilerinin nasıl alınacağı gösterilmektedir:

Kotlin

fun traverseStructure(structure: AssistStructure) {
    val windowNodes: List<AssistStructure.WindowNode> =
            structure.run {
                (0 until windowNodeCount).map { getWindowNodeAt(it) }
            }

    windowNodes.forEach { windowNode: AssistStructure.WindowNode ->
        val viewNode: ViewNode? = windowNode.rootViewNode
        traverseNode(viewNode)
    }
}

fun traverseNode(viewNode: ViewNode?) {
    if (viewNode?.autofillHints?.isNotEmpty() == true) {
        // If the client app provides autofill hints, you can obtain them using
        // viewNode.getAutofillHints();
    } else {
        // Or use your own heuristics to describe the contents of a view
        // using methods such as getText() or getHint()
    }

    val children: List<ViewNode>? =
            viewNode?.run {
                (0 until childCount).map { getChildAt(it) }
            }

    children?.forEach { childNode: ViewNode ->
        traverseNode(childNode)
    }
}

Java

public void traverseStructure(AssistStructure structure) {
    int nodes = structure.getWindowNodeCount();

    for (int i = 0; i < nodes; i++) {
        WindowNode windowNode = structure.getWindowNodeAt(i);
        ViewNode viewNode = windowNode.getRootViewNode();
        traverseNode(viewNode);
    }
}

public void traverseNode(ViewNode viewNode) {
    if(viewNode.getAutofillHints() != null && viewNode.getAutofillHints().length > 0) {
        // If the client app provides autofill hints, you can obtain them using
        // viewNode.getAutofillHints();
    } else {
        // Or use your own heuristics to describe the contents of a view
        // using methods such as getText() or getHint()
    }

    for(int i = 0; i < viewNode.getChildCount(); i++) {
        ViewNode childNode = viewNode.getChildAt(i);
        traverseNode(childNode);
    }
}

Not: Çoğu görünüm, View sınıfına dahil edilen AUTOFILL_HINT değerlerinin listesine uygun autofillHints özellikleri sağlar. Ancak HtmlInfo gibi görünümlerin, W3C otomatik tamamlama özelliği sayfasında listelenen özelliklerle uyumlu olma olasılığı daha yüksektir.

Kullanıcı verilerini kaydetme

Bir otomatik doldurma hizmetinin, uygulamalardaki görünümleri doldurmak için kullanıcı verilerine ihtiyacı vardır. Kullanıcılar bir görünümü manuel olarak doldurduğunda, verileri mevcut otomatik doldurma hizmetine kaydetmeleri istenir (Şekil 2).

Şekil 2. Otomatik doldurma kaydetme kullanıcı arayüzü.

Verileri kaydedebilmek için hizmetin, verileri gelecekte kullanmak üzere saklamak istediğini belirtmesi gerekir. Android sistemi verileri kaydetme isteği göndermeden önce, hizmetin görünümleri doldurma fırsatı bulduğu bir doldurma isteği gönderilir. Hizmet, verileri kaydetmek istediğini belirtmek için doldurma isteğinin yanıtına bir SaveInfo nesnesi ekler. SaveInfo nesnesi en az aşağıdaki verileri içerir:

• Kaydedilen kullanıcı verilerinin türü. Kullanılabilir SAVE_DATA değerlerinin listesi için SaveInfo bölümüne bakın.
• Bir kaydetme isteğini tetiklemek için değiştirilmesi gereken minimum görüntüleme grubu. Örneğin, bir giriş formunda kullanıcının kaydetme isteğini tetiklemek için genellikle username ve password görünümlerini güncellemesi gerekir.

Aşağıdaki kod örneğinde gösterildiği gibi, bir SaveInfo nesnesi bir FillResponse nesnesi ile ilişkilendirilir:

Kotlin

override fun onFillRequest(
    request: FillRequest,
    cancellationSignal: CancellationSignal,
    callback: FillCallback
) {
    ...
    // Builder object requires a non-null presentation
    val notUsed = RemoteViews(packageName, android.R.layout.simple_list_item_1)

    val fillResponse: FillResponse = FillResponse.Builder()
            .addDataset(
                    Dataset.Builder()
                            .setValue(parsedStructure.usernameId, null, notUsed)
                            .setValue(parsedStructure.passwordId, null, notUsed)
                            .build()
            )
            .setSaveInfo(
                    SaveInfo.Builder(
                            SaveInfo.SAVE_DATA_TYPE_USERNAME or SaveInfo.SAVE_DATA_TYPE_PASSWORD,
                            arrayOf(parsedStructure.usernameId, parsedStructure.passwordId)
                    ).build()
            )
            .build()
    ...
}

Java

@Override
public void onFillRequest(FillRequest request, CancellationSignal cancellationSignal, FillCallback callback) {
    ...
    // Builder object requires a non-null presentation
    RemoteViews notUsed = new RemoteViews(getPackageName(), android.R.layout.simple_list_item_1);

    FillResponse fillResponse = new FillResponse.Builder()
            .addDataset(new Dataset.Builder()
                    .setValue(parsedStructure.usernameId, null, notUsed)
                    .setValue(parsedStructure.passwordId, null, notUsed)
                    .build())
            .setSaveInfo(new SaveInfo.Builder(
                    SaveInfo.SAVE_DATA_TYPE_USERNAME | SaveInfo.SAVE_DATA_TYPE_PASSWORD,
                    new AutofillId[] {parsedStructure.usernameId, parsedStructure.passwordId})
                    .build())
            .build();
    ...
}

Otomatik doldurma hizmeti, kullanıcı verilerini onSaveRequest() yönteminde kalıcı hale getirmek için mantık uygulayabilir. Bu yöntem genellikle istemci etkinliği sona erdikten sonra veya istemci uygulaması commit()'i çağrdığında çağrılır. Aşağıdaki kodda onSaveRequest() yönteminin bir örneği gösterilmektedir:

Kotlin

override fun onSaveRequest(request: SaveRequest, callback: SaveCallback) {
    // Get the structure from the request
    val context: List<FillContext> = request.fillContexts
    val structure: AssistStructure = context[context.size - 1].structure

    // Traverse the structure looking for data to save
    traverseStructure(structure)

    // Persist the data - if there are no errors, call onSuccess()
    callback.onSuccess()
}

Java

@Override
public void onSaveRequest(SaveRequest request, SaveCallback callback) {
    // Get the structure from the request
    List<FillContext> context = request.getFillContexts();
    AssistStructure structure = context.get(context.size() - 1).getStructure();

    // Traverse the structure looking for data to save
    traverseStructure(structure);

    // Persist the data - if there are no errors, call onSuccess()
    callback.onSuccess();
}

Otomatik doldurma hizmetleri, hassas verileri kalıcı hale getirmeden önce şifrelemelidir. Ancak kullanıcı verileri hassas olmayan etiketler veya veriler içerebilir. Örneğin, bir kullanıcı hesabı, verileri iş veya kişisel hesap olarak işaretleyen bir etiket içerebilir. Hizmetler, etiketleri şifrelemelidir. Hizmetler, etiketleri şifrelemeden kullanıcı kimlik doğrulaması yapmamışsa sunu görünümlerinde etiketleri kullanabilir. Ardından hizmetler, kullanıcı kimliğini doğruladıktan sonra etiketleri gerçek verilerle değiştirebilir.

Otomatik doldurmayı kaydetme kullanıcı arayüzünü ertele

Android 10'dan itibaren, otomatik doldurma iş akışını uygulamak için birden fazla ekran kullanıyorsanız (ör. kullanıcı adı alanı için bir ekran, şifre için başka bir ekran) SaveInfo.FLAG_DELAY_SAVE işaretçisini kullanarak otomatik doldurma kaydetme kullanıcı arayüzünü erteleyebilirsiniz.

Bu işaret ayarlanırsa SaveInfo yanıtıyla ilişkili otomatik doldurma bağlamı sabitlendiğinde otomatik doldurma kaydetme kullanıcı arayüzü tetiklenmez. Bunun yerine, gelecekteki doldurma isteklerini yayınlamak için aynı görevde ayrı bir etkinlik kullanabilir ve ardından kullanıcı arayüzünü bir kayıt isteği aracılığıyla gösterebilirsiniz. Daha fazla bilgi için SaveInfo.FLAG_DELAY_SAVE başlıklı makaleyi inceleyin.

Kullanıcı kimlik doğrulamasını zorunlu kılın

Otomatik doldurma hizmetleri, kullanıcının görünümleri doldurmadan önce kimlik doğrulamasını zorunlu kılarak ek bir güvenlik düzeyi sağlayabilir. Aşağıdaki senaryolar, kullanıcı kimlik doğrulamasını uygulamak için uygundur:

• Uygulamadaki kullanıcı verilerinin kilidinin birincil şifre veya parmak izi taraması kullanılarak açılması gerekir.
• Kart doğrulama kodu (CVC) kullanılarak kredi kartı bilgileri gibi belirli bir veri kümesinin kilidinin açılması gerekir.

Hizmetin, verilerin kilidini açmadan önce kullanıcı kimlik doğrulaması gerektirdiği bir senaryoda, hizmet standart veriler veya bir etiket sunabilir ve kimlik doğrulamayı yapan Intent'ı belirtebilir. Kimlik doğrulama akışı tamamlandıktan sonra isteği işlemek için ek verilere ihtiyacınız varsa bu tür verileri intent'e ekleyebilirsiniz. Kimlik doğrulama etkinliğiniz, verileri uygulamanızdaki AutofillService sınıfına döndürebilir.

Aşağıdaki kod örneğinde, isteğin kimlik doğrulama gerektirdiğinin nasıl belirtileceği gösterilmektedir:

Kotlin

val authPresentation = RemoteViews(packageName, android.R.layout.simple_list_item_1).apply {
    setTextViewText(android.R.id.text1, "requires authentication")
}
val authIntent = Intent(this, AuthActivity::class.java).apply {
    // Send any additional data required to complete the request
    putExtra(MY_EXTRA_DATASET_NAME, "my_dataset")
}

val intentSender: IntentSender = PendingIntent.getActivity(
        this,
        1001,
        authIntent,
        PendingIntent.FLAG_CANCEL_CURRENT
).intentSender

// Build a FillResponse object that requires authentication
val fillResponse: FillResponse = FillResponse.Builder()
        .setAuthentication(autofillIds, intentSender, authPresentation)
        .build()

Java

RemoteViews authPresentation = new RemoteViews(getPackageName(), android.R.layout.simple_list_item_1);
authPresentation.setTextViewText(android.R.id.text1, "requires authentication");
Intent authIntent = new Intent(this, AuthActivity.class);

// Send any additional data required to complete the request
authIntent.putExtra(MY_EXTRA_DATASET_NAME, "my_dataset");
IntentSender intentSender = PendingIntent.getActivity(
                this,
                1001,
                authIntent,
                PendingIntent.FLAG_CANCEL_CURRENT
        ).getIntentSender();

// Build a FillResponse object that requires authentication
FillResponse fillResponse = new FillResponse.Builder()
        .setAuthentication(autofillIds, intentSender, authPresentation)
        .build();

Etkinlik, kimlik doğrulama akışını tamamladıktan sonra RESULT_OK değeri göndererek setResult() yöntemini çağırmalı ve EXTRA_AUTHENTICATION_RESULT ekstrasını, doldurulmuş veri kümesini içeren FillResponse nesnesine ayarlamalıdır. Aşağıdaki kodda, kimlik doğrulama akışı tamamlandıktan sonra sonucun nasıl döndürüleceğiyle ilgili bir örnek gösterilmektedir:

Kotlin

// The data sent by the service and the structure are included in the intent
val datasetName: String? = intent.getStringExtra(MY_EXTRA_DATASET_NAME)
val structure: AssistStructure = intent.getParcelableExtra(EXTRA_ASSIST_STRUCTURE)
val parsedStructure: ParsedStructure = parseStructure(structure)
val (username, password) = fetchUserData(parsedStructure)

// Build the presentation of the datasets
val usernamePresentation =
        RemoteViews(packageName, android.R.layout.simple_list_item_1).apply {
            setTextViewText(android.R.id.text1, "my_username")
        }
val passwordPresentation =
        RemoteViews(packageName, android.R.layout.simple_list_item_1).apply {
            setTextViewText(android.R.id.text1, "Password for my_username")
        }

// Add the dataset to the response
val fillResponse: FillResponse = FillResponse.Builder()
        .addDataset(Dataset.Builder()
                .setValue(
                        parsedStructure.usernameId,
                        AutofillValue.forText(username),
                        usernamePresentation
                )
                .setValue(
                        parsedStructure.passwordId,
                        AutofillValue.forText(password),
                        passwordPresentation
                )
                .build()
        ).build()

val replyIntent = Intent().apply {
    // Send the data back to the service
    putExtra(MY_EXTRA_DATASET_NAME, datasetName)
    putExtra(EXTRA_AUTHENTICATION_RESULT, fillResponse)
}

setResult(Activity.RESULT_OK, replyIntent)

Java

Intent intent = getIntent();

// The data sent by the service and the structure are included in the intent
String datasetName = intent.getStringExtra(MY_EXTRA_DATASET_NAME);
AssistStructure structure = intent.getParcelableExtra(EXTRA_ASSIST_STRUCTURE);
ParsedStructure parsedStructure = parseStructure(structure);
UserData userData = fetchUserData(parsedStructure);

// Build the presentation of the datasets
RemoteViews usernamePresentation = new RemoteViews(getPackageName(), android.R.layout.simple_list_item_1);
usernamePresentation.setTextViewText(android.R.id.text1, "my_username");
RemoteViews passwordPresentation = new RemoteViews(getPackageName(), android.R.layout.simple_list_item_1);
passwordPresentation.setTextViewText(android.R.id.text1, "Password for my_username");

// Add the dataset to the response
FillResponse fillResponse = new FillResponse.Builder()
        .addDataset(new Dataset.Builder()
                .setValue(parsedStructure.usernameId,
                        AutofillValue.forText(userData.username), usernamePresentation)
                .setValue(parsedStructure.passwordId,
                        AutofillValue.forText(userData.password), passwordPresentation)
                .build())
        .build();

Intent replyIntent = new Intent();

// Send the data back to the service
replyIntent.putExtra(MY_EXTRA_DATASET_NAME, datasetName);
replyIntent.putExtra(EXTRA_AUTHENTICATION_RESULT, fillResponse);

setResult(RESULT_OK, replyIntent);

Bir kredi kartı veri kümesinin kilidinin açılması gereken senaryoda, hizmet CVV'yi isteyen bir kullanıcı arayüzü görüntüleyebilir. Banka adı ve kredi kartı numarasının son dört hanesi gibi ortak veriler sunarak, veri kümesi kilitlenene kadar verileri gizleyebilirsiniz. Aşağıdaki örnekte, bir veri kümesi için kimlik doğrulamanın nasıl zorunlu kılınacağı ve kullanıcı CVC'yi sağlayana kadar verilerin nasıl gizleneceği gösterilmektedir:

Kotlin

// Parse the structure and fetch payment data
val parsedStructure: ParsedStructure = parseStructure(structure)
val paymentData: Payment = fetchPaymentData(parsedStructure)

// Build the presentation that shows the bank and the last four digits of the
// credit card number, such as 'Bank-1234'
val maskedPresentation: String = "${paymentData.bank}-" +
        paymentData.creditCardNumber.substring(paymentData.creditCardNumber.length - 4)
val authPresentation = RemoteViews(packageName, android.R.layout.simple_list_item_1).apply {
    setTextViewText(android.R.id.text1, maskedPresentation)
}

// Prepare an intent that displays the UI that asks for the CVC
val cvcIntent = Intent(this, CvcActivity::class.java)
val cvcIntentSender: IntentSender = PendingIntent.getActivity(
        this,
        1001,
        cvcIntent,
        PendingIntent.FLAG_CANCEL_CURRENT
).intentSender

// Build a FillResponse object that includes a Dataset that requires authentication
val fillResponse: FillResponse = FillResponse.Builder()
        .addDataset(
                Dataset.Builder()
                        // The values in the dataset are replaced by the actual
                        // data once the user provides the CVC
                        .setValue(parsedStructure.creditCardId, null, authPresentation)
                        .setValue(parsedStructure.expDateId, null, authPresentation)
                        .setAuthentication(cvcIntentSender)
                        .build()
        ).build()

Java

// Parse the structure and fetch payment data
ParsedStructure parsedStructure = parseStructure(structure);
Payment paymentData = fetchPaymentData(parsedStructure);

// Build the presentation that shows the bank and the last four digits of the
// credit card number, such as 'Bank-1234'
String maskedPresentation = paymentData.bank + "-" +
    paymentData.creditCardNumber.subString(paymentData.creditCardNumber.length - 4);
RemoteViews authPresentation = new RemoteViews(getPackageName(), android.R.layout.simple_list_item_1);
authPresentation.setTextViewText(android.R.id.text1, maskedPresentation);

// Prepare an intent that displays the UI that asks for the CVC
Intent cvcIntent = new Intent(this, CvcActivity.class);
IntentSender cvcIntentSender = PendingIntent.getActivity(
        this,
        1001,
        cvcIntent,
        PendingIntent.FLAG_CANCEL_CURRENT
).getIntentSender();

// Build a FillResponse object that includes a Dataset that requires authentication
FillResponse fillResponse = new FillResponse.Builder()
        .addDataset(new Dataset.Builder()
                // The values in the dataset are replaced by the actual
                // data once the user provides the CVC
                .setValue(parsedStructure.creditCardId, null, authPresentation)
                .setValue(parsedStructure.expDateId, null, authPresentation)
                .setAuthentication(cvcIntentSender)
                .build())
        .build();

Etkinlik, CVC'yi doğruladıktan sonra setResult() yöntemini çağırarak bir RESULT_OK değeri iletmeli ve EXTRA_AUTHENTICATION_RESULT ekstrasını, kredi kartı numarasını ve son kullanma tarihini içeren bir Dataset nesnesine ayarlamalıdır. Yeni veri kümesi, kimlik doğrulama gerektiren veri kümesinin yerini alır ve görünümler hemen doldurulur. Aşağıdaki kodda, kullanıcı CVC'yi sağladıktan sonra veri kümesinin nasıl döndürüleceği gösterilmektedir:

Kotlin

// Parse the structure and fetch payment data.
val parsedStructure: ParsedStructure = parseStructure(structure)
val paymentData: Payment = fetchPaymentData(parsedStructure)

// Build a non-null RemoteViews object to use as the presentation when
// creating the Dataset object. This presentation isn't actually used, but the
// Builder object requires a non-null presentation.
val notUsed = RemoteViews(packageName, android.R.layout.simple_list_item_1)

// Create a dataset with the credit card number and expiration date.
val responseDataset: Dataset = Dataset.Builder()
        .setValue(
                parsedStructure.creditCardId,
                AutofillValue.forText(paymentData.creditCardNumber),
                notUsed
        )
        .setValue(
                parsedStructure.expDateId,
                AutofillValue.forText(paymentData.expirationDate),
                notUsed
        )
        .build()

val replyIntent = Intent().apply {
    putExtra(EXTRA_AUTHENTICATION_RESULT, responseDataset)
}

Java

// Parse the structure and fetch payment data.
ParsedStructure parsedStructure = parseStructure(structure);
Payment paymentData = fetchPaymentData(parsedStructure);

// Build a non-null RemoteViews object to use as the presentation when
// creating the Dataset object. This presentation isn't actually used, but the
// Builder object requires a non-null presentation.
RemoteViews notUsed = new RemoteViews(getPackageName(), android.R.layout.simple_list_item_1);

// Create a dataset with the credit card number and expiration date.
Dataset responseDataset = new Dataset.Builder()
        .setValue(parsedStructure.creditCardId,
                AutofillValue.forText(paymentData.creditCardNumber), notUsed)
        .setValue(parsedStructure.expDateId,
                AutofillValue.forText(paymentData.expirationDate), notUsed)
        .build();

Intent replyIntent = new Intent();
replyIntent.putExtra(EXTRA_AUTHENTICATION_RESULT, responseDataset);

Verileri mantıksal gruplar halinde düzenleme

Otomatik doldurma hizmetleri, verileri farklı alanlardaki kavramları ayıran mantıksal gruplar halinde düzenlemelidir. Bu sayfadaki mantıksal gruplara bölümler denir. Aşağıdaki listede, bölüm ve alanlara ilişkin tipik örnekler verilmiştir:

• Kullanıcı adı ve şifre alanlarını içeren kimlik bilgileri.
• Cadde, şehir, eyalet ve posta kodu alanlarını içeren adres.
• Kredi kartı numarası, son kullanma tarihi ve doğrulama kodu alanlarını içeren ödeme bilgileri.

Verileri doğru şekilde bölümleyen bir otomatik doldurma hizmeti, bir veri kümesinde birden fazla bölümden gelen verileri göstermeden kullanıcılarının verilerini daha iyi koruyabiliyor. Örneğin, kimlik bilgilerini içeren bir veri kümesinin ödeme bilgilerini içermesi gerekmez. Verileri bölümlere ayırmak, hizmetinizin bir isteği karşılamak için gereken minimum miktarda alakalı bilgiyi göstermesine olanak tanır.

Verilerin bölümler halinde düzenlenmesi, hizmetlerin birden fazla bölümden görünümlere sahip etkinlikleri doldurmasını ve istemci uygulamasına minimum miktarda ilgili veri göndermesini sağlar. Örneğin, kullanıcı adı, şifre, sokak ve şehir görünümleri içeren bir etkinliği ve aşağıdaki verileri içeren bir otomatik doldurma hizmetini ele alalım:

Bölüm	Alan 1	Alan 2
Kimlik Bilgisi	iş_kullanıcı_adı	iş_şifresi
	personal_username	personal_password
Adres	work_street	work_city
	personal_street	personal_city

Hizmet, hem iş hem de kişisel hesaplar için kimlik bilgileri bölümünü içeren bir veri kümesi hazırlayabilir. Kullanıcı bir veri kümesi seçtiğinde, daha sonraki bir otomatik doldurma yanıtı, kullanıcının ilk tercihine bağlı olarak iş adresini veya kişisel adresini sağlayabilir.

Bir hizmet, AssistStructure nesnesini gezerken isFocused() yöntemini çağırarak isteği başlatan alanı tanımlayabilir. Bu sayede hizmet, uygun bölüm verileriyle bir FillResponse hazırlayabilir.

SMS tek seferlik kodunu otomatik doldurma

Otomatik doldurma hizmetiniz, SMS Retriever API'yi kullanarak kullanıcıya SMS ile gönderilen tek seferlik kodları doldurmasına yardımcı olabilir.

Bu özelliği kullanabilmek için aşağıdaki koşulların karşılanması gerekir:

• Otomatik doldurma hizmeti, Android 9 (API düzeyi 28) veya sonraki sürümlerde çalışıyor.
• Kullanıcı, otomatik doldurma hizmetinizin SMS'deki tek seferlik kodları okuması için izin verir.
• Otomatik doldurma özelliğini sağladığınız uygulama, tek kullanımlık kodları okumak için SMS Retriever API'yi kullanmıyor.

Otomatik doldurma hizmetiniz, Google Play Hizmetleri 19.0.56 veya sonraki sürümlerde SmsCodeRetriever.getAutofillClient() çağrısı yaparak kullanılabilen SmsCodeAutofillClient'i kullanabilir.

Bu API'yi bir otomatik doldurma hizmetinde kullanmak için birincil adımlar şunlardır:

1. Otomatik doldurma hizmetinde, otomatik olarak doldurduğunuz uygulamanın paket adı için etkin istek olup olmadığını belirlemek üzere SmsCodeAutofillClient adresindeki hasOngoingSmsRequest değerini kullanın. Otomatik doldurma hizmetiniz yalnızca bu değer false döndürülürse bir öneri istemi göstermelidir.
2. Otomatik doldurma hizmetinin tek seferlik kodları otomatik olarak doldurma izni olup olmadığını kontrol etmek için otomatik doldurma hizmetinde SmsCodeAutofillClient'ten checkPermissionState'u kullanın. Bu izin durumu NONE, GRANTED veya DENIED olabilir. Otomatik doldurma hizmeti, NONE ve GRANTED eyaletleri için bir öneri istemi göstermelidir.
3. Otomatik doldurma kimlik doğrulama etkinliğinde, SMS kodu sonucu mevcut olduğunda SmsCodeRetriever.SMS_CODE_RETRIEVED_ACTION için BroadcastReceiver dinleme etkinliği kaydetmek üzere SmsRetriever.SEND_PERMISSION iznini kullanın.

4. SMS ile gönderilen tek seferlik kodları dinlemeye başlamak için SmsCodeAutofillClient numaralı telefondan startSmsCodeRetriever numaralı telefonu arayın. Kullanıcı, otomatik doldurma hizmetinizin SMS'den tek seferlik kodları almasına izin verirse bu işlem, şu andan itibaren son bir ila beş dakika içinde alınan SMS mesajlarını arar.

   Otomatik doldurma hizmetinizin tek kullanımlık kodları okumak için kullanıcı izni istemesi gerekiyorsa startSmsCodeRetriever tarafından döndürülen Task, ResolvableApiException döndürülerek başarısız olabilir. Bu durumda, izin isteği için kullanıcı rızası iletişim kutusu görüntülemek üzere ResolvableApiException.startResolutionForResult() yöntemini çağırmanız gerekir.

5. Intent'ten SMS kodu sonucunu alın ve ardından SMS kodunu otomatik doldurma yanıtı olarak döndürün.

Not: Yayın intent'inin SMS Retriever API'den geldiğini algılamak için alıcınıza com.google.android.gms.auth.api.phone.permission.SEND iznini ekleyebilirsiniz. Bu izin ayarı, Google Play Hizmetleri 19.8.31 veya sonraki sürümlerde kullanılabilir.

Gelişmiş otomatik doldurma senaryoları

Klavyeyle entegrasyon

Android 11'den itibaren platform, klavyelerin ve diğer giriş yöntemi düzenleyicilerin (IME'ler) açılır menü kullanmak yerine satır içi otomatik doldurma önerileri göstermesine olanak tanır. Otomatik doldurma hizmetinizin bu işlevi nasıl destekleyebileceği hakkında daha fazla bilgi için Otomatik doldurmayı klavyelerle entegre etme başlıklı makaleyi inceleyin.

Veri kümelerini sayfalara ayırma

Büyük bir otomatik doldurma yanıtı, isteği işlemek için gereken uzaktan taşınabilir nesneyi temsil eden Binder nesnesinin izin verilen işlem boyutunu aşabilir. Android sisteminin bu senaryolarda istisna atmasını önlemek için bir seferde en fazla 20 Dataset nesnesi ekleyerek FillResponse'yi küçük tutabilirsiniz. Yanıtınız için daha fazla veri kümesi gerekiyorsa kullanıcılara daha fazla bilgi olduğunu bildiren ve seçildiğinde sonraki veri kümesi grubunu alan bir veri kümesi ekleyebilirsiniz. Daha fazla bilgi için addDataset(Dataset) başlıklı makaleyi inceleyin.

Verileri birden fazla ekrana bölerek kaydetme

Uygulamalar genellikle kullanıcı verilerini aynı etkinlikteki birden fazla ekrana böler. Özellikle yeni bir kullanıcı hesabı oluşturmak için kullanılan etkinliklerde bu durumla karşılaşılır. Örneğin, ilk ekranda kullanıcı adı istenir, kullanıcı adı mevcutsa ikinci ekranda şifre istenir. Bu durumlarda, otomatik doldurma hizmetinin otomatik doldurma kaydetme kullanıcı arayüzünü gösterebilmesi için kullanıcının her iki alana da giriş yapması gerekir. Bu tür senaryoları ele almak için aşağıdaki adımları izleyin:

1. İlk dolgu isteğinde, yanıta ekranda bulunan kısmi alanların otomatik doldurma kimliklerini içeren bir istemci durumu paketi ekleyin.
2. İkinci doldurma isteğinde, istemci durumu paketini alın, önceki istemede istemci durumunda ayarlanan otomatik doldurma kimliklerini alın ve bu kimlikleri ile FLAG_SAVE_ON_ALL_VIEWS_INVISIBLE işaretini ikinci yanıtta kullanılan SaveInfo nesnesine ekleyin.
3. Kayıt isteğinde her alanın değerini elde etmek için uygun FillContext nesnelerini kullanın. Her doldurma isteği için bir doldurma bağlamı vardır.

Daha fazla bilgi için Veriler birden fazla ekrana bölündüğünde kaydetme başlıklı makaleyi inceleyin.

Her istek için başlatma ve yıkım mantığı sağlayın

Her otomatik doldurma isteği olduğunda Android sistemi hizmete bağlanır ve onConnected() yöntemini çağırır. Hizmet, isteği işledikten sonra Android sistemi onDisconnected() yöntemini çağırır ve hizmet ile bağlantıyı kaldırır. Bir isteği işlemeden önce çalıştırılacak kod sağlamak için onConnected(), bir isteği işlemeden sonra çalıştırılacak kod sağlamak için onDisconnected() uygulayabilirsiniz.

Otomatik doldurma kaydetme kullanıcı arayüzünü özelleştirme

Otomatik doldurma hizmetleri, kullanıcıların hizmetin verilerini kaydetmesine izin vermek isteyip istemediklerine karar vermelerine yardımcı olmak için otomatik doldurma kaydetme kullanıcı arayüzünü özelleştirebilir. Hizmetler, basit bir metin veya özelleştirilmiş bir görünüm aracılığıyla kaydedilenler hakkında ek bilgi sağlayabilir. Hizmetler, kayıt isteğini iptal eden düğmenin görünümünü de değiştirebilir ve kullanıcı bu düğmeye dokunduğunda bildirim alabilir. Daha fazla bilgi için SaveInfo referans sayfasına bakın.

Uyumluluk modu

Uyumluluk modu, otomatik doldurma hizmetlerinin otomatik doldurma amacıyla erişilebilirlik sanal yapısını kullanmasına olanak tanır. Özellikle, otomatik doldurma API'lerini açıkça uygulamayan tarayıcılarda otomatik doldurma işlevi sağlamak için kullanışlıdır.

Uyumluluk modunu kullanarak otomatik doldurma hizmetinizi test etmek için uyumluluk modu gerektiren tarayıcıyı veya uygulamayı açıkça izin verilenler listesine ekleyin. Aşağıdaki komutu çalıştırarak hangi paketlerin izin verilenler listesine eklendiğini kontrol edebilirsiniz:

$ adb shell settings get global autofill_compat_mode_allowed_packages

Test ettiğiniz paket listede yoksa aşağıdaki komutu çalıştırarak paketi ekleyin. Burada pkgX, uygulamanın paketidir:

$ adb shell settings put global autofill_compat_mode_allowed_packages pkg1[resId1]:pkg2[resId1,resId2]

Uygulama bir tarayıcıysa oluşturulan sayfanın URL'sini içeren giriş alanının kaynak kimliğini belirtmek için resIdx kullanın.

Uyumluluk modu aşağıdaki sınırlamalara sahiptir:

• Hizmet FLAG_SAVE_ON_ALL_VIEWS_INVISIBLE işaretini kullandığında veya setTrigger() yöntemi çağrıldığında bir kayıt isteği tetiklenir. FLAG_SAVE_ON_ALL_VIEWS_INVISIBLE, uyumluluk modu kullanılırken varsayılan olarak ayarlanır.
• Nodların metin değeri onSaveRequest(SaveRequest, SaveCallback) yönteminde kullanılamayabilir.

Uyumluluk modu ve bu modla ilişkili sınırlamalar hakkında daha fazla bilgi için AutofillService sınıf referansına bakın.