Android Oreo:如何将我的应用程序发布为自动填充服务提供商?

时间:2017-11-18 15:14:22

标签: android passwords autofill android-8.0-oreo

我是密码管理器应用的独立开发者。我应该做什么,或者我应该实施什么(接口/ API /服务),以使我的应用成为自动填充服务提供商(在使用Android Oreo API> = 26的设备中)?

我已阅读各种相关文档,但我无法理解如何执行此操作。我错过了什么吗?

目前,我发现只有知名密码管理器支持此功能:

Image of apps that provide Autofill service

欢迎任何提示。

1 个答案:

答案 0 :(得分:6)

像往常一样,谷歌自己的examples repository provides a good starting point用于学习自动填充框架的API,并且涵盖了比我能够回答的更多的材料。以下是关键概念的概述。根据{{​​3}}中的说明,我们要创建一个自动填充服务,它将处理来自其他应用(客户端)的请求,以存储和检索自动填充字段数据。

首先,我们需要创建一个履行此合同的服务提供者类。我们可以扩展基数documentation

import android.service.autofill.AutofillService;
...
public class MyAutofillService extends AutofillService {
    ...
    @Override
    public void onFillRequest(FillRequest request, CancellationSignal cancellationSignal,
        FillCallback callback) { ... }

    @Override
    public void onSaveRequest(SaveRequest request, SaveCallback callback) { ... }
}

服务的AutofillService classonFillRequest()方法对我们的理解最为重要。 Android系统调用onFillRequest()来确定我们的服务是否可以为特定活动自动填充字段,并为方法提供onSaveRequest(),其中包含我们的服务将检查可填写字段的上下文和视图信息。服务完成后,它会使用相应的自动填充数据调用提供的callback

以下是为FillRequest提供自动填充建议所需的基本步骤的显着简化概述:

@Override
public void onFillRequest(FillRequest request, CancellationSignal signal, FillCallback callback) {
    List<FillContext> contexts = request.getFillContexts();
    AssistStructure structure = contexts.get(contexts.size() - 1);
    WindowNode windowNode = structure.getWindowNodeAt(0);
    ViewNode viewNode = windowNode.getRootViewNode(); // pretend this is an EditText

    String suggestionText = "This will appear in the autofill list for 'viewNode'.";
    RemoteViews suggestion = new RemoteViews(getPackageName(), R.layout.autofill_suggestion);
    suggestion.setTextViewText(R.id.autofill_suggestion, suggestionText);

    Dataset suggestionDataset = new Dataset.Builder(suggestion) 
        .setValue(viewNode.getAutoFillId(), AutofillValue.forText(suggestionText))
        .build();

    FillResponse response = new FillResponse.Builder() 
        .addDataset(suggestionDataset)
        .build();

    callback.onSuccess(response);
}

正如我们所看到的,Autofill API需要大量代码才能为我们事先已经知道的View提供单个静态自动填充建议 - 该示例假定viewNode是一个我们要为其提供自动填充建议的文本输入字段。实际上,这个例子太简单了,但我想清楚地表明最小的实现。对于每个WindowNode,我们需要遍历根FillRequest及其每个子节点的视图树,以查找我们的服务希望为其提供自动填充数据的每个输入字段,然后创建一个ViewNodeRemoteViews包含我们将使用Dataset添加到FillResponse的每个字段的自动填充建议。此示例未显示用于为R.layout.autofill_suggestion创建建议显示项的TextView RemoteViews的纯XML格式。

类似地,当用户想要将数据保存在活动的字段中以用于将来的完成请求时,Android会调用onSaveRequest()并注入我们的服务用来查找要记住的自动填充数据的FillResponse.Builder.addDataset()

每种方法的具体实现取决于我们的应用程序提供的自动填充数据的类型。自动填充服务必须仔细检查每个字段的特征,并仔细选择一组适当的自动填充建议,以避免将用户的数据泄露给恶意客户端活动(请参阅注释)。特别是对于密码管理器,我们需要特别注意正确地验证服务的用户,并在请求和保存自动填充数据时提供一组安全的建议。

我们现在可以在项目的 AndroidManifest.xml <application>块中SaveRequest

<service
    android:name=".MyAutofillService"
    android:label="Multi-Dataset Autofill Service"
    android:permission="android.permission.BIND_AUTOFILL_SERVICE">
    <meta-data
        android:name="android.autofill"
        android:resource="@xml/multidataset_service" />

    <intent-filter>
        <action android:name="android.service.autofill.AutofillService" />
    </intent-filter>
</service>

如图所示,这会将我们的自动填充服务绑定为可用选项,该选项显示在问题中显示的自动填充服务列表中。 android:name属性必须与我们AutofillService类的名称相匹配,我们的应用必须声明BIND_AUTOFILL_SERVICE权限。将android:label的值更改为服务的合适名称(例如,“使用Password Manager自动填充”)。或者,在字符串资源中设置它。另请注意,我们应提供“设置”活动,用于配置我们在<meta‑data> android.autofill中指定的服务:

<autofill-service android:settingsActivity="foo.bar.SettingsActivity" />

然后,用户可以通过其设备设置启用我们的自动填充服务。我们可以在设置或首次启动期间广播register the service意图,以帮助用户找到此屏幕。