SailfishOS using app in emulator basics: Difference between revisions

From Qt Wiki
Jump to navigation Jump to search
No edit summary
No edit summary
Line 1: Line 1:
[[Category:SailfishOS::Introduction_tutorial]]
[[Category:SailfishOS::Introduction_tutorial]]


[toc align_right="yes" depth="2"]
[toc align_right="yes" depth="2"]


'''English''' | [[:SailfishOS_using_app_in_emulator_basics_Polish|Polski]]
'''English''' | [[:SailfishOS_using_app_in_emulator_basics_Polish|Polski]]


''''_<br />Article is part 3 of &quot;Introduction Tutorial&amp;quot;:/wiki/Category:SailfishOS::Introduction_tutorial.<br />&quot;&lt; Go To Part 2&amp;quot;:/wiki/SailfishOS_first_application ||| &quot;Go To Part 4 &gt;&quot;:/wiki/SailfishOS_code_walkthrough<br />''''_
''''_
Article is part 3 of "Introduction Tutorial":/wiki/Category:SailfishOS::Introduction_tutorial.
"< Go To Part 2":/wiki/SailfishOS_first_application ||| "Go To Part 4 >":/wiki/SailfishOS_code_walkthrough
''''_


= Using SailfishOS Apps =
= Using SailfishOS Apps =
Line 11: Line 14:
SailfishOS is a touch based UI and here is a quick explaination how to use some of the gestures in the emulator - for a complete explanation see the UX framework page.
SailfishOS is a touch based UI and here is a quick explaination how to use some of the gestures in the emulator - for a complete explanation see the UX framework page.


There are two kinds of gestures in SailfishOS - &quot;pulls&amp;quot; are those within the screen; &quot;pushes&amp;quot; are those starting outside the screen. It may help to think of moving an edge of the screen by pushing or pulling it.
There are two kinds of gestures in SailfishOS - "pulls" are those within the screen; "pushes" are those starting outside the screen. It may help to think of moving an edge of the screen by pushing or pulling it.


''Hint: Pushes are a little tricky to use in the emulator with a mouse since they actually start at the very edge of the window - some users prefer to disable mouse integration in VirtualBox (press Host + &quot;I&amp;quot; or use the Machine menu) to make it easier to push from the edge.''
''Hint: Pushes are a little tricky to use in the emulator with a mouse since they actually start at the very edge of the window - some users prefer to disable mouse integration in VirtualBox (press Host + "I" or use the Machine menu) to make it easier to push from the edge.''


== Pulley Menu ==
== Pulley Menu ==
Line 23: Line 26:
== Nested Page ==
== Nested Page ==


The pulley menu item &quot;Show Page 2&amp;quot; takes you to the next Page. The menu item can be activated in two ways:
The pulley menu item "Show Page 2" takes you to the next Page. The menu item can be activated in two ways:


