Panoramica delle versioni SDK e registro delle modifiche

Questa versione 3 presenta importanti modifiche rispetto alla v2 su tutte le piattaforme. 

Registro delle modifiche iOS SDK v3

Versione 3.8.0 (Rilasciata il 18/12/2025)

Aggiunto

    • isConsentRequired metodo, che offre la stessa funzionalità del checkIfConsentIsRequired .
    • Strategia di registrazione migliorata
    • Risolto il problema con il listener della dimensione del carattere

    Versione 3.6.0 (Rilasciata il 15/10/2025)

    Aggiunto

      • noHash parametro per UrlConfig per controllare il metodo di inserimento dei dati di consenso ed evitare di inviare la stringa di consenso come hash nell'URL
      • Implementa l'API setATTStatus() per memorizzare e trasmettere automaticamente lo stato ATT

      Rimosso

        • Tutti i metodi contrassegnati in precedenza come deprecati

        Versione 3.5.2 (Rilasciata il 16/09/2025)

        Hotfix

        • Risolto il problema che, a seconda delle configurazioni del CMP e delle dimensioni dello schermo del dispositivo, rendeva i pulsanti all'interno della WebView non cliccabili.

        Versione 3.5.1 (Rilasciata il 16/09/2025)

        Aggiunto

        • Aggiunto il supporto per iPhone 17.  

        Versione 3.5.0 (Rilasciata il 12/08/2025)

        Aggiunto

        • Oggetto JSON con opzioni di configurazione per clienti specifici.
        • L'aggiornamento a questa versione non è necessario, a meno che non sia esplicitamente indicato nelle configurazioni della tua dashboard CMP. 

        Versione 3.4.0 (Rilasciata il 09/07/2025)

        Aggiunto/Migliorato

        • Attiva/disattiva la modalità Consenso di Google v2 per attivare e disattivare l'attivazione automatica del setConsent per aggiornare i consensi tramite introspezione
        • Consenso automatico tramite introspezione ai seguenti SDK: AppsFlyer, AdJust, Branch, Kochava, Singular, AirBridge e Tenjin
        • Miglioramenti generali di SwiftDoc su tutte le classi esposte

        Versione 3.3.1 (Rilasciata il 19/06/2025)

        Corretto

        • Timeout anticipato Problema con il checkAndOpen metodo

        Versione 3.3.0 (Rilasciata il 18/06/2025)

        Aggiunto/Migliorato

        • Google Consent Mode v2 ora attiva automaticamente il setConsent per aggiornare i consensi tramite introspezione
        • Gestione del ciclo di vita di WKWebView migliorata per aumentare le prestazioni
        • Funzionalità di accessibilità che ora aumenta la dimensione dei caratteri all'interno del layer di consenso in base alle impostazioni del dispositivo per il testo ingrandito
        • Versione asincrona del forceOpen metodo

        Corretto

        • Problema con il getGoogleConsentModeStatus metodo che in alcuni casi restituiva la stringa sbagliata
        • Visualizzazione irregolare del layer di consenso su alcuni dispositivi
        • La modalità scura ora visualizza correttamente il design previsto
        • getStatusForVendor Il metodo ora restituisce correttamente lo stato di un determinato fornitore
        • Problema che impediva la visualizzazione consecutiva del layer di consenso

        Versione 3.2.0 (Rilasciata il 17/03/2025)

        Aggiunto/Migliorato

        • Modalità Consenso di Google v2
        • SwiftDoc per rendere più chiaro l'utilizzo

          Modifica sostanziale/Rimosso

          • Tutti i metodi di gestione ATT a causa dell'impossibilità di richiamare i metodi ATT durante gli eventi del ciclo di vita appropriati, che non sono accessibili dall'interno del nostro SDK CMP. 

          Versione 3.1.1 (Rilasciata il 26/02/2025)

          Aggiunto

          • Aggiunto serializzatore personalizzato per gestire la mappatura tra valori stringa JSON e tipi enum

          Corretto

          • Aggiornati i metodi pertinenti per utilizzare i tipi di enumerazione corretti che davano falsi risultati "negativi" per alcuni consensi

          Versione 3.1.0 (Rilasciata il 18/02/2025)

          Modifiche principali
          • Introdotta una nuova gestione unificata dello stato del consenso tramite getUserStatus() metodo
          • Aggiunto il supporto per l'integrazione con Google Consent Mode v2
          • Gestione avanzata di WebView e gestione del ciclo di vita
          Nuove funzionalità
          • – Aggiunto getStatusForPurpose() e getStatusForVendor() per il controllo granulare del consenso
          • Introdotto forceOpen() per la gestione diretta del layer di consenso con il jumpToSettings parametro
          • Aggiunto checkAndOpen() con gestione degli errori migliorata e supporto per i callback
          • Implementato nuovo ConsentStatus enum per una gestione più precisa dello stato del consenso
          • Aggiunta la compatibilità con Google Consent Mode v2 getGoogleConsentModeStatus()
          • Introdotto LinkClickHandler typealias per i callback di gestione degli URL. Questo aggiunge funzionalità di gestione dei clic sui link al nostro SDK CMP, consentendo alle applicazioni di personalizzare la gestione dei link all'interno del livello di consenso.
          Deprecazioni

          Diversi metodi sono stati deprecati a favore di alternative più robuste o unificate:

          • Obsoleto checkIfConsentIsRequired() – Usa checkAndOpen() invece
          • Obsoleto hasUserChoice() – Usa getUserStatus() invece
          • Obsoleto hasPurposeConsent() – Usa getStatusForPurpose() invece
          • Obsoleto hasVendorConsent() – Usa getStatusForVendor() invece

          I seguenti metodi sono stati consolidati in getUserStatus():

          • Obsoleto getAllPurposesIDs()
          • Obsoleto getEnabledPurposesIDs()
          • Obsoleto getDisabledPurposesIDs()
          • Obsoleto getAllVendorsIDs()
          • Obsoleto getEnabledVendorsIDs()
          • Obsoleto getDisabledVendorsIDs()

          Metodi UI

          • Obsoleto openConsentLayer() – Usa forceOpen() invece
          • Obsoleto checkWithServerAndOpenIfNecessary() – Usa checkAndOpen() invece
          Guida alla migrazione

          Per migrare alla nuova API:

          1. Sostituisci i singoli metodi di verifica del consenso con getUserStatus()
          2. Aggiorna le chiamate relative all'interfaccia utente per utilizzare forceOpen() e checkAndOpen()
          3. Rifattorizza i controlli di scopo e fornitore per utilizzare getStatusForPurpose() e getStatusForVendor()

          Tutti i metodi deprecati saranno rimossi nel prossimo aggiornamento della versione.

          Riscritto

          Protezione rafforzata contro la chiusura della webview.

          Versione 3.0.2 (Rilasciata il 16/12/2024)

          Corretto

          Problemi di collegamento con le integrazioni Objective-C.

          Versione 3.0.1 (Rilasciata il 04/12/2024)

          Corretto

          Problema con la codifica/decodifica JSON per alcuni CMP specifici.

          Versione 3.0.0 (Rilasciata il 16/10/2024)

          Completamente riscritta da zero, questa versione offre tutti i vantaggi, le funzionalità e le correzioni raccolti con i nostri clienti negli ultimi anni. È più leggera, più veloce e più sicura. 

          Registro delle modifiche Android SDK v3

          Versione 3.8.0 (Rilasciata il 18/12/2025)

          Aggiunto

            • isConsentRequired metodo, che offre la stessa funzionalità del metodo checkIfConsentIsRequired .

            Versione 3.7.1 (Rilasciata il 03/12/2025)

            Migliorata

            • Rilevamento automatico della piattaforma Android TV

            Versione 3.7.0 (Rilasciata il 18/11/2025)

            Migliorata

            • ConsentLayerUIConfig l'oggetto ora accetta:
              • statusBarColor, containerBackgroundColor, dialogThemeResIdand e showSystemBars per ottenere design pixel perfect

            Versione 3.6.2 (Rilasciata il 06/11/2025)

            Aggiunto/Migliorato

            • ConsentLayerUIConfig l'oggetto ora accetta:
              • gravity parametro per consentire TOP, CENTER o BOTTOM impostazioni tramite Position.custom()
              • navigationBarColor per consentire l'occultamento della barra di navigazione (tramite Color.TRANSPARENT)

            Versione 3.6.1 (Rilasciata il 03/11/2025)

            Corretto

            • Raggio degli angoli migliorato: ora il contenuto di WebView si adatta correttamente agli angoli arrotondati
            • Position.custom() ora applica correttamente larghezza e altezza personalizzate invece di ricorrere alla modalità a schermo intero
            • respectsSafeArea La configurazione ora funziona correttamente: la finestra di dialogo si estende sotto le barre di sistema quando è impostata su false (Android 11+)

            Versione 3.6.0 (Rilasciata il 15/10/2025)

            Aggiunto

            • Aggiorna Kotlin alla versione 2.2.20 e AGP alla versione 8.9.3
            • Aggiorna Compose BOM alla versione 2025.02.00
            • Aggiorna AndroidX e le librerie principali alle versioni più recenti
            • noHash parametro all' UrlConfig oggetto, per evitare di passare il cmpimport parametro all'URL utilizzando un hash
            • compileSdk aggiornato alla versione 36
            • Dipendenze interne aggiornate alle ultime versioni (relative alla serializzazione)

            Versione 3.5.2 (Rilasciata il 30/09/2025)

            Aggiunto

            • compileSdk aggiornato alla versione 36
            • Dipendenze interne aggiornate alle ultime versioni (relative alla serializzazione)

            Corretto

            • Chiamata errata del didCloseConsentLayer callback al riavvio dell'app

            Versione 3.5.1 (Rilasciata il 29/09/2025)

            Corretto

            • BadTokenException segnalata da alcuni clienti tramite Crashlytics
            • Chiamata duplicata del didShowConsentLayer callback

            Versione 3.5.0 (Rilasciata il 12/08/2025)

            Aggiunto

            • Oggetto JSON con opzioni di configurazione per clienti specifici.
            • L'aggiornamento a questa versione non è necessario, a meno che non sia esplicitamente indicato nelle configurazioni della tua dashboard CMP. 

            Versione 3.4.0 (Rilasciata il 09/07/2025)

            Aggiunto

            • Attiva o disattiva la modalità Consenso di Google v2 per attivare o disattivare l'attivazione automatica del setConsent per aggiornare i consensi tramite introspezione
            • Consenso automatico tramite introspezione ai seguenti SDK: AppsFlyer, AdJust, Branch, Kochava, Singular, AirBridge e Tenjin

            Versione 3.3.0 (Rilasciata il 18/06/2025)

            Aggiunto/Migliorato

            • Google Consent Mode v2 ora attiva automaticamente il setConsent per aggiornare i consensi tramite introspezione
            • Gestione del ciclo di vita di WKWebView migliorata per aumentare le prestazioni
            • Funzionalità di accessibilità che ora aumenta la dimensione dei caratteri all'interno del layer di consenso in base alle impostazioni del dispositivo per il testo ingrandito
            • Versione asincrona del forceOpen metodo

            Corretto

            • Problema con l'area sicura su API 35+
            • La modalità scura ora visualizza correttamente il design previsto
            • Parametri Javadoc su checkAndOpen metodo

            Versione 3.2.2 (Rilasciata il 17/04/2025)

            Corretto

            • Problema con il parametro jumpToSettings del metodo forceOpen. 

            Versione 3.2.1 (Rilasciata il 27/03/2025)

            Rimosso

            • Autorizzazione SYSTEM_ALERT_WINDOW

            Modificato

            • Nuovo supporto minSdk, ora a partire dal livello API 21 (Android 5). 

            Versione 3.2.0 (Rilasciata il 17/03/2025)

            Aggiunto/Migliorato

            • Modalità Consenso di Google v2
            • Javadoc per rendere più chiaro l'utilizzo

            Corretto

            • Perdita di memoria nei metodi delegati di CMPManager

            Versione 3.1.2 (Rilasciata il 26/02/2025)

            Aggiunto

            • Aggiunto serializzatore personalizzato per gestire la mappatura tra valori stringa JSON e tipi enum

            Corretto

            • Metodi aggiornati e pertinenti per utilizzare i tipi di enumerazione corretti

            Versione 3.1.1 (Rilasciata il 21/02/2025)

            Modifiche sostanziali

            • CMPManagerDelegate.didReceiveConsent ora accetta Map<String, Any> invece di JsonObject
            • Rimosso l'esposizione diretta di JsonObject dalle API pubbliche

            Aggiunto

            • Funzioni di estensione type-safe/null-safe per Map<String, Any>

            Modificato

            • Allineamento dell'API pubblica dell'SDK Android con l'implementazione iOS
            • Miglioramento della sicurezza dei tipi e dei valori nulli nei metodi delegati
            • Gestione aggiornata della serializzazione interna

            Migrazione

            Aggiorna le implementazioni di CMPManagerDelegate per utilizzare Map<String, Any>.

            Versione 3.1.0 (Rilasciata il 18/02/2025)

            Modifiche principali
            • Introdotta una nuova gestione unificata dello stato del consenso tramite getUserStatus() metodo
            • Aggiunto il supporto per l'integrazione con Google Consent Mode v2
            • Gestione avanzata di WebView e gestione del ciclo di vita
            Nuove funzionalità
            • – Aggiunto getStatusForPurpose() e getStatusForVendor() per il controllo granulare del consenso
            • Introdotto forceOpen() per la gestione diretta del layer di consenso con il jumpToSettings parametro
            • Aggiunto checkAndOpen() con gestione degli errori migliorata e supporto per i callback
            • Implementato nuovo ConsentStatus enum per una gestione più precisa dello stato del consenso
            • Aggiunta la compatibilità con Google Consent Mode v2 con getGoogleConsentModeStatus()
            • Introdotto LinkClickHandler typealias per i callback di gestione degli URL. Questo aggiunge funzionalità di gestione dei clic sui link al nostro SDK CMP, consentendo alle applicazioni di personalizzare la gestione dei link all'interno del livello di consenso.
            Deprecazioni

            Diversi metodi sono stati deprecati a favore di alternative più robuste o unificate:

            • Obsoleto checkIfConsentIsRequired() – Usa checkAndOpen() invece
            • Obsoleto hasUserChoice() – Usa getUserStatus() invece
            • Obsoleto hasPurposeConsent() – Usa getStatusForPurpose() invece
            • Obsoleto hasVendorConsent() – Usa getStatusForVendor() invece

            I seguenti metodi sono stati consolidati in getUserStatus():

            • Obsoleto getAllPurposesIDs()
            • Obsoleto getEnabledPurposesIDs()
            • Obsoleto getDisabledPurposesIDs()
            • Obsoleto getAllVendorsIDs()
            • Obsoleto getEnabledVendorsIDs()
            • Obsoleto getDisabledVendorsIDs()

            Metodi UI

            • Obsoleto openConsentLayer() – Usa forceOpen() invece
            • Obsoleto checkWithServerAndOpenIfNecessary() – Usa checkAndOpen() invece
            Guida alla migrazione

            Per migrare alla nuova API:

            1. Sostituisci i singoli metodi di verifica del consenso con getUserStatus()
            2. Aggiorna le chiamate relative all'interfaccia utente per utilizzare forceOpen() e checkAndOpen()
            3. Rifattorizza i controlli di scopo e fornitore per utilizzare getStatusForPurpose() e getStatusForVendor()

            Tutti i metodi deprecati saranno rimossi nel prossimo aggiornamento della versione.

            Riscritto

            Protezione rafforzata contro la chiusura della webview.

            Versione 3.0.1 (Rilasciata il 04/12/2024)

            Corretto

            Problema con la codifica/decodifica JSON per alcuni CMP specifici.

            Versione 3.0.0 (Rilasciata il 16/10/2024)

            Completamente riscritta da zero, questa versione offre tutti i vantaggi, le funzionalità e le correzioni raccolti insieme ai nostri clienti negli ultimi anni. È più leggera, più veloce e più sicura. 

            Registro delle modifiche React Native SDK v3

            Versione 3.8.0 (Rilasciata il 22/12/2025)

            Aggiunto

            Aggiornamento delle dipendenze dagli SDK nativi iOS e Android sottostanti alle versioni più recenti (Android: 3.8.0 e iOS 3.8.0).

            Versione 3.6.6 (Rilasciata il 15/12/2025)

            Migliorata

            Incoerenza nella digitazione del setATTStatus metodo sul bridge Objective-C e Swift.  

            Versione 3.6.5 (Rilasciata il 09/12/2025)

            Corretto

            Incoerenza nella digitazione del setATTStatus metodo sul bridge Objective-C e Swift.  

            Versione 3.6.4 (Rilasciata il 04/12/2025)

            Aggiunta di nuove dipendenze alla parte specifica per Android: 

            org.jetbrains.kotlinx:kotlinx-coroutines-core:1.10.2 
            org.jetbrains.kotlinx:kotlinx-coroutines-android:1.10.2
            androidx.lifecycle:lifecycle-runtime-ktx:2.6.1
            androidx.lifecycle:lifecycle-common-java8:2.6.1

            Versione 3.6.3 (Rilasciata il 03/12/2025)

            Aggiornamento delle dipendenze dagli SDK nativi iOS e Android sottostanti alla versione 3.7.1.

            Versione 3.6.2 (Rilasciata il 26/11/2025)

            Corretto

            Aggiungi enumerazioni/helper tipizzati per gli stili di sfondo, gli effetti di sfocatura, le posizioni della webview, lo stato ATT e le convalide/avvisi; normalizza la configurazione della webview e la gestione dei colori.
            Inoltra il parametro noHash, allinea le impostazioni predefinite e aggiungi avvisi di piattaforma per background/customRect non supportati su Android.
            Aggiornare gli esempi per utilizzare i nuovi enum/helper e l'enum ATT per una guida più chiara.

            Versione 3.6.1 (Rilasciata il 30/10/2025)

            Corretto

            Nuova architettura nell'implementazione specifica per iOS.

            Versione 3.6.0 (Rilasciata il 20/10/2025)

            Aggiunto

            Aggiornamento delle dipendenze dagli SDK nativi iOS e Android sottostanti alle versioni più recenti (Android: 3.6.0 e iOS 3.6.0).

            Adattare il codice per tenere conto delle modifiche negli SDK nativi sottostanti v3.6.0

            Versione 3.5.3 (Rilasciata il 29/09/2025)

            Aggiunto

            Aggiornamento delle dipendenze dagli SDK nativi iOS e Android sottostanti alle versioni più recenti (Android: 3.5.1 e iOS 3.5.2).

            Versione 3.5.2 (Rilasciata il 27/08/2025)

            Aggiunto

            Callback che consente agli utenti di intercettare i clic sui link all'interno della webview (controlla le API native di iOS e Android). 

            Versione 3.5.1 (Rilasciata il 18/08/2025)

            Corretto

            La proprietà isCancellable dell'SDK Android nativo è ora correttamente mappata, impedendo che il livello di consenso venga chiuso dal pulsante Indietro

            Versione 3.5.0 (Rilasciata il 13/08/2025)

            Corretto

            Problema con i callback che non vengono attivati correttamente

            Oggetto JSON di consenso standardizzato

            Aggiunto

            Aggiornamento delle dipendenze dagli SDK nativi iOS e Android sottostanti alla versione 3.5.0.

            Versione 3.4.0 (Rilasciata il 18/07/2025)

            Aggiornamento delle dipendenze dagli SDK nativi iOS e Android sottostanti alla versione 3.4.0.

            Versione 3.3.0 (Rilasciata il 18/06/2025)

            Aggiornamento delle dipendenze dagli SDK nativi iOS e Android sottostanti alla versione 3.3.0.

            Versione 3.2.4 (pubblicata il 17/04/2025)

            Aggiornamento delle dipendenze alla versione nativa di Android 3.2.2.

            Versione 3.2.3 (pubblicata il 15/04/2025)

            Rimosse le funzionalità relative all'Apple Transparency Tracking (ATT). Per ulteriori informazioni sull'ATT, clicca qui

            Versione 3.2.2 (rilasciata il 10/04/2025)

            Correzione delle dipendenze interne mancanti per iOS 3.2.0.

            Versione 3.2.1 (rilasciata il 27/03/2025)

            Aggiornamento delle dipendenze interne alla versione 3.2.1 di Android Native

            Versione 3.2.0 (rilasciata il 17/03/2025)

            Aggiornamento della versione per adattarsi alle modifiche sopra menzionate sugli SDK nativi di Android e iOS. 

            Versione 3.0.0 (Rilasciata il 16/10/2024)

            Completamente riscritta da zero, questa versione offre tutti i vantaggi, le funzionalità e le correzioni raccolti con i nostri clienti negli ultimi anni. È più leggera, più veloce e più sicura. 

            Registro delle modifiche Flutter SDK v3

            Versione 3.8.0 (Rilasciata il 22/12/2025)

            Aggiunto

            Aggiornamento delle dipendenze dagli SDK nativi iOS e Android sottostanti alle versioni più recenti (Android: 3.8.0 e iOS 3.8.0).

            Versione 3.6.1 (Rilasciata il 27/10/2025)

            Corretto

            Condizione identificata nell' setUrlConfig() implementazione del metodo che si attivava checkAndOpen() automaticamente.

            Versione 3.6.0 (Rilasciata il 20/10/2025)

            Aggiunto

            Aggiornamento delle dipendenze dagli SDK nativi iOS e Android sottostanti alle versioni più recenti (Android: 3.6.0 e iOS 3.6.0).

            Adattare il codice per tenere conto delle modifiche negli SDK nativi sottostanti v3.6.0

            Versione 3.5.1 (rilasciata il 30/09/2025)

            Aggiunto
            • Aggiornamento delle dipendenze interne delle versioni native sottostanti dell'SDK Android alla versione 3.5.2

            Versione 3.5.0 (rilasciata il 29/09/2025)

            Aggiunto
            • Aggiornamento delle dipendenze interne delle versioni native sottostanti dell'SDK Android alla versione 3.5.1 e di iOS alla versione 3.5.2

            Versione 3.4.1 (rilasciata il 18/08/2025)

            Corretto
            • La proprietà isCancellable dell'SDK Android nativo è ora correttamente mappata, impedendo che il livello di consenso venga chiuso dal pulsante Indietro

            Versione 3.4.0 (rilasciata il 14/07/2025)

            Aggiunto
            • Aggiornamento delle dipendenze interne delle versioni native sottostanti di Android e iOS alla versione 3.4.0

            Versione 3.3.0 (Rilasciata il 18/06/2025)

            Aggiunto/Migliorato

            • Dipendenze aggiornate per tenere conto del rilascio della v.3.3.0 degli SDK CMP nativi sottostanti per iOS e Android
            • Supporto alla modalità scura 
            • Compilato utilizzando Flutter 3.32.0
            • Gestore dei clic sui link con bridge

              Corretto

              • Perdita di memoria e incongruenze tra le chiamate di metodo specifiche della piattaforma.

              Versione 3.2.3 (pubblicata il 10/06/2025)

              Corretto
              • Problema di posizionamento del layer di consenso su iOS, i posizionamenti a metà schermo non funzionano come previsto

              Versione 3.2.2 (rilasciata il 22/05/2025)

              Corretto
              • Falso messaggio di errore che veniva registrato nei metodi forceOpen e checkAndOpen, nonostante l'operazione fosse andata a buon fine

              Versione 3.2.1 (rilasciata il 27/03/2025)

              Aggiornamento delle dipendenze interne alla versione 3.2.1 di Android Native

              Versione 3.2.0 (rilasciata il 17/03/2025)

              Aggiornamento della versione per adattarsi alle modifiche sopra menzionate sugli SDK nativi di Android e iOS. 

              Versione 3.0.0 (Rilasciata il 16/10/2024)

              Completamente riscritta da zero, questa versione offre tutti i vantaggi, le funzionalità e le correzioni raccolti con i nostri clienti negli ultimi anni. È più leggera, più veloce e più sicura. 

              Registro delle modifiche Unity SDK v3

              Versione 3.6.0 (rilasciata il 23/10/2025)

              Aggiornamento della versione per adattarsi alle modifiche sopra menzionate sugli SDK nativi sottostanti di Android e iOS. 

              Versione 3.2.0 (rilasciata il 19/03/2025)

              Aggiornamento della versione per adattarsi alle modifiche sopra menzionate sugli SDK nativi sottostanti di Android e iOS. 

              Versione 3.0.0 (Rilasciata il 16/10/2024)

              Non utilizzare questa versione, è stata deprecata e non avrà più supporto; utilizza invece la 3.2.0.

              Completamente riscritta da zero, questa versione offre tutti i vantaggi, le funzionalità e le correzioni raccolti con i nostri clienti negli ultimi anni. È più leggera, più veloce e più sicura. 

               

              We do our best to keep this purely informative documentation up to date. However, if you notice that any of these guides need a little touch-up, let us know!