Migrer le SDK Adapty React Native vers la v4.1

Le SDK Adapty React Native 4.1 modifie la façon dont Adapty Attribution est activé, renomme les API d’attribution externe et change le format du fichier de secours. Il permet également à votre application de prendre en charge les achats intégrés promus sur l’App Store et rétablit le flag hasViewConfiguration sur AdaptyFlow.

Si vous êtes encore sur la version 3.x, commencez par Migrer vers la v4.0 puis suivez ce guide.

Référence rapide

Installation

Mettez à jour le package react-native-adapty :

npm install react-native-adapty@latest
# or
yarn add react-native-adapty@latest

Les prérequis d’exécution sont inchangés par rapport à la version 4.0 : iOS 15.0 et React Native 0.75. Consultez Installer le SDK Adapty pour la configuration complète.

La version 4.1 prend également en charge l’intégration SPM de React Native, qui remplace CocoaPods pour votre projet iOS et nécessite React Native 0.87 ou une version ultérieure. Elle couvre uniquement les projets React Native purs, CocoaPods reste le gestionnaire par défaut, et la migration est optionnelle — voir Configurer votre projet iOS. Si votre application utilise le Mode Enfants, chaque gestionnaire de paquets l’applique différemment.

⚠️ L’attribution Adapty est désactivée par défaut

Dans les versions 4.0 et antérieures, le SDK enregistrait les installations pour Adapty Attribution automatiquement. À partir de la version 4.1, cette fonctionnalité est désactivée par défaut : le SDK n’enregistre plus les installations, les événements 'onInstallationDetailsSuccess' et 'onInstallationDetailsFail' ne se déclenchent jamais, et getCurrentInstallationStatus retourne le statut not_available.

Si vous utilisez Adapty Attribution, activez-le lors de l’activation du SDK :

  adapty.activate('YOUR_PUBLIC_SDK_KEY', {
+   adaptyAttributionEnabled: true,
  });

Si vous n’utilisez pas Adapty Attribution, aucune modification n’est nécessaire.

APIs d’attribution externe renommées

Les APIs qui transmettent les données d’attribution depuis un fournisseur externe (Adjust, AppsFlyer, Branch, Tenjin ou un fournisseur personnalisé) ont été renommées pour correspondre aux SDK natifs.

updateAttribution → updateExternalAttribution

La méthode est renommée et son deuxième paramètre est renommé de source en provider. Les données d’attribution restent un objet simple :

- await adapty.updateAttribution(attribution, 'adjust');
+ await adapty.updateExternalAttribution(attribution, 'adjust');

AttributionSource → AdaptyExternalAttributionProvider

Le type de fournisseur est renommé. Il reste une union ouverte — les valeurs prédéfinies sont 'apple_search_ads', 'adjust', 'appsflyer', 'branch', 'tenjin', et un nouveau 'custom' pour les fournisseurs qu’Adapty n’intègre pas directement. Toute autre chaîne est également acceptée, ce qui permet qu’un fournisseur ajouté ultérieurement par Adapty fonctionne sans mise à jour du SDK :

- import type { AttributionSource } from 'react-native-adapty';
+ import type { AdaptyExternalAttributionProvider } from 'react-native-adapty';

AdaptyProfile.appliedAttributionSources → appliedExternalAttributionProviders

La propriété du profil qui liste les fournisseurs d’attribution appliqués au profil est renommée, et le type de ses éléments change en conséquence :

- if (profile.appliedAttributionSources?.includes('apple_search_ads')) {
+ if (profile.appliedExternalAttributionProviders?.includes('apple_search_ads')) {
      // Apple Ads attribution has been applied
  }

Le code qui y fait référence doit être mis à jour — voir Afficher un paywall ciblé Apple Ads.

Fichiers de secours

Le format du fichier de secours a changé avec le SDK 4.1. Téléchargez à nouveau le fichier depuis Placements > Fallbacks et intégrez-le dans votre application, même si vous en aviez déjà téléchargé un pour la version 4.0.

hasViewConfiguration est restauré dans AdaptyFlow

La version 4.0 avait supprimé hasViewConfiguration lors du renommage d’AdaptyPaywall en AdaptyFlow. La version 4.1 le restaure sur AdaptyFlow, ce qui permet à une branche hasViewConfiguration de l’époque v3 de fonctionner à nouveau, à condition de renommer la fonction et l’objet qu’elle lit :

- if (paywall.hasViewConfiguration) {
-   const view = await createPaywallView(paywall);
+ if (flow.hasViewConfiguration) {
+   const view = await createFlowView(flow);
    await view.present();
  }

Sur la version 4.0, en l’absence du flag, createFlowView lève une AdaptyError pour un flow sans configuration de vue. Ce comportement reste valable en version 4.1 — le flag est une alternative à la gestion d’exception, pas un remplacement. Voir Récupérer la configuration de la vue.

Achats intégrés promus sur l’App Store

Avec la version 4.0, un achat intégré promu sur votre page produit App Store s’effectuait de manière autonome et Adapty enregistrait la transaction comme n’importe quelle autre, mais votre application n’avait aucun moyen de l’intercepter. La version 4.1 ajoute ce point d’accroche — il s’agit donc d’une nouvelle fonctionnalité plutôt que d’une étape de migration : sans code de votre part, le SDK continue de finaliser les achats promus à votre place.

Écrivez du code uniquement pour prendre en charge la finalisation vous-même — par exemple pour afficher un écran en premier. Enregistrez un écouteur pour le nouvel événement 'onPromotedPurchaseReceived', et finalisez l’achat avec adapty.makePromotedPurchase. Tant que cet écouteur est enregistré, le SDK cesse de finaliser les achats promus à votre place.