Bugsee Unity SDK

UPM package for the Bugsee crash and session-replay SDK on Unity (2021.3+).

This repository replaces the legacy .unitypackage / Assets/Plugins distribution. The previous repo remains available as a reference foundation.

Install

In Unity Package Manager → Add package from git URL:

https://github.com/bugsee/bugsee-unity.git

Pin a version/tag when available:

https://github.com/bugsee/bugsee-unity.git#0.1.0

The package depends on EDM4U. Add the OpenUPM scoped registry to your project’s Packages/manifest.json if it is not already present:

{
  "scopedRegistries": [
    {
      "name": "package.openupm.com",
      "url": "https://package.openupm.com",
      "scopes": [
        "com.google.external-dependency-manager"
      ]
    }
  ]
}

Native SDKs

Platform	Integration	Current pin
Android	EDM4U → Maven Central	bugsee-android:7.3.0 + bugsee-android-ndk:7.3.0
iOS	Swift Package Manager + Plugins/iOS/BugseeUnityBridge.mm	bugsee/spm 7.0.0-beta5

Android stack

Piece	Status
bugsee-android	Default via EDM 7.3.0 (no Maven transitives)
bugsee-android-ndk	Declared explicitly (native fatal capture for IL2CPP primary LNM)
Gradle plugin 4.0.8	Applied on launcher by BugseeAndroidGradleSetup on Unity 6+ (ndk { enabled = true })

Refreshing native artifacts

./Tools~/scripts/update-native-sdks.sh

See Tools~/versions.env for pinned versions and paths.

Crashes & symbols

See Documentation~/index.md for:

• ExceptionPipeline vs DetectAndReportCrash
• Hang / ANR / OOM launch options
• BUGSEE_APP_TOKEN Editor uploads (il2cpp-linemap, elf, proguard)
• iOS archive-time dSYM + linemap Run Script
• Create symbols.zip / FULL native debug symbols vs SYMBOL_TABLE

Layout

Runtime/           # C# runtime API + asmdef
Editor/            # EDM, Gradle, iOS SPM, linemap + symbol upload
Plugins/           # iOS ObjC++ bridge, Android UnityManagedException.java
Native~/ios/Bugsee # Unused local SPM stub (Xcode uses github.com/bugsee/spm)
Tools~/            # Version pins + maintenance scripts
Documentation~/    # Package docs shown in Package Manager
Samples~/
  BugseeMiniGame/  # Standalone QA minigame (excluded from UPM via ~)

Sample project

Open Samples~/BugseeMiniGame in Unity Hub (2021.3+) to try a small arena with HUD buttons and in-world Bugsee stations. See that folder’s README.

Status

• Android + iOS bridges (Launch, exceptions, filters, report handler, lifecycle, native crash options)
• ExceptionPipeline (managed auto-capture) + UnityManagedException JSON contract
• Editor symbol orchestrator (linemap / ELF / ProGuard / iOS archive dSYM)
• Contracts (Options, Lifecycle, Reporting, Exchange, Appearance, Feedback)

See DESIGN.md for the full plan.

License

MIT — see LICENSE.