How to Develop Flutter Apps for Huawei Devices

Flutter Apps for Huawei Devices are becoming increasingly important as Huawei continues to expand its ecosystem with Huawei Mobile Services (HMS).

For Huawei smartphones, replace Google Mobile Services (GMS) APIs with Huawei Mobile Services (HMS) to ensure full compatibility.

This guide explains how to develop Flutter Apps for Huawei Devices and configure your project with Huawei Mobile Services (HMS).

Additionally, you’ll learn to integrate Huawei Push Kit, Map Kit, Location Kit, Analytics Kit, and Account Kit with practical Flutter code examples.

Finally, you’ll learn how to publish Flutter Apps for Huawei Devices to Huawei AppGallery with step-by-step instructions.

You can read more interesting blogs by mobikul .

In this guide, you’ll learn:

What Huawei Mobile Services (HMS) is
Differences between GMS and HMS
How to configure a Flutter project for Huawei
Integrate HMS plugins
Handle Push Notifications, Maps, Location, Analytics, Authentication, and In-App Purchases
Best practices for publishing to Huawei AppGallery
Complete Flutter code examples

Why Huawei Devices Need HMS

Developing Flutter apps for Huawei devices requires replacing Google Mobile Services (GMS) with Huawei Mobile Services (HMS).

This enables features such as push notifications, maps, analytics, authentication, and location services.

Examples:

Feature	Google	Huawei
Maps	Google Maps	Huawei Map Kit
Push Notifications	Firebase Cloud Messaging	Huawei Push Kit
Analytics	Firebase Analytics	Huawei Analytics Kit
Authentication	Google Sign-In	Huawei Account Kit
Location	Google Location Services	Huawei Location Kit
In-App Purchase	Google Play Billing	Huawei IAP Kit

Huawei provides Huawei Mobile Services (HMS Core) as an alternative.

HMS Architecture

How to Develop Flutter Apps for Huawei Devices

Prerequisites

Before you begin, configure Flutter, Android Studio, and your Huawei Developer account.

Flutter SDK
Android Studio
Huawei Developer Account
Huawei AppGallery Connect project
Physical Huawei device (recommended)

Step 1: Configure Gradle

Project Level build.gradle

buildscript {
    repositories {
        google()
        mavenCentral()
        maven {
            url 'https://developer.huawei.com/repo/'
        }
    }

    dependencies {
        classpath 'com.huawei.agconnect:agcp:1.9.1.301'<span dir="auto" style="vertical-align: inherit"><span dir="auto" style="vertical-align: inherit">
    }</span></span>
}

