HarmonyOS5 云服务技术分享 -- 手机号登录教程

2025-05-21
广东
本文字数：2520 字
阅读完需：约 8 分钟

一、为什么选择手机号认证？

在开始代码之前，先说说它的优势：

用户友好：不需要记忆复杂用户名
安全性强：双重验证机制（短信+密码）
快速接入：HarmonyOS Auth SDK 已封装好核心逻辑

二、环境准备

先确保你的项目已经：

集成 AGC 认证 SDK
在 AGC 控制台开启手机认证能力
在module.json5添加权限：

`"requestPermissions": [ {"name": "ohos.permission.READ_SMS"} // 如果需要自动读取短信验证码 ]`

复制代码

三、核心功能实现（附代码）

🔑 场景 1：新用户注册

分两步走：获取验证码 → 创建账号

//import auth, { VerifyCodeAction } from '@hw-agconnect/auth';
auth.requestVerifyCode({  action: VerifyCodeAction.REGISTER_LOGIN, // 注册登录共用类型  lang: 'zh_CN', // 短信语言  sendInterval: 60, // 短信重发间隔(秒)  verifyCodeType: {    phoneNumber: '13812345678', // 记得替换真实号码！    countryCode: "86",    kind: "phone"  }}).then(() => {  console.log("验证码已发送，注意查收~");}).catch(err => {  console.error("发送失败:", err.message);});
// 第二步：创建用户（自动登录）auth.createUser({  kind: 'phone',  countryCode: '86',  phoneNumber: '13812345678',  password: 'Init@123', // 初始密码（可选）  verifyCode: '654321' // 用户收到的6位验证码}).then(user => {  console.log("注册成功！UID:", user.uid);});

复制代码

🔐 场景 2：密码登录

auth.signIn({  credentialInfo: {    kind: 'phone',    phoneNumber: '13812345678',    countryCode: '86',    password: 'your_password' // 用户设置的密码  }}).then(user => {  console.log("登录成功！当前用户:", user);}).catch(err => {  if(err.code === 203817858) { // 密码错误特殊处理    console.warn("密码错误，还剩", err.remainingTimes, "次尝试机会");  }});

复制代码

✨ 嗨，各位 HarmonyOS 开发者小伙伴！今天咱们来聊聊如何在应用中集成「手机号登录认证」功能。无论是用"手机号+密码"还是"手机号+验证码"，这篇保姆级教程都会手把手带你实现。准备好了吗？Let's go~ 🚀

一、为什么选择手机号认证？

在开始代码之前，先说说它的优势：

用户友好：不需要记忆复杂用户名
安全性强：双重验证机制（短信+密码）
快速接入：HarmonyOS Auth SDK 已封装好核心逻辑

二、环境准备

先确保你的项目已经：

集成 AGC 认证 SDK
在 AGC 控制台开启手机认证能力
在module.json5添加权限：

json复制"requestPermissions": [  {"name": "ohos.permission.READ_SMS"} // 如果需要自动读取短信验证码]

复制代码

三、核心功能实现（附代码）

🔑 场景 1：新用户注册

分两步走：获取验证码 → 创建账号

typescript复制// 第一步：申请验证码import auth, { VerifyCodeAction } from '@hw-agconnect/auth';
auth.requestVerifyCode({  action: VerifyCodeAction.REGISTER_LOGIN, // 注册登录共用类型  lang: 'zh_CN', // 短信语言  sendInterval: 60, // 短信重发间隔(秒)  verifyCodeType: {    phoneNumber: '13812345678', // 记得替换真实号码！    countryCode: "86",    kind: "phone"  }}).then(() => {  console.log("验证码已发送，注意查收~");}).catch(err => {  console.error("发送失败:", err.message);});
// 第二步：创建用户（自动登录）auth.createUser({  kind: 'phone',  countryCode: '86',  phoneNumber: '13812345678',  password: 'Init@123', // 初始密码（可选）  verifyCode: '654321' // 用户收到的6位验证码}).then(user => {  console.log("注册成功！UID:", user.uid);});

复制代码

🔐 场景 2：密码登录

typescript复制auth.signIn({  credentialInfo: {    kind: 'phone',    phoneNumber: '13812345678',    countryCode: '86',    password: 'your_password' // 用户设置的密码  }}).then(user => {  console.log("登录成功！当前用户:", user);}).catch(err => {  if(err.code === 203817858) { // 密码错误特殊处理    console.warn("密码错误，还剩", err.remainingTimes, "次尝试机会");  }});

复制代码

📲 场景 3：验证码登录

//auth.requestVerifyCode({  action: VerifyCodeAction.REGISTER_LOGIN,  // ...其他参数同上});
// 使用验证码登录auth.signIn({  credentialInfo: {    kind: 'phone',    phoneNumber: '13812345678',    countryCode: '86',    verifyCode: '123456'   }}).then(user => {  console.log("无密码登录成功！");});

复制代码

四、账号管理技巧

修改绑定手机号（需已登录）

auth.getCurrentUser(...  user.updatePhone({    countryCode: '86',    phoneNumber: '13887654321', // 新号码    verifyCode: '112233',    lang: "zh_CN"  }).then(() => {    console.log("换绑成功！");  });});

复制代码

修改密码（登录后操作）

auth.getCurrentUser(...  user.updatePassword({    password: 'NewPwd@2024',    providerType: 'phone'   });});

复制代码

忘记密码？一键重置！

//auth.requestVerifyCode({  action: VerifyCodeAction.RESET_PASSWORD,  // ...其他参数同上});
// 执行重置auth.resetPassword({  kind: 'phone',  password: 'FreshStart@123',  phoneNumber: '13812345678',  countryCode: '86',  verifyCode: '665544'});

复制代码

五、避坑指南 🚧

敏感操作保护：修改手机号/密码时，必须 5 分钟内登录过
错误码处理：
203817932: 验证码错误
203817933: 验证码过期
203817945: 操作过于频繁
多设备登录：通过auth.settings.enableMultiDevice(true)开启支持

六、扩展能力 🔗

想让你的认证系统更强大？试试这些：

• 账号关联：绑定微信/邮箱实现多方式登录
• 云函数触发：监听用户注册/登录事件
• 安全加固：启用二步验证（2FA）

最后的话

希望这篇指南能让你轻松玩转 HarmonyOS 手机认证！如果遇到问题，欢迎评论区提问交流。别忘了在实际开发中做好异常处理和日志记录哦~

如果有其他想了解的功能，欢迎在评论区留言告诉我！咱们下期见~ 👋 （文章结束）

发布于: 刚刚阅读数: 3

莓创技术

关注

一只会打代码的羊 2020-03-20 加入

还未添加个人简介

发布

暂无评论

创作场景

HarmonyOS5 云服务技术分享 -- 手机号登录教程

一、为什么选择手机号认证？

二、环境准备

三、核心功能实现（附代码）

🔑 场景 1：新用户注册

🔐 场景 2：密码登录

一、为什么选择手机号认证？

二、环境准备

三、核心功能实现（附代码）

🔑 场景 1：新用户注册

🔐 场景 2：密码登录

📲 场景 3：验证码登录

四、账号管理技巧

修改绑定手机号（需已登录）

修改密码（登录后操作）

忘记密码？一键重置！

五、避坑指南 🚧

六、扩展能力 🔗

最后的话

莓创技术

评论