samsung / cordova-sectv-orsay

cordova-sectv-orsay` is an TV application library that allows for Cordova-based projects to be built for the Legacy Samsung Smart TV (A.K.A Orsay) Platform.

cordova-sectv-orsay

cordova-sectv-orsay is an application library that allows for Cordova-based projects to be built for the Legacy Samsung Smart TV (A.K.A Orsay) Platform. Cordova based applications are, at the core, applications written with web technology: HTML, CSS and JavaScript.

Supported Platform

• Legacy Samsung Smart TV (sectv-orsay)

Supported cordova plugins

There are 3 cordova plugins which are supported on TOAST

• cordova-plugin-device
• cordova-plugin-globalization
• cordova-plugin-network-information

If you want more details, please refer Supported Cordova Plugin

Project Structure

    ./
     |-cordova-js-src/ .... cordova-js sectv-orsay platform implementation
     |  |-plugin/ ......... cordova plugin implementations
     |  |-exec.js ......... cordova/exec module
     |  `-platform.js ..... cordova/platform module having platform definition and bootstrap
     |-www/ ............... Project template for Orsay platform
     |-package.json ....... NPM package configuration
     '-README.md .......... this file

How to Build

This section describes the build process which creates cordova.js file for the sectv-orsay cordova platform. Please see Cordova-js for more detail of compile task.

1. Clone the Cordova-js project as sibling of this project.

   $ git clone https://github.com/Samsung/cordova-sectv-orsay.git
   $ git clone https://github.com/apache/cordova-js.git

   Repositories will be created like below directory structure.

   ./
    |-cordova-js
    `-cordova-sectv-orsay
   

2. Add "sectv-orsay" as a target of "compile" task on Gruntfile.js in the cordova-js project.

   ...
   grunt.initConfig({
       pkg: grunt.file.readJSON('package.json'),
       "compile": {
           ...,
           "sectv-orsay": {}
       },
       "compile-browserify": {
       ...
   });

3. Add "sectv-orsay" property to "cordova-platforms" object in the cordova-js project's package.json with path to this project's repository as its value.

   "cordova-platforms": {
       ...,
       "cordova-sectv-orsay": "../cordova-sectv-orsay"
   }

4. In the cordova-js directory's root, run below command to create cordova-js/pkg/cordova.sectv-orsay.js file.

   $ grunt compile:sectv-orsay

5. We recommend to copy the created file to the www directory which is including Orsay Application project templates for further use. In the cordova-js directory:

   $ cp ./pkg/cordova.sectv-orsay.js ../cordova-sectv-orsay/www/cordova.js

How to use

For creating application package for Orsay TV:

1. Copy your Cordova project's www directory which includes your application implementation to a new directory for the orsay project.

   Assuming we've developed a Cordova project named as "MyProject" and it is located as a sibling of cordova-sectv-orsay.

   ./
    |-cordova-js
    |-cordova-sectv-orsay
    `-MyProject
      |- platforms
      |- plugins
      |- www
      |  |- index.html
      |  `- ...
      `- config.xml
   

   $ cd MyProject
   $ cp -rf ./www ./orsayprj

2. Create the Orsay config.xml file in the orsay project.

3. Copy the built cordova-js/pkg/cordova.sectv-orsay.js to your new orsay project root with name cordova.js.

   $ cp ../cordova-js/pkg/cordova.sectv-orsay.js ./orsayprj/cordova.js

4. Zip the orsay project directory to package.

   $ zip -r MyProject_sectv-orsay.zip ./orsayprj

• We recommand to use the grunt-cordova-sectv Grunt task to automate these process.

Known Issues

Not yet

cordova-sectv-orsay's Issues

Request contribution for regular release until February 29

Dear Developers,

Regular release of TOAST is scheduled as v1.1.0 in March 14.
We will include source code which is contributed until February 29.
If you are in preparation for contribution, please apply your source code on time.

Thank you.

Toast build for orsay not working

I create an application for smart tvs with TOAST project. During the development I test everything with tizen emulator and tizen studio and everything was fine.
After finishing development I tried to run the application on both orsay TV and orsay emulator and unfortunatly there was a lots of issue in that platform. I fixed some issues in design but I can't fix the main issue.
When I run the application, There is a line in console that say : deviceready has not fired after 5 seconds. And I can't use any of the TOAST api functionalities.
I create an empty project and do exactly what this page say: https://github.com/Samsung/cordova-plugin-toast#prepare-to-start
But again I got the same error. Please help me.
Here is the log:

cordova/platform: orsay bootstrap BEGIN            cordova.js:1365
adding proxy for NetworkStatus            cordova.js:887
adding proxy for Console            cordova.js:887
adding proxy for Device            cordova.js:887
adding proxy for Globalization            cordova.js:887
cordova/platform: orsay bootstrap END            cordova.js:1460
adding proxy for toast.inputdevice            cordova.js:1880
return Window             cordova.js:1880
adding proxy for toast.tvwindow            cordova.js:1880
return Window             cordova.js:1880
adding proxy for toast.tvchannel            cordova.js:1880
adding proxy for toast.tvaudiocontrol            cordova.js:1880
adding proxy for toast.drminfo            cordova.js:1880
adding proxy for toast.application            cordova.js:1880
adding proxy for toast.Media            cordova.js:1880
Failed to load resource: fail to read a resource form decryptied file            file:///home/smarttv/Apps/xThreeApp/cordova_plugins.js
deviceready has not fired after 5 seconds.            cordova.js:1880
Channel not fired: onNativeReady            cordova.js:1880
Channel not fired: onCordovaReady            cordova.js:1880
Channel not fired: onCordovaConnectionReady            cordova.js:1880
Channel not fired: onCordovaInfoReady            cordova.js:1880