Install the AppAmbit SDK by Hand: Every Platform

Overview

This is the one manual setup video every other AppAmbit tutorial builds on. No CLI wizard, no scaffolding tool, just the by-hand integration, uncut, on the platform you actually ship: create an app, copy its App Key, add the SDK, call AppAmbit.start("appKey"), and watch the first session land in the dashboard. iOS, Android, Flutter, React Native, and .NET MAUI each get their own chapter with verified syntax. Jump to yours, or watch straight through to see how little the shape changes between platforms.

What You'll Learn

• Creating an app in the AppAmbit dashboard and copying its App Key
• Adding the AppAmbit SDK by hand: CocoaPods, Gradle, pub.dev, npm, or NuGet, depending on platform
• Calling AppAmbit.start("appKey") (or the platform equivalent) to initialize the SDK
• Confirming the first session shows up in the dashboard, proving the integration is live

Prerequisites

Before you begin, make sure you have:

1. A mobile app project on the platform you're integrating: iOS, Android, Flutter, React Native, or .NET MAUI
2. An AppAmbit account (sign up for free)
3. For iOS: CocoaPods installed on your machine

Create Your App and Copy the App Key

Every platform starts the same way. In the AppAmbit dashboard, create a new app (or open an existing one) and go to its Info page. Copy the App Key: this is what links the SDK on your device to this specific app in your dashboard. Keep it private. It's referenced as <YOUR-APPKEY> in every snippet below.

iOS (Swift)

Add the SDK with CocoaPods. If the project doesn't have a Podfile yet, run pod init first, then add the SDK inside your app's target:

target 'YourApp' do
  use_frameworks!

  pod 'AppAmbitSdk'
end

Run pod install, close the .xcodeproj, and reopen the generated .xcworkspace. Then initialize the SDK once, at app startup:

import AppAmbit

AppAmbit.start(appKey: "<YOUR-APPKEY>")

Android (Kotlin)

Add the SDK from Maven Central. In the module-level build.gradle (or build.gradle.kts), add the dependency:

dependencies {
    implementation("com.appambit:appambit:1.0.2")
}

Sync Gradle, then call AppAmbit.start inside onCreate, before setContentView:

import com.appambit.sdk.AppAmbit

override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)

    AppAmbit.start(applicationContext, "<YOUR-APPKEY>")

    setContentView(R.layout.activity_main)
}

The Java call is the same shape: AppAmbit.start(getApplicationContext(), "<YOUR-APPKEY>");.

Flutter

Add the package from pub.dev:

flutter pub add appambit_sdk_flutter

Initialize it before runApp, in main.dart:

void main() async {
  WidgetsFlutterBinding.ensureInitialized();

  AppambitSdk.start(appKey: '<YOUR-APPKEY>');

  runApp(const MyApp());
}

React Native

Install the SDK via npm, then install the native iOS pods:

npm install appambit
cd ios && pod install

Initialize it once, near your app's entry point:

import * as AppAmbit from "appambit";

AppAmbit.start("<YOUR-APPKEY>");

.NET MAUI

Add the NuGet package to your MAUI project:

dotnet add package com.AppAmbit.Sdk

Wire it up in MauiProgram.cs:

using AppAmbit;

public static class MauiProgram
{
    public static MauiApp CreateMauiApp()
    {
        var builder = MauiApp.CreateBuilder();
        builder
            .UseMauiApp<App>()
            .UseAppAmbit("<YOUR-APPKEY>");

        return builder.Build();
    }
}

On iOS targets, also add the URL exceptions AppAmbit needs to Info.plist, covered in the SDK setup guide.

Confirm It's Live

Run the app once on every platform you integrated. Back in the AppAmbit dashboard, open the app's Audience tab: the first session shows up within seconds, proving the SDK is initialized and talking to AppAmbit. That's the whole manual setup: no more configuration needed before recording crashes, tracking events, or shipping a release.

Next Steps

With the SDK installed, jump straight into a feature: no setup required in any of these:

• Add Crash Reporting on iOS (Swift)
• Add Crash Reporting on Android (Java)
• Catch Your First Crash in Flutter
• Track Your First Event in React Native
• From First Event to Insight