Android SDK Setup

PushBots Android SDK setup guide.

What we do?

PushBots is a push notification service that help you manage notifications on all platforms (Android, iOS, Web, react-native, cordova) efficiently and easily.

Required For Setup:-

• A PushBots account

  • You will find APP_ID while integrating your project with dashboard

• An APP-ID and CLIENT-ID from HWS (HUAWEI Service)

• Android Studio

Setup PushBots

1. Adding PushBots Dependencies

build.gradle(project)

allprojects {
    repositories {
        maven { url 'http://developer.huawei.com/repo/' }
    }
}

build.gradle

implementation 'com.pushbots:pushbots-lib:3.3.0@aar'
implementation 'com.huawei.hms:push:4.0.0.300'
implementation 'com.google.android.gms:play-services-location:17.0.0' // optional

2. Integrate with PushBots dashboard

Add to defaultConfig section, then replace PUSHBOTS_APP_ID and HUAWEI_CLIENT_ID

build.gradle

defaultConfig {
        // Add PushBots integration data
        manifestPlaceholders = [
                pushbots_app_id               : "YOUR_APP_ID",
                pushbots_loglevel             : "DEBUG",
                google_sender_id              : "YOUR_CLIENT_ID"
        ]

    }

Set your app-id that you get from HMS console in your manifest:

Manifest.xml

 <meta-data
            android:name="com.huawei.hms.client.appid"
            android:value="appid=YOUR_HMS_APP_ID" />

3. Initialize PushBots

PushBots should be initialized when app just started, one of the existing ways is to initialize it in our application.

MyApplication.kt

import android.app.Application
import com.pushbots.push.Pushbots

class MyApplication : Application() {
   override fun onCreate() {
        super.onCreate()
        // Initialize Pushbots Library
        Pushbots.sharedInstance().init(this)
   }
}

Now add your Application to Manifest.xml

AndroidManifest.xml

 <application
     android:name=".MyApplication">
 </application>

Now you have initialized PushBots successfully, BUT there is one more step to be able to receive notifications.

You need to register for it (You may register for it inside you MyApplication.class or MainActivity.class):

MainActivity.kt

//Register for Push Notifications
Pushbots.sharedInstance().registerForRemoteNotifications()

Things you can do using PushBots:-

• You can set device info so you can recognize/manage users on dashboard easily i.e:

MainActivity.kt

Pushbots.setEmail("[email protected]")
Pushbots.setName("PUSH BOTS")
Pushbots.setAlias("PUSHER")

Now you can manage users easily on dashboard.

Use our plugin to fix dependencies conflicts

• Using the plugins DSL

plugins {
  id "com.pushbots.android.plugin.pushbots-gradle-plugin" version "1.0-SNAPSHOT"
}

• Using legacy plugin application:

buildscript {
  repositories {
   maven { url "https://plugins.gradle.org/m2/" }
  }

// Inside your app.build.gradle
dependencies {
   classpath "gradle.plugin.com.pushbots:pushbots-gradle-plugin:1.0-SNAPSHOT"
  }
}


apply plugin: "com.pushbots.android.plugin.pushbots-gradle-plugin"

AndroidX Migration

If your project is using AndroidX you will need to make sure Jetifier is enabled to be compatible with PushBots. In your gradle.properties file, set the following two flags to true

gradle.properties

android.useAndroidX=true
android.enableJetifier=true