Миграция Adapty Unity SDK на v4.3
Adapty Unity SDK 4.3 требует Unity 6, удаляет Adapty.GetLogLevel, по умолчанию показывает встроенные сообщения Google Play и изменяет тип C# для некоторых данных событий флоу на Android. Изучите каждое изменение в этом гайде, чтобы сохранить прежнее поведение приложения.
Если вы используете версию 3.x, начните с Перехода на v4.1, а затем следуйте этому руководству.
Краткий справочник
| v4.1 | v4.3 |
|---|---|
| Unity 2022.3 или выше | Unity 6.0 (6000.0) или выше |
Adapty.GetLogLevel(...) | удалено — отслеживайте уровень, который вы задали через builder.LogLevel или Adapty.SetLogLevel |
| Сообщения Google Play не запрашиваются | Сообщения Google Play отображаются по умолчанию на Android, включая поверх флоу |
Целочисленные параметры событий флоу приходят как double на Android | Они приходят как long на обеих платформах |
Установка
Adapty Unity SDK 4.3 требует Unity 6.0 (6000.0) или новее. Если ваш проект работает на Unity 2022.3, сначала обновите проект или оставайтесь на Adapty SDK 4.1.x.
Adapty SDK 4.1.x не работает с GameActivity — точкой входа Android по умолчанию для новых проектов Unity 6: обработчики завершения и события никогда не доходят до C#. Если вы обновляете Unity раньше, чем SDK, держите Application Entry Point в значении Activity до перехода на Adapty SDK 4.3. SDK 4.3 работает с обеими точками входа.
Чтобы установить SDK 4.3 через Unity Package Manager, используйте этот Git URL:
https://github.com/adaptyteam/AdaptySDK-Unity.git?path=/Packages/com.adapty.unity-sdk#4.3.0-beta.1
Если вы устанавливаете через Unity package, скачайте adapty-unity-plugin-4.3.0-beta.1.unitypackage из релиза 4.3.0-beta.1. Перед импортом удалите папку Assets/AdaptySDK/Plugins/Android/Local. SDK 4.3 больше не включает внутренний Android Java wrapper, который хранится в этой папке, а при импорте .unitypackage старые файлы не удаляются — без этого шага старый wrapper останется в проекте.
Остальные требования не изменились по сравнению с 4.1: iOS 15.0 и Xcode 26. Подробности об установке см. в разделе Установка SDK.
GetLogLevel удалён
Adapty.GetLogLevel больше недоступен. Уровень логирования — это тот, который вы задали через builder.LogLevel при активации SDK, или позже через Adapty.SetLogLevel. Если ваш код считывает уровень обратно, просто сохраните значение, которое вы установили:
- Adapty.GetLogLevel((level, error) => {
- // use level
- });
+ var logLevel = AdaptyLogLevel.Verbose;
+ builder.LogLevel = logLevel;
+ // use logLevel
Сообщения Google Play отображаются по умолчанию
Начиная с версии 4.3, SDK запрашивает встроенные сообщения Google Play — например, уведомления об отклонённых платежах — каждый раз, когда Activity вашего приложения запускается после активации. Это происходит в том числе при возврате приложения на передний план, а также при открытии или закрытии флоу или онбординга, поэтому сообщение может появиться поверх пейвола.
Если это подходит для вашего приложения, никаких изменений не требуется. Чтобы управлять моментом отображения сообщений, активируйте SDK с ручной обработкой на Android и вызывайте Adapty.ShowStoreMessages в подходящий для вашего приложения момент:
var builder = new AdaptyConfiguration.Builder("YOUR_PUBLIC_SDK_KEY");
#if UNITY_ANDROID
builder.SetStoreMessagesHandling(AdaptyStoreMessagesHandling.Manual);
#endif
Adapty.Activate(builder.Build(), (error) => {
// handle the error
});
Установите ручную обработку только для Android, чтобы не затронуть iOS: на iOS 16 и выше ручная обработка также удерживает сообщения App Store до тех пор, пока ваше приложение не вызовет Adapty.ShowStoreMessages. Подробное описание API см. в разделе Управление сообщениями стора.
В ручном режиме сторы не показывают сообщения самостоятельно. Если ваше приложение никогда не вызывает Adapty.ShowStoreMessages, пользователи никогда не увидят уведомление об отклонённом платеже.
Числовые параметры событий флоу имеют тип long на Android
На Android целочисленные параметры FlowViewDidReceiveAnalyticEvent раньше приходили как double. Начиная с версии 4.3, они приходят как long, как и на iOS. Это касается значений даты и времени в событиях flow input.
Приведение к double теперь вызывает исключение на Android. Вместо приведения типов используйте преобразование числовых параметров:
- var timestamp = (double)parameters["value"];
+ var timestamp = Convert.ToInt64(parameters["value"]);
Новое в 4.3
Эти дополнения подключаются по желанию. Существующий код продолжает работать без них:
- Управление сообщениями стора: Выбирайте, когда показывать сообщения App Store и Google Play.
- Предзагрузка плейсментов:
Adapty.PreloadFlowsиAdapty.PreloadFlowsForDefaultAudienceпрогревают кеш флоу. - Сохранение представления флоу:
view.Dismiss(false, ...)сохраняет представление для повторного показа, аview.Destroy(...)освобождает его. - Планы с обязательством на 12 месяцев: Свойство
AdaptySubscription.PricingTermsописывает план на iOS, а уровни доступа и подписки возвращаютBillingPlanиCommitmentInfo. - Новый код ошибки:
AdaptyErrorCode.BillingPlanUnavailable(1060, только iOS).MakePurchaseвозвращает его, когда продукт не предлагает запрошенный тарифный план на данном устройстве или в сторфронте. Если ваш код перебирает все значенияAdaptyErrorCode, добавьте обработку нового. - Режим наблюдателя:
Adapty.ReportTransactionпринимает опциональныйappleJWSTransactionна iOS. - Название варианта:
AdaptyFlow.VariationNameвозвращает название варианта, заданное в дашборде Adapty.