Using the Web Simulator

Mobile WebWearable WebTV Web

Dependencies

  • Tizen Studio 1.0 and Higher

Content

The Tizen Web Simulator is a light-weight tool that provides many settings and features to develop Web applications. You can use the simulator features to debug your applications.

The Tizen Web Simulator:

  • Supports running and debugging modern HTML5 Web applications.
  • Simulates Tizen Web APIs using a JavaScript backend. For more information on Tizen Web APIs supported by the simulator, see Tizen API Coverage.
  • Includes configuration panels for sending in events and messages to debug features, such as Geolocation, Accelerometer, and Messaging.
  • Runs on the Google Chrome™ browser.
  • Provides preferences to allow you to customize how it works.

The Tizen Web Simulator is based on the Ripple-UI Framework and is licensed under Apache Software License v.2.0.

NoteThe Web Simulator does not support a wearable circular UI.

Figure: Tizen Web Simulator

Tizen Web Simulator

Web Simulator Settings

The Web Simulator has several settings for developing Web applications.

Application Navigation Bar

The application navigation bar is used to load an application, view the browsing history, and modify the Web Simulator configuration and visibility settings.

The navigation bar has the following options:

  • Address bar

    When the Web Simulator is launched from Tizen Studio, the file path of your application main file is displayed in the address bar. You can edit this field for changing the file or project to run.

    Address bar

  • Reload button

    Reloads the current application.

    Reload button

  • Browsing history

    Click the history button to view the previously launched applications.

    Browsing history

  • Configuration button

    Opens the Web Simulator configuration window.

    Web Simulator configuration

  • Panel visibility button

    Opens the panel visibility window.

    Web Simulator panel visibility

  • Information button

    Opens the Web Simulator information window.

    Web Simulator information

Simulator Configuration Settings

You can modify the following configuration settings in the Web Simulator configuration window:

  • Configuration management

    Save your configuration settings to the local storage and restore the settings at a later time.

    Configuration settings save and load buttons

  • Device settings

    Set the device API and device resolution to simulate the device resolution of the target device on the DEVICE tab.

    NoteTo provide similar UI rendering on the emulator and the target device, set the emulator resolution to tizen WVGA (480x800) or tizen HD (720x1280), as the viewport property of these resolutions is configured to be the same as the target device's.
  • System settings

    The Tizen System Information API (for mobile and wearable applications) is used to retrieve device and network-related information. Use the SYSTEM SETTINGS tab to set the device status and to test whether your application can retrieve the current device status. You can also test the application listener functions for status change notifications.

    You can modify the following system configuration settings on the SYSTEM SETTINGS tab:

    • CONFIG

      Manage the device vibration and screen lock status.

    • CPU

      Manually set the CPU load. If the value is set to 0, the CPU is idle. If the value is set to 1, the CPU usage is 100%.

    • BUILD, LOCALE, DEVICE ORIENTATION, STORAGE, and DISPLAY

      Display the build type, language, country, display orientation, dots per inch (DPI), and device width and height. You can also set the display brightness and storage attributes.

    • PERIPHERAL

      Display and set the video output.

  • Network settings

    Set the network type, Wi-Fi network, cellular network, and SIM card-related configuration options on the NETWORK tab.

Simulator Preferences

To view the Tizen Web Simulator preferences, select Window > Preferences > Tizen Studio > Web > Simulator in Tizen Studio.

Google Chrome™ Browser Settings

In this section, you can modify Google Chrome™ browser-related preferences.

Google Chrome™ Browser Location

Enter the full path to the Google Chrome™ browser program. When first started, Tizen Studio attempts to discover the location. However, it can be necessary to enter or modify this value manually.

  • For Linux: /opt/google/chrome/google-chrome.
  • For Windows® 64-bit: C:\Program Files (x86)\Google\Chrome\Application\chrome.exe
  • For Windows® 32-bit: C:\Program Files\Google\Chrome\Application\chrome.exe

Extra Parameters

The simulator is started with default parameters, including the ones described in the following table.

Table: Default parameters

Parameters Description
--allow-access-from-files Allows the simulator JavaScript APIs to access files on the disk (such as config.xml and the application icon).
--disable-web-security Allows the simulator to do cross-domain requests (such as access the map location on another server).

To add more start-up parameters, enter them in this field.

Profile Data Location

Enter the full directory path for the simulator to store user preferences and Web application data.

NoteLinux users must manually define this parameter instead of using the default value, since the total length of the directory path in Linux is very limited for this parameter. Using the default value can prevent you from launching more than 1 application concurrently. There is no such restriction in the Windows® version.

Simulator Settings

In this section, you can modify simulator-related preferences:

  • Simulator location

    Set whether to use the default version of the simulator, or a custom version.

    • Internal: Use the simulator that is part of Tizen Studio.
    • External: Use a custom build or other simulator version. Enter the full path to the index.html file for the version you want to use.
  • Selecting Launch the simulator in Google Chrome application mode launches the simulator without the Google URL bar or tabs at the top. The result is that the simulator appears as a standalone application. The setting has no effect on the simulator features.

Tizen API Coverage

Below is a summary of the Tizen APIs supported in this release. Some APIs are supported with a JavaScript backend and others are provided by Google Chrome™. Tizen also supports W3C/HTML5 Specifications.

Supported Tizen Web Device API

The following APIs are implemented by the simulator in JavaScript:

Non-supported Tizen Web Device API

The following APIs are not supported by the current version of the simulator. Support for these APIs is under development.

  • Message Port
  • Secure Element

Web Simulator Known Issues

Tizen APIs have the following known issues on the Web simulator:

  • Not all Tizen-specific properties are supported in the Web simulator config.xml configuration file. However, the syntax and values of all Tizen-specific properties are verified. The verification result is displayed in the Application Configuration panel of the widget configuration editor.
  • You can run only 1 application at a time. If your application uses the Application API to invoke another service or application, use the Web simulator features to simulate results for the required callbacks.
  • DST (Daylight Saving Time) -related methods of the Time API are not supported.
  • For the Messaging module, the attachment is not supported, and the message body is always loaded.
  • If you are using the jQuery Mobile swipe component, the swipe action is simulated by mouse click and unclick events. jQuery Mobile does not recognize swipe actions if they begin or end outside the component, and if the mouse pointer is dragged slowly or not in a straight line.

W3C/HTML5 Specifications

The following W3C/HTML5 specifications are supported:

  • Widget:

  • Content (documents, graphics, multimedia):
    • HTML5 audio
    • HTML5 video
    • HTML5 forms
    • Session History API
    • HTML5 2D canvas
    • Inline SVG
  • CSS3:
    • CSS3 2D transforms
    • CSS3 3D transforms
    • CSS3 animations
    • CSS3 transitions
    • iframe sandbox attribute
    • HTML5 2D canvas
    • CSS3 colors
  • Device/OS integration:
    • Geolocation API Specification
    • Orientation and acceleration
    • Browser onLine State
    • Vibration API
    • Web audio
    • Web notifications
  • Network and communication:
    • WebSocket API
    • Web messaging
    • XMLHttpRequest
    • Cross-origin resource sharing (CORS)
    • Server-sent events
  • Storage:
    • Web storage
    • File API
    • File API: directories and system
    • File API: writer
    • HTML5 application cache
    • Web SQL database
    • Indexed DB API
  • Performance:
    • Web workers
    • Page Visibility API (via JavaScript backend)
    • Animation timing control