User Tools

Site Tools


agl-demonstrator:browser

This is an old revision of the document!


Browser

Summary

The Browser application allows the user to browse the internet, search for webpages, access web links, input web addresses directly, and play back media hosted on webpages and websites.

The Browser contain a front end feature screen (implemented in HTML5) that will display web pages to the user and include soft keys to control and input data into the Browser application such as:

Features

  • Address bar
  • Status bar
  • ‘Back’ soft key
  • ‘Forward’ soft key
  • ‘Refresh’ soft key
  • ‘New tab’ soft key
  • Long press
  • Quick touch
  • Pop-up Keyboard

Resources

Watch Browser.

Access the Design Requirements Document (DRD).

Access the Sources.

Download the Application WGT.

What the app does

The Browser application displays web pages to the user and includes soft keys to control and input data into the Browser application such as:

  • Address bar
  • Status bar
  • ‘Back’ soft key
  • ‘Forward’ soft key
  • ‘Refresh’ soft key
  • ‘New tab’ soft key
  • Long press
  • Quick touch
  • Pop-up Keyboard

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

# You will need the following two files on your Tizen box.

<nowiki>wrt-0.8.288-1.i686.rp</nowiki>m
<nowiki>edje-1.7.8-1.i686.rp</nowiki>m

For information regarding the issues that these files address, please see the Tizen Jira ticket found at https://bugs.tizen.org/jira/si/jira.issueviews:issue-html/TIVI-2144/TIVI-2144.html https://bugs.tizen.org/jira/si/jira.issueviews:issue-html/TIVI-2144/TIVI-2144.html]

They can be installed via running the following two commands from the directory where you have placed them on your Tizen box.

rpm -iU --force <nowiki>wrt-0.8.288-1.i686.rp</nowiki>m
rpm -iU --force <nowiki>edje-1.7.8-1.i686.rp</nowiki>m

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:~&gt; 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 t8j6HTRpuz t8j6HTRpuz.MediaPlayer
4 Store 8.2.4401 http://com.intel.tizen/store intelPoc13 intelPoc13.Store
5 NFC 12.1.3750 http://com.intel.tizen/Browser intelPoc19 intelPoc19.Browser.wgt

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

root:~> wrt-installer -i intelPoc19.Browser.wgt

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

===========================================================
   # wrt-installer #
   # argc [3]
   # argv[0] = [wrt-installer]
   # argv[1] = [-i]
   # argv[2] = [intelPoc19.Browser.wgt]
   ## wrt-installer : intelPoc19.Browser.wgt 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 intelPoc19.Browser.wgt      <-- note: use the App ID when 
un-installing 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] = [intelPoc19.Browser.wgt]
   ===========================================================
   ## wrt-installer : intelPoc19.Browser.wgt un-installation 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 intelPoc19.Browser.wgt

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 intelPoc19.Browser.wgt

This will produce output like the following:

root:~/wgt> wrt-launcher -d -s intelPoc19.Browser.wgt
   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://&lt;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/intelPoc19/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 intelPoc19.Browser

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 intelPoc19.Browser.wgt

Launch

wrt-installer -i intelPoc19.Browser.wgt

Known Bugs

Issue Type Key Summary
Bug If the target page uses a screen reload function, it will reload the entire page, replacing the entire display area (the POC interface as well as the browser area) with the content of the web page. Short of parsing the page prior to rendering and removing the offending code, there isn’t a viable work around for this. A number of websites use code such as this to prevent them from being opened in an iFrame.
Bug TIVI-2782 When mini-browser's window became full screen, it was just scaled. Width resolution was not changed.
Bug TIVI-2460 MiniBrowser exits unexpectedly during benchmark Rscohn2 sbp is loading
Bug TIVI-2457 [Reg]The performance of Browsermark 2.0 has regression
Bug TIVI-2931 MiniBrowser exits while try to playback html5 video in VMware Player
Bug TIVI-1135 Problem with ListBox Row in MiniBrowser
Bug TIVI-1614 web page content (Fish IE Tank) reports wrong resolution and does not handle the MiniBrowser window size correctly

Release History

Features

The Browser contain a front end feature screen (implemented in HTML5) that will display web pages to the user and include soft keys to control and input data into the Browser application such as:

  • Address bar
  • Status bar
  • ‘Back’ soft key
  • ‘Forward’ soft key
  • ‘Refresh’ soft key
  • ‘New tab’ soft key
  • Long press
  • Quick touch
  • Pop-up Keyboard

Bug Fixes

Key Summary
TIVI-786 [WLD]Browser will crash when open webgl webpage
TIVI-2383 Browser cannot be launched
TIVI-287 [REG][2.0]Segmentation fault occurred when launching Browser with command line
TIVI-532 Browser is unable to render content, just white screen
TIVI-847 [WLD] Browser crashed when click menus in more option button
TIVI-793 [WLD] Unable to close apps by clicking close button on GhostCluster/Browser/Dialer
TIVI-275 [2.0] Fail to render any web pages in Browser which is launched by command
TIVI-305 Fail to play html videos(implemented by video tag) in Browser
TDIST-376 no way to set “Location” on browser before running Geolocation tests on Lunchbox
TIVI-1689 ICO HomeScreen is unable to launch browser
TDIST-330 [CSSFixedPositioning] No test results display on browser.
TDIST-132 Browser incorrectly handles HTTP authentication
TIVI-669 Failed to play html audio/video in Browser
TDIST-447 Websimulator dosen't work in the latest chrome browser
TIVI-504 ENABLE_DFG_JIT causes browser to crash
TIVI-381 Fail to play html audio(implemented by audio tag) in Browser
TIVI-2672 [TIVISBB] MiniBrowser page is disappeared when playing video in Browser
TIVI-1889 MiniBrowser closed unexpectedly before Sunspider benchmark is finished
TIVI-2140 MiniBrowser sometimes cannot be closed after visit Google aquarium benchmark
TIVI-2276 [REG]MiniBrowser returns “request cancelled” Error
TIVI-1060 [3.0] [Minibrowser] Address bar excessively responds keyboard input sometimes
TIVI-1859 [3.0] MiniBrowser app exits immediately after launched in VMware Player
TIVI-1771 [3.0][REG]Minibrowser is not visible in ico UI
TIVI-2647 [REG] MiniBrowser cannot be launched
TIVI-2810 [SDK][NativeApp] launch MiniBrowser from command “MiniBrowser” have “elementary elm_config.c” fail
agl-demonstrator/browser.1439074838.txt.gz · Last modified: 2015/08/08 23:00 by wminer