Welcome to Developing for Edge 04/06/2017

Transcription

1 Welcome to Developing for Edge 04/06/2017

2 A few housekeeping items: If you have any questions for the presenters, please post them in the Q&A box and we will answer them at the end of the presentation. If you have any technical issues during the webinar, please send a comment to the Q&A box for assistance. This session is being recorded and will be shared with the presentation slides on the Samsung Developer webpage: And please don t forget to provide feedback before you leave the session. Your feedback is critical to ensure that we improve these webinars.

3 Developing for Edge By Ashutosh Sharma Samsung Developer Program SEA- Content & Services Mountain View, CA The information in this presentation is offered only for general informational and educational purposes. These materials are intended, but not promised or guaranteed to be complete, or up-to-date and should in no way be taken as an indication of future results Samsung Electronics America Inc.

4 How can we help you? Dev Support Team based in Mountain View, CA supports you and your Android and Tizen projects: Samsung Android Galaxy SDKs (Edge Look) Theme Editor Watch Face Editor. Tizen Wearable SDK Submission and promotion of your apps Join the Samsung Developer Program for free at Log in and submit support or promotion requests Feedback: Ashutosh Sharma to

5 Upcoming Webinars Area Subject Date Description Galaxy S8/S8+ Gear VR Controller Samsung DeX Overview of Samsung Galaxy S8/S8+ Take Control: Developing for The Gear VR controller Extend your productivity: creating Samsung DeX Compatible Apps April 20 April 28 May 11 Possibilities with services and SDK available with Galaxy S8/S8+ devices Overview of Gear VR controller How to make your make DeX compatible

6 Introduction What is a Edge application? Android edge apps are special widget that makes our Android View system more Useable, Intuitive and Visual.

7 Samsung Edge Store

8 Samsung Edge Devices and Market

9 Edge Devices Currently there are below Edge devices available in market. Samsung Galaxy S8 and S8+ Samsung Galaxy S7 Edge Samsung Galaxy S6 Edge and S6 Edge+ Samsung Galaxy Note 4 Samsung Edge Active series devices

10 Top 20 Edge panels are getting 60k monthly downloads only 105 Edge panels available resulting in a high attach ratio BILD Newsticker CNN for Samsung Edge Panel CNN for Samsung Edge Panel CNN Newsstream for Samsung Edge Bar Data Usage Panel DataUsagePanel Edge+ News EdgeBoard EdgeTaskManager Everything Edge Gismeteo lite LOL Friends Panel app for Facebook Ram Usage Manager Panel Ram Usage Panel RSS Feeds for Edge S Note widget for Edge S Planner widget for Edge Widget edge panel The average of cumulative downloads of top 20 Edge panels since between April and August 2016: 239,000/installs in 4 months = 60k installs a month! Worst performer: 1k/day Best performer: 4.7k/day

11 Edge banner promotion typically increases daily downloads 4-5x 5x

12 Case study: Edge panel increased daily downloads of the main app downloads 10x 2. Edge panel released 1. Main app released in Galaxy apps 2. 10x increase in main app downloads

13 Potential Market Global addressable Edge device market: 42M+. Until now, Samsung flagship devices were released in both flat and Edge versions. Now, ALL of the latest S8 and S8+ devices are Edge versions. Currently there are less than 200 Edge apps on the market. Each of your Edge apps will have a large share of a huge market.

14 Look Edge Architecture The Look architecture consists of: Applications: One or more application that uses Look. Slook SDK: Look UI components. View System: Android framework view system.

15 Type of Edge Apps Edge Single Mode Edge Single Plus Mode Edge Feeds Mode Edge Immersive Mode (will be deprecated in N)

16 Edge (Look) SDK : Content Docs > Programming Guide_Look_Edge.pdf Libs > look_v1.4.0.jar and sdk-v1.0.0.jar Samples > Look > EdgeScreen Tools > edge_simulator_v1.4.0 > edge_simulatorv1.4.0.apk edge_simulator_v1.4.0.jar How_to_use_the_Edge_Simulator.pdf

17 App Type: Edge Single Plus (Panel) Edge Single Plus mode is similar with Edge Single Mode, but can provide many contents using the wide UI. Edge(Look) v1.4.0 supports the options where you can define the variable width and API which can describe the Edge Single Plus mode. Edge Single Plus mode is supported in Galaxy Edge devices operating on Android M and N.

18 App Type: Edge Single Edge Single Plus mode is similar with Edge Single Mode, but can provide many contents using the wide UI. Edge(Look) v1.4.0 supports the options where you can define the variable width and API which can describe the Edge Single Plus mode. Note: Single Mode(160 px) will be hidden automatically if App support Single Plus Panel.

19 App Type: Edge Feeds If users swipe upwards and downwards on the Edge screen when the screen is off. When the users tap the contents in the feed, the connected link is shown. The feed is displayed only within the timeout settings and if there is no interaction on the feed, the feed disappears after the timeout. Unavailable on Galaxy S8 and S8+

