Upgrade Guides#
Migration notes covering cross-cutting changes (DPoP nonce auto-management, the HaapiLogger setLogType migration) and per-framework major-version upgrades. Read the relevant guide before bumping a HAAPI SDK to a new major version.
Cross-cutting vs per-framework. Cross-cutting upgrades apply on all platforms and layers at the same time; per-framework upgrades describe the breaking changes within a single framework’s major-version bump. The relevant guide is usually called out in the framework’s release notes.
Cross-Cutting Migrations#
Changes that affect Driver / SDK / UI layers across iOS and Android simultaneously.
| Page | Topic |
|---|---|
| Upgrade — DPoP Nonce Auto-Management | The SDK now manages dpop-nonce automatically; what to remove from your code |
| Upgrade — HaapiLogger setLogType Migration | Deprecated isXxxEnabled flags replaced by setLogType / setLevel with severity ordering |
Upgrade — Link handling by rel and type | Classify a link before acting on it, and followLink refuses an off-host target |
Per-Framework Major Versions#
Breaking changes scoped to a single framework’s major-version transition.
| Page | Framework |
|---|---|
| Upgrade — iOS UIKit v5 | IdsvrHaapiUIKit 5.x — breaking API changes from 4.x |
| Upgrade — Android UIWidget v5 | IdsvrHaapiUIWidget 5.x — breaking API changes from 4.x |
| Upgrade — React Native vN | identityserver.haapi.reactnative.sdk major-version upgrade placeholder, populated on each major release |
Platform Requirement Changes#
A raised minimum OS or toolchain version for one platform’s frameworks. These are breaking for anyone below the new floor even when they arrive in a minor release, because a project that cannot meet the requirement cannot link the release at all.
| Page | Platform |
|---|---|
| Upgrade — iOS minimum version 15.0 | iOS 5.7.0 — iOS 15.0 and Xcode 27 required; the Haapi device-support probe removed |