Repository navigation
[Android] 4.0.0 #1017
markmur
announced in
Announcements
[Android] 4.0.0
#1017
Replies: 0 comments
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Uh oh!
There was an error while loading. Please reload this page.
🎉 Checkout Kit 4.0.0 for Android is here!
This is a major milestone: the first stable release of Checkout Kit for Android, the successor to Checkout Sheet Kit. Bring Shopify checkout into your app with your store's branding, Checkout UI extensions, Shopify Functions, and supported payment methods intact.
Built on the Embedded Checkout Protocol, 4.0.0 brings typed checkout events, a native bottom sheet or app-owned embedded presentation, observable preloading, and deeper control over appearance and navigation. Whether your app uses Views or Jetpack Compose, you can make checkout feel at home.
Thank you to everyone who tried the SDK, reported issues, and helped shape this release. We're excited to see what you build! 🚀
Explore the Checkout Kit documentation and the Android integration guide.
Install with Gradle:
implementation("com.shopify:checkout-kit:4.0.0")If you're using Checkout Sheet Kit, replace the
com.shopify:checkout-sheet-kitdependency. Requires JDK 17+, minSdk 23+, compileSdk 35+, and a WebView withWebMessageListenersupport (Android System WebView or Chrome 83+).Breaking changes
Move lifecycle calls to
ShopifyCheckout. Public checkout APIs now live incom.shopify.checkoutkit.checkout; update your Kotlin and Java imports. The old lifecycle entry points have been removed.ShopifyCheckout.create(checkoutUrl, context) { ... }. Read shared configuration withShopifyCheckout.getConfiguration().copy()calls with builders or Kotlin configuration blocks—for example,Preloading { enabled = false }. Protocol models use builders or configuration blocks too, and protocol string values are extensible; handle unknown values inwhenexpressions. The SDK uses stable Embedded Checkout Protocol 2026.08.25.1, retaining wire version 2026-08-25. Recompile consumers when upgrading.customize { ... }orcopy(...). RenamewebViewBackground→webViewBackgroundColor,headerBackground→headerBackgroundColor,headerFont→headerTitleColor,progressIndicator→progressIndicatorColor, andcloseIconTint→closeIconTintColor. Update corresponding Java accessors, builder methods, andCheckoutSheetOptions.closeIconTintColor. SerializedColorskeys also change: reserialize stored color schemes after upgrading.PreloadState.IdlewithPreloadState.Idle()andPreloadState.ExpiredwithPreloadState.Idle(PreloadState.IdleReason.Expired). Match withis PreloadState.Idleand inspect its reason. Java callers usenew PreloadState.Idle()instead ofIdle.INSTANCE.CheckoutLinkAction.OpenwithCheckoutLinkAction.Default. SDK resources now use thecheckout_prefix; update resource overrides and UI selectors, including the close button IDcheckout_close_button.Additive changes
ShopifyCheckoutin your own container. Compose apps can host it withAndroidViewwithout adding a Compose dependency to the SDK. Calldestroy()when removing an embedded checkout; useAndroidView.onReleasein Compose.Behaviour changes
onFailruns beforeonDismiss. CallingCheckoutHandle.dismiss()does not invokeonDismiss.configureapplies changes atomically from a copy. If the block throws, the configuration is unchanged; retaining the configuration object cannot mutate applied settings afterward.uiModeinandroid:configChanges.shop.comorigins, including subdomains, are trusted alongsideshop.appwhen an origin allowlist is configured.What's Changed
Full Android changelog: 4.0.0 release details
This discussion was created from the release [Android] 4.0.0.
All reactions