20 App Type: Edge Immersive You can use the extra edge screen as a sub-window for the main activity to offer wider views. A screen with a 16:10 expanded view is provided. This is visible while a specific Application is running, or in a specific screen of the Application and once you get out of the screen or application, this automatically disappears. Note: Edge immersive is longer supported for new devices because of usability issues. So far the only supported device is Note 4.

21 Look SDK: Components Components look-v1.4.0.jar sdk-v1.0.0.jar Imported packages: com.samsung.android.sdk.look The following permission has to be specified in the AndroidManifest.xml file to initialize Look. <uses-permission android:name= "com.samsung.android.providers.context.permission.write_use_app_feature_survey"/>

22 Initializing Look SDK The Slook.initialize() method: Initializes the Look package. Checks if the Look libraries are installed on the device. Checks if the device is a Samsung device. SsdkUnsupportedException.VENDOR_NOT_SUPPORTED Checks if the device supports the Look package. SsdkUnsupportedException.DEVICE_NOT_SUPPORTED

23 Type of Edge App Supported We can check if a Look package feature is supported on the device using the isfeatureenabled() method. The feature types are defined in the Slook class. The feature type is passed as a parameter when calling the isfeatureenabled() method. The method returns a Boolean value that indicates the support for the feature on the device. Boolean isfeatureenabled(int type); The following types are defined as constants in the Slook class: COCKTAIL_BAR (Edge Feeds) COCKTAIL_PANEL (Edge Single Plus, Single, Immersive)

24 Edge Single Mode o o o Edge Single mode which operates as a stand-alone. You can use Edge single in the Edge(Curved) screen while using an application in the main screen. For this mode, you have to use the COCKTAIL_PANEL feature.

25 o o o o Edge Single Plus Mode Edge single plus mode is similar with Edge Single but with wide UI. In order to use Edge Single plus mode, you should define com.samsung.android.cocktail.v2.action.cocktail_update as the intent-filter of Provider. For this mode, you have to use the COCKTAIL_PANEL feature. For compatibility, be certain to declare 23 (Android 6.0) as API Level in the minsdkversion attribute.

26 Edge Feeds Mode o o o o o Edge Feeds mode is another kind of Edge Single mode. If you want to implement an Edge Feeds mode, you should define feeds in the category attribute of the cocktail-provider. Implementation is similar with Edge Single mode. Edge Feeds mode can be activated during screen off (for Overlaid Edge Device). For this mode, you have to use the COCKTAIL_PANEL feature, too.

27 Implementing Edge Apps

28 Declaring a cocktail provider in Manifest In order to add an Edge Single Mode, Edge Single Plus Mode or Edge Feeds Mode in the Edge(curved) screen area, you need to add the receiver and metadata for your cocktail provider in the AndroidManifest.xml file. For Edge Single and Edge Feeds Mode <receiver android:name=".edgesingleprovider" > <intent-filter> <action android:name= "com.samsung.android.cocktail.action.cocktail_update" /> </intent-filter> <meta-data android:name="com.samsung.android.cocktail.provider" android:resource="@xml/edge_single"> </receiver>

29 Declaring a cocktail provider in Manifest Cont. For Edge Single Plus <receiver android:name=".edgesingleplusprovider" > <intent-filter> <action android:name= "com.samsung.android.cocktail.v2.action.cocktail_update" /> </intent-filter> <meta-data android:name="com.samsung.android.cocktail.provider" android:resource="@xml/edge_single_plus"> </receiver> The <meta-data> element specifies the CocktailProviderInfo resource and requires the following attributes. For merged application with main and edge app combined don t add these tag to manifest file: android:name specifies the metadata name. Use com.samsung.android.cocktail.provider to identify the data as the CocktailProviderInfo descriptor. android:resource specifies the CocktailProviderInfo resource location.

30 Adding CocktailProviderInfo Metadata label specifies the name of the Edge App. description specifies the description of the the Edge App. previewimage shows a preview of what the the Edge App that will look like after being enabled. updateperiodmillis defines how often the Edge Framework should request an update from the SlookCocktailProvider by calling the onupdate() callback method. The actual update is not guaranteed to occur exactly on time with the defined value and it is not suggested to update it frequently not more than once an hour.

31 Adding CocktailProviderInfo Metadata- Cont. permitvisibilitychanged if it is set to true, the onvisibilitychanged of the SlookCocktailProvider is called when the Edge App is shown. configure Configuration Activity for the App, which can be launched from Edge(curved) screen setting. category defines the category as feed for Edge Feeds Mode. cocktailwidth defines the width of Edge Single Plus Mode. If you use the attribute, your provider should use com.samsung.android.cocktail.v2.action.cocktail_update as the intent filter. launchonclick defines the button of Edge Single Plus Mode. You can set a button on Edge Single Plus Mode, launching the main activity you want. If you use the attribute, your provider should use com.samsung.android.cocktail.v2.action.cocktail_update as the intent filter.

32 Implementing a class extending SlookCocktailProvider onupdate(context, SlookCocktailManager, in[]) This method is called when the data on Edge Single Mode, Edge Single Plus Mode or the Edge Feeds Mode gets update. If necessary, it should perform the essential setup, such as defining event handlers for views and starting a temporary Service.

