Skip to content
This repository
branch: master

Fetching latest commit…

Octocat-spinner-32-eaf2f5

Cannot retrieve the latest commit at this time

Octocat-spinner-32 bin
Octocat-spinner-32 code
Octocat-spinner-32 doc
Octocat-spinner-32 screenshots
Octocat-spinner-32 .hgignore
Octocat-spinner-32 Licence.txt
Octocat-spinner-32 README.md
README.md

Status Shout! v1.0

The Status Shout! example application demonstrates the use of social media (in this case, Twitter & Facebook), OAuth authentication, and posting status update messages with images.

The Status Shout! application uses the Social Connect QML plug-in, which handles authentication of the application to different social media and can be easily utilised in other applications. The application also uses the official Qt Quick Components for navigation and UI.

The Social Connect QML plug-in used in the Status Shout! example application is available at http://projects.developer.nokia.com/socialconnect

The Status Shout! uses Qt Quick Components in numerous places. For example, when navigating deeper into the application, the PageStack is used. The StatusBar and ToolBar (with all the ToolButtons etc.) are also used.

This example application demonstrates:

  • Using the Social Connect QML plug-in:
    • Authentication with OAuth (versions 1.0 & 2.0).
    • Posting a message to social media services.
  • Using Qt Quick Components in an application that supports multiple resolutions and both touch UI and keypad.
  • Smart startup of the application (content and application UI loaded during splash screen.

This example application is hosted in Nokia Developer Projects:

For more information on the implementation, visit the wiki page:

1. Usage

The customised Social Connect QML plug-in can be taken into use either by linking it statically into the application, or by using it "as is" by merely adding the socialconnect.sis file into the .pro file (as has been done in the Status Shout! example application).

Follow the step-by-step guide from the Social Connect plug-in wiki for more details:

2. Prerequisites

  • Qt basics
  • Qt Quick basics
  • Qt Quick Components basics

3. Project structure and implementation

3.1 Folders

| The root folder contains the licence information and | this file (release notes). | |- design Contains UX design files. | |- screenshots Contains screenshots taken from the application. | |- code Root folder for project, gfx, QML, and Javascript files. |

3.2 Important files and classes

Class Description
LoadHelper Helper class that is used to load the main QML
file right after showing the splash screen.
------------------------- ---------------------------------------------------

3.3 Used APIs/QML elements/Qt Quick Components

The following APIs, QML elements, and Qt Quick Components have been used.

Standard QML elements:

  • Connections
  • Flickable
  • ListView
  • Loader
  • Text
  • TextEdit
  • WebView

  • Behavior

  • ParallelAnimation
  • State
  • Transition

QML elements from Qt Quick Components:

  • BusyIndicator
  • Label
  • ListItem
  • Switch
  • ScrollDecorator
  • QueryDialog

QML elements from the Social Connect QML plug-in:

  • FacebookConnection
  • TwitterConnection
  • WebInterface

4. Compatibility

Compatible with:

  • Symbian devices with Qt 4.7.4 or higher.

Tested on:

  • Nokia E7-00
  • Nokia 808

Developed with:

  • Qt SDK 1.2

4.1 Required capabilities

NetworkServices and ReadUserData. Required for the Social Connect QML plug-in to work correctly with network. The application can be self signed on Symbian.

4.2 Known issues and design limitations

Camera button not working properly:

  • Functionality for taking a picture with the camera has not yet been implemented.

Gallery button not working properly:

  • Functionality for selecting a picture from the device's gallery has not yet been implemented.

5. Building, installing, and running the application

5.1 Preparations

Check that you have the latest Qt SDK installed in the development environment and the latest Qt version on the device.

Qt Quick Components 1.1 or higher is required.

5.2 Using the Qt SDK

You can install and run the application on the device by using the Qt SDK. Open the project in the SDK, set up the correct target (depending on the device platform), and click the Run button. For more details about this approach, visit the Qt Getting Started section at Nokia Developer (http://www.developer.nokia.com/Develop/Qt/Getting_started/).

5.3 Symbian device

Make sure your device is connected to your computer. Locate the .sis installation file and open it with Nokia Suite. Accept all requests from Nokia Suite and the device. Note that you can also install the application by copying the installation file onto your device and opening it with the Symbian File Manager application.

After the application is installed, locate the application icon from the application menu and launch the application by tapping the icon.

6. Licence

See the licence text file delivered with this project. The licence file is also available online at http://projects.developer.nokia.com/statusshout/browser/Licence.txt

7. Related documentation

Qt Quick Components

8. Version history

1.0 Initial release.

Something went wrong with that request. Please try again.