Troubleshooting

Check if .NET MAUI SDK is initialized correctly

Call the following Screeb method from our SDK:

using Screeb.Maui;

await Screeb.Debug();

You will get contextual information about the running user session in the native logs.

Error cases

• An empty channel id means you didn't call the InitSdk method.
• An empty respondent id means you exceeded your respondent quota.

Debug targeting rules

Since the targeting engine built by Screeb runs in the background, you may not understand which rules prevent your survey from being displayed to a user.

Call the following Screeb method from our SDK:

using Screeb.Maui;

await Screeb.DebugTargeting();

You will get a list of available surveys and the associated targeting rules in the native logs.

The rules with a green dot 🟢 are the ones that have been validated for this user. The rules with a red dot 🔴 are not validated and may be the reason why your survey is not displayed.

iOS: "Failed to build module 'Screeb'; this SDK is not supported by the compiler"

Failed to build module 'Screeb'; this SDK is not supported by the compiler (the SDK is built with 'Apple Swift version 5.5.2 (swiftlang-1300.0.47.5 clang-1300.0.29.30)', while this compiler is 'Apple Swift version 5.7.1 (swiftlang-5.7.1.135.3 clang-1400.0.29.51)'). Please select a toolchain which matches the SDK.

This compilation error is raised when support for library evolution is not enabled. This is typically handled automatically in .NET MAUI projects, but if you encounter this issue, ensure your iOS build settings are configured correctly.

Android: ProGuard / R8 configuration

If you are using code shrinking (ProGuard or R8) in your Android release builds, the Screeb SDK should work out of the box. However, if you encounter issues, you may need to add ProGuard rules.

The SDK includes its own ProGuard rules, but if you need to add custom rules, create a proguard-rules.pro file and add:

-keep class app.screeb.sdk.** { *; }

Common issues

Survey not showing

1. Targeting rules: Check the survey targeting rules in the admin console
2. User identification: Ensure the user is identified before the survey trigger fires
3. SDK initialization: Verify that InitSdk() completed successfully
4. Debug targeting: Use DebugTargeting() to see which rules are failing

Crashes on startup

1. Channel ID: Verify your channel ID is correct
2. Permissions: Ensure all required permissions are set in AndroidManifest.xml (Android) or Info.plist (iOS)
3. SDK version: Make sure you're using the latest version of Screeb.Maui

Hooks not firing (iOS v0.1.0)

See the MAUI Hooks page for information about iOS limitations in v0.1.0.