Install the SDK on .NET MAUI

In this guide, you will learn how to get started with the Genius Scan SDK for .NET MAUI.

The Genius Scan SDK provides a .NET MAUI plugin to perform a simple integration with the document scan flow or the barcode scan flow.

Package information

• NuGet package: GeniusScanSDK.ScanFlow
• Supported platforms: iOS 15.0+, Android 23+
• .NET: 9.0+

Setup

The SDK supports .NET MAUI apps targeting iOS and Android. If you start from a template that also targets Mac Catalyst or Windows, either install the corresponding .NET workloads or remove those target frameworks from your project before building the SDK integration.

Installation

Install the NuGet package to your project:

dotnet add package GeniusScanSDK.ScanFlow --version 6.0.0-beta11

During restore or Android builds, NuGet may report Xamarin.AndroidX dependency constraint warnings with the beta package. These warnings do not block the integration if the build completes without errors.

Platform-specific configuration

Set the native minimum versions in your project file:

<SupportedOSPlatformVersion Condition="$([MSBuild]::GetTargetPlatformIdentifier('$(TargetFramework)')) == 'ios'">15.0</SupportedOSPlatformVersion>
<SupportedOSPlatformVersion Condition="$([MSBuild]::GetTargetPlatformIdentifier('$(TargetFramework)')) == 'android'">23.0</SupportedOSPlatformVersion>

Android configuration

Forward OnActivityResult to the service so promises complete correctly:

protected override void OnActivityResult(int requestCode, Result resultCode, Intent? data)
{
    if (!ScanFlowService.OnActivityResult(requestCode, resultCode, data))
    {
        base.OnActivityResult(requestCode, resultCode, data);
    }
}

iOS configuration

In your Platforms/iOS/Info.plist, add the camera usage description:

<key>NSCameraUsageDescription</key>
<string>We use the camera to scan documents</string>

What’s Next?

Next, configure a license key. To compare with a working integration, see the sample apps.