Skip to main content
Version: .NET MAUI SDK

Install

How to install the .NET MAUI SDK in your app?​

See the example to install the last version of the Screeb SDK dependency in a .NET MAUI app.

NuGet Screeb.MauiLicense: MIT

Screeb SDK Usage in CI Environments​

Please note that if you are utilizing a Continuous Integration (CI) system, it is advisable to deactivate the Screeb SDK during CI execution. This precaution helps prevent the creation of numerous new anonymous users and potential exceedance of your MTU limit.

Technical requirements​

The Screeb SDK is configured to work with Android API 19+ (required by the underlying Screeb Android SDK) and iOS version 12.0 minimum.

The size of the SDK is approximately 120 KB on Android and approximately 400 KB on iOS.

How to configure the .NET MAUI SDK in your app?​

First, log in to the Screeb application, then create your first survey.

Add Screeb as a dependency​

dotnet add package Screeb.Maui

Android​

The Android SDK needs the permissions INTERNET to work well.

<uses-permission android:name="android.permission.INTERNET" />

The SDK also need theses permissions if you want to use the Screeb Audio/Video feature.

<uses-permission android:name="android.permission.CAMERA"/>
<uses-permission android:name="android.permission.MICROPHONE" />
<uses-feature android:name="android.hardware.camera" android:required="true"/>
<uses-feature android:name="android.hardware.camera.autofocus"/>
<uses-permission android:name="android.permission.RECORD_AUDIO" />
<uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS" />

iOS​

The SDK need theses permissions if you want to use the Screeb Audio/Video feature.

<key>NSCameraUsageDescription</key>
<string>This app needs access to the camera to take photos.</string>
<key>NSMicrophoneUsageDescription</key>
<string>This app needs access to microphone to record audio.</string>
<key>UISupportedInterfaceOrientations</key>

Import Screeb SDK into your package​

using Screeb.Maui;

Setup the SDK​

tip

You can find your channel id in your workspace settings.

// Init the sdk at app start
await Screeb.InitSdk(
    channelId: "<YOUR-CHANNEL-ID>",
    userId: "<USER-ID>",
    properties: new Dictionary<string, object>
    {
        ["example-prop1"] = false,
        ["example-prop2"] = 29,
        ["example-prop3"] = "iPhone 13"
    }
);

About SDK lifecycle​

At any time, you can disable the Screeb SDK with the following command:

using Screeb.Maui;

await Screeb.CloseSdk();

To enable the Screeb In-App Message editor on your .NET MAUI app, you need to configure deep links on both platforms.

iOS​

Add the following to your Info.plist file, replacing <channel-id> with your channel ID:

<key>CFBundleURLTypes</key>
<array>
  <dict>
    <key>CFBundleTypeRole</key>
    <string>Viewer</string>
    <key>CFBundleURLName</key>
    <string>screeb</string>
    <key>CFBundleURLSchemes</key>
    <array>
      <string>screeb-<channel-id></string>
    </array>
  </dict>
</array>

If using AppDelegate, add this code:

@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate {
    func application(_ app: UIApplication, open url: URL, options: [UIApplication.OpenURLOptionsKey: Any]) -> Bool {
        Screeb.handleDeepLink(url: url)
        return true
    }
}

Or if using SceneDelegate:

class SceneDelegate: UIResponder, UIWindowSceneDelegate {
    func scene(_ scene: UIScene, openURLContexts URLContexts: Set<UIOpenURLContext>) {
        Screeb.handleDeepLink(url: URLContexts.first?.url)
    }
}

Android​

Add the following intent filter to your main Activity in AndroidManifest.xml, replacing <channel-id> with your channel ID:

<intent-filter>
    <action android:name="android.intent.action.VIEW" />
    <category android:name="android.intent.category.DEFAULT" />
    <category android:name="android.intent.category.BROWSABLE" />
    <data android:scheme="screeb-<channel-id>" />
</intent-filter>

Then handle deep links in your MainActivity.cs:

protected override void OnCreate(Bundle savedInstanceState)
{
    base.OnCreate(savedInstanceState);
    Screeb.HandleDeepLink(Intent);
}

protected override void OnNewIntent(Intent intent)
{
    base.OnNewIntent(intent);
    Screeb.HandleDeepLink(intent);
}