Android Kotlin Autofill Service开发疑问与填充失效问题求助

一、SettingsActivity相关解答 #

• 需实现的核心内容：
  • 账号密码的管理界面（增、删、改、查）
  • 快捷引导用户开启系统自动填充权限的入口（首次打开应用时）
  • 可选进阶功能：加密设置、数据备份/恢复、自动填充规则自定义等
• 是否设为LAUNCHER Activity：完全可以。这是用户打开应用的核心入口，后续把空白的MainActivity改造成具备上述管理功能的界面即可。

二、onFillRequest触发逻辑的纠正 #

你的理解有偏差，不是点击任意输入框都会触发：

• 只有当输入框符合自动填充识别条件时（比如设置了autofillHint为username/password，或系统通过输入类型、提示文本判断是账号密码输入框），系统才会调用onFillRequest()。
• 前提是必须在系统设置中启用你的自动填充服务，否则不会触发任何回调。

三、自动填充不生效的问题修复 #

从代码来看，核心问题出在输入框节点的识别逻辑上，以下是具体修复方案：

1. 修复输入框识别逻辑（parseStructure方法） #

当前代码直接取根布局的AutofillId作为账号密码的ID，这完全错误——根节点是容器，不是输入框。需要递归遍历所有ViewNode，找到真正的账号/密码输入框：

private fun parseStructure(structure: AssistStructure): ParsedStructure? {
    var usernameId: AutofillId? = null
    var passwordId: AutofillId? = null

    // 遍历所有窗口节点
    for (windowIndex in 0 until structure.windowNodeCount) {
        val windowNode = structure.getWindowNodeAt(windowIndex)
        traverseNodesForInputFields(windowNode.rootViewNode) { id, isPasswordField ->
            if (isPasswordField) {
                passwordId = id
            } else {
                usernameId = id
            }
        }
    }

    return if (usernameId != null && passwordId != null) {
        ParsedStructure(usernameId!!, passwordId!!)
    } else {
        null // 找不到有效输入框时返回null，避免后续报错
    }
}

private fun traverseNodesForInputFields(node: AssistStructure.ViewNode?, onFieldFound: (AutofillId, Boolean) -> Unit) {
    node ?: return

    // 判断是否为账号或密码输入框
    val isPassword = node.inputType and InputType.TYPE_TEXT_VARIATION_PASSWORD != 0
    val isUsername = node.autofillHints?.any {
        it == View.AUTOFILL_HINT_USERNAME || it == View.AUTOFILL_HINT_EMAIL_ADDRESS
    } == true || node.hint?.contains("账号", ignoreCase = true) == true || node.hint?.contains("username", ignoreCase = true) == true

    // 找到有效输入框且有AutofillId时回调
    if ((isUsername || isPassword) && node.autofillId != null) {
        onFieldFound(node.autofillId!!, isPassword)
    }

    // 递归遍历子节点
    for (childIndex in 0 until node.childCount) {
        traverseNodesForInputFields(node.getChildAt(childIndex), onFieldFound)
    }
}

2. 修正onFillRequest方法逻辑 #

处理找不到输入框的情况，同时简化测试数据的使用：

override fun onFillRequest(
    request: FillRequest,
    cancellationSignal: CancellationSignal,
    callback: FillCallback
) {
    val latestContext = request.fillContexts.last()
    val parsedStructure = parseStructure(latestContext.structure) ?: run {
        callback.onSuccess(null) // 无有效输入框时返回空响应
        return
    }

    // 测试用硬编码数据
    val testUsername = "test_user"
    val testPassword = "test_pass123"

    // 构建填充选项的展示视图
    val itemPresentation = RemoteViews(packageName, R.layout.simple_list_item_1)
    itemPresentation.setTextViewText(R.id.text1, testUsername)

    // 构建填充数据集
    val dataset = Dataset.Builder()
        .setValue(parsedStructure.usernameId, AutofillValue.forText(testUsername), itemPresentation)
        .setValue(parsedStructure.passwordId, AutofillValue.forText(testPassword), itemPresentation)
        .build()

    val fillResponse = FillResponse.Builder()
        .addDataset(dataset)
        .build()

    callback.onSuccess(fillResponse)
}

3. 其他必要检查 #

• 确保R.layout.simple_list_item_1布局存在，且包含R.id.text1的TextView（如果自定义布局，需对应修改ID）。
• 测试前必须在系统设置中启用你的「Custom Autofill Service」。
• 优先选择支持自动填充的应用测试（比如系统浏览器、Google登录界面），部分第三方应用可能禁用了自动填充功能。

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