buildscript {

repositories {

google()

mavenCentral()

maven {

url 'https://developer.huawei.com/repo/'

}

dependencies {

classpath 'com.huawei.agconnect:agcp:1.9.1.301'

}

}

App Level build.gradle

plugins {
    id 'com.android.application'
    id 'com.huawei.agconnect'<span dir="auto" style="vertical-align: inherit"><span dir="auto" style="vertical-align: inherit">
}</span></span>

plugins {

id 'com.android.application'

id 'com.huawei.agconnect'

}

Step 2: Add HMS Flutter Packages

pubspec.yaml

dependencies:
  flutter:
    sdk: flutter

  huawei_push: ^6.12.0+300
  huawei_location: ^6.12.0+300
  huawei_map: ^6.12.0+300
  huawei_analytics: ^6.12.0+300
  huawei_account: ^6.12.0+300
  huawei_iap: ^6.12.0+300

dependencies:

flutter:

sdk: flutter

huawei_push: ^6.12.0+300

huawei_location: ^6.12.0+300

huawei_map: ^6.12.0+300

huawei_analytics: ^6.12.0+300

huawei_account: ^6.12.0+300

huawei_iap: ^6.12.0+300

Install packages

flutter pub get

1	flutter pub get

Step 3: Add AGConnect Configuration

Place the configuration file inside:

android/app/agconnect-services.json

1	android/app/agconnect-services.json

Step 4: Android Permissions

AndroidManifest.xml

<uses-permission android:name="android.permission.INTERNET"/>

<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"/>

<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION"/>

<uses-permission android:name="android.permission.INTERNET"/>

<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"/>

<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION"/>

Huawei Push Kit

import 'package:huawei_push/huawei_push.dart';

1	import 'package:huawei_push/huawei_push.dart';

Configure Huawei Push Kit

Future<void> initPush() async {

  await Push.enableLogger();

  Push.getToken("").then((token) {

    print("Push Token : $token");

  });

}

Future<void> initPush() async {

await Push.enableLogger();

Push.getToken("").then((token) {

print("Push Token : $token");

});

}

Receive Push Token

Push.onTokenReceivedStream.listen((event) {

  print(event.token);

});

Push.onTokenReceivedStream.listen((event) {

print(event.token);

});

Listen for Notifications

Push.onMessageReceivedStream.listen((RemoteMessage message) {

  print(message.data);
<span dir="auto" style="vertical-align: inherit"><span dir="auto" style="vertical-align: inherit">
});</span></span>

Push.onMessageReceivedStream.listen((RemoteMessage message) {

print(message.data);

});

Huawei Analytics Kit

import 'package:huawei_analytics/huawei_analytics.dart';

1	import 'package:huawei_analytics/huawei_analytics.dart';

Initialize Analytics

Future<void> initAnalytics() async {

  await HMSAnalytics.getInstance();
<span dir="auto" style="vertical-align: inherit"><span dir="auto" style="vertical-align: inherit">
}</span></span>

Future<void> initAnalytics() async {

await HMSAnalytics.getInstance();

}

Log Analytics Event

await HMSAnalytics.onEvent(

  "login",

  {
    "method": "email"
  }

);

await HMSAnalytics.onEvent(

"login",

{

"method": "email"

}

);

Huawei Account Kit

import 'package:huawei_account/huawei_account.dart';

1	import 'package:huawei_account/huawei_account.dart';

Login with Huawei

Future<void> signIn() async {

  final helper = AccountAuthService();

  final user = await helper.signIn();

  print(user.displayName);
<span dir="auto" style="vertical-align: inherit"><span dir="auto" style="vertical-align: inherit">
}</span></span>

Future<void> signIn() async {

final helper = AccountAuthService();

final user = await helper.signIn();

print(user.displayName);

}

Huawei Location Kit

import 'package:huawei_location/huawei_location.dart';

1	import 'package:huawei_location/huawei_location.dart';

Get Current Location

final locationService = FusedLocationProviderClient();

Location location =
    await locationService.getLastLocation();

print(location.latitude);

print(location.longitude);

final locationService = FusedLocationProviderClient();

Location location =

await locationService.getLastLocation();

print(location.latitude);

print(location.longitude);

Huawei Map Kit

Display Huawei Map

HuaweiMap(

  initialCameraPosition: CameraPosition(

    target: LatLng(
      28.6139,
      77.2090,
    ),

    zoom: 12,

  ),

)

HuaweiMap(

initialCameraPosition: CameraPosition(

target: LatLng(

28.6139,

77.2090,

zoom: 12,

)

Add Marker

Marker(
<span dir="auto" style="vertical-align: inherit"><span dir="auto" style="vertical-align: inherit">
  markerId: MarkerId("1"),</span></span>

  position: LatLng(
    28.6139,
    77.2090,<span dir="auto" style="vertical-align: inherit"><span dir="auto" style="vertical-align: inherit">
  ),</span></span>
<span dir="auto" style="vertical-align: inherit"><span dir="auto" style="vertical-align: inherit">
)</span></span>

Marker(

markerId: MarkerId("1"),

position: LatLng(

28.6139,

77.2090,

),

)

Huawei In-App Purchases

import 'package:huawei_iap/huawei_iap.dart';

1	import 'package:huawei_iap/huawei_iap.dart';

Initialize IAP

await IapClient.startIapConnection();

1	await IapClient.startIapConnection();

Load Products

ProductInfoReq request = ProductInfoReq();

request.priceType = 0;

request.productIds = [

  "premium"

];

ProductInfoReq request = ProductInfoReq();

request.priceType = 0;

request.productIds = [

"premium"

];

Purchase Product

PurchaseIntentReq request = PurchaseIntentReq();

request.productId = "premium";

await IapClient.createPurchaseIntent(request);

PurchaseIntentReq request = PurchaseIntentReq();

request.productId = "premium";

await IapClient.createPurchaseIntent(request);

Detect Huawei Device

<span dir="auto" style="vertical-align: inherit"><span dir="auto" style="vertical-align: inherit">import 'dart:io';</span></span>

Future<bool> isHuaweiDevice() async {

  return Platform.isAndroid;
<span dir="auto" style="vertical-align: inherit"><span dir="auto" style="vertical-align: inherit">
}</span></span>

import 'dart:io';

Future<bool> isHuaweiDevice() async {

return Platform.isAndroid;

}

Note: For production applications, detect HMS availability instead of relying only on Platform.isAndroid.

Create Push Service Interface

abstract class PushService {

  Future<void> init();
<span dir="auto" style="vertical-align: inherit"><span dir="auto" style="vertical-align: inherit">
}</span></span>

abstract class PushService {

Future<void> init();

}

Firebase Push Implementation

class FirebasePushService implements PushService {

  @override
  Future<void> init() async {

    // Firebase initialization
<span dir="auto" style="vertical-align: inherit"><span dir="auto" style="vertical-align: inherit">
  }</span></span>
<span dir="auto" style="vertical-align: inherit"><span dir="auto" style="vertical-align: inherit">
}</span></span>

class FirebasePushService implements PushService {

@override

Future<void> init() async {

// Firebase initialization

}

}

Huawei Push Implementation

class HuaweiPushService implements PushService {

  @override
  Future<void> init() async {

    await Push.getToken("");

  }

}

class HuaweiPushService implements PushService {

@override

Future<void> init() async {

await Push.getToken("");

}

Build Release APK

flutter build apk --release

1	flutter build apk --release

Build App Bundle

flutter build appbundle

1	flutter build appbundle

Verify Flutter Environment

flutter doctor

1	flutter doctor

Install Dependencies Again

flutter pub get

1	flutter pub get

Best Practices

Keep business logic independent of HMS-specific code.
Detect HMS or GMS availability at runtime.
Store credentials securely and avoid hardcoding.
Next, test your app on both Huawei and GMS devices.
Use the latest stable versions of HMS plugins.
Request only the permissions your app requires.
Finally, follow Huawei AppGallery guidelines before publishing.

Publishing to Huawei AppGallery

Create an AppGallery Connect project.
Configure package name and signing certificate.
Download and add agconnect-services.json.
Generate a signed release APK or App Bundle.
Upload the build to AppGallery Connect.
Complete privacy, permissions, screenshots, and store listing information.
Submit the application for review.

Conclusion

Developing Flutter apps for Huawei devices is straightforward once your project is configured with Huawei Mobile Services (HMS).

By integrating Huawei Push Kit, Map Kit, Location Kit, Analytics Kit, Account Kit, and In-App Purchases, you can provide a seamless experience for Huawei users.

Build or migrate your Flutter app and publish it on Huawei AppGallery with HMS.

For more updates, make sure to keep following Mobikul Blogs to learn more about mobile app development.

Ajay Kumar

Proficient in Flutter and Dart, developing high-performance Android and iOS apps. Delivers business-focused solutions with intuitive designs and robust functionalities for diverse requirements.

27 Jul, 2026
Created by - Ajay Kumar

. . .