Merge pull request #283 from adjust/v550

Version 5.5.0

Author: uerceg

CHANGELOG.md

@@ -1,3 +1,19 @@
+### Version 5.5.0 (6th December 2025)
+#### Added
+- Added `getAdidWithTimeout` method to the `Adjust` API to allow retrieving the ADID with a specified timeout. If the value is not obtained in time, null is returned.
+- Added `getAttributionWithTimeout` method to the `Adjust` API to allow retrieving the current attribution information with a specified timeout. If the value is not obtained in time, null is returned.
+- Added the `resolveLinkWithUrl` method to the `Adjust` API to resolve the underlying Adjust link from other links that wrap Adjust links.
+- Added ability to disable the reading of the app set ID. You can do this by calling the `disableAppSetIdReading` method on your `AdjustConfig` instance.
+
+#### Changed
+- Updated the Adjust Signature library version to 3.62.0.
+
+#### Native SDKs
+- [[email protected]][ios_sdk_v5.5.0]
+- [[email protected]][android_sdk_v5.5.0]
+
+---
+
 ### Version 5.4.4 (23rd October 2025)
 #### Changed
 - Updated the Adjust Signature library version to 3.61.0.
@@ -801,6 +817,7 @@ In case you were using beta version of the SDK v5, please switch to the official
 [ios_sdk_v5.4.3]: https://github.com/adjust/ios_sdk/tree/v5.4.3
 [ios_sdk_v5.4.4]: https://github.com/adjust/ios_sdk/tree/v5.4.4
 [ios_sdk_v5.4.6]: https://github.com/adjust/ios_sdk/tree/v5.4.6
+[ios_sdk_v5.5.0]: https://github.com/adjust/ios_sdk/tree/v5.5.0
 
 [android_sdk_v4.10.4]: https://github.com/adjust/android_sdk/tree/v4.10.4
 [android_sdk_v4.11.0]: https://github.com/adjust/android_sdk/tree/v4.11.0
@@ -847,3 +864,4 @@ In case you were using beta version of the SDK v5, please switch to the official
 [android_sdk_v5.4.2]: https://github.com/adjust/android_sdk/tree/v5.4.2
 [android_sdk_v5.4.4]: https://github.com/adjust/android_sdk/tree/v5.4.4
 [android_sdk_v5.4.5]: https://github.com/adjust/android_sdk/tree/v5.4.5
+[android_sdk_v5.5.0]: https://github.com/adjust/android_sdk/tree/v5.5.0

VERSION

@@ -1 +1 @@
-5.4.4
+5.5.0

android/build.gradle

@@ -27,5 +27,5 @@ android {
 
 dependencies {
     implementation 'com.facebook.react:react-native:+'
-    implementation 'com.adjust.sdk:adjust-android:5.4.5'
+    implementation 'com.adjust.sdk:adjust-android:5.5.0'
 }

android/src/main/java/com/adjust/sdk/Adjust.java

@@ -283,6 +283,14 @@ && checkKey(mapConfig, "isDataResidency")) {
             }
         }
 
