Миграция Adapty Capacitor SDK на v4.3
Adapty Capacitor SDK 4.3 по умолчанию показывает встроенные сообщения Google Play, удаляет неиспользуемый параметр из getOnboardingForDefaultAudience, расширяет тип кодов ошибок и требует наличия продвигаемого продукта в событии. Изучите каждое изменение в этом гайде, чтобы поведение вашего приложения оставалось прежним, а TypeScript-сборка проходила без ошибок.
Если вы всё ещё используете версию 3.x, сначала пройдите Миграцию на v4.1.1, а затем следуйте этому гайду.
Краткий справочник
| v4.2 | v4.3 |
|---|---|
params: undefined или fetchPolicy: undefined вызывает ошибку | Применяются значения по умолчанию |
| Сообщения Google Play не запрашиваются | Сообщения Google Play отображаются по умолчанию на Android |
getOnboardingForDefaultAudience принимает params.loadTimeoutMs и игнорирует его | params.loadTimeoutMs удалён из типа |
error.adaptyCode типизирован как известный код | Тип также допускает коды, которые ваша версия SDK не знает |
На iOS makePromotedPurchase принимает продукт, созданный вами вручную | Требуется продукт из события 'onPromotedPurchaseReceived' |
accessLevel.android.offerId | устарело — используйте верхнеуровневый offerId |
Параметры, переданные как undefined, принимают значения по умолчанию
В версии 4.2 передача params: undefined в getFlow, getOnboarding или их варианты с аудиторией по умолчанию вызывала TypeError, а fetchPolicy: undefined приводила к ошибке на нативной стороне. Начиная с версии 4.3, параметр, переданный как undefined, сохраняет своё значение по умолчанию: fetchPolicy возвращается к 'reload_revalidating_cache_data', а loadTimeoutMs — к 5000 мс. Если раньше вы обходили эту ошибку, просто не указывая такие ключи, теперь можно передавать необязательные значения из конфигурации как есть.
Сообщения Google Play отображаются по умолчанию
Начиная с версии 4.3, SDK запрашивает встроенные сообщения Google Play — например, уведомления об отклонённом платеже — каждый раз, когда Activity вашего приложения запускается после activate, в том числе при возврате приложения на передний план. Такое сообщение может появиться поверх пейвола.
Если это подходит для вашего приложения, никаких изменений не требуется. В режиме 'auto' сообщения не появляются при холодном запуске — подробнее см. Показ сообщений при запуске на Android. Чтобы сохранить поведение версии 4.2, используйте ручную обработку на Android и не вызывайте showStoreMessages. Чтобы самостоятельно контролировать момент появления сообщений, инициализируйте SDK с ручной обработкой на Android и вызовите showStoreMessages в подходящий для вашего приложения момент:
await adapty.activate({
apiKey: 'YOUR_PUBLIC_SDK_KEY',
params: {
storeMessagesHandling: Capacitor.getPlatform() === 'android' ? 'manual' : 'auto',
},
});
Установите ручную обработку только на Android, чтобы не менять поведение на iOS: на iOS 16 и выше ручная обработка также удерживает сообщения App Store до тех пор, пока ваше приложение не вызовет showStoreMessages. Полное описание API см. в разделе Управление сообщениями стора.
В ручном режиме сторы не показывают сообщения самостоятельно. Если ваше приложение никогда не вызывает showStoreMessages, пользователи никогда не увидят уведомление об отклонённом платеже.
loadTimeoutMs удалён из getOnboardingForDefaultAudience
getOnboardingForDefaultAudience никогда не использовал params.loadTimeoutMs: запрос для аудитории по умолчанию не имеет таймаута. Начиная с версии 4.3, параметр также исключён из типа, поэтому передача его в объектном литерале приводит к ошибке сборки TypeScript. Удалите его в любом случае: SDK игнорирует его.
const onboarding = await adapty.getOnboardingForDefaultAudience({
placementId: 'YOUR_PLACEMENT_ID',
params: {
fetchPolicy: 'reload_revalidating_cache_data',
- loadTimeoutMs: 5000,
},
});
getOnboarding сохраняет loadTimeoutMs.
Типы кодов ошибок допускают неизвестные коды
Нативные SDK могут возвращать коды ошибок, более новые, чем ваш Capacitor SDK. Начиная с версии 4.3, тип ErrorCode также допускает такие коды, поэтому обращение вида ErrorCode[error.adaptyCode] или исчерпывающий switch по error.adaptyCode может перестать компилироваться. Используйте вместо этого error.codeName, getErrorCodeName() или isKnownErrorCode(). Сравнение вида error.adaptyCode === ErrorCodeName.paymentCancelled или switch с ветвью default изменений не требует.
4.3 также даёт имена кодам, которые в предыдущих версиях отображались как неизвестные, поэтому getErrorPrompt(1050) теперь возвращает 'paymentPendingError' вместо 'Unknown code: 1050'. Подробнее о вспомогательных методах для работы с ошибками — в разделе Обработка ошибок.
Передавайте продвигаемый продукт как есть
На iOS функция makePromotedPurchase теперь требует намерение о покупке из App Store, которое несёт продукт из события 'onPromotedPurchaseReceived'. Продукт, созданный вручную или полученный через getPaywallProducts, работал в версии 4.2, но не работает в 4.3. Передавайте продукт именно из события:
await adapty.addListener('onPromotedPurchaseReceived', async ({ product }) => {
const result = await adapty.makePromotedPurchase({ product });
});
См. Встроенные покупки, продвигаемые в сторе.
android.offerId устарел
Уровни доступа и подписки теперь имеют поле offerId на верхнем уровне: это офер Google Play, по которому была оформлена подписка. В уровнях доступа android.offerId по-прежнему работает, но считается устаревшим. Используйте offerId верхнего уровня: его значение зависит от стора, в котором была совершена покупка, а не от операционной системы устройства.
Новое в 4.3
Эти дополнения подключаются по желанию. Существующий код продолжает работать без них:
- Управление сообщениями стора: Выберите, когда появляются сообщения App Store и Google Play.
- Предзагрузка плейсментов:
preloadFlowsиpreloadFlowsForDefaultAudienceпрогревают кэш флоу. - Сохранение закрытого флоу:
view.dismiss({ destroy: false })сохраняет флоу для повторного показа, аview.destroy()освобождает его. - Планы с обязательством на 12 месяцев: Свойство
product.subscription?.ios?.pricingTermsописывает план на iOS, а уровни доступа возвращаютbillingPlanиcommitmentInfo. - Режим наблюдателя:
reportTransactionпринимает необязательный параметрios.jwsTransaction. - Новые коды ошибок для функций 4.3:
billingPlanUnavailable(1060),operationInProgress(3201) иresolverFailure(3202) — только для iOS. См. Обработка ошибок. - Уровень логирования debug:
'debug'записывает низкоуровневые внутренние детали работы нативного SDK. См. Логирование.