Skip to main content
Samsung Developer Program

Edge App Development Overview

Edge app build options and development environment to create Edge panel apps and Edge feed apps.

For details about the Edge API, see the Edge API Structure section.

Edge Development Options

You have several options in developing and distributing your Edge apps, depending on the type of Edge panel or feed.  Edge Single Plus and Single panel apps and Edge feed apps can be: part of, associated with, or independent of an Android app.  Edge Immersive panel apps must be part of an Android app.

For Edge Single Plus panel apps, the Edge Single panel apps, and Edge feed apps:

For standalone Edge apps:

  • Each APK:
    • Is freely or commercially distributed as 1 product in app stores.
    • Can contain 1 or more Edge panels or feeds of the same type: Edge Single Plus panels, Edge Single panels, or Edge feeds.
  • Each Edge panel or feed:
    • Can share content with and launch actions for: the device platform and independent sources.
    • Can be made available and can be launched only by the user (not other apps).
       

For companion Edge apps of an associated Android app:

  • Each APK:
    • Is freely or commercially distributed as 1 product in app stores.
    • Can contain 1 or more Edge panels or feeds of the same type: Edge Single Plus panels, Edge Single panels, or Edge feeds.
  • Each companion Edge panel or feed:
    • Can share content with and launch actions for: the Android app, the device platform, and independent sources.
    • Can made available and can be launched only by the user (not the Android app or other apps).
       

For Edge Immersive apps integrated into an Android app (deprecated):

  • The Android APK:
    • Is freely or commercially distributed as 1 product in app stores.
    • Can contain 1 Edge immersive app (display area).
  • The Edge Immersive panel:
    • Can share content with and launch actions for: the Android app, the device platform, and independent sources.
    • Can only be launched by the associated Android app.

 

Edge App Requirements and Recommendations

For each type of Edge panel or feed app, the following requirements must be met:

  • All types of Edge panel and feed apps:
    • For all Edge apps in any type of APK:
      • All Edge apps must be of the same type.
      • For each Edge app, the project resource directory res/layout/ must specify the Edge app screen layout. 
      • The project resource directory res/xml/ must contain an XML resource file for the type of Edge app.
      • The APK AndroidManifest.xml must contain a  receiver metadata tag that specifies the XML resource file.
      • We recommend that:
        • Your Edge app extend the Android BroadcastReceiver class in order to manage Edge broadcasts.
        • Your Edge app have a single depth (default setting).
           
    • For Edge apps in an Edge APK:
      • When distributing your Edge app via the Galaxy Apps store, the APK AndroidManifest.xml must contain an application metadata tag that specifies the type of Edge app (used by the Galaxy Apps store).
         
    • For Edge apps combined with an Android app in an Android APK:
      • When distributing your Edge app via the Galaxy Apps store, the APK AndroidManifest.xml must NOT contain an application metadata tag that specifies the type of Edge app.
         
  • Edge Single Plus panel apps:
    • Your Edge app must specify API level 23 as the minSdkVersion and targetSdkVersion.
    • Your Edge app receiver's intent filter must specify android:name= "com.samsung.android.cocktail.v2.action.COCKTAIL_UPDATE"
    • User devices must be running Android 6.0 (Marshmallow) or above.
    • For an Edge or Android APK that has more than 1 Edge Single Plus panel app, it is recommended that:
      • The Edge apps EITHER:
        • All have a screen width of 160 pixels.
          OR
        • All have screen widths that are greater than or less than 160 pixels.
      • You do NOT mix Edge apps with screen widths of 160 pixels with other Edge apps with screen widths greater than or less than 160 pixels.

        Caution:  If an Edge or Android APK has Edge Single Plus panel apps with screen widths of 160 pixels AND apps with screen widths greater than or less than 160 pixels: 
        • In devices with an Android OS prior to Marshmallow (M), ONLY the apps with 160 pixel screens will be available to the user.
        • In devices with an Android OS of Marshmallow (M) or later, ONLY the apps with screens greater or less than 160 pixel screens will be available to the user.
           
  • Edge Single panel apps:
    • Your Edge app must specify API level 21 as the minSdkVersion and targetSdkVersion.
    • Your Edge app receiver's intent filter must specify android:name= "com.samsung.android.cocktail.action.COCKTAIL_UPDATE"
    • User devices must be running Android 5.0 (Lollipop) or above. 
       
  • Edge feed apps:
    • Your Edge app receiver's intent filter must specify android:name= "com.samsung.android.cocktail.action.COCKTAIL_UPDATE"
    • Your Edge app must specify API level 21 as the minSdkVersion and targetSdkVersion.
    • Your Edge app essential metadata must specify category=‘feeds’
    • User devices must be running Android 5.0 (Lollipop) or above.
    • We recommend using a black background in order to match the inactive display screen.
       
  • Edge Immersive panels in an Android app (deprecated):

    • The Android app must set a subview.

    • The Android app must specify the panel layout in activity code.
       

User Device Requirements

To display your Edge panel or feed app, the user device must have a curved Edge screen on the right side or on both right and left sides of the device.  If the user device has two curved Edges, the user can configure which side is to be the active Edge side. 

From the active Edge side, users can activate and start the display of Edge Single Plus panels (which take up the entire display screen), and activate and display Edge Single panels and Edge feeds.  Edge Immersive panels are displayed on the active Edge side when the parent Android app displays the panel.

The Look package uses a static Java library that depends on internal Android framework modules.  Therefore, the Look package only runs on devices that support those modules.

To support an Edge app:

  • For all types, the user device must be a Samsung Edge device that has a curved Edge screen on one side (Samsung Note Edge device) or on two sides (Samsung S8+, S8, S7, S6+, and S6 Edge devices).
  • For Samsung S6+ and S6 devices, the device OS determines support.

     

The following types of Edge apps are supported () by Samsung Edge devices.

  Note Edge S6+ or S6
OS < M
S6+ or S6
OS M or >
S7 S8 S8+
Single Plus panels    
Single panels      
Immersive panels          
Feeds      

 

Look Development Environment

The section describes the Look architecture, files, user device requirements, and IDE setup.

Architecture

The Look architecture consists of:

  • Applications: One or more applications that use Look
  • SLookSDK: Look UI components
  • Slook-support
  • View System: Android Framework View System

Look_Overview_Architecture.png

Components

Jar files:

  • look-v1.3.0.jar
  • sdk-v1.0.0.jar

 Imported packages:

  • com.samsung.android.sdk.look
  • com.samsung.android.sdk.SsdkUnsupportedException

Setting Up the IDE

To develop applications for Samsung mobile devices, configure your Android development environment to meet the following requirements. If your development environment is already configured, you can skip this section.

Edge Project Structure and Development

The following is a typical Edge project directory structure and development plan for Android Studio.

      Edge_Project_Directory_Structure.png
 

 

     

    • Was this article helpful?