Camera Kit Changelog
Long Term Support Versions
Long Term Support (LTS) SDK versions are a commitment from Camera Kit to provide fixes for 1 year after initial release, including critical bug fixes and security patches. More information on LTS versions can be found here.
Changelogs
- Camera Kit Mobile
- Camera Kit Web
Version 1.37.0
December 18, 2024:
- Lens Studio 5.4 support
- Support for Lens HTTP requests
Version 1.36.1
November 22, 2024:
- iOS: Fix Lens Studio 5.3 support
Version 1.34.0
September 18, 2024:
- Lens Studio 5.1 support
- iOS: Fix an issue with Custom Location Markers
- iOS: Fix an issue caused by the
NS_OPTIONS
not being supported in Objc++
Version 1.30.1
June 26, 2024:
- Supported through: April 23, 2025
- Max Compatible Lens Studio Version: Lens Studio 5.0.10
- Release notes can be found here
All Versions
Known Issues
- Custom Location does not work on iOS versions 1.37.0 and later. We are working on a fix.
Version 1.39.0
March 6 2025:
- Lens Studio 5.7 support
- iOS: Ability to select an image or video from the device's gallery and use it as a source for Lens processing
- iOS: Fix for UIImage and AVAsset orientation handling
- iOS: Improvements for Lens assets caching logic
- iOS: Performance and stability improvements
Version 1.38.0
February 6, 2025:
- Lens Studio 5.6 support
- Android: Added Jetpack compose basic sample app
Version 1.37.0
December 18, 2024:
- Lens Studio 5.4 support
- Support for Lens HTTP requests
Version 1.36.x (LTS Version)
Version 1.36.1 (LTS Version)
November 22, 2024:
- iOS: Fix Lens Studio 5.3 support
Version 1.36.0 (LTS Version)
November 14, 2024:
Lens Studio 5.3 support
- Android: Updated basic sample application to apply single specified Lens
- Android: Optimized Camera Kit Session initialization for better performance
- Android: Launched a dedicated Android repository: https://github.com/Snapchat/camera-kit-android-sdk
- iOS: Launched a dedicated iOS repository: https://github.com/Snapchat/camera-kit-ios-sdk, now supporting Swift Package Manager
Version 1.35.0
October 16, 2024:
Lens Studio 5.2.0 support
Version 1.34.X (LTS Version)
Version 1.34.0 (LTS Version)
September 18, 2024:
- Lens Studio 5.1 support
- iOS: Fix an issue with Custom Location Markers
- iOS: Fix an issue caused by the
NS_OPTIONS
not being supported in Objc++
Version 1.33.0
August 21, 2024:
- Lens Studio 5.0.19 support
Version 1.32.0
July 24, 2024:
- Lens Studio 5.0.17 support
Version 1.31.0
June 13, 2024:
- Lens Studio 5.0.14 support
- Android: New
camerakit-sample-basic
app demonstrating a simple way of integrating Camera Kit into your own application. - iOS: Updated Privacy Manifest file describing data that the SDK collects and the reasons required APIs that it uses.
Version 1.30.X (LTS Version)
Version 1.30.1 (LTS Version)
June 26, 2024:
- iOS: Update to Privacy manifest file describing data the SDK collects and reasons required APIs it uses.
Version 1.30.0 (LTS Version)
April 24, 2024:
- Lens Studio 5.0.10 support
- iOS: Added Privacy manifest file describing data the SDK collects and reasons for required APIs it uses.
- iOS: Added new SCCameraKitPushToDeviceProtocol#unpair method to unpair from Push-to-Device.
- Android: Added new LensPushToDeviceService#initiatePairing and LensPushToDeviceService#unpair methods to pair and unpair Push-to-Device without using default UI.
Version 1.29.0
March 22, 2024:
- Lens Studio 5.0.8 support
- Android: Fix for incorrect processing size that sometimes resulted in pixelated image on some of the Android devices
- iOS: Fix for a blank preview on app launch when device is in a low bandwidth environment
Version 1.28.0
February 9, 2024:
- Lens Studio 5.0.4 support
- Android: Fix an issue when
LensesComponent.Processor#clear()
doesn't remove a lens while using custom UI - Android: Fix a crash when using Push-To-Device
Version 1.27.0
December 13, 2024:
- Lens Studio 5.0.2 support
- Android: Addressed behavior changes for apps targeting Android 14 or higher
Known Issue:
- Push-to-Device on Android does not connect to Lens Studio
Version 1.26.2
December 13, 2024:
-
iOS: Update CocoaPods's pod names to SCCameraKit, SCCameraKitReferenceUI, SCCameraKitReferenceSwiftUI, SCCameraKitLoginKitAuth, SCCameraKitBaseExtension, SCCameraKitConnectedLensesExtension, SCCameraKitPushToDeviceExtension from this release on. Framework names in code remain the same.
-
Bug fixes:
- iOS: Fix face detection for 3+ faces on front camera.
Version 1.26.1
Oct 16, 2023
- Bug fixes:
- Lens elements that use overlay render target may be get incorrectly positioned when camera input does not match preview output aspect ratio
- Lens audio playback is not muted when app is paused (Android only)
- HIGH_SAMPLING_RATE_SENSORS permission declaration is missing in the core SDK manifest (Android only)
- Early display rotation notification causing incorrect input processing size calculation on Android 14 (Android only)
Version 1.26.0
Sep 13, 2023
-
Lens Studio 4.55 support
-
Improved experience for accepting Terms of Service for app users under the age of 13 in the US.
- This has been implemented 1.24 for mobile, and is now available to enable from the Snap Kit Developer Portal.
-
See Terms of Service documentation for more details.
-
Android: Please check the Changelog on GitHub for full details. Summary of changes:
connectOutput
method moved intosupport-media-recording
andmediaStoreSourceFor
method moved into a separate Maven artifactsupport-media-picker-source
- Default Lenses carousel UI moved into
support-lenses-carousel
and default media picker UI moved intosupport-media-picker-ui
. These components are removed from corecamerakit
artifacts.
-
Fix a bug where wrong camera orientation was used after device rotation on iOS 16 and later (iOS only)
Version 1.25.0
Aug 16, 2023
- Lens Studio 4.53 support
- Fix a bug in the ARCore field of view, which was causing poor performance and incorrect object positioning for world tracking lenses (Android only)
- Fix a bug when the first lens in the carousel has not been applied if
LensesComponent.Carousel.Configuration#disableIdle
set totrue
(Android only)
Version 1.24.0
June 28, 2023
-
Lens Studio 4.49 support
-
Android: Add a Profiling Extension to monitor the Camera Kit performance. See Profiling.
-
Android: Add a new API to get lens snapcode image and deep link URIs, usage example:
session.lenses.repository.get(LensesComponent.Repository.QueryCriteria.Available("lens-group-id")) { result ->
result.whenHasFirst { lens ->
val snapcodePngUri = lens.snapcodes.find { it is LensesComponent.Lens.Media.Image.Png }?.uri
val snapcodeDeepLinkUri = lens.snapcodes.any { it is LensesComponent.Lens.Media.DeepLink }?.uri
}
} -
Android: Add
READ_MEDIA_VIDEO
andREAD_MEDIA_IMAGES
permissions to the sample apps which are required to access media files on devices when using the Media Picker lenses feature. -
iOS: Add a debug dialog to swap API token for testing.
-
iOS: Add support for configuring debug dialogs via deep links/qr codes.
-
iOS: Fix a bug where certain assets could be loaded later than expected, potentially causing the lens to fail to load entirely if device was offline.
Version 1.23.0
May 17, 2023
-
Lens Studio 4.47 support
-
Android: Add a new API to get lens preview sequences -
LensesComponent.Lens.Media.Sequence
. usage example:session.lenses.repository.get(LensesComponent.Repository.QueryCriteria.Available("lens-group-id")) { result ->
result.whenHasFirst { lens ->
(lens.previews.find { preview ->
preview is LensesComponent.Lens.Media.Sequence.Webp
} as? LensesComponent.Lens.Media.Sequence.Webp)?.let { webpSequence ->
webpSequence.values.forEach { imageUri ->
// do something with each image
}
}
}
} -
Android: Prompt users to install a new ArCore version when available when using lenses that require it
-
iOS: Fix share button working as save button in the reference UI
Version 1.22.0
May 8, 2023
- Lens Studio 4.46 support
- Deprecate application ID, remove its use across sample apps
- Android: Add a debug dialog to swap API token for testing
- Android: Fix a bug introduced in SDK version 1.18.0 where lenses exported from Lens Studio version 4.31 and prior could lead to a crash on Adreno GPU based devices
- iOS: Fix a bug in the reference UI where tapping the share button could lead to a crash on iPad
Version 1.21.1
Mar 29, 2023
- Fix bug from 1.21.0 where tap targets on edges are not working (iOS only)
- Fixed issue where photos of certain lenses could output a blank image (iOS only)
Version 1.21.0
Mar 24, 2023
- Lens Studio 4.43 support
Version 1.20.0
Feb 22, 2023
- Android: Add a way to collect Camera Kit diagnostics information on-demand. This feature can be enabled when an issue in Camera Kit is encountered, please reach out to the Camera Kit support for further instructions.
- Sample app changes: Add examples on how to remove the control strip from the
CameraActivity
and remove "Share with Snapchat" placeholder button - Fix Snap attribution view is not shown outside of US
- Fix bug where login flow could fail during Push to Device configuration (iOS only)
Version 1.19.2
Jan 13, 2023
- iOS: Fix the issue of staging watermark showing with production API token
Version 1.19.1
Jan 11, 2023
- Android: Fix a crash caused by
RejectedExecutionException
afterSession
is closed
Version 1.19.0
Dec 28, 2022
- New Sample App Add a new sample app that demonstrates a custom implementation of lenses carousel and camera preview layout. Sample app source can be downloaded from Camera Kit GitHub repo.
- Change Groups option Add a debug menu to the sample app to customize lens groups at runtime (iOS only).
- API Updates Remove deprecated lens icon/preview accessors (Android only):
LensesComponent.Lens.iconUri
replaced byicons.find { it is LensesComponent.Lens.Media.Image.Png }?.uri
LensesComponent.Lens.preview
replaced bypreviews.find { it is LensesComponent.Lens.Media.Image.Webp }?.uri
Version 1.18.1
Dec 2, 2022
- Android: Fix an issue where touch gestures are not be processed by lenses if no
View
is provided toLensesComponent.Builder#dispatchTouchEventsTo
Version 1.18.0
Nov 21, 2022
- Custom Location AR support (Beta feature), which allows developers to map and author AR content at a location of their choosing.
- Staging Watermark applies on staging builds of Camera Kit integrations
- Design Guidelines example added to Sample Apps.
- iOS: Xcode 14 or above required, discontinued support for iOS 11 and lower
- Android: Upgrade CameraX dependency to 1.1.0
Version 1.17.1
Dec 2, 2022
- Android: Fix an issue where touch gestures are not be processed by lenses if no
View
is provided toLensesComponent.Builder#dispatchTouchEventsTo
Version 1.17.0
Oct 18, 2022
- Remote API support (Beta feature), which allows developers to pass local or remote data through to a Lens.
- City-Scale AR Lens support (Beta feature), which allows developers to create unique Lens experiences in select regions of certain cities around the world.
- Lens Push-to-Device (P2D) from Lens Studio, which allows developers to send Lenses from Lens Studio to their Camera Kit application for testing.
- Android: Expose new API to obtain WebP lens icon resources. Note that PNG Lens icon resources are deprecated, to be removed in 1.19.
Version 1.16.0
Sept 9, 2022
- Multi-User Service Beta access to Multi-User Services. Get in touch with your Camera Kit contact to gain access.
- arm64 simulator support Added support for arm64 simulators (iOS only).
Version 1.15.1
July 21, 2022
- Lens apply reset New API to apply a Lens while resetting its state if the Lens was applied already (Android only)
- ARCore performance Improved ARCore performance and crash fixes.
Version 1.14.1
July 5, 2022
- SDK version New API to obtain the current version of the Camera Kit SDK (Android only)
- Flash and ring light Add standard flash along with ring light for front-facing flash to sample (iOS only; Android already available in 1.13.0)
- Static assets Add support for lenses with static assets
Version 1.13.0
May 31, 2022
- Tone mapping and Portrait mode New APIs and sample app changes to demonstrate Tone mapping and Portrait mode adjustments.
- Ring flash mode Support for ring flash mode for front-facing camera flash (Android only)
- Viewport configuration — Add explicit viewport configuration to
SCCameraKitPreviewView
(iOS only)
Version 1.12.0
April 22, 2022
- API token is mandatory Apps must add API token to use Camera Kit. See Android and iOS documentation for examples on how to obtain and provide an API token.
- Legal prompt update The legal agreement prompt has been updated to use a more user friendly text copy. Updating to this release will result in users needing to accept the updated prompt which includes a new link to the Camera Kit's "learn more" page.
- Dynamic Feature sample app — Added sample apps to demonstrate dynamic feature loading (DFM) (Android only)
- New Crop and Aspect ratio option CameraXImageProcessorSource#startPreview takes aspect ratio and crop option (applied to each frame before processing) parameters (Android only)
- SDK size improvements About 500KB binary size reduction (Android only)
Version 1.11.0
Mar 14, 2022
- Text Input — Users will now be able to input text in Lenses
- Lens Studio support — Lenses built with Lens Studio version 4.16 are now supported
- Video recording timer Fix a bug to allow recording videos up to 60 seconds by default (iOS only)
Version 1.10.0
Mar 1, 2022
- Privacy key — Added missing "Privacy - Location When In Use Usage Description" entry in the Sample App (iOS only)
- Lens camera preference — Support programmatic switching of camera based on lens facing (front or rear) preference (Android only, iOS upcoming)
- Binary size optimizations — 1.3MB uncompressed savings (iOS only)
- Cache size — Removed limit on cache size to allow for larger media picker images (iOS only)
- Directory structure — Use consistent directory names for files related to CameraKit (Android only)
- Emulator support — Fix a bug where emulator images failed to render lenses (Android only)
Version 1.9.0
Jan 21, 2022
- Lens Studio 4.13 support — Lenses uploaded with Lens Studio 4.13 will now be available for use with Camera Kit
- M1/arm64 simulator support — now you can use M1 macs to build Camera Kit and try with arm64 simulator (iOS only)
- Tap-To-Focus — users can now tap on screen to focus in live view (iOS only, Android support was added in 1.8.1)
Version 1.8.1
Dec 13, 2021
- Legal agreement prompt — SDK will now show Terms of Service prompt when lens is applied first time.
- API token authorization — apps should now use API token based authorization for Camera Kit access instead of APP ID based authorization.
- Lenses audio mute/unmute support — apps can now mute\unmute audio from lenses without affecting device volume settings (Android only). We also added sample app for custom implementation of audio and video recording for Android.
- Tap-To-Focus — users can now tap on screen to focus in live view (Android only)
- Rotation detection — added support to maintain continuous focus even if device is rotated (Android only)
Version 1.7.0
Sept 29, 2021
- SwiftUI Support (Beta) — apps can now use SwiftUI with Camera Kit (iOS only). This is an early preview, please let us know your feedback.
- Added SRE metrics — added SRE metrics to increase observability of the quality for the backend service
- Simplified integration — new layouts and screens for simple use cases and quicker integration (Android only).
- Gallery media source support — media can now be picked from the gallery for media processor (Android only)
- Carousel reference UI — added reference UI for Lens Carousel (Android only)
- Toggle capture button control — apps can now enable or disable Snap button based on download status of the lens (Android only)
Version 1.6.0
April 30, 2021
- Image Picker — provides the ability to apply photos as textures within a Lens from the user’s personal photo collection. Note: iOS requires an entry for this in your app plist for “Privacy - Photo Library Usage Description”
- Landmarker Lenses — full support for large-scale Lens experiences on some of the world’s most recognizable landmarks. Note: iOS requires an entry for this in your app plist for “Privacy - Location When In Use Usage Description”
- ARCore — bringing native tracking to Android (iOS SDK supports ARKit). For certain Lenses, this will provide additional depth and tracking capabilities.
- Render Zones — safe rendering areas for UI placement
- Accessibility Improvements — customize Lens content descriptions in the carousel UI (Android only)
- Volume Capture Event — Camera Kit can respond to volume up events to start capture (Android only)
Version 1.2.0
February 5, 2025
Changes
- Improved keyboard support
- General bug fixes and reliability enhancements
Version 1.1.0
December 18, 2024
Changes
- Introduced support for Lens HTTP requests
- Added support for custom font
Version 1.0.x (LTS Version)
November 15, 2024
Changes
- General bug fixes and reliability enhancements
Version 0.23.0 (LTS Version)
October 18, 2024
Changes
- General bug fixes and reliability enhancements
Version 0.22.0 (LTS Version)
September 17, 2024
Changes
- General bug fixes and reliability enhancements
Version 0.21.0
August 21, 2024
Changes
- General bug fixes and reliability enhancements
Version 0.20.0
July 24, 2024
Changes
- General bug fixes and reliability enhancements
Version 0.18.1
July 9, 2024
Changes
- Fixed an issue where users experienced reduced frame rates with Lenses utilizing World Mesh.
Version 0.18.0
June 12, 2024
Changes
- Improved platform error handling
- General bug fixes and reliability enhancements
Version 0.17.0 (LTS Version)
Apr 23, 2024
- Lens Studio 5.0.10 support
- Various Bug Fixes
Version 0.16.2
Mar 24, 2024
Breaking Changes
- Updated exports for improved compatibility; consumers may need to adjust imports to align with new paths.
- createUserMediaSource, which was previously marked for deprecation, has been removed. Consumers will need to create MediaStreams via the native MediaDevices interface and create a CameraKitSource with createMediaStreamSource.
- CameraKitDeviceInfo, which was also previously marked for deprecation, has been removed in favor of CameraKitDeviceOptions. This change aligns the cameraType property of the CameraKitSource configuration with that of the native getUserMedia API.
Features & Optimizations
- Improved platform error handling
- General bug fixes and reliability enhancements
Version 0.15.0
Feb 12, 2024
Breaking Changes
- The
applyLens
API has changed to accept additional launch data params.
Features & Optimizations
- CameraKitSession's play() and pause() methods have been updated to independently control Live and Capture output canvases.
- When using createMediaStreamSource, the render size automatically adjusts to the dimensions of the source media stream track, resolving issues with zoomed-in output, particularly on Safari mobile.
- Custom transformation matrices can now be supplied in the Sample App.
- Reduced API payload size with differential data fetching optimization.
Bug Fixes
- Web workers are now disabled by default in Safari mobile to address a frame stuttering issue. This issue has been resolved on desktop and will continue to utilize web workers by default.
Version 0.14.0
Dec 13, 2023
Features
- Camera type will now automatically be inferred based on the Media Stream track settings
- Improved error messaging in the Push to Web sample app
Bug Fixes
- Increased Camera Kit Source reliability
Version 0.13.1
Oct 18, 2023
Features
- Introducing Remote API support
- Bug fixes and performance enhancements
Version 0.12.0 (LTS Version)
Sep 13, 2023
Breaking Changes SDK domain has been changed from .snapchat.com to .snapar.com. Updates to your application’s content security policy may be required.
Features
- A Push to Web sample app has been added; allowing developers to push Lenses from Lens Studio directly to the sample app for testing.
- Lens Studio 4.55 support
Bug Fixes
- Fixed an issue in Firefox where an audio context may not be available
Version 0.11.0
Aug 9, 2023
- Introducing Push2Web, an extension that allows you to send Lenses to your application directly from Lens Studio.
- Localization of the Terms of Service dialog
Version 0.10.0
June 21, 2023
- Introducing Test Your Lenses, a new sample page app that lets you test your Lenses with the Web SDK.
- Parallel shader compilation support
- Improvements for the events handling when there are multiple instances of CameraKit
Version 0.9.1
June 12, 2023
- Fixes an issue where an increased number of metrics may be emitted by the SDK.
- Increased reliability when using createMediaStreamSource.
Version 0.9.0
May 17, 2023
- Lens Studio compatibility updates
- Upgrade TypeScript to version 5
Version 0.8.0
May 3, 2023
- Bug fixes and Lens Studio compatibility updates
Version 0.7.0
April 17, 2023
- Allow specific WASM asset urls to be specified in
bootstrapCameraKit