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, Single panel apps, and Edge feed apps can be independent of (standalone apps) or associated with an Android app (companion apps).  Edge Immersive panel apps must be part of an Android app.
 

For standalone Edge apps:

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

For companion Edge apps of an associated Android app:

  • Each APK:
    • Can contain 1 or more Edge panels or feeds.
    • Must contain Edge panels or feeds of the same type: Edge Single Plus panels, Edge Single panels, or Edge feeds.
    • Must contain the Android app.
    • Is freely or commercially distributed as 1 product in app stores.
       
  • 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 launched only by the user (not by the Android app or other apps).
       

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

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

 

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 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:
        • Each Edge app extend the Android BroadcastReceiver class in order to manage Edge broadcasts.
        • Your Edge app have a single depth (default setting).
        • You do not mix the following Edge apps in 1 APK:
          • Edge panel apps with a 160-pixel panel width
          • Edge panel apps with panel widths that are 550 pixels or less and is not 160 pixels.

            Caution:  If an Edge or Android APK contains a mix of those Edge panel apps: 
            • In devices with an Android OS prior to Marshmallow (M), only the apps with 160 pixel screens will be available to the user after they download the APK.
            • 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 after they download the APK.
               
    • 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:
    • Must specify
      • API level 23 for minSdkVersion and targetSdkVersion.
      • A panel width that is 550 pixels or less and is not 160 pixels.
      • A receiver intent filter with: android:name= "com.samsung.android.cocktail.v2.action.COCKTAIL_UPDATE"
  • Edge Single panel apps:
    • Must specify:
      • API level 21 for minSdkVersion and targetSdkVersion.
      • A panel width of 160 pixels
      • A receiver intent filter with: android:name= "com.samsung.android.cocktail.v2.action.COCKTAIL_UPDATE"
         
  • Edge feed apps:
    • Must specify:
      • API level 21 for minSdkVersion and targetSdkVersion.
      • A receiver intent filter with:
        android:name= "com.samsung.android.cocktail.action.COCKTAIL_UPDATE"
      • Essential metadata with: category=‘feeds’
         
    • 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 support your Edge app, the user device must:

  • Be an Edge device, which has a curved Edge screen on either: one side (Samsung Note Edge device), or on two sides (Samsung S8+, S8, S7, S6+, and S6 Edge devices).  
    Note:  For Samsung S6+ and S6 devices, the device OS determines which type of Edge apps are supported.
  • Have the Look package installed.
     

For devices with 2 curved Edges, the user can configure which side is 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.
 

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

  Note 4 Edge S6+ or S6
OS < L
S6+ or S6
OS L 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?