Bubbl Android SDK Integration Guide

Copy

• Copy for LLM

  Copy page as Markdown for LLMs
• View as Markdown

  Open this page as Markdown
• Open in ChatGPT

  Get insights from ChatGPT
• Open in Claude

  Get insights from Claude
• Connect to Cursor

  Install MCP server on Cursor
• Connect to VS Code

  Install MCP server on VS Code

This guide explains how to integrate the Bubbl Android SDK into a clean Android app and why each decision is made. It is intentionally over-explained so a brand‑new developer can copy, paste, and understand every step.

You will find:

1. A quick start guide with minimal steps.
2. A full integration walkthrough with code snippets, tooltips, and explanations.
3. A clear list of differences between the Bubbl host app and a vanilla Android app.
4. Troubleshooting and a checklist.

Who this is for

• Android devs with little to no SDK integration experience.
• Anyone who wants to understand why each line exists, not just what it does.

What Bubbl adds to a vanilla app

• Location awareness and geofence refresh.
• Push notifications and in‑app modal experiences.
• Optional surveys with structured answer collection.
• Logging utilities and diagnostics.

SDK requirements (from Bubbl docs)

• minSdk 26 or higher.
• targetSdk 34 or higher.
• Kotlin 1.8+ and Java 11+.
• Firebase BOM and FCM messaging for push notifications.

Local reference

This guide references the internal host app in:

• /Users/jackwright/Projects/Bubbl/bubbl-internal-android-host-app

The host app includes extra screens and helper code for debugging and demos that are not required for basic integration. We call those out explicitly.