Troubleshooting - Android SDK (v4)

Last updated September 27, 2024

Issue

A coroutine dependency error occurs during the build process with the following message.

Text

1234
java.lang.NoClassDefFoundError: kotlin/coroutines/AbstractCoroutineContextKey
    at java.base/java.lang.ClassLoader.defineClass1(Native Method)
    at java.base/java.lang.ClassLoader.defineClass(ClassLoader.java:1016)
  ...

Cause

If the kotlinx-coroutines-core library version is 1.3.5 or later, the kotlin-stdlib library version must be at a certain level or later.

Solution

Check whether the kotlin-stdlib library version is 1.3.70 or later with the gradlew dependencies command. If the version is earlier than 1.3.70, you need to update it.

Issue

Deeplink Open events that occur through the push notifications generated by the Braze SDK are not collected by Airbridge. Instead, the App Open event is collected.

Cause

The Airbridge Android SDK uses the dataString in the action and intent of the Activity to distinguish between Deeplink Open events and App Open events.

When a user opens the app through a push notification using the Braze SDK, the app goes through an activity called NotificationTrampolineActivity. This activity handles push notifications, but the dataString is not included in its action and intent, preventing the SDK from determining if it's a Deeplink Open event or an App Open event.

Solution

The problem can be solved using the code snippet below for Airbridge Android SDK versions v2.21.5 and later.

1234567
val option = AirbridgeOptionBuilder("YOUR_APP_NAME", "YOUR_APP_SDK_TOKEN")
  .setLifecycleIntegration {
    it.takeIf { it.javaClass.name == "com.braze.push.NotificationTrampolineActivity" }
    ?.run { intent?.extras?.getString("uri") }
  }
  .build()
Airbridge.initializeSDK(application, option)

12345678910111213141516
AirbridgeOption option = new AirbridgeOptionBuilder("YOUR_APP_NAME", "YOUR_APP_SDK_TOKEN")
  .setLifecycleIntegration(new AirbridgeLifecycleIntegration() {
      @Nullable
      @Override
      public String getDataString(@NonNull Activity activity) {
          if (activity.getClass().getName().equals("com.braze.push.NotificationTrampolineActivity")
                  && activity.getIntent() != null
                  && activity.getIntent().getExtras() != null) {
              return activity.getIntent().getExtras().getString("uri");
          }
          return null;
      }
    })
  })
  .build();
Airbridge.initializeSDK(application, option);
AirbridgeOption option = new AirbridgeOptionBuilder("YOUR_APP_NAME", "YOUR_APP_SDK_TOKEN")
  .setLifecycleIntegration(new AirbridgeLifecycleIntegration() {
      @Nullable
      @Override
      public String getDataString(@NonNull Activity activity) {
          if (activity.getClass().getName().equals("com.braze.push.NotificationTrampolineActivity")
                  && activity.getIntent() != null
                  && activity.getIntent().getExtras() != null) {
              return activity.getIntent().getExtras().getString("uri");
          }
          return null;
      }
    })
  })
  .build();
Airbridge.initializeSDK(application, option);

Issue

The "Manifest merger failed" error occurred during the build process.

Cause

The Airbridge SDK's AndroidManifest.xml includes rules to opt-out of backing up the Shared Preferences data. This is done to avoid retaining the same Airbridge settings during reinstallation so that new installs or re-installs can be detected accurately.

Merging Airbridge SDK backup rules with your app backup rules can cause conflicts.

Solution

Below are the opt-out rules defined in the Airbridge SDK.

123456789101112131415161718192021
<?xml version="1.0" encoding="utf-8"?>
<data-extraction-rules>
    <cloud-backup>
        <exclude domain="sharedpref" path="airbridge-internal" />
        <exclude domain="sharedpref" path="airbridge-install" />
        <exclude domain="sharedpref" path="airbridge-user-info" />
        <exclude domain="sharedpref" path="airbridge-user-alias" />
        <exclude domain="sharedpref" path="airbridge-user-attributes" />
        <exclude domain="sharedpref" path="airbridge-device-alias" />
        <exclude domain="database" path="airbridge.db" />
    </cloud-backup>
    <device-transfer>
        <exclude domain="sharedpref" path="airbridge-internal" />
        <exclude domain="sharedpref" path="airbridge-install" />
        <exclude domain="sharedpref" path="airbridge-user-info" />
        <exclude domain="sharedpref" path="airbridge-user-alias" />
        <exclude domain="sharedpref" path="airbridge-user-attributes" />
        <exclude domain="sharedpref" path="airbridge-device-alias" />
        <exclude domain="database" path="airbridge.db" />
    </device-transfer>
</data-extraction-rules>
<?xml version="1.0" encoding="utf-8"?>
<data-extraction-rules>
    <cloud-backup>
        <exclude domain="sharedpref" path="airbridge-internal" />
        <exclude domain="sharedpref" path="airbridge-install" />
        <exclude domain="sharedpref" path="airbridge-user-info" />
        <exclude domain="sharedpref" path="airbridge-user-alias" />
        <exclude domain="sharedpref" path="airbridge-user-attributes" />
        <exclude domain="sharedpref" path="airbridge-device-alias" />
        <exclude domain="database" path="airbridge.db" />
    </cloud-backup>
    <device-transfer>
        <exclude domain="sharedpref" path="airbridge-internal" />
        <exclude domain="sharedpref" path="airbridge-install" />
        <exclude domain="sharedpref" path="airbridge-user-info" />
        <exclude domain="sharedpref" path="airbridge-user-alias" />
        <exclude domain="sharedpref" path="airbridge-user-attributes" />
        <exclude domain="sharedpref" path="airbridge-device-alias" />
        <exclude domain="database" path="airbridge.db" />
    </device-transfer>
