在 HarmonyOS（鸿蒙）中，华为账号（Huawei ID） 是用户身份的统一管理平台，它为用户提供个性化服务、设备间同步、云端数据管理等功能。为了更好地实现这些服务，开发者需要在应用中集成华为账号登录功能，便于用户快速、无缝地登录和享受服务。

华为账号的默认登录功能使得应用能够轻松地支持用户通过华为账号进行身份验证，而无需复杂的流程。

🧑‍💻 开天辟地 HarmonyOS（鸿蒙）——华为账号篇：默认登录

✅ 一、华为账号默认登录功能概述

通过华为账号登录，应用可以提供以下功能：

  • 单点登录（SSO）：用户只需要一次登录即可访问所有支持华为账号的应用和服务。
  • 云服务同步：用户的云端数据（如联系人、云相册、云备份等）可以在不同设备间无缝同步。
  • 第三方授权接入：华为账号支持授权其他第三方应用访问用户的部分信息，如基本资料、支付信息等。

默认登录意味着，用户通过应用启动时，如果已经在设备上登录过华为账号，应用可以自动完成登录操作，减少用户的操作步骤。

✅ 二、默认登录的核心流程

  1. 初始化华为账号 SDK：应用需要首先引入华为账号 SDK 并进行初始化。
  2. 检查用户登录状态：在应用启动时，检查用户是否已经登录华为账号。
  3. 自动登录：如果用户已经登录，应用会自动完成登录操作。
  4. 登录界面：如果用户未登录，会弹出登录界面供用户手动登录。
  5. 获取用户信息：登录成功后，可以获取用户的基本信息（如姓名、头像、邮箱等）。

✅ 三、集成华为账号默认登录

1. 引入 SDK

在项目的 build.gradle 文件中添加华为账号 SDK 的依赖。

dependencies {
    implementation 'com.huawei.hms:account:5.0.0.300'
}

2. 初始化华为账号 SDK

在 Application 或 MainActivity 中，初始化华为账号 SDK：

import huaweiAccount from '@ohos.huawei.account';

async function initHuaweiAccount() {
  try {
    await huaweiAccount.init();  // 初始化华为账号 SDK
    console.log('华为账号 SDK 初始化成功');
  } catch (error) {
    console.error('华为账号 SDK 初始化失败:', error);
  }
}

3. 检查用户是否已登录

通过 SDK 提供的接口检查用户是否已经登录华为账号：

import huaweiAccount from '@ohos.huawei.account';

async function checkLoginStatus() {
  const signInResult = await huaweiAccount.isSignIn();

  if (signInResult) {
    console.log('用户已登录');
    // 继续获取用户信息或自动跳转到应用主页面
  } else {
    console.log('用户未登录');
    // 弹出登录界面让用户登录
  }
}

4. 自动登录或弹出登录界面

如果用户未登录，应用会弹出登录界面。你可以通过如下方式请求用户登录：

import huaweiAccount from '@ohos.huawei.account';

async function loginWithHuaweiAccount() {
  try {
    const signInResult = await huaweiAccount.signIn();
    console.log('登录成功', signInResult);
    // 获取用户信息
    getUserInfo();
  } catch (error) {
    console.error('登录失败:', error);
  }
}

5. 获取用户信息

登录成功后，可以通过 getUserInfo() 方法获取用户的基本信息：

import huaweiAccount from '@ohos.huawei.account';

async function getUserInfo() {
  try {
    const userInfo = await huaweiAccount.getUserInfo();
    console.log('用户信息:', userInfo);
  } catch (error) {
    console.error('获取用户信息失败:', error);
  }
}

✅ 四、默认登录相关权限声明

在使用华为账号登录功能时，应用需要在 config.json 中声明相关的权限和服务。

{
  "reqPermissions": [
    {
      "name": "ohos.permission.GET_ACCOUNT",
      "reason": "获取用户账号信息"
    }
  ],
  "services": [
    {
      "name": "com.huawei.hms.account",
      "description": "华为账号服务"
    }
  ]
}

GET_ACCOUNT 权限允许应用获取用户账号信息，如 HMS Core 中的账户。

✅ 五、处理登录成功与失败

  • 成功登录后的处理：用户登录成功后，应用可以获取用户信息并进行相关业务操作，如个性化推荐、同步数据等。
  • 登录失败的处理：如果用户登录失败，可能是由于网络问题或权限问题，可以给用户提供重试或者其他错误提示。
async function handleSignInResult(result) {
  if (result.success) {
    console.log('登录成功');
    // 执行登录后的操作，比如进入主页面
  } else {
    console.error('登录失败:', result.errorCode);
    // 提供错误提示并允许用户重试
  }
}

✅ 六、总结

功能说明
默认登录用户如果已登录华为账号，则应用自动完成登录操作，无需重复输入凭证。
华为账号 SDK提供一系列接口，让应用能够轻松集成华为账号的登录、信息获取等功能。
权限声明需要在 config.json 文件中声明访问账号信息的权限。
自动登录与手动登录支持自动登录和手动登录，提升用户体验。

📌 一句话总结：

华为账号的默认登录功能为用户提供了无缝的身份验证体验，开发者可以通过简单的接口实现华为账号的自动登录、信息获取等功能，提升应用的用户体验。