33 Implementing a class extending SlookCocktailProvider onenabled(context) This method is called when the Edge App is created for the first time. If you need to open a new database or perform setup, then this is a good place to do it. ondisabled(context) This method is called when the instance of your Edge App is deleted from the enabled list. This is where you should clean up any work done in onenabled(context), such as delete a temporary database. onreceive(context, Intent) This method is called for every broadcast and before each of the above callback methods. onvisibilitychanged(context, int, int) This method is called when the visibility of the Edge App is changed. If the visibility is COCKTAIL_VISIBILITY_SHOW, the state of the Edge App is shown. At that time, if you want to refresh your Edge Apps, you should call updatecocktail with a new RemoteViews. If you want the callback method called, you have to define permitvisibilitychanged to true in the CocktailProviderInfo

34 Updating RemoteViews with SlookCocktailManager Instance The RemoteViews object can support the following layout classes: FrameLayout LinearLayout RelativeLayout GridLayout Button ImageButton ImageView ProgressBar TextView ViewFlipper ListView

35 SlookCocktailManager APIs static SlookCocktailManager getinstance(context) Get the SlookCocktailManager instance to use for the supplied context object. void updatecocktail(int id, RemoteViews view) Set the Remoteviews to use for the specified cocktail ID. void notifycocktailviewdatachanged(int id, int viewid) Notifies the specified collection view in the specified Cocktail instance. int[] getcocktailids(componentname provider) Get the cocktailids that have been bound to the given Cocktail provider. void setonpullpendingintent(int id, int viewid, PendingIntent pendingintent) Set pull to refresh interaction for specified view to notify invalidate their data.

36 SlookCocktailManager APIs Cont. void setonlongclickpendingintent(remoteviews rv, int viewid, PendingIntent longclickpendingintent) Set long click pending intent to specified view in RemoteViews. void setonlongclickpendingintenttemplate(remoteviews rv, int viewid, PendingIntent pendingintenttemplate) Set long click pending intent template to specified collections in RemoteViews. void updatecocktail(int id, RemoteViews contentview, RemoteViews helpview) Set the content view and help view to use for the specified cocktail ID. Below layout support for helpview. FrameLayout LinearLayout RelativeLayout GridLayout Button ImageButton ImageView ProgressBar TextView ViewFlipper.

37 Use pull to refresh interaction Slook SDK v1.4.0, you can easily add pull to refresh interaction on your edge panel by setonpullpendingintent API. After set pull to refreshing target view, it will be added on SwipeRefreshLayout and it send registered pendingintent with pulling gesture on target view. The target view of SetOnPullPendingIntent API is available for panel contentview not for panel helpview. Note :- This API can only be accessed on Android N onwards

38 Set long click pending intent Similar with RemoteViews.SetOnClickPendingIntent API you can set a pending intent to launch with long clicking on your edge panel. This is supported from SDK v If long click target view using collections (e.g. ListView, GridView etc.) you can set a pendingintent template instead set them on each items of collections individually.

39 Continued.. To work pendingintent template you need to set fillinintent on its item views, and it should set on root view of item layout. setonlongclickpendingintenttemplate works base on AdapterView.setOnItemLongClickListener. It could be restricted on some collections widgets such as StackView and AdapterViewFlipper.

40 Categories for Edge specials in Galaxy Apps Metadata should be defined in AndroidManifest.xml to register Edge specials in GalaxyApps. The <meta-data> element specifies the search filter which requires the following attributes: Don t add below tags if your app is combined main app and edge app into one APK. android:name specifies the metadata name. Use com.samsung.android.cocktail.mode to identify the categories on the GalaxyApps. android:resource specifies the Edge Mode for GalaxyApps

41 How to use simulator for Edge App Using Simulator 1. Install simulator (edge_simulator_1.4.0.apk) to android virtual device or any android device. [Virtual device configuration : Nexus "" 1440x dpi, M OS] 2. Create the edge application with Simulator SDK (edge_simulator_1.4.0.jar). 3. Run and debug your edge application in the simulator (edge_simulator_1.4.0.apk). 4. If app is using ListView then follow below steps. Define shareduserid com.samsung.android.cocktailbar in Manifest.xml. Provider metadata file maxwidth and maxheight as 100dp. Add bind-permission to simulator.apk by adb adb shell appwidget package com.samsung.android.cocotailbar user Sign your apk using the key provided in SDK Key Allas: androiddebugkey Key password: android

42 Sample App Demo and Step by Step Guide Sample App Source Code: Sample App Step by Step Guide: More Edge sample Apps:

43 Next Steps How to get started Get this presentation at: Register with Seller office: How can we help you? Register to Samsung Developer Program and submit support or promotion request. I Register to learn more: April 20 th Overview of Samsung Galaxy S8/S8+ More Webinar Resources (available now) Theme Webinar Series Your feedback is greatly appreciated and makes these webinars even better! 43

44