FAQs & Troubleshooting

  • 1 minute(s) read
Prev Next

Overview

This section covers common questions and general troubleshooting steps for the Mapp Engage Android SDK (v6 and v7).

For version-specific implementation details, refer to the respective SDK documentation.

FAQs

FAQ

How do I enable my app to receive Push Notifications?

  • Enable push notification functionality within your app.

  • Ensure devices are opted in to receive notifications.

  • Confirm that Firebase Cloud Messaging (FCM) is correctly configured.

  • Verify that the Android Channel is properly configured in Mapp Engage.

Do I need to update my Mapp SDK integration when a new version is released?

Yes, it is recommended to update to the latest SDK version. The version format follows x.y.z:

  • Major updates (x or y changes): May include new features or breaking changes.

  • Minor updates (z changes): Typically include bug fixes and minor improvements.

Always review the release notes before upgrading.

Why are devices not receiving push notifications?

Check the following:

  • Devices are opted in for push notifications.

  • SDK initialization is correctly implemented.

  • The Firebase token is successfully generated and registered.

  • The token is visible and valid in the Mapp Engage dashboard.

  • No errors appear in Android Studio Logcat.

  • The correct Firebase project and google-services.json file are used.

What types of media can be sent to Android devices?

Supported formats:

  • Video

  • Animated images

  • Images

  • Audio files

Recommended size limits:

  • Images: up to 10 MB

  • Audio: up to 5 MB

  • Video: up to 50 MB

Always test rich media notifications on physical devices before launch.

Troubleshooting

FAQ

I cannot receive Push Notifications

  • Verify your setup using the Getting Started documentation.

  • Ensure you are using a supported and up-to-date SDK version.

  • Confirm that SDK initialization is implemented in your Application class.

  • Check that push notifications are enabled for the device.

  • Use Android Studio Logcat to inspect runtime logs and errors.

  • Validate that the device has network connectivity.

Push notifications do not work on Huawei/Honor devices

Some newer Huawei and Honor devices do not support Google Firebase services due to platform restrictions. Since the Android SDK relies on Firebase Cloud Messaging (FCM), push notifications may not function on devices without Google Mobile Services (GMS).

Verify device compatibility and consider platform-specific alternatives if required.