com.AppAmbit.Sdk 4.0.1

AppAmbit .NET SDK

Track. Debug. Distribute. AppAmbit: track, debug, and distribute your apps from one dashboard.

Lightweight SDK for analytics, events, logging, crashes, and offline support. Simple setup, minimal overhead.

Full product docs live here: docs.appambit.com

Contents

• Features
• Requirements
• Install
• Quickstart
• Usage
• Release Distribution
• Privacy and Data
• Troubleshooting
• Contributing
• Versioning
• Security
• License

Features

• Session analytics
• Ambit Trail records detailed navigation for debugging
• Event tracking with rich properties
• Error logging for quick diagnostics
• Crash capture with stack traces and threads
• Offline support with batching, retry, and queue
• Create mutliple app profiles for staging and production
• Lightweight, modern .NET API for iOS and Android

Requirements

• .NET 9.0 or newer with the .NET workload

• Visual Studio 2022 (17.6 or newer) or VS Code with .NET extensions

• Supported targets:

  • WPF
  • WinUI

Install

NuGet

Add the package to your project:

dotnet add package com.AppAmbit.Sdk
# or specify version
dotnet add package com.AppAmbit.Sdk --version 4.0.1

Or, using Visual Studio:

• Right-click your project → Manage NuGet Packages…
• Search for AppAmbit and install the latest stable version.

Quickstart

Initialize AppAmbit early in your application lifecycle (e.g. in Program.cs.

using AppAmbit;

public partial class App : Application
{
    public override void OnFrameworkInitializationCompleted()
    {
        AppAmbitSdk.Start("<YOUR-APPKEY>");
        ...
        base.OnFrameworkInitializationCompleted();
    }
}

Usage

• Session activity – automatically tracks user session starts, stops, and durations

• Ambit Trail – records detailed navigation of user and system actions leading up to an issue for easier debugging

• Track events – send structured events with custom properties

    Analytics.TrackEvent("Audio started", new Dictionary<string, string> {
        { "Category", "Music" },
        { "FileName", "favorite.mp3"}
    });
  

• Logs: add structured log messages for debugging

    Crashes.LogError("This code should not be reached");
  

• Crash Reporting: uncaught crashes are automatically captured and uploaded on next launch

Release Distribution

Upload your APK, AAB, or IPA directly to your AppAmbit dashboard. Distribute release builds through:

• Direct install links
• Email distribution
• Environment-specific channels

Privacy and Data

• The SDK batches and transmits data efficiently
• You control what is sent — avoid secrets or sensitive PII
• Complies with store policies for iOS and Android.

For more details, see docs.appambit.com.

Troubleshooting

• No data in dashboard → verify API key, check network access, and ensure AppAmbitSdk.Start() is called once at startup.
• NuGet restore issues → run dotnet restore or clear local caches with dotnet nuget locals all --clear.
• Crashes not appearing → remember crashes are reported on the next app launch.

Contributing

We welcome issues and pull requests.

• Fork the repo
• Create a feature branch
• Add tests where applicable
• Open a PR with a clear summary

Please follow .NET coding guidelines and document public APIs.

Versioning

Semantic Versioning (MAJOR.MINOR.PATCH) is used.

• Breaking changes → major
• New features → minor
• Fixes → patch

Security

If you find a security issue, please contact hello@appambit.com rather than opening a public issue.

License

Open source under the terms described in the LICENSE file.

Links

• Docs: docs.appambit.com
• Dashboard: appambit.com
• Discord: discord.gg
• Examples: Sample .NET demo (iOS and Android) included in repo.