Kotlin

PushExpress -- SDK Kotlin

Note: if you need fully unique apps, do obfuscation guide, else do all steps below.

Step 1. Prerequisites

You will need to integrate your Push.Express account with Firebase.

  1. Follow Push.Express integration guide

  2. Create or use existing app in Android Studio

  3. Follow Firebase Cloud Messaging integration guide

Step 2. Add the JitPack repository to your build file

Ensure you have the latest Android Studio and Android Gradle Plugin!

In your settings.gradle, add the Jitpack repo to repositories list (only if you use Gradle Centralized Repository Declaration feature, default for new projects since Android Studio Electric Eel):

// settings.gradle (Project Settings) in Android Studio
// ...
dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        // ...
        maven { url 'https://jitpack.io' }
    }
}
Alternatively, if you use old `allprojects` style

In your root-level (project-level) Gradle file (<project>/build.gradle), add the Jitpack repo to repositories list:

// build.gradle (Project: My_Application) in Android Studio
// ...
allprojects {
    repositories {
        // ...
        maven { url "https://jitpack.io" }
    }
}

Step 3. Add Push.Express SDK dependency

In your module (app-level) Gradle file (<project>/<app-module>/build.gradle), add the pushexpress-android-sdk dependency:

// build.gradle (Module :app) in Android Studio
// ...
dependencies {
    // ...
    implementation 'com.github.pushexpress:pushexpress-android-sdk:1.2.0'
}

Step 4. Add required code

See How to use Push.Express SDK in your Android Studio project

Setup Push.Express

Get Firebase Private key

  1. Go to Firebase Console and create a new project (or use existing one)

    You can use one project for all your apps.

  2. Open Project Settings

  3. Go to Service accounts, press Generate new private key and save it to file private-key.json (you can use same key for all apps)

Integrate your Push.Express App with Firebase

  1. Go to your Push.Express account

  2. Open existing App settings or create a new App

  3. Switch App Type to PushExpress SDK

  4. Paste private-key.json file to Firebase Admin SDK private key textbox

Setup Firebase

  1. Go to Firebase Console and create a new project (or use existing one)

    You can use one project for all your apps.

  2. Open Project Settings -> General

  3. Create new Android app or just download google-services.json from existing app

If you need to create new app, just:

  • Register it

  • Download google-services.json

  • Press next-next-next =)

  1. Put google-services.json to your app dir (like <project>/app/google-services.json)

  2. In top of your root-level (project-level) Gradle file (<project>/build.gradle), make sure you have the following lines:

    // build.gradle (Project: My_Application) in Android Studio

plugins {
  id 'com.android.application' version '8.0.2' apply false
  // ...

  // Add the dependency for the Google services Gradle plugin
  id 'com.google.gms.google-services' version '4.3.15' apply false
}

  3. In your module (app-level) Gradle file (<project>/<app-module>/build.gradle), add the Firebase Cloud Messaging dependency:

    // build.gradle (Module :app) in Android Studio

plugins {
    id 'com.android.application'
    // ...

    // Add the Google services Gradle plugin
    id 'com.google.gms.google-services'
}

dependencies {
    // Import the Firebase BoM
    implementation platform('com.google.firebase:firebase-bom:32.1.1')

    // ...
}

Full official instructions can be found in Firebase Cloud Messaging Android guide.

How to use Push.Express SDK in your Android Studio project

You should already have all prerequisites from previous steps!

Push.Express SDK dependencies should be added to your project and you should have ready Push.Express App, see main guides first.

Add required code

  1. Get your PUSHEXPRESS_APP_ID from Push.Express account page

  2. Add code to your Android Studio app

    import com.pushexpress.sdk.main.SdkPushExpress

const val PUSHEXPRESS_APP_ID = "####-######"

class MainActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)

        SdkPushExpress.initialize(PUSHEXPRESS_APP_ID)
        SdkPushExpress.setExternalId("<some_external_id>") // optional
        SdkPushExpress.activate() // Don't forget to activate SDK workflow!

        Log.d("Myapp", "App Instance Token: " +
                SdkPushExpress.getInstanceToken())
        Log.d("Myapp", "App External ID: " +
                SdkPushExpress.getExternalId())
    }
}

  3. Ask for notification permissions

    // ...
