1.1.0 Pre Release 6

Nuget

• Common UIControls
  • Nuget package here.
• TV.UIControls
  • Nuget package here.

Enhancements

• [CommonUI] Added AllowShadowClipping to ShadowFrame (#91)
• [CommonUI] Update docs to add Tizen.Theme.Common to reference (#88)

1.1.0 Pre Release 5

Nuget

• Common UIControls
  • Nuget package here.
• TV.UIControls
  • Nuget package here.

Important Notice 📢

• Introduce to Tizen.Theme.Common (Common UI) 🎉
  • The Tizen.Theme.Common has been newly added to provide advanced UI controls (such as ContentButton, ContentPopup, ShadowFrame and so on) that can be used in common (not present in the UX of a specific product).
  • For this reason, the common UI controls that were provided in the existing TV.UIControls are deprecate and can be used through the Tizen.Theme.Common. See below for detailed changes.

Getting Started with Tizen.Theme.Common

1. How to Init
   It is same as initializing the Tizen.TV.UIControls.

CommonUI.Init(app);

// Or, you can use InitOptions as followings. 
// Make sure that Tizen.Theme.Common.InioOptions. (not Tizen.TV.UIControls.InitOptions)
CommonUI.Init(new InitOptions(app));

2. Load the common theme
   If you want each control to be applied in the look & feel defined in the common theme file, load it as below.

CommonUI.AddCommonThemeOverlay();

⚠️ To make it work properly, CommonUI.AddCommonThemeOverlay() should be called after other's Init including Forms.Init() and UIControls.Init().

⚠️ If you want the look and feel of the basic control to be defined according to the platform/product theme rather than the common theme, you can omit CommonUI.AddCommonThemeOverlay().

Deprecated APIs Migration Guide ⚡ ⚡ ⚡

The following classes are deprecate from Tizen.TV,UIControls 1.1.0, and no longer be supported in the future.
Instead, these are provided through the Tizen.Theme.Common. Please refer to the migration guide below for details.

• Tizen.TV.UIControls.Forms.AnimatablePage → Tizen.Theme.Common.AnimatablePage
• Tizen.TV.UIControls.Forms.AnimatedContentPage → Tizen.Theme.Common.AnimatedContentPage
• Tizen.TV.UIControls.Forms.AnimatedNavigationPage → Tizen.Theme.Common.AnimatedNavigationPage
• Tizen.TV.UIControls.Forms.ContentButton → Tizen.Theme.Common.ContentButton
• Tizen.TV.UIControls.Forms.ContentPopup → Tizen.Theme.Common.ContentPopup
• Tizen.TV.UIControls.Forms.ContentPopupManager → Tizen.Theme.Common.ContentPopupManager
• Tizen.TV.UIControls.Forms.EmbeddingControls → Tizen.Theme.Common.EmbeddingControls
• Tizen.TV.UIControls.Forms.EmbeddingControlsConverter → Tizen.Theme.Common.EmbeddingControlsConverter
• Tizen.TV.UIControls.Forms.FileMediaSource → Tizen.Theme.Common.FileMediaSource
• Tizen.TV.UIControls.Forms.FileMediaSourceConverter → Tizen.Theme.Common.FileMediaSourceConverter
• Tizen.TV.UIControls.Forms.FocusFrame → Tizen.Theme.Common.FocusFrame
• Tizen.TV.UIControls.Forms.GridView → Tizen.Theme.Common.GridView
• Tizen.TV.UIControls.Forms.GridViewItemFocusedEventArgs → Tizen.Theme.Common.GridViewItemFocusedEventArgs
• Tizen.TV.UIControls.Forms.IContentPopupRenderer → Tizen.Theme.Common.IContentPopupRenderer
• Tizen.TV.UIControls.Forms.IGridViewController → Tizen.Theme.Common.IGridViewController
• Tizen.TV.UIControls.Forms.IPlatformMediaPlayer → Tizen.Theme.Common.IPlatformMediaPlayer
• Tizen.TV.UIControls.Forms.IVideoOutput → Tizen.Theme.Common.IVideoOutput
• Tizen.TV.UIControls.Forms.MediaPlayer → Tizen.Theme.Common.MediaPlayer
• Tizen.TV.UIControls.Forms.MediaSource → Tizen.Theme.Common.MediaSource
• Tizen.TV.UIControls.Forms.MediaSourceConverter → Tizen.Theme.Common.MediaSourceConverter
• Tizen.TV.UIControls.Forms.MediaView → Tizen.Theme.Common.MediaView
• Tizen.TV.UIControls.Forms.OverlayMediaView → Tizen.Theme.Common.OverlayMediaView
• Tizen.TV.UIControls.Forms.OverlayPage → Tizen.Theme.Common.OverlayPage
• Tizen.TV.UIControls.Forms.PlaybackState → Tizen.Theme.Common.PlaybackState
• Tizen.TV.UIControls.Forms.UriMediaSource → Tizen.Theme.Common.UriMediaSource

New Controls 🎉

[CommonUI] ShadowFrame (#87)

• ShadowFrame is a Frame that allows you to customize the border and shadow related properties.

Property	Description	Remark
CornerRadius	Each individual corner's radius.	Frame.CornerRadius is ignored.
BorderWidth	The width of frame border.	The default value is 1.0.
ShadowColor	The color of shadow.	The default value is #3E000000.
ShadowOpacity	The opacity of shadow.	The default value is 0.24.
ShadowBlurRadius	The radius of shadow blur effect.	The default value is 10.0.
ShadowOffsetX	The x-axis offset of shadow.	The default value is 0.0.
ShadowOffsetX	The x-axis offset of shadow.	The default value is 8.0.

⚠️ Make sure that in order to use ShadowFrame, you must set UseSkiaSharp to true when Forms.Init().

var option = new InitializationOptions(app)
{
     //Using DP without device scaling mode
    DisplayResolutionUnit = DisplayResolutionUnit.DP(),
    UseSkiaSharp = true
};
Forms.Init(option);

Enhancements

• [CommonUI] Added the ShadowFrame (#87)
• [CommonUI] Allows Pressed Visual sTate to ContentButton (#86)
• [Common UI] Added Tizen.Theme.Common project (#83)
• [TV UI] Supports IsPreviousPageVisible to AnimatedNavigationPage (#82)
• [TV UI] Remove unused GridViewOrientation (#81)

1.1.0 Pre Release 4

Nuget package here.

Important Notice 📢

• Update the version of referenced Xamarin.Forms version to 5.0.0.1829-pre6

New Controls 🎉

- GridView (#59)

• API Refernce

- AnimatedNavigationPage and AnimatedContentPage (#77)

• Developers Guide
• API Refernce

Enhancements

• Add ItemFocused event in RecycleItemsView (#67)
• Support DRM-protected content playback (#69)

  Make sure that the http://developer.samsung.com/privilege/drmplay privilege is required if you want to start DRM-pretected content playback.

• Update FocusFrame to handle focused event on descendants view (#74)
• Add gengrid item full style theme in tizen-tv-ui-controls-theme (#75)

Bug Fixes

• Fix default focused item index on RecycleItemsView (#72)
• Fix target file to support theme for all api level (#76)

1.1.0 Pre Release 3

Nuget package here.

Bug Fixes

• Load target file(.target) and theme file(.edj) correctly (#70)

1.1.0 Pre Release 2

Nuget package here.

Important Notice 📢

• Opt-in Init has been supported.

Legacy :

TVUIControls.Init();
Form.Init(app);
// Should set MainWindowProvider for MediaPlayer
UIControls.MainWindowProvider = () => app.MainWindow; 

New way :

Forms.Init(app);
// UIControls.Init() should be called after Forms.Init() 
// No MainWindowProvider required for MediaPlayer
UIControls.Init(new InitOptions(app));

New Controls 🎉

- Focus Frame (#63)

• Developers Guide
• API Refernce

- Content Button (#65)

• Developers Guide
• API Refernce

- Content Popup (#68)

• Developers Guide
• API Refernce

Enhancements

• [RecycleItemsView] Add ItemFocused event in RecycleItemsView (#67)
• TV UI Theme (*.edj) has been added (#68)

1.1.0 Pre Release 1

Nuget package here.

Important Notice

• Update the version of referenced Xamarin.Forms version to 4.4.0.991537 (#55)

Enhancements

• [RecycleItemsView] Optimize and refactoring for new feature (#47)

Issues Fixed

• Fix Interop related issues on TV product (#53)
• [InputEvents] Considering modal page when event is delivered (#50)

1.0.0

Nuget package here.

Important Notes

• Both Tizen.TV.UIControls.Forms.Renderer.UIControls.PreInit() and Tizen.TV.UIControls.Forms.Renderer.UIControls.PostInit() are no longer used. Please use Tizen.TV.UIControls.Forms.UIControls.Init() instead.

Issues Fixed

• Fix OverlayViewRenderer issue (#39)
• Simplify registration process (#40)
• Fix MediaSourceConverter correctly
• Fix state transition of PlaybackCompleted (#42)

1.0.0 Pre Release 2

Nuget package here.

Important Notes

• Issues have been resolved.
• DrawerLayout API has been introduced.
• Default renderers for Entry and Editor are added to fix issues on TV.

1.0.0 Pre Release 1

Nuget package here.

Important Notes

• MediaPlayer API has been introduced.
• RecycleItemsView API has been introduced.
• RemoteControl API has been introduced.