Skip to main content
Samsung Developer Program

Rich notification development environment

To integrate rich notification into Android™ and Gear companion apps, you will need an understanding of the rich notification architecture and the development environment.

Rich notification architecture

The following figure shows the rich notification architecture:

Rich Notification Architecture Block Diagram

The rich notification architecture consists of:

Applications One or more Android™ apps that use rich notification
Gear Manager Interface between the Android host and remote Gear devices
Goprovider Gear Manager module that forwards rich notifications from the Android device to the Gear device
Samsung Notification Service Service that sends rich notifications from the Android app to the Gear device
Samsung Accessory Service Framework Environment for connecting Android and remote devices

RN development environment

We support Android™ host KitKat 4.4.2 (API 19) or above.

Note: The Android device must be able to connect to the Gear wearable device through the Gear Manager App.

  • Components:
    • Rich notification JAR file (richnotification-v#.#.#.jar)
    • Rich notification SDK client lib JAR file (sdk-v#.#.#.jar)
      To use any Samsung SDK, this lib file must be included.
    • gson-2.2.4.jar or above
  • Rich notification package to be imported:
  • The sending of rich notifications to the Gear device must be properly configured on the Android device:
    • Ensure Gear Manager > Notifications > Limit notifications(Off).
    • For each Android app that can send rich notifications (sender app), ensure Managing Notifications > [Sender app listing] (checkmarked).

To import Rich Notification libraries to your application project:

  1. Add the rich notification JAR, rich notification SDK client lib JAR, and gson JAR files to the libs folder of your Android application in Eclipse:


  1. Add the following permissions to your Android manifest file:
    1. Rich notification needs the following permissions:
      <uses-permission android:name=""/>
      <uses-permission android:name=""/>
    2. If the permissions are not added the initialization will fail withSecurityException
      • For Samsung devices: 
        • Android 4.4.2 (KitKat) and above: SecurityException is thrown and your application does not work.
        • Prior to Android 4.4.2 (KitKat): No exception is thrown and your application will work properly.
      • For other companies: No exception and your application will work properly.
    3. When SrnRemoteBuiltInAction with OperationType.CALL is used, the following permission must be added:
      <uses-permission android:name="android.permission.CALL_PHONE"/>
    4. When SrnRemoteBuiltInAction with OperationType.SMS is used, the following permission must be added:
      <uses-permission android:name="android.permission.SEND_SMS"/>


    • Was this article helpful?