我们有太多的应用程序正在实现谷歌智能锁。我们显然有相同的实现,但它们的行为不同。
第一个仅在用户已保存某些凭据时显示用于选择帐户的对话框,并且仅显示他已保存的一个或多个帐户。
第二个将始终显示一个对话框来选择帐户,即使用户从未保存凭据,并且将显示设备中的所有帐户。这会导致用户看到太多帐户,选择一个帐户只会自动完成没有密码的电子邮件。
我们花了一些时间才弄清楚发生了什么。碰巧我们正在检查具有不同条件的不成功凭据请求的解析。第一个应用程序使用result.getStatus().getStatusCode() == CommonStatusCodes.RESOLUTION_REQUIRED
,而第二个应用程序正在执行result.getStatus().hasResolution()
,即使状态代码不是RESOLUTION_REQUIRED而是SIGN_IN_REQUIRED。
通过命名,它们似乎应该具有类似的行为,但它们没有。为什么会有这种差异?
根据用户是否存储了调用应用的凭据,CredentialsApi.request()
调用的结果状态代码会有所不同。有关详细信息,请查看 API 概述,但需要快速摘要:
如果用户存储了多个凭据(可能存储在设备上的一个或多个 Google 帐号中),系统会返回RESOLUTION_REQUIRED
结果,并可以通过显示多个已保存凭据的对话框进行解析,允许用户选择一个凭据。详
当没有可用的存储凭据时,将返回SIGN_IN_REQUIRED
结果,并可以通过显示电子邮件地址列表的对话框进行解析(用于电子邮件地址自动填充,以及名称或图片(如果可用)。这不需要设备权限(在 Android M 上非常有用,否则需要运行时GET_ACCOUNTS提示),并帮助用户轻松填写登录或注册表单。详
Auth.CredentialsApi.request(apiClient, request).setResultCallback(
new ResultCallback<CredentialRequestResult>() {
public void onResult(CredentialRequestResult result) {
Status status = result.getStatus();
if (status.isSuccess()) {
// Successfully read credential without any user interaction, this
// means there was only a single credential and user has auto
// sign-in enabled.
processRetrievedCredential(result.getCredential(), false);
} else if (status.getStatusCode() == CommonStatusCodes.RESOLUTION_REQUIRED) {
// This is the case where the user has multiple saved
// credentials and needs to pick one
resolveResult(status, RC_READ);
} else if (status.getStatusCode() == CommonStatusCodes.SIGN_IN_REQUIRED) {
// User has no saved credentials, but a dialog to select email
// address (a "hint") is available (optional)
resolveResult(status, RC_HINT);
}
}
});
对于这两种结果hasResolution()
返回true
,因为两者都可以解决,尽管结果不同,不幸的是,这令人困惑。我们将更新文档以更好地解释。
在任何一种情况下,用户的选择都将以 onActivityResult()
形式返回,但"提示"将仅设置标识符(电子邮件地址)而没有密码。
public void onActivityResult(int requestCode, int resultCode, Intent data) {
...
if (resultCode == RESULT_OK) {
Credential result = data.getParcelableExtra(Credential.EXTRA_KEY);
if (requestCode == RC_HINT) {
String email = result.getId(); // for auto-fill
} else if (requestCode == RC_READ) {
String email = result.getId(); // for auto sign-in
String password = result.getPassword(); // only for saved credentials
在CredentialsApi.request()
中返回仅电子邮件对话框的原因是保存额外的 API 调用,以提取上述详细信息中所述的电子邮件"提示"选择器对话框,以防应用需要按顺序进行 API 调用。但是,这是可选的,因为对于许多应用的 UX,在应用启动时检索凭据以进行自动登录更有意义,然后在用户开始登录或注册时单独请求电子邮件选择器对话框,如示例代码所示。