</data-extraction-rules>

12345678910
<?xml version="1.0" encoding="utf-8"?>
<full-backup-content>
    <exclude domain="sharedpref" path="airbridge-internal" />
    <exclude domain="sharedpref" path="airbridge-install" />
    <exclude domain="sharedpref" path="airbridge-user-info" />
    <exclude domain="sharedpref" path="airbridge-user-alias" />
    <exclude domain="sharedpref" path="airbridge-user-attributes" />
    <exclude domain="sharedpref" path="airbridge-device-alias" />
    <exclude domain="database" path="airbridge.db" />
</full-backup-content>
<?xml version="1.0" encoding="utf-8"?>
<full-backup-content>
    <exclude domain="sharedpref" path="airbridge-internal" />
    <exclude domain="sharedpref" path="airbridge-install" />
    <exclude domain="sharedpref" path="airbridge-user-info" />
    <exclude domain="sharedpref" path="airbridge-user-alias" />
    <exclude domain="sharedpref" path="airbridge-user-attributes" />
    <exclude domain="sharedpref" path="airbridge-device-alias" />
    <exclude domain="database" path="airbridge.db" />
</full-backup-content>

Fix confilict with fullBackupContent="string"

If you add android:fullBackupContent="string" in the AndroidManifest.xml, you might get the following error:

Build Output

1
Manifest merger failed : Attribute application@fullBackupContent value=(string) from AndroidManifest.xml
Manifest merger failed : Attribute application@fullBackupContent value=(string) from AndroidManifest.xml

To fix this error, add tools:replace="android:fullBackupContent" in the <application> tag in the AndroidManifest.xml file.

Fix conflict with dataExtractionRules="string resource"

If you add android:dataExtractionRules="string resource" in the AndroidManifest.xml, you might get the following error:

Build Output

12
Manifest merger failed : Attribute application@dataExtractionRules value=(string resource) from AndroidManifest.xml
Manifest merger failed : Attribute application@dataExtractionRules value=(string resource) from AndroidManifest.xml

To fix this error, add tools:replace="android:dataExtractionRules" in the <application> tag in the AndroidManifest.xml file.

Fix conflict with allowBackup="false"

If you add android:allowBackup="false" in the AndroidManifest.xml, you might get the following error:

Build Output

123
Manifest merger failed : Attribute application@allowBackup value=(false) from AndroidManifest.xml:32:9-36
	is also present at [:airbridge] AndroidManifest.xml:27:9-35 value=(true).
	Suggestion: add 'tools:replace="android:allowBackup"' to <application> element at AndroidManifest.xml:30:5-250:19 to override.
Manifest merger failed : Attribute application@allowBackup value=(false) from AndroidManifest.xml:32:9-36
	is also present at [:airbridge] AndroidManifest.xml:27:9-35 value=(true).
	Suggestion: add 'tools:replace="android:allowBackup"' to <application> element at AndroidManifest.xml:30:5-250:19 to override.

To fix this error, add tools:replace="android:allowBackup" in the <application> tag in the AndroidManifest.xml file.

If compileSdkVersion is less than 31

Since the android:dataExtractionRules feature was added from API Level 31, you might get the following error if compileSdkVersion is less than 31:

Build Output

1
AndroidManifest.xml: AAPT: error: attribute android:dataExtractionRules not found.
AndroidManifest.xml: AAPT: error: attribute android:dataExtractionRules not found.

To fix this error, add tools:remove="android:dataExtractionRules" in the <application> tag in the AndroidManifest.xml file.

For more guidance, refer to the articles below.

Issue

GAID is being collected as 00000000-0000-0000-0000-000000000000 even though LAT (Limited Ad Tracking) is deactivated.

Cause

The AD_ID permission has been excluded due to other third-party libraries.

Solution

Add AD_ID permission.

12345
<manifest ...>
  ...
  <uses-permission android:name="com.google.android.gms.permission.AD_ID" />
  ...
</manifest>
<manifest ...>
  ...
  <uses-permission android:name="com.google.android.gms.permission.AD_ID" />
  ...
</manifest>

Was this page helpful?

Have any questions or suggestions?

Troubleshooting - Android SDK (v4)

Coroutine dependency error occurred during the build process

Issue

Cause

Solution

Deeplink Opens that occur through push notifications using the Braze SDK are not collected

Issue

Cause

Solution

"Manifest merger failed" error occurred during the build process

Issue

Cause

Solution

Fix confilict with fullBackupContent="string"

Fix conflict with dataExtractionRules="string resource"

Fix conflict with allowBackup="false"

If compileSdkVersion is less than 31

GAID is collected as 00000000-0000-0000-0000-000000000000

Issue

Cause

Solution

Troubleshooting - Android SDK (v4)self.__wrap_n!=1&&self.__wrap_b(":R29jtt7ppjtsba:",0.5)

Coroutine dependency error occurred during the build process

Issue

Cause

Solution

Deeplink Opens that occur through push notifications using the Braze SDK are not collected

Issue

Cause

Solution

"Manifest merger failed" error occurred during the build process

Issue

Cause

Solution

Fix confilict with fullBackupContent="string"

Fix conflict with dataExtractionRules="string resource"

Fix conflict with allowBackup="false"

If compileSdkVersion is less than 31

GAID is collected as 00000000-0000-0000-0000-000000000000

Issue

Cause

Solution

Troubleshooting - Android SDK (v4)