News

From Automotive Grade Linux
Jump to: navigation, search

Summary

News is an HTML5 app presenting summaries of articles from AFP in the categories of Top News, Entertainment and Sports.

Both full-text and summary views feature one-finger touch scrolling utilizing the open source iScroll 4 library (MIT license). Data is retrieved from AppCarousel/Wmode’s XML feeds for each category via jQuery's ajax functionality and translated into HTML on the fly purely on the client side (though XSLT is not used). CSS, including CSS3, is used to style the presentation layer for the Tizen IVI environment.

Resources

Watch News video.

Access the Design Requirements Document (DRD).

Access the Sources.

Download the Application WGT.

What the app does

Features for the News application include the following:

  • Current date and time
  • access to Settings screen
  • summary list view for each category
  • a thumbnail graphic and sample text for each article with datestamp
  • single finger scroll
  • full article view with all three categories across the top

To launch the application the user touches the News button (folded newpaper icon) at the top of the device, or launch through Application Screen.

Once launched, the user can see more articles by via single finger scroll to swipe the list up further. The carrin near the bottom of the screen indicates more articles are available.

The three category headers for Top News, Entertainment, and Sports are near the top of the screen under the current date and time. Touching/tapping another category header will take the user to another summary list view of that category’s articles.

News1.png News2.png

Tapping a summary item’s thumbnail image or headline will take the user to a modal pop-over of the article's full text.

News3.png News4.png

The modal can be dismissed via the persistent close box in the upper right-hand corner.

The user can exit the News application at any time using the return arrow in the lower left corner. 

Technical Details

The sections below are taken from directions for what is known as the Tizen IVI 3.0-M2-EOY (commonly called 'the Jan. 15 image'. The current Tizen release is dated 2014.01.14, and may require some adjustment.

Installation Prerequisites

The following installation directions take the base Tizen image and install needed supporting software

Instructions for debugging WRT Apps on Tizen IVI (installation, removal, and deployment)

Tizen IVI WRT applications are built into widget ('.wgt') files for deployment (a format based on the W3C widget specification, see http://www.w3.org/TR/widgets/ for more information). Once you have built or received the widget files for one or more applications that you wish to deploy and run, the next step is to copy them onto the target device. Common options for this would be tools like scp/sftp (in a Linux/Unix environment), FileZilla (Windows and Mac) or Cyberduck (Mac).

Once the .wgt files have been transferred to the target machine, they may be installed, launched and uninstalled.

To get a list of currently installed applications, use the following command from a terminal (or remote shell/ssh session) on the target hardware (log in as root with the password tizen):

   root:~> wrt-launcher -l

This will produce output similar to the following:

No

Name

Version

GUID

Package ID

App ID

1

saythis

1.0.0

http://yourdomain/sayThis

lYjFlj49Q4

lYjFlj49Q4.saythis

2

Settings

1.0.0

http://yourdomain/Settings

ODBQpKvkS1

ODBQpKvkS1.Settings

3

MediaPlayer

1.0.0

http://yourdomain/MediaPlayer<nowiki>/ | t8j6HTRpuz | t8j6HTRpuz.MediaPlayer |- | 4 | Store | 8.2.4401 | <nowiki>http://com.intel.tizen/store

intelPoc13

intelPoc13.Store

5

Phone

8.2.4399

http://com.intel.tizen/phone

intelPoc15

intelPoc15.phone


If the application you wish to install is not already installed, simply enter (using intelPoc16.HVAC.wgt as an example):

   root:~> wrt-installer -i intelPoc16.HVAC.wgt

If successful, you should see output such as the following:

   ===========================================================
   # wrt-installer #
   # argc [3]
   # argv[0] = [wrt-installer]
   # argv[1] = [-i]
   # argv[2] = [intelPoc16.HVAC.wgt]
   ## wrt-installer : intelPoc16.HVAC installation was successful.
   ===========================================================

If unsuccessful, you may see errors such as 'invalid widget package', 'privilege level violation' or, if the application is already installed (and its widget file was built with a different signature than the one you wish to install), 'invalid signature'. The first two errors are out of scope for this document.

If you see 'invalid signature', and the widget file has to your knowledge been created with a valid signature, the likely cause is a conflict between the signature of the currently installed version and that of the new version. Though both signatures may be valid, the system treats the upgrade of an existing package with a different signature as a security violation. To work around this issue, simply uninstall the application and subsequently install the new version:

    root:~> wrt-installer -un intelPoc16.HVAC      <-- note: use the App ID when unstalling and

the full widget filename when installing

If the uninstall is successful, you should see output like the following:

   ===========================================================
   # wrt-installer #
   # argc [3]
   # argv[0] = [wrt-installer]
   # argv[1] = [-un]
   # argv[2] = [intelPoc16.HVAC]
   ===========================================================
   ## wrt-installer : intelPoc16.HVAC uninstallation was successful.

Refer to installation instructions above for the subsequent installation steps.

In order to launch and run an installed application, issue the following command with the application's App ID as an argument:

   root:~> wrt-launcher -s intelPoc16.HVAC

You should see the application start and run on the target device.

To launch the application in debug mode, add the '-d' flag:

   root:~> wrt-launcher -d -s intelPoc16.HVAC

This will produce output like the following:

   root:~/wgt> wrt-launcher -d -s intelPoc16.HVAC
   port: 36070
   result: launched

The port number referenced is a random high port which allows one to connect to the target device with a web browser using a URL of the form:

   http://<ip address or name of target device>:<port #>

For example:

   http://192.168.1.223:36070

Once connected, you should see a single link in the upper right of the resulting web page, e.g.:

   file:///opt/usr/apps/intelPoc16/res/wgt/index.html

Clicking that link will launch Webkit Web Inspector, a set of web development tools that should look familiar to users of Firefox Firebug or Chrome Dev Tools. Click the 'Console' icon in the toolbar to go to the Javascript console. Press ctrl-R, or type:

   window.location.reload();

...to reload the application in order to display the startup/initialization functions associated with the app (since the app has already started by the time the debug interface is available).

To exit a running application, issue the following command with the application's App ID as an argument:

   root:~> wrt-launcher -k intelPoc16.HVAC

Instruction to the console:

Assumptions these are all running from the Tizen platform and can access the console by SSH command or Control ALT F4 for a terminal. Tizen instructions are at Tizen.org

Install

   wrt-installer -i intelPoc16.HVAC.wgt


Launch

   wrt-installer -i intelPoc16.HVAC.wgt

Known Bugs

Initial version without formal testing

Release History

Features

  • Current date and time
  • access to Settings screen
  • summary list view for each category
  • a thumbnail graphic and sample text for each article with datestamp
  • single finger scroll
  • full article view with all three categories across the top

Bug Fixes

Initial version without formal testing