+        // app set ID reading (Android only)
+        if (checkKey(mapConfig, "isAppSetIdReadingEnabled")) {
+            boolean isAppSetIdReadingEnabled = mapConfig.getBoolean("isAppSetIdReadingEnabled");
+            if (!isAppSetIdReadingEnabled) {
+                adjustConfig.disableAppSetIdReading();
+            }
+        }
+
         // store info 
         if (checkKey(mapConfig, "storeInfo")) {
             ReadableMap storeInfo = mapConfig.getMap("storeInfo");
@@ -603,9 +611,15 @@ public void processDeeplink(final ReadableMap mapDeeplink) {
     @ReactMethod
     public void processAndResolveDeeplink(final ReadableMap mapDeeplink, final Callback callback) {
         if (mapDeeplink == null) {
+            if (callback != null) {
+                callback.invoke((String) null);
+            }
             return;
         }
         if (!checkKey(mapDeeplink, "deeplink")) {
+            if (callback != null) {
+                callback.invoke((String) null);
+            }
             return;
         }
 
@@ -622,11 +636,44 @@ public void processAndResolveDeeplink(final ReadableMap mapDeeplink, final Callb
             new OnDeeplinkResolvedListener() {
             @Override
             public void onDeeplinkResolved(String resolvedLink) {
-                callback.invoke(resolvedLink);
+                if (callback != null) {
+                    callback.invoke(resolvedLink);
+                }
             }
         });
     }
 
+    @ReactMethod
+    public void resolveLinkWithUrl(final String url, final ReadableArray resolveUrlSuffixArray, final Callback callback) {
+        if (url == null) {
+            if (callback != null) {
+                callback.invoke((String) null);
+            }
+            return;
+        }
+        String[] suffixArray = null;
+        if (resolveUrlSuffixArray != null && resolveUrlSuffixArray.size() > 0) {
+            int n = resolveUrlSuffixArray.size();
+            suffixArray = new String[n];
+            for (int i = 0; i < n; i++) {
+                suffixArray[i] = resolveUrlSuffixArray.getString(i);
+            }
+        }
+        com.adjust.sdk.AdjustLinkResolution.resolveLink(
+            url,
+            suffixArray,
+            new com.adjust.sdk.AdjustLinkResolution.AdjustLinkResolutionCallback() {
+                @Override
+                public void resolvedLinkCallback(Uri resolvedLink) {
+                    if (callback != null) {
+                        String resolvedUrl = resolvedLink != null ? resolvedLink.toString() : null;
+                        callback.invoke(resolvedUrl);
+                    }
+                }
+            }
+        );
+    }
+
     @ReactMethod
     public void setPushToken(final String token) {
         com.adjust.sdk.Adjust.setPushToken(token, getReactApplicationContext());
@@ -714,7 +761,9 @@ public void isEnabled(final Callback callback) {
             new com.adjust.sdk.OnIsEnabledListener() {
             @Override
             public void onIsEnabledRead(boolean isEnabled) {
-                callback.invoke(isEnabled);
+                if (callback != null) {
+                    callback.invoke(isEnabled);
+                }
             }
         });
     }
@@ -724,30 +773,104 @@ public void getAttribution(final Callback callback) {
         com.adjust.sdk.Adjust.getAttribution(new com.adjust.sdk.OnAttributionReadListener() {
             @Override
             public void onAttributionRead(AdjustAttribution attribution) {
-                callback.invoke(AdjustUtil.attributionToMap(attribution));
+                if (callback != null) {
+                    callback.invoke(AdjustUtil.attributionToMap(attribution));
+                }
             }
         });
     }
 
+    @ReactMethod
+    public void getAttributionWithTimeout(final ReadableMap timeoutMap, final Callback callback) {
+        if (timeoutMap == null || !checkKey(timeoutMap, "timeoutInMilliseconds")) {
+            if (callback != null) {
+                callback.invoke((WritableMap) null);
+            }
+            return;
+        }
+
+        long timeoutInMilliseconds;
+        try {
+            timeoutInMilliseconds = (long) timeoutMap.getDouble("timeoutInMilliseconds");
+        } catch (Exception e) {
+            if (callback != null) {
+                callback.invoke((WritableMap) null);
+            }
+            return;
+        }
+
+        com.adjust.sdk.Adjust.getAttributionWithTimeout(
+            getReactApplicationContext(),
+            timeoutInMilliseconds,
+            new com.adjust.sdk.OnAttributionReadListener() {
+                @Override
+                public void onAttributionRead(AdjustAttribution attribution) {
+                    if (callback != null) {
+                        if (attribution == null) {
+                            callback.invoke((WritableMap) null);
+                        } else {
+                            callback.invoke(AdjustUtil.attributionToMap(attribution));
+                        }
+                    }
+                }
+            });
+    }
+
     @ReactMethod
     public void getAdid(final Callback callback) {
         com.adjust.sdk.Adjust.getAdid(new com.adjust.sdk.OnAdidReadListener() {
             @Override
             public void onAdidRead(String adid) {
-                callback.invoke(adid);
+                if (callback != null) {
+                    callback.invoke(adid != null ? adid : null);
+                }
             }
         });
     }
 
+    @ReactMethod
+    public void getAdidWithTimeout(final ReadableMap timeoutMap, final Callback callback) {
+        if (timeoutMap == null || !checkKey(timeoutMap, "timeoutInMilliseconds")) {
+            if (callback != null) {
+                callback.invoke((String) null);
+            }
+            return;
+        }
+
+        long timeoutInMilliseconds;
+        try {
+            timeoutInMilliseconds = (long) timeoutMap.getDouble("timeoutInMilliseconds");
+        } catch (Exception e) {
+            if (callback != null) {
+                callback.invoke((String) null);
+            }
+            return;
+        }
+
+        com.adjust.sdk.Adjust.getAdidWithTimeout(
+            getReactApplicationContext(),
+            timeoutInMilliseconds,
+            new com.adjust.sdk.OnAdidReadListener() {
+                @Override
+                public void onAdidRead(String adid) {
+                    if (callback != null) {
+                        callback.invoke(adid != null ? adid : null);
+                    }
+                }
+            });
+    }
+
     @ReactMethod
     public void getLastDeeplink(final Callback callback) {
         com.adjust.sdk.Adjust.getLastDeeplink(
             getReactApplicationContext(),
             new OnLastDeeplinkReadListener() {
             @Override
             public void onLastDeeplinkRead(Uri uri) {
-                String strUri = (uri != null) ? uri.toString() : "";
-                callback.invoke(strUri);
+                if (callback != null) {
+                    String strUri = (uri != null) ? uri.toString() : null;
+                    callback.invoke(strUri);
+                }
             }
         });
     }
@@ -757,10 +880,12 @@ public void getSdkVersion(final String sdkPrefix, final Callback callback) {
         com.adjust.sdk.Adjust.getSdkVersion(new com.adjust.sdk.OnSdkVersionReadListener() {
             @Override
             public void onSdkVersionRead(String sdkVersion) {
-                if (sdkVersion == null) {
-                    callback.invoke("");
-                } else {
-                    callback.invoke(sdkPrefix + "@" + sdkVersion);
+                if (callback != null) {
+                    if (sdkVersion == null) {
+                        callback.invoke((String) null);
+                    } else {
+                        callback.invoke(sdkPrefix + "@" + sdkVersion);
+                    }
                 }
             }
         });
@@ -889,6 +1014,10 @@ public void trackPlayStoreSubscription(final ReadableMap mapEvent) {
     @ReactMethod
     public void verifyPlayStorePurchase(final ReadableMap mapEvent, final Callback callback) {
         if (mapEvent == null) {
+            if (callback != null) {
+                WritableMap map = Arguments.createMap();
+                callback.invoke(map);
+            }
             return;
         }
 
@@ -934,6 +1063,10 @@ public void onVerificationFinished(AdjustPurchaseVerificationResult verification
     @ReactMethod
     public void verifyAndTrackPlayStorePurchase(final ReadableMap mapEvent, final Callback callback) {
         if (mapEvent == null) {
+            if (callback != null) {
+                WritableMap map = Arguments.createMap();
+                callback.invoke(map);
+            }
             return;
         }
 
@@ -1068,7 +1201,9 @@ public void getGoogleAdId(final Callback callback) {
             new com.adjust.sdk.OnGoogleAdIdReadListener() {
             @Override
             public void onGoogleAdIdRead(String googleAdId) {
-                callback.invoke(googleAdId);
+                if (callback != null) {
+                    callback.invoke(googleAdId);
+                }
             }
         });
     }
@@ -1080,7 +1215,9 @@ public void getAmazonAdId(final Callback callback) {
             new com.adjust.sdk.OnAmazonAdIdReadListener() {
             @Override
             public void onAmazonAdIdRead(String amazonAdId) {
-                callback.invoke(amazonAdId);
+                if (callback != null) {
+                    callback.invoke(amazonAdId);
+                }
             }
         });
     }

example/android/app/build.gradle

@@ -110,7 +110,7 @@ android {
 dependencies {
     // The version of react-native is set by the React Native Gradle Plugin
     implementation("com.facebook.react:react-android")
-    implementation("com.adjust.sdk:adjust-android-google-lvl:5.4.4")
+    implementation("com.adjust.sdk:adjust-android-google-lvl:5.5.0")
 
     if (hermesEnabled.toBoolean()) {
         implementation("com.facebook.react:hermes-android")

ext/android/sdk

@@ -91,6 +91,7 @@ declare module 'react-native-adjust' {
     public disableIdfvReading(): void
     public disableSkanAttribution(): void
     public disableAppTrackingTransparencyUsage(): void
+    public disableAppSetIdReading(): void
     public setEventDeduplicationIdsMaxSize(eventDeduplicationIdsMaxSize: number): void
     public setAttConsentWaitingInterval(attConsentWaitingInterval: number): void
     public setUrlStrategy(urlStrategyDomains: string[], useSubdomains: boolean, isDataResidency: boolean): void
@@ -227,21 +228,24 @@ declare module 'react-native-adjust' {
     getIdfa: (callback: (idfa: string | null) => void) => void
     getIdfv: (callback: (idfv: string | null) => void) => void
     getGoogleAdId: (callback: (adid: string | null) => void) => void
-    getAdid: (callback: (adid: string) => void) => void
+    getAdid: (callback: (adid: string | null) => void) => void
+    getAdidWithTimeout: (timeoutInMilliseconds: number, callback: (adid: string | null) => void) => void
     getAttribution: (callback: (attribution: AdjustAttribution) => void) => void
+    getAttributionWithTimeout: (timeoutInMilliseconds: number, callback: (attribution: AdjustAttribution | null) => void) => void
     getAmazonAdId: (callback: (adid: string | null) => void) => void
-    getSdkVersion: (callback: (sdkVersion: string) => void) => void
+    getSdkVersion: (callback: (sdkVersion: string | null) => void) => void
     requestAppTrackingAuthorization: (handler: (status: number) => void) => void
     updateSkanConversionValue: (conversionValue: number, coarseValue: string, lockWindow: boolean, callback: (error: string | null) => void) => void
     getAppTrackingAuthorizationStatus: (callback: (status: number) => void) => void
     trackThirdPartySharing: (adjustThirdPartySharing: AdjustThirdPartySharing) => void
     trackMeasurementConsent: (measurementConsent: boolean) => void
-    getLastDeeplink: (callback: (lastDeeplink: string) => void) => void
+    getLastDeeplink: (callback: (lastDeeplink: string | null) => void) => void
     verifyAppStorePurchase: (purchase: AdjustAppStorePurchase, callback: (verificationResult: AdjustPurchaseVerificationResult) => void) => void
     verifyAndTrackAppStorePurchase: (adjustEvent: AdjustEvent, callback: (verificationResult: AdjustPurchaseVerificationResult) => void) => void
     verifyPlayStorePurchase: (purchase: AdjustPlayStorePurchase, callback: (verificationResult: AdjustPurchaseVerificationResult) => void) => void
     verifyAndTrackPlayStorePurchase: (adjustEvent: AdjustEvent, callback: (verificationResult: AdjustPurchaseVerificationResult) => void) => void
-    processAndResolveDeeplink: (adjustDeeplink: AdjustDeeplink, callback: (resolvedLink: string) => void) => void
+    processAndResolveDeeplink: (adjustDeeplink: AdjustDeeplink, callback: (resolvedLink: string | null) => void) => void
+    resolveLinkWithUrl: (url: string, resolveUrlSuffixArray: string[], callback: (resolvedLink: string | null) => void) => void
     endFirstSessionDelay: () => void
     enableCoppaComplianceInDelay: () => void
     disableCoppaComplianceInDelay: () => void