Password AutoFill 기능으로 저장된 암호의 도메인이 airbridge.io 또는 abr.ge로 보이는 현상이 앱을 사용하는 유저에게 발생할 수 있습니다.
에어브릿지 SDK의 딥링크를 설정한 후에 Password AutoFill 기능을 활용하면 도메인이 에어브릿지 딥링크의 앱 링크(applinks) 도메인 airbridge.io 또는 abr.ge로 저장됩니다.
Password AutoFill에 사용하는 webcredentials 도메인을 설정하면 문제를 해결할 수 있습니다.
1. 암호를 저장하는 도메인을 준비해주세요.
2. 아래 JSON을 https://YOUR_DOMAIN/.well-known/apple-app-site-association에 Content-Type: application/json으로 호스팅합니다. 준비한 도메인이 YOUR_DOMAIN입니다.
애플 개발자 대시보드의 [Identifiers]>[YOUR_APP]에서 App ID Prefix, Bundle ID를 확인할 수 있습니다.
{ "webcredentials": { "apps": ["YOUR_APP_ID_PREFIX.YOUR_BUNDLE_ID"] }}3. Xcode의 [YOUR_PROJECT]>[Signing & Capabilities]로 이동합니다.
4. '+ Capability'를 클릭해 Associated Domains를 추가합니다. Associated Domains에 webcredentials:YOUR_DOMAIN을 입력합니다.
Cordova-Ionic SDK 2.0.1 이상의 버전으로 iOS 빌드 시 Bitcode 를 지원하지 않아서 아래와 같이 에러가 발생 할 수 있습니다.
ld: XCFrameworkIntermediates/AirBridge/AirBridge.framework/AirBridge(AirBridge-arm64-master.o)' does not contain bitcode. You must rebuild it with bitcode enabled (Xcode setting ENABLE_BITCODE)Cordova-Ionic SDK 2.0.1 버전 부터 Airbridge iOS SDK 1.28.0 버전 으로 업데이트 되었습니다. Airbridge iOS SDK 는 1.28.0 버전 부터 Bitcode 를 지원하지 않습니다.
해당 에러 발생 시 아래 가이드를 참고 바랍니다.
빌드하면 아래 메시지와 함께 Dependencies coroutines 오류가 발생합니다.
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) ...kotlinx-coroutines-core 라이브러리 버전이 v1.3.5 이상이면 kotlin-stdlib 라이브러리 버전이 일정 레벨 이상이어야 합니다.
gradlew dependencies 커멘드로 kotlin-stdlib 라이브러리 버전이 v1.3.70 이상인지 확인해 주세요. 해당 버전 미만이라면 업데이트를 진행해야 합니다.
브레이즈 SDK를 사용한 푸시 알림으로 발생한 딥링크 실행(Deeplink Open) 이벤트가 수집되지 않습니다. 대신 실행(Open) 이벤트가 수집됩니다.
에어브릿지 안드로이드 SDK는 activity의 action에 있는 dataString과 intent의 dataString으로 딥링크 실행 이벤트와 실행 이벤트를 판별합니다.
브레이즈 SDK를 사용한 푸시 알림으로 앱을 실행하면 NotificationTrampolineActivity을 사용합니다. 브레이즈 SDK를 사용한 푸시 알림으로 앱을 실행하면 NotificationTrampolineActivity의 activity의 action과 intent로부터 dataString을 확인할 수 없습니다. 이로 인해 딥링크 실행 이벤트와 실행 이벤트를 판별할 수 없습니다.
android/app/src/main/java/.../MainApplication.kt 파일에 아래와 같이 코드를 추가해주세요.
import co.ab180.airbridge.cordova.AirbridgeCordova import co.ab180.airbridge.cordova.common.AirbridgeLifecycleIntegration...AirbridgeCordova .setLifecycleIntegration = { activity -> return@setLifecycleIntegration activity .takeIf { it.javaClass.name == "com.braze.push.NotificationTrampolineActivity" } ?.run { intent?.extras?.getString("uri") }}import co.ab180.airbridge.cordova.AirbridgeCordova ;import co.ab180.airbridge.cordova.common.AirbridgeLifecycleIntegration;...AirbridgeCordova .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; }});import co.ab180.airbridge.cordova.AirbridgeCordova import co.ab180.airbridge.cordova.common.AirbridgeLifecycleIntegration...AirbridgeCordova .setLifecycleIntegration = { activity -> return@setLifecycleIntegration activity .takeIf { it.javaClass.name == "com.braze.push.NotificationTrampolineActivity" } ?.run { intent?.extras?.getString("uri") }}import co.ab180.airbridge.cordova.AirbridgeCordova ;import co.ab180.airbridge.cordova.common.AirbridgeLifecycleIntegration;...AirbridgeCordova .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; }});빌드하면 Manifest merger failed 오류가 발생합니다.
에어브릿지 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><?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>android:fullBackupContent="string"를 AndroidManifest.xml에 추가하면 다음과 같은 오류가 발생할 수 있습니다.
Manifest merger failed : Attribute application@fullBackupContent value=(string) from AndroidManifest.xml위 오류를 해결하려면 AndroidManifest.xml 파일의
<manifest> 태그에 xmlns:tools="http://schemas.android.com/tools"를 추가 해주세요.
<application> 태그에 tools:replace="android:fullBackupContent"를 추가 해주세요.
android:dataExtractionRules="string resource"를 AndroidManifest.xml에 추가하면 다음과 같은 오류가 발생할 수 있습니다.
Manifest merger failed : Attribute application@dataExtractionRules value=(string resource) from AndroidManifest.xml 위 오류를 해결하려면 AndroidManifest.xml 파일의
<manifest> 태그에 xmlns:tools="http://schemas.android.com/tools"를 추가 해주세요.
<application> 태그에 tools:replace="android:dataExtractionRules"를 추가 해주세요.
android:allowBackup="false"를 AndroidManifest.xml에 추가하면 다음과 같은 오류가 발생할 수 있습니다.
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 파일의
<manifest> 태그에 xmlns:tools="http://schemas.android.com/tools"를 추가 해주세요.
<application> 태그에 tools:replace="android:allowBackup"를 추가 해주세요.
android:dataExtractionRules 기능이 API Level 31 부터 추가되었기 때문에 compileSdkVersion이 31 미만일 경우, 다음과 같은 오류가 발생할 수 있습니다.
AndroidManifest.xml: AAPT: error: attribute android:dataExtractionRules not found.위 오류를 해결하려면 AndroidManifest.xml 파일의
<manifest> 태그에 xmlns:tools="http://schemas.android.com/tools"를 추가 해주세요.
<application> 태그에 tools:remove="android:dataExtractionRules"를 추가 해주세요.
아래 가이드를 함께 참고해 주세요.
에어브릿지 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-73is 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.에어브릿지 SDK 백업 규칙과 서드파티 SDK 백업 규칙 중복 적용으로 인해 빌드 에러가 발생할 수 있습니다.
android/app/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>생성된 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><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">도움이 되었나요?