Releases

What changed in Lime Ad SDK. One version covers all platforms; platform-specific changes carry a label.

How to read a version number

Versions follow SemVer: major.minor.patch.

Part	Example	Meaning	Integration changes needed
Major	4.0.0	Breaking changes	Yes — see “Before you upgrade”
Minor	3.1.0	New features	No
Patch	3.0.1	Bug fixes	No

Platform

v3.0.0September 23, 2026

LatestFirst release

• 5 breaking
• 6 added
• 15 fixed

The first release with a single version for all platforms and public documentation. Earlier builds had separate numbers for Android, iOS and the browser. Starting with 3.0.0 there is one version.

! Before you upgrade

These changes need updates to your integration.

• AllThe version number is now shared by Android, Android TV, iOS and the browser. Use version 3.0.0 in the SDK address instead of the platform-specific numbers.
• All{{SDK_VERSION}} in the VAST URL now resolves to 3.0.0 (was 2.5.0).
• iOSAn error before the ad loads arrives in the same shape as every other event: { name: "AdError", code, message, type, … } instead of a data field.
• WebThe playback-blocked error code is now permission_denied (was premission denied).
• Allautoplay=false and autoplay=0 no longer turn autoplay on.

Added 6

• AllSDK address on the CDN: platform and version in the path — https://cdn.adsdk.ru/android/v3/. The v3 channel gets every 3.x fix, v3.0.0 never changes, latest is for debugging. The os parameter still works for addresses without a platform in the path.
• AllRedesigned ad UI on Android, Android TV and iOS: new button layout and a scrim behind the buttons for readability.
• Android TVThe ad-notice control: a caption about ads in the corner of the screen.
• AllThe all value in controls enables every control available on the platform.
• AllThe SDK waits until the page has a size before loading an ad. If the page still has no size after 3 seconds, AdError arrives with code viewport_unavailable.
• Allos=web in a WebView now fails right away with AdError code web_ui_in_native_build.

Fixed 15

• AndroidAn error before the ad loads reaches AdError once instead of twice. The SDK picks the signature the app declared: 6, 4 or 3 arguments.
• AndroidAdPodCompleted receives ad_is_last instead of undefined.
• AllAdPodCompleted reports the real pod length instead of 0, and the number of shown creatives ad_pod_showed_count on every platform.
• AllAdSkippableStateChanged passes status: true instead of an event object. On Android the AdSkippableStateChanged(Boolean) method is now actually called.
• WebStyles load from the stable style.css address.
• WebAdsEnded fires once instead of twice.
• AllgetAdCurrentTimeSec() returns seconds instead of milliseconds. When the app's player plays the video, it returns the time from timeupdateAd(), so the skip button countdown runs correctly.
• AllgetAdSkippableState() returns true after AdSkippableStateChanged, including when the app's player plays the video.
• AllEvery creative of an ad pod becomes skippable: AdSkippableStateChanged used to fire for the first one only.
• AllWith autoplay in a WebView the ad becomes skippable at skipoffset, not right after it starts.
• AllWhen the platform cannot be detected, android is used instead of an empty UI.
• AllInvalid ad_media_file_width and ad_media_max_duration_sec values are ignored instead of breaking media file selection.
• AllAdLoaded, quartiles and AdComplete fire exactly once per creative, VPAID included.
• WebAdComplete tracking.
• WebUnhandled promise rejection when starting playback.