트러블 슈팅 - 안드로이드 SDK (Deprecated)

BillingClient Dependency

에어브릿지 SDK를 직접 설치할 경우, BillingClient 의존성 문제로 인해 컴파일 오류가 발생할 수 있습니다.에어브릿지 SDK v2.26.1부터 In-App 구매 내역을 수집하는 기능이 추가되었습니다. 에어브릿지 SDK는 In-App 구매 라이브러리에 대한 의존성을 compileOnly로 설정하고 있어, Gradle 빌드 시에는 문제가 없지만 직접 설치할 경우 의존성 문제로 인해 컴파일 오류가 발생할 수 있습니다.이 문제를 해결하려면 아래 내용을 참고해 주세요.

dependencies {
    api fileTree(dir: 'libs', include: ['billingClient.aar'])
}

Ad ID permission

LAT(LimitAdTracking)를 비활성화한 상태에서 GAID가 00000000-0000-0000-0000-000000000000으로 잡히는 이슈

AndroidManifest.xml 파일을 열어주세요.
com.google.android.gms.permission.AD_ID 권한을 다음과 같이 추가해 주세요.

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

더 자세한 내용은 구글 가이드를 참고해 주세요.

Braze push notification

Braze SDK 를 사용하여 push notification 을 통해 deeplink 를 open 할 시 airbridge 에서 event 가 DEEPLINK OPEN 이 안잡히고 OPEN 이 발생합니다.Airbridge SDK 는 event 확인을 위해서 activity 의 action 과 intent 의 dataString 으로 전달 되는 값을 통해 DEEPLINK OPEN ,OPEN 등을 판별 하고 있습니다. 그러나 Braze SDK 에 push notification 을 생성시 Braze SDK 에 정의 된 NotificationTrampolineActivity 을 통해서 open 되는데 해당 activity Action 과 intent 에서 dataString 값을 확인 할 수 없어서 발생하게 됩니다.airbridge android SDK v2.21.5 에서 추가된 아래 interface 를 통해 해당 내용을 해결 할 수 있습니다.

