Android quickstart
Connect your Firebase service account, add the Pushizo Android SDK with Gradle, initialize it in your Application class, request the Android 13+ permission and send a test push.
The Pushizo Android SDK is written in Kotlin (minSdk 23, AGP 8). Push goes through FCM as a data-only message; the SDK builds the notification, so tap and delivery feedback stay consistent even when the app is in the background. For Huawei devices see HMS. For the full API see the Android SDK.
Firebase and the service account
Create a Firebase project, add your Android app, and put the google-services.json file under app/. Download the service account JSON from Firebase → Project settings → Service accounts → Generate new private key; then go to Dashboard → Channels → Android Push, upload the JSON and click Verify.
Gradle
// root build.gradle.kts
plugins { id("com.google.gms.google-services") version "4.4.2" apply false }
// app/build.gradle.kts
plugins { id("com.google.gms.google-services") }
dependencies { implementation("com.pushizo:pushizo-android:0.2.0") }Nothing extra is needed in the manifest: INTERNET, POST_NOTIFICATIONS, PushizoMessagingService and NotificationOpenedReceiver are added through manifest merging. For the default icon/color, use <meta-data android:name="com.pushizo.sdk.default_notification_icon" …>.
Initialize
class App : Application() {
override fun onCreate() {
super.onCreate()
Pushizo.initialize(
this,
"app_…",
Pushizo.Options(
// apiUrl = "https://api.pushizo.com", // self-hosted
logLevel = HsLog.Level.WARN,
defaultChannelName = "Notifications",
),
)
}
}Request permission and identify the user
Android 13+ requires a runtime permission; the SDK opens the system dialog with requestPermission:
Pushizo.Notifications.requestPermission(activity) // result: onRequestPermissionsResult → Pushizo.Notifications.onPermissionResult()
Pushizo.login("user_42") // as soon as you know the identity; devices merge under the same user
Pushizo.User.addTags(mapOf("plan" to "pro"))Without permission, the subscription stays pending; it is registered automatically once permission is granted (permission flow).
Test push
Open the app on a real device or an emulator with Google Play; an android_push record appears under Dashboard → Subscriptions. Mark the record as a Test device and click Send test push. For notification channels (importance, sound), see notification channels.
Related: Android push channel, Migrating from Firebase.