Android自动填充服务应用开发问题（Google文档晦涩）

1. 替代废弃的setValue方法 #

API 30及以上setValue已被废弃，需使用AutofillValue的静态方法生成对应类型的值，再通过Dataset.Builder关联到目标AutofillId：

// 构建文本填充数据集
val dataset = Dataset.Builder()
    .setValue(
        targetAutofillId, // 待填充字段的AutofillId
        AutofillValue.forText("硬编码测试用户名")
    )
    .setId("test-username-dataset") // 给数据集设置唯一标识
    .build()

// 组装填充响应并返回
val response = FillResponse.Builder()
    .addDataset(dataset)
    .build()
callback.onSuccess(response)

2. 正确获取AutofillId #

不能直接取根ViewNode的ID，需要递归遍历整个ViewNode树，筛选出带自动填充提示（autofillHints）或符合输入类型的控件：

private fun collectValidAutofillIds(node: ViewNode): List<AutofillId> {
    val ids = mutableListOf<AutofillId>()
    // 检查当前节点是否为可填充的输入控件
    node.autofillId?.let { id ->
        // 优先筛选带autofillHints的控件
        if (!node.autofillHints.isNullOrEmpty()) {
            ids.add(id)
        }
        // 或根据输入类型判断，比如文本类输入框
        else if (node.inputType and InputType.TYPE_CLASS_TEXT == InputType.TYPE_CLASS_TEXT) {
            ids.add(id)
        }
    }
    // 递归遍历子节点
    node.children?.forEach { childNode ->
        ids.addAll(collectValidAutofillIds(childNode))
    }
    return ids
}

// 在onFillRequest中调用获取有效ID
val rootNode = structure.windowNodes.first().rootViewNode
val validAutofillIds = collectValidAutofillIds(rootNode)

3. 解决填充列表无内容的问题 #

结合API 34特性，排查以下关键点：

• 目标输入框需设置autofillHints：比如用户名输入框添加android:autofillHints="username"，密码框添加android:autofillHints="password"，系统仅识别带明确提示的可填充字段。
• 确保FillResponse构建正确：每个Dataset必须关联有效的AutofillId，且调用callback.onSuccess(response)返回响应，若无可填充字段需返回null。
• 适配API 34的请求逻辑：在onFillRequest中正确处理最新的填充上下文，示例代码：

override fun onFillRequest(
    request: FillRequest,
    cancellationSignal: CancellationSignal,
    callback: FillCallback
) {
    val latestContext = request.fillContexts.last()
    val structure = latestContext.structure
    val rootNode = structure.windowNodes.first().rootViewNode
    val validIds = collectValidAutofillIds(rootNode)

    if (validIds.isEmpty()) {
        callback.onSuccess(null)
        return
    }

    // 构建多个测试数据集
    val datasets = mutableListOf<Dataset>()
    datasets.add(
        Dataset.Builder()
            .setValue(validIds[0], AutofillValue.forText("test_user_01"))
            .setId("user_01")
            .build()
    )
    datasets.add(
        Dataset.Builder()
            .setValue(validIds[0], AutofillValue.forText("test_user_02"))
            .setId("user_02")
            .build()
    )

    val response = FillResponse.Builder()
        .addDatasets(datasets)
        .build()

    callback.onSuccess(response)
}

• 验证服务激活状态：在系统设置中确认你的应用已设为默认自动填充服务，测试时重新打开目标应用，聚焦输入框触发填充提示。

内容的提问来源于stack exchange，提问作者Mihir Kandoi