import android.content.pm.PackageManager
import android.os.Build
import android.widget.Toast
import androidx.activity.result.contract.ActivityResultContracts
import androidx.core.content.ContextCompat

class MainActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)

        // ...
        askNotificationPermission()
    }

    private val notificationPermissionLauncher = registerForActivityResult(
        ActivityResultContracts.RequestPermission()
    ) { isGranted: Boolean ->
        if (isGranted) {
            Toast.makeText(this, "Notifications permission granted", Toast.LENGTH_SHORT)
                .show()
        } else {
            Toast.makeText(
                this,
                "FCM can't post notifications without POST_NOTIFICATIONS permission",
                Toast.LENGTH_LONG
            ).show()
        }
    }

    private fun askNotificationPermission() {
        // This is only necessary for API Level > 33 (TIRAMISU)
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU) {
            if (ContextCompat.checkSelfPermission(this,
                    android.Manifest.permission.POST_NOTIFICATIONS) ==
                PackageManager.PERMISSION_GRANTED
            ) {
                // FCM SDK (and your app) can post notifications.
            } else {
                // Directly ask for the permission
                notificationPermissionLauncher.launch(
                    android.Manifest.permission.POST_NOTIFICATIONS)
            }
        }
    }
}

Obfuscation

You can obfuscate your app with standard minifyEnabled true, but if you want more uniq app code, follow the guide below =)

Step 1. Prerequisites

You will need to integrate your Push.Express account with Firebase.

  1. Follow Push.Express integration guide

  2. Create or use existing app in Android Studio

  3. Follow Firebase Cloud Messaging integration guide

Step 2. Download full SDK repo

  1. Download pushexpress-android-sdk.zip

  2. Unzip and rename directory to pushexpress-android-sdk

  3. Place pushexpress-android-sdk near your app dir, for example

./
  \- MyApplication
  \- pushexpress-android-sdk

Step 3. Obfuscate SDK locally

You need Linux (Ubuntu) or MacOS, it will not work on Windows out of the box!

Open Terminal app and do next steps.

  1. Ensure you have installed Perl, coreutils find and xargs commands

    which perl && which find && which xargs && echo "OK"

  2. In local SDK dir (pushexpress-android-sdk) run obfs.pl script

    cd pushexpress-android-sdk
./scripts/obfs.pl

  3. Get new SDK package name, use it in next steps instead of 'com.sdk.pushexpress'

You need to do this step for each app, so you need to have separate local SDK copy for each app!

But you don't need (and it is really bad) to repeat this step if you just want to update your app.

Step 4. Add local SDK dependency

  1. In your settings.gradle add path to local SDK

    // settings.gradle (Project Settings) in Android Studio

include ':sdkpushexpress'
project(':sdkpushexpress').projectDir = new File('../pushexpress-android-sdk/sdkpushexpress')

  2. In your module (app-level) Gradle file (<project>/<app-module>/build.gradle), add the SDK dependency

    // build.gradle (Module :app) in Android Studio

dependencies {
    ...
    implementation project (":sdkpushexpress")
}

  3. Run File->Sync Project with Gradle files in Android Studio

Step 5. Add required code

See How to use Push.Express SDK in your Android Studio project

Step 6. Enable project obfuscation

  1. Enable R8.fullMode in your gradle.properties

    # Project-wide Gradle settings
...
android.enableR8.fullMode=true

  2. In your module (app-level) Gradle file (<project>/<app-module>/build.gradle), enable obfuscation (minifyEnabled true)

    // build.gradle (Module :app) in Android Studio
android {
    ...
    buildTypes {
        release {
            minifyEnabled true
    ...

Step 7. Build and try to send push

  1. Select Release build variants for your app and SDK (don't forget to sign you app)

  2. Build->Clean Project

  3. Build->Build bundle(s) / APK(s)->Build APK(s)

  4. Check obfuscation with decompiler, for example, jadx

    cd ./MyApplication/app/build/outputs/apk/release/
jadx app-release.apk

grep -ril 'pushexpress' app-release/
find app-release/ -iname '*pushexpress*'

# you should see no files here

Now you can try to send push in you local device or emulator, make sure all works as expected.

Step 5. Build and try to send push

Use Push.Express Documentation to learn how to view app installs on your devices and send notifications.

PreviousPWANextSwift

Last updated