Installation

Previous version

This page documents Bugsee Android SDK 6.x, the previous major version. The current line is 7.x — see Migrating from 6.x to 7.x to upgrade, or Installation to start a new integration.

Agent-Assisted Setup

Ask your AI coding assistant:

Use curl to download, read and follow: https://docs.bugsee.com/ai/agent-skills/sdk/android/SKILL.md

Works with Claude Code, Cursor, Copilot, Codex, and more. Learn more

Gradle Installation

Add the following dependency to your app module's build.gradle file

dependencies {
   implementation 'com.bugsee:bugsee-android:6.+'
}

info

The statement above fetches the latest available 6.x release. The 6. prefix matters: a bare + resolves to the newest version at this coordinate, which is now on the 7.x line and is not source-compatible with 6.x. To pin an exact version instead, replace 6.+ with the version you want — you can find all released versions in our release notes. To move to the current line, see Migrating from 6.x to 7.x.

This is the recommended way to install Bugsee.

If you use Maven (for example, Android Maven Plugin) to build your project, follow the Maven Installation instructions.

warning

If you're getting an "attribute android:foregroundServiceType not found" error, you should set compileSdkVersion in your build.gradle file to at least 35 (SDK 6.0.0 and newer require it — see the release notes). Make sure you have that Android SDK installed on your system.

Initialization

If you have no android.app.Application subclass, it is necessary to create it and to specify its name as the "android:name" attribute in your <application> tag in AndroidManifest.xml.

<application
    android:name="com.example.MyApplication">
    <!--...-->
</application>

Launch Bugsee from onCreate() method of your Application subclass.

Java

import com.bugsee.library.Bugsee;

public class MyApplication extends Application {
    @Override
    public void onCreate() {
        super.onCreate();
        Bugsee.launch(this, "<your_app_token>");
    }
}

Kotlin

import com.bugsee.library.Bugsee

class MyApplication : Application() {
    override fun onCreate() {
        super.onCreate()
        Bugsee.launch(this, "<your_app_token>")
    }
}

If you want to launch Bugsee from some other place (e.g., after a particular user action), you must use another variant of Bugsee.launch() which accepts Activity as the first argument. You must pass the current top activity into it.

Java

import com.bugsee.library.Bugsee;

public class MyCustomActivity extends Activity {
    public void onUserClick() {
        Bugsee.launch(this, "<your_app_token>");
    }
}

Kotlin

import com.bugsee.library.Bugsee

class MyCustomActivity : Activity() {
    override fun onUserClick() {
        Bugsee.launch(this, "<your_app_token>")
    }
}