Skip to main content

Getting Started with Push Notification 2.0 Integration

RC's Push 2.0 integration solution (requires IMLib SDK ≧ 5.6.0) encapsulates third-party vendor push channel SDKs into plugins, making it easier for developers to quickly integrate and configure. It is suitable for IMLib, Global IM UIKit, or other RC Android client SDKs that depend on IMLib.

tip

If your app needs to integrate third-party vendor push clients on its own or requires the use of push integrator SDKs (e.g., Getui, JPush, etc.), this integration solution is not applicable. For more details, see Resolving Push Client Conflicts.

Integrating Third-Party Push Services​

Currently, RC's Push 2.0 integration solution (requires IMLib SDK ≧ 5.6.0) has adapted to Xiaomi, Huawei, Honor, Meizu, OPPO, vivo, and FCM push services. Due to restrictions imposed by domestic phone manufacturers, RC's self-built push channel (RongPush) cannot survive on most domestic device models. You can prioritize integrating third-party push services.

Resolving Third-Party Push Client Conflicts​

If your app or other SDKs your app depends on have already integrated third-party push clients, you cannot follow the steps above to integrate RC Push 2.0 SDK, as conflicts will occur.

After completing the configuration in the RC Console as described in Integrating Third-Party Push Services, you need to manually report the third-party vendor push service Token to the RC server. For detailed steps, refer to Resolving Push Client Conflicts.

Integrating RC's Self-Built Push Channel​

RC's self-built push channel (RongPush) is a stable and reliable long-connection channel maintained between the RC client SDK and RC's push service. It is the default push feature of the SDK, providing basic push capabilities without the need for additional third-party libraries.

Once the SDK is initialized and the push feature is enabled, the RC self-built push channel (RongPush) is automatically activated, giving your app basic push capabilities. However, due to restrictions imposed by domestic phone manufacturers, RongPush cannot survive on most domestic device models. It is recommended to integrate third-party push channels simultaneously.

Configure build.gradle.

android {
 defaultConfig {
    //...
    manifestPlaceholders = [
        //Enable rongpush. If RongPush is not needed, it can be disabled
        RONG_PUSH_ENABLE : "true"
    ]
 }
}
dependencies {
    // x.y.z is the current IM SDK version number
    implementation 'cn.rongcloud.sdk.push:rong:x.y.z'
}

Before initializing the SDK, call the following code to initialize the RongPushPlugin module.

RongPushPlugin.init(getContext());
tip

Since RC's default push channel is an application-level push, it is subject to various system permission restrictions. It is recommended to prompt users to enable the corresponding permissions to improve push delivery rates.

Last updated on