Skip to main content

SDK Binary Sizes

Understand how SDK binary sizes differ between the distributed artifacts and what gets installed in your app.

Download on theApp StoreDownload on theGoogle Play

Overview​

The Veryfi Lens SDK is distributed as fat binaries that include native code for all supported architectures. This makes integration simple, but the download size of the artifact is larger than the size that actually ends up in your built app.

When you build your app, the build system (Gradle on Android, Xcode on iOS) typically includes only the architecture(s) needed for your target devices. As a result, the size added to your app is smaller than the size of the distributed .aab or .xcframework.

SDK flavors

These sizes refer to the full SDK flavor. If you use a specific SDK flavor (e.g. checks-only on iOS), the size can be reduced almost by half. Not all flavors reduce the same; on iOS the SDK size in your app with a specific flavor can be in the range of roughly 5 MB to 15 MB, depending on the flavor.

iOS: XCFramework size vs app size​

On iOS, the SDK is distributed as an XCFramework. The XCFramework contains slices for all supported architectures and platforms, for example:

  • arm64 (iPhone/iPad devices)
  • x86_64 (Simulator, Intel Mac)
  • arm64 (Simulator, Apple Silicon)

So one XCFramework includes device + simulator slices for multiple architectures.

Distributed XCFramework size (all architectures)​

As of Feb 10, the full Lens SDK XCFramework (all slices: device + simulator) is approximately:

ArtifactApproximate size
Lens SDK XCFramework (all slices)~110 MB

Screenshot: XCFramework size​

iOS XCFramework size

Size in your app (e.g. device only)​

When you build an app for the App Store, you typically include only device architectures (e.g. arm64). Simulator slices are not shipped. The IPA size increase when adding the SDK to a new project is roughly ~29 MB. The actual download size for users can be smaller, as Apple may further reduce it per device (e.g. via App Thinning).

In your app (device arm64 only)Approximate size
IPA size increase with SDK~29 MB
caution

Actual user download size may be lower than the IPA size increase; Apple handles device-specific variants (e.g. App Thinning).

Screenshot: IPA size comparison (without SDK vs with SDK)​

iOS IPA size comparison