AirbridgeConfig config = new AirbridgeConfig.Builder("YOUR_APP_NAME", "YOUR_APP_SDK_TOKEN")
    .setLifecycleIntegration(new AirbridgeLifecycleIntegration() {
    @Nullable
    @Override
    public String getDataString(@NotNull 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.init(this, config)

val config = AirbridgeConfig.Builder("YOUR_APP_NAME", "YOUR_APP_SDK_TOKEN")
    .setLifecycleIntegration {
      it.takeIf { it.javaClass.name == "com.braze.push.NotificationTrampolineActivity" }
      ?.run { intent?.extras?.getString("uri") }
  }
    .build()
Airbridge.init(this, config)

deeplink.page

deeplink.page 는 airbridge android SDK v2.21.1 버전에서 deprecated 되었습니다. 그렇지만 내부 동작을 통해 여전히 지원 및 동작은 되고 있습니다.airbridge android SDK v2.21.0 이하 버전을 사용중이라면 하단에 명시된 절차에 따라서 Intent Filter를 설정해 주세요.

AndroidManifest.xml 파일을 열어주세요.
딥링크를 처리할 Activity에 Intent Filter를 다음과 같이 추가해 주세요

<activity ...>
    ...
    <intent-filter android:autoVerify="true">
        <action android:name="android.intent.action.VIEW" />
        <category android:name="android.intent.category.DEFAULT" />
        <category android:name="android.intent.category.BROWSABLE" />

        <data android:scheme="http" android:host="YOUR_APP_NAME.deeplink.page" />
        <data android:scheme="https" android:host="YOUR_APP_NAME.deeplink.page" />
    </intent-filter>
    <intent-filter android:autoVerify="true">
        <action android:name="android.intent.action.VIEW" />

        <category android:name="android.intent.category.DEFAULT" />
        <category android:name="android.intent.category.BROWSABLE" />

        <data android:scheme="http" android:host="YOUR_APP_NAME.airbridge.io" />
        <data android:scheme="https" android:host="YOUR_APP_NAME.airbridge.io" />
    </intent-filter>
    <intent-filter>
        <action android:name="android.intent.action.VIEW" />

        <category android:name="android.intent.category.DEFAULT" />
        <category android:name="android.intent.category.BROWSABLE" />

        <data android:scheme="YOUR_APP_URI_SCHEME" />
    </intent-filter>
</activity>

Dependencies

`java.lang.NoClassDefFoundError: kotlin/coroutines/AbstractCoroutineContextKey` 문제

Text

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)
  ...

참조 : https://github.com/Kotlin/kotlinx.coroutines/issues/1879

@qwwdfsad에 따르면 kotlinx-coroutines-core 라이브러리 1.3.5 이상의 버전을 사용 시 반드시 kotlin-stdlib 라이브러리 버전 1.3.70 이상을 사용하도록 강제하고 있습니다.gradlew dependencies 커멘드를 통해 현재 포함된 kotlinx-coroutines-core 라이브러리 버전이 1.3.5 이상인 경우 kotlin-stdlib 라이브러리 버전이 1.3.70 이상인지 확인해 주세요.

Auto Backup

참조 : https://developer.android.com/guide/topics/data/autobackup

에어브릿지 SDK의 AndroidManifest.xml에는 공유 환경 설정 데이터 백업을 옵트아웃하는 규칙이 포함되어 있습니다. 이는 재설치 중에 동일한 에어브릿지 설정 값들을 유지하지 않도록 하여 새로운 설치 또는 재설치를 정확하게 감지하도록 하기 위해 수행됩니다.에어브릿지 SDK 백업 규칙과 앱 백업 규칙의 병합 과정에서 충돌을 방지하려면 각 사용 사례에 대해 다음 지침을 수행하세요.에어브릿지 SDK에서 정의하는 옵트아웃하는 규칙은 다음과 같습니다.

<?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"?>
<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>

fullBackupContent="string"과의 충돌 방지

android:fullBackupContent="string"를 AndroidManifest.xml에 추가하면 다음과 같은 오류가 발생할 수 있습니다.

Build Output

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

위 오류를 해결하려면 AndroidManifest.xml 파일의 <application> 태그에 tools:replace="android:fullBackupContent"를 추가 해주세요.

dataExtractionRules="string resource"과의 충돌 방지

android:dataExtractionRules="string resource"를 AndroidManifest.xml에 추가하면 다음과 같은 오류가 발생할 수 있습니다.

Build Output

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

위 오류를 해결하려면 AndroidManifest.xml 파일의 <application> 태그에 tools:replace="android:dataExtractionRules"를 추가 해주세요.

allowBackup="false"과의 충돌 방지

android:allowBackup="false"를 AndroidManifest.xml에 추가하면 다음과 같은 오류가 발생할 수 있습니다.

Build Output

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.

위 오류를 해결하려면 AndroidManifest.xml 파일의 <application> 태그에 tools:replace="android:allowBackup"를 추가 해주세요.

compileSdkVersion이 31 미만일 경우

android:dataExtractionRules 기능이 API Level 31 부터 추가되었기 때문에 compileSdkVersion이 31 미만일 경우, 다음과 같은 오류가 발생할 수 있습니다.

Build Output

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

위 오류를 해결하려면 AndroidManifest.xml 파일의 <application> 태그에 tools:remove="android:dataExtractionRules"를 추가 해주세요.

에어브릿지 SDK 백업 규칙 병합 충돌 문제

에어브릿지 SDK 백업 규칙과 서드파티 SDK 백업 규칙 중복 적용으로 인해 빌드 에러가 발생하는 경우 해결 방법은 아래를 참고해주세요.예) 에어브릿지 SDK 백업 규칙과 Appsflyer SDK 백업 규칙이 중복 적용되는 경우 아래와 같은 빌드 에러가 표시됩니다.

Attribute application@fullBackupContent value=(@xml/appsflyer_backup_rules) from [com.appsflyer:af-android-sdk:6.6.1] AndroidManifest.xml:14:18-73
is also present at [io.airbridge:sdk-android:2.14.0] AndroidManifest.xml:27:18-78 value=(@xml/airbridge_auto_backup_rules).
Suggestion: add 'tools:replace="android:fullBackupContent"' to <application> element at AndroidManifest.xml:7:5-13:19 to override.

이 문제를 해결하기 위해서는 아래와 같이 설정해주세요.

backup_rules.xml 설정

src/main/res/xml 폴더를 생성해주세요.
생성된 xml 폴더 내부에 (e.g. custom_backup_rules.xml) 파일을 생성해주세요.
에어브릿지 SDK에서 정의하는 데이터 백업 규칙을 다음과 같이 추가해 주세요.

<?xml version="1.0" encoding="utf-8"?>
<full-backup-content>
    <!-- Airbridge Backup Rules -->
    <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" />

    <!-- Appsflyer Backup Rules -->
    <exclude domain="sharedpref" path="appsflyer-data"/>

    <!-- Your Custom Backup Rules -->
</full-backup-content>

data_extraction_rules.xml 설정

알립니다data_extraction_rules.xml 설정은 Airbridge Android SDK v2.27.1 이상부터 필요로 합니다.

생성된 xml 폴더 내부에 (e.g. custom_data_extraction_rule.xml) 파일을 생성해주세요.
에어브릿지 SDK에서 정의하는 데이터 백업 규칙을 다음과 같이 추가해 주세요.

<?xml version="1.0" encoding="utf-8"?>
<data-extraction-rules>
    <cloud-backup>
        <!-- Airbridge Backup Rules -->
        <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" />

        <!-- Appsflyer Backup Rules -->
        <exclude domain="sharedpref" path="appsflyer-data"/>

        <!-- Your Custom Backup Rules -->
    </cloud-backup>
    <device-transfer>
        <!-- Airbridge Backup Rules -->
        <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" />

        <!-- Appsflyer Backup Rules -->
        <exclude domain="sharedpref" path="appsflyer-data"/>

        <!-- Your Custom Backup Rules -->
    </device-transfer>
</data-extraction-rules>

AndroidManifest.xml 설정

Airbridge Android SDK v2.27.1 이상

<manifest
    ...
    xmlns:tools="http://schemas.android.com/tools">

    <application
        ...
        android:allowBackup="true"
        android:fullBackupContent="@xml/custom_backup_rules"
        android:dataExtractionRules="@xml/custom_data_extraction_rules"
        tools:replace="android:fullBackupContent,android:dataExtractionRules">

Airbridge Android SDK v2.27.1 미만

<manifest
    ...
    xmlns:tools="http://schemas.android.com/tools">

    <application
        ...
        android:allowBackup="true"
        android:fullBackupContent="@xml/custom_backup_rules"
        tools:replace="android:fullBackupContent">

Double brace initialization issue

HashMap<String, Object> semanticAttributes = new HashMap();
semanticAttributes.put("products", Arrays.asList(
        // double brace initialization issue
        new HashMap<String, Object>() {{
            put("name", "MacBook Pro");
            put("price", 1548200);
            put("position", 1);
            put("brandID", 23);
            put("brandName", "apple");
        }},
        new HashMap<String, Object>() {{
            put("name", "MacBook Air");
            put("price", 1500000);
            put("position", 2);
            put("brandID", 23);
            put("brandName", "apple");
        }}
    )
);

HashMap<String, Object> customAttributes = new HashMap();
customAttributes.put("customKey", "customValue");

Airbridge.trackEvent(
    "purchase",
    "action",
    "label",
    3048200,
    customAttributes,
    semanticAttributes
);

Android SDK는 Google의 GSON 라이브러리를 사용중이며, 해당 라이브러리에 Double Brace Initialization 관련 Known Issue가 존재합니다. 하여 위 Java 코드와 같이 Products 객체를 만들때 Double Brace Initialization를 사용하면 products 데이터가 누락될 수 있기 때문에, 결제 완료의 예시 코드처럼 직접 Product 객체를 만들어 사용하시는 것을 권장드립니다.

LAT(LimitAdTracking)를 비활성화한 상태에서 GAID가 00000000-0000-0000-0000-000000000000으로 잡히는 이슈

​java.lang.NoClassDefFoundError: kotlin/coroutines/AbstractCoroutineContextKey 문제

Airbridge Android SDK v2.27.1 이상

Airbridge Android SDK v2.27.1 미만

`java.lang.NoClassDefFoundError: kotlin/coroutines/AbstractCoroutineContextKey` 문제