User Tools

Site Tools


email

This is an old revision of the document!


Email

Summary

The Email application provides a critical means of communication by email for users on the go. The interface enables users to connect and manage email from an existing email account via IMAP protocol.

Shared services

  • Bootstrap
  • Car indicators
  • Configuration
  • Text-to-speech
  • Theme engine

Share components

  • Global methods
  • jQuery extensions
    • Alphabet Bookmarking
    • Audio Player
    • Bottom Panel
    • Box Caption
    • Button Controls
    • Clock
    • Incoming Call handler
    • Library
    • Progress Bar
    • Tabs
    • Top Bar Icons
  • Settings

Resources

Watch .

Access the .

Access the .

Download the .

What the app does

The Email application enables the users to add an IMAP-accessible email account, view a list of emails in the inbox and other folders, and view individual emails full screen. The user can reply, reply-all, and forward from an email as well as search the email body text.

The Email application provides the user with the ability to:

  • Add multiple accounts
  • Switch between accounts
  • Compose and send new emails
  • Edit and send email drafts
  • Access and view email folders
  • Search for email by text
  • Sync the app with email service
  • Delete single and multiple emails

The email application provides the user with convenient features, including:

  • Collapsible side menu with quick access:
    • switching accounts
    • the active inbox
    • initiating a sync
    • managing settings and accounts
  • navigation between full emails
  • autofill composed emails, replies, and forwards
  • last sync date and time
  • deletion alerts
  • action completion notifications

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 packages are required to be installed prior to installing the HTML5 widget:

  • email-service
  • ss-server
  • msg-server-tools
  • wrt-plugins-tizen-email

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 t8j6HTRpuz t8j6HTRpuz.MediaPlayer
4 Store 8.2.4401 http://com.intel.tizen/store intelPoc13 intelPoc13.Store
5 Phone 12.1.3750 http://com.intel.tizen/phone intelPoc15 intelPoc15.phone

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

root:~> wrt-installer -i Email.wgt

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

===========================================================
   # wrt-installer #
   # argc [3]
   # argv[0] = [wrt-installer]
   # argv[1] = [-i]
   # argv[2] = [Email.wgt]
   ## wrt-installer : intelPoc34.Email 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 intelPoc34.Email       <-- 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] = [intelPoc34.Email]
   ===========================================================
   ## wrt-installer : intelPoc34.Email 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 intelPoc34.Email

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 intelPoc34.Email 

This will produce output like the following:

root:~/wgt> wrt-launcher -d -s intelPoc34.Email
   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/d1RlEaxhZb/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 intelPoc34.Email

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 intelPoc34.Email

Launch

wrt-installer -i ODBQpKvkS1.Settings.wgt

Known Bugs

Issue Type Key Summary
Bug If the USB device is removed and returned, the application will not find it again. The application must be stopped and restarted.
Bug There are sync issues between the server and the client app. This is an email-service native component issue.
Bug There are timing issues between the Tizen Messaging API and the email-service. Some calls will return prematurely and result in unexpected behavior. This is an email-service native component issue.
Bug Some mail items may not appear due to folder categorization in the email-service. For example, some items are marked as being in the important folder but not in the inbox folder. This is an email-service native component issue.
Bug Some mail items cannot be updated. This is an email-service native component issue.
Bug Some folders are missing from the app. There is no Trash and Sent items folder currently implemented.
Bug Search only searches body of emails for the current folder on all accounts
Bug Search without results loads inbox after a delay
Bug Searching from folder other than inbox doesn’t display results list
Bug Navigation only navigates one email forward and back
Bug Drafts cannot be deleted from app
Bug Deleted email is not deleted from service
Bug Missing feature: Folders list is not loaded dynamically from service
Bug Factory reset loads add account screen and change account screen simultaneously
Bug Remove account, when accounts present, loads modal incorrectly before loading change account screen
Bug Missing feature: no account alert not functional
Bug Missing feature: newly added account doesn’t automatically load inbox
Bug Syncing performance issues
Bug Reply and reply-all “to” field doesn’t auto-populate

Release History

Features

  • Currently only Gmail has been tested and verified as fully functional.

Bug Fixes

Initial release

Key Summary
email-service crashes after opening an email from the list. Use the latest version of the email-service with the update_mail() API call crash fix.
email.1417046796.txt.gz · Last modified: 2014/11/27 00:06 by dcrane