Pull the pulley menu down until the menu item is highlighted; then release to activate, or<br />[[Image:http://i.imgur.com/KB3B8uu.png|img 2]]
Pull the pulley menu down until the menu item is highlighted; then release to activate, or
[[Image:http://i.imgur.com/KB3B8uu.png|img 2]]


Pull the pulley menu all the way down to expose the entire menu, and tap on the menu item to activate<br />[[Image:http://i.imgur.com/IZzK83v.png|img 3]]
Pull the pulley menu all the way down to expose the entire menu, and tap on the menu item to activate
[[Image:http://i.imgur.com/IZzK83v.png|img 3]]


In the second Page, notice the visual indicators at the top left corner. They indicate the level of the stacked Page.
In the second Page, notice the visual indicators at the top left corner. They indicate the level of the stacked Page.
Line 33: Line 38:
[[Image:http://i.imgur.com/CtyREsi.png|img 4]]
[[Image:http://i.imgur.com/CtyREsi.png|img 4]]


To move back to the first page you can:<br />* simply pull from left to right anywhere in the screen<br />* pull from left to right on the page header(useful if the screen has other touch functionality)<br />* touch the glowing page indicator in the top left corner
To move back to the first page you can:
* simply pull from left to right anywhere in the screen
* pull from left to right on the page header(useful if the screen has other touch functionality)
* touch the glowing page indicator in the top left corner


== Active Cover ==
== Active Cover ==


Applications running in the background have &quot;Covers&amp;quot; which provide a visual summary for the application and support interactiion as well. They are displayed in the Home area.
Applications running in the background have "Covers" which provide a visual summary for the application and support interactiion as well. They are displayed in the Home area.


You can access the Home area and see the active cover of the application you just compiled by pushing the application from the side.<br />[[Image:http://i.imgur.com/h5vF6rd.png?1|img 5]]
You can access the Home area and see the active cover of the application you just compiled by pushing the application from the side.
[[Image:http://i.imgur.com/h5vF6rd.png?1|img 5]]


This application is showing &quot;My Cover&amp;quot; as the visual representation and provides Play and Pause icons to describe the possible actions.
This application is showing "My Cover" as the visual representation and provides Play and Pause icons to describe the possible actions.


Pull the cover from left to right to access the left action; pull the other way for the right action.
Pull the cover from left to right to access the left action; pull the other way for the right action.
Line 49: Line 58:
There are at least few ways to close the app, most typical are:
There are at least few ways to close the app, most typical are:


1. In the Home screen press and hold the application until the covers fade out and provide a close button - then tap the close button<br />[[Image:http://i.imgur.com/REG10Vp.png?1|close app a]]
1. In the Home screen press and hold the application until the covers fade out and provide a close button - then tap the close button
[[Image:http://i.imgur.com/REG10Vp.png?1|close app a]]


2. In the application screen push the application from top<br />[[Image:http://i.imgur.com/00rAHJX.png?1|close app a]]
2. In the application screen push the application from top
[[Image:http://i.imgur.com/00rAHJX.png?1|close app a]]


3. You can also close the application directly from QtCreator by using the stop button
3. You can also close the application directly from QtCreator by using the stop button


''''_<br />Article is part 3 of &quot;Introduction Tutorial&amp;quot;:/wiki/Category:SailfishOS::Introduction_tutorial.<br />&quot;&lt; Go To Part 2&amp;quot;:/wiki/SailfishOS_first_application ||| &quot;Go To Part 4 &gt;&quot;:/wiki/SailfishOS_code_walkthrough<br />''''_
''''_
Article is part 3 of "Introduction Tutorial":/wiki/Category:SailfishOS::Introduction_tutorial.
"< Go To Part 2":/wiki/SailfishOS_first_application ||| "Go To Part 4 >":/wiki/SailfishOS_code_walkthrough
''''_

Revision as of 11:00, 25 February 2015


[toc align_right="yes" depth="2"]

English | Polski

'_ Article is part 3 of "Introduction Tutorial":/wiki/Category:SailfishOS::Introduction_tutorial. "< Go To Part 2":/wiki/SailfishOS_first_application ||| "Go To Part 4 >":/wiki/SailfishOS_code_walkthrough '_

Using SailfishOS Apps

SailfishOS is a touch based UI and here is a quick explaination how to use some of the gestures in the emulator - for a complete explanation see the UX framework page.

There are two kinds of gestures in SailfishOS - "pulls" are those within the screen; "pushes" are those starting outside the screen. It may help to think of moving an edge of the screen by pushing or pulling it.

Hint: Pushes are a little tricky to use in the emulator with a mouse since they actually start at the very edge of the window - some users prefer to disable mouse integration in VirtualBox (press Host + "I" or use the Machine menu) to make it easier to push from the edge.

Pulley Menu

In the UI, notice the glow at the top edge. It indicates a pulley menu which can be revealed with a pull-down gesture in the main window.

img 1

Nested Page

The pulley menu item "Show Page 2" takes you to the next Page. The menu item can be activated in two ways:

Pull the pulley menu down until the menu item is highlighted; then release to activate, or img 2

Pull the pulley menu all the way down to expose the entire menu, and tap on the menu item to activate img 3

In the second Page, notice the visual indicators at the top left corner. They indicate the level of the stacked Page.

img 4

To move back to the first page you can:

  • simply pull from left to right anywhere in the screen
  • pull from left to right on the page header(useful if the screen has other touch functionality)
  • touch the glowing page indicator in the top left corner

Active Cover

Applications running in the background have "Covers" which provide a visual summary for the application and support interactiion as well. They are displayed in the Home area.

You can access the Home area and see the active cover of the application you just compiled by pushing the application from the side. img 5

This application is showing "My Cover" as the visual representation and provides Play and Pause icons to describe the possible actions.

Pull the cover from left to right to access the left action; pull the other way for the right action.

Stopping the application

There are at least few ways to close the app, most typical are:

1. In the Home screen press and hold the application until the covers fade out and provide a close button - then tap the close button close app a

2. In the application screen push the application from top close app a

3. You can also close the application directly from QtCreator by using the stop button

'_ Article is part 3 of "Introduction Tutorial":/wiki/Category:SailfishOS::Introduction_tutorial. "< Go To Part 2":/wiki/SailfishOS_first_application ||| "Go To Part 4 >":/wiki/SailfishOS_code_walkthrough '_