DEV Community

陈杨
陈杨

Posted on

HarmonyOS5 Cloud Service Technology Sharing--Account Login

#arkts

Hey, fellow developers! Today, let's talk about the much-anticipated ArkTS (API 12) in the HarmonyOS ecosystem, especially how to quickly implement HUAWEI ID sign-in. Whether you're a newcomer to HarmonyOS or a tech pro looking to upgrade your existing project, this practical guide will get you started with ease~

🌟 1. Preparation: Configure Your Development Environment

Step 1. Enable Authentication Service

  • Log in to the AppGallery Connect console, find your project, and enable the service with one click in "Build" > "Authentication Service" (grab a coffee and wait about 2 minutes for it to take effect).

Step 2. Configure Certificate Fingerprint

//"metadata": [ 
  {
    "name": "client_id",
    "value": "Your Client ID (find it in project settings)"
  }
]
Enter fullscreen mode Exit fullscreen mode

👉 Pro Tip: An expired certificate fingerprint will cause sign-in to fail. It's recommended to set up an automatic update reminder in advance.

🛠️ 2. Sign-in in Four Lines of Code (with Error Handling Tips) 

import { hilog } from '@kit.PerformanceAnalysisKit';

// Core sign-in code
auth.signIn({
  autoCreateUser: true,
  credentialInfo: { kind: "hwid" }
}).then(result => {
  hilog.info(0x0000, 'Sign-in successful', `User UID: ${result.getUser().getUid()}`);
  // You can redirect to the home page here
}).catch(error => {
  hilog.error(0x0000, 'Sign-in failed', `Error code: ${error.code}, Details: ${error.message}`);
  // It's recommended to add a retry button here
});
Enter fullscreen mode Exit fullscreen mode

🔥 3. Advanced Features Revealed

1. Seamless Multi-Account Switching

  • Use <font style="color:rgb(255, 80, 44);background-color:rgb(255, 245, 245);">auth.link()</font> to link WeChat/QQ accounts, allowing users to choose their preferred sign-in method next time.
  • For sensitive operations, remember to add <font style="color:rgb(255, 80, 44);background-color:rgb(255, 245, 245);">auth.reauthenticate()</font> for secondary verification, which is both secure and user-friendly.

2. User Lifecycle Management

//auth.signOut(); 

// Account deletion (remember to show a confirmation dialog first)
auth.deleteUser().then(() => {
  console.log('See you around~');
});
Enter fullscreen mode Exit fullscreen mode

🚨 Pitfall Guide (Lessons Learned the Hard Way)

  • Certificate Fingerprint Triple-Check: After debugging on a new device, changing computers, or updating the certificate, you must reconfigure the fingerprint.
  • Token Expiration Handling: It's recommended to add auto-refresh logic in your interceptor for seamless, user-transparent token renewal.
  • Huawei App Review Secret: Place test accounts in "Project Settings > Test users" to skyrocket your approval rate.

Final Words

As the native language of the HarmonyOS ecosystem, ArkTS demonstrates amazing productivity in API 12. Integrating HUAWEI ID sign-in now not only improves the user experience but also seamlessly connects with over 20 other AppGallery Connect services. If you encounter any bugs, feel free to summon me in the comments section~

I look forward to seeing the amazing applications you create with ArkTS! See you next time! 🚀

(If you found this useful, remember to give it a star ⭐️ and share it with your fellow developers on the HarmonyOS front line~)

Top comments (0)