mobile development with qt for symbian

Mobile Application Developmentwith Qt for Symbian

Qt for Symbian: bit.ly/qtsymbian

Visit:

bit.ly/qtsymbian...get Qt for your phone


About Me

Jason Barron

3

Started July, 2005

Began in Support

Switched to Development


About Me

Alessandro Portale

09/02 – 01/07Color management

02/07 – 03/08Qt tools

04/08 – todayQt port to Symbian


Goal

• Why use Qt for Symbian?

• Learn what you need to get started.

• Learn how to make great apps on Symbian.


Agenda

• Getting Started

• Application Development

• UI Types

• New “Mobile-esque” Features in 4.6

• Advanced integration


Why use Qt for Symbian?

1. Symbian is a relevant mobile platform.

2. Qt is an easy way to access Symbian.

3. Many of you already know Qt!


The Symbian Landscape

S60 3.1, 3.2 S60 5.0

Symbian^1 S^2 S^3 S^4

Today


The Developer’s Shopping List

SDK

IDE

Open C plugin (POSIX)

Qt


Compilers

Free Available From Binaries Can be used to compile

Qt Apps

WINSCW Yes Carbide.c++ Win32* Yes Yes

GCC-E Yes S60 SDK(CodeSourcery)

ARM No** Yes

RVCT No ARM Ltd. ARM Yes Yes

* Win32 binaries run in the Symbian Emulator

** Technically can compile Qt, but libraries containing WSD will not run


Agenda

• Getting Started


• UI types




Demo


Application Development – From Scratch

• Carbide's Qt project wizard• Editing the Ui Form• show(), showMaximized() or

showFullScreen()?• Running the application in the emulator• Running the application on the phone


Demonstration


Carbide's Qt project wizard


Editing the Ui Form


Adjusting the show() call


Running the application in the emulator


Building and deploying for the device


Command Line

C:\qt\...\analogclock> qmake

C:\qt\...\analogclock> make debug-winscwC:\qt\...\analogclock> make release-gcceC:\qt\...\analogclock> make release-armv5

C:\qt\...\analogclock> make sis


Port an existing application

• Original application on the Desktop

• Carbide's Qt .pro file import• Running the application in the emulator• Desktop Ui vs. Mobile Ui


Carbide's Qt .pro file import


Running the application in the emulator


Desktop Ui vs. Mobile Ui

Successful port?



Mobile friendly Ui



Including different Ui headers



Instantiating and showing different Uis



AppController knows the view as QObjectthat emits colorChanged()



Both Uis emit a colorChanged() signal


Agenda

• Getting Started


• UI Types




UI Types


Agenda

• Getting Started


• UI Types




qmake Keywords

• MMP_RULES• BLD_INF_RULES

• TARGET– .UID3– .EPOCHEAPSIZE– .CAPABILITY

• DEPLOYMENT• ICON

• QMAKE_CXXFLAGS– .ARMCC– .WINSCW


Input Method Hints

… QWidget::inputMethodHints() const;

void QWidget::setInputMethodHints(…);


Input Method Hints

• Change Behavior:– Qt::ImhHiddenText– Qt::ImhNoAutoUppercase– Qt::ImhPreferNumbers– Qt::ImhPreferUppercase– Qt::ImhPreferLowercase– Qt::ImhNoPredictiveText

• Restrict Input:– Qt::ImhDigitsOnly– Qt::ImhFormattedNumbersOnly– Qt::ImhUppercaseOnly– Qt::ImhLowercaseOnly– Qt::ImhDialableCharactersOnly– Qt::ImhEmailCharactersOnly

• Masks:– Qt::ImhExclusiveInputMask


Soft keys

QAction::setSoftKeyRole(…);…QAction::softKeyRole() const;

enum SoftKeyRole {QAction::NoSoftKey, //(default)QAction::PositiveSoftKey,QAction::NegativeSoftKey,QAction::SelectSoftKey,}


Navigation Modes

void QApplication::setNavigationMode(...);... QApplication::navigationMode();

enum NavigationMode {NavigationModeNone,NavigationModeKeypadTabOrder,NavigationModeKeypadDirectional,NavigationModeCursorAuto,NavigationModeCursorForceVisible

};


Exceptions

MyWidget::MyWidget(QWidget *parent) : QDialog(parent),label(new QLabel("Name?", this)),edit(new QLineEdit(this)),button(new QPushButton("Ok"))

{setLayout(new QVBoxLayout);layout()->addWidget(label);layout()->addWidget(edit);layout()->addWidget(button);

}

What happens if ‘new’ on line 4 throws std::bad_alloc?


QScopedPointer

class MyWidget: public QDialog{

Q_OBJECT

public:MyWidget(QWidget *parent = 0);

private:#ifdef USE_SCOPED_POINTER

QScopedPointer<QLabel> label;QScopedPointer<QLineEdit> edit;QScopedPointer<QPushButton> button;

#elseQLabel *label;QLineEdit *edit;QPushButton *button;

#endif};

Deletes it’s object when the scope terminates.


Agenda

• Getting Started


• UI Types




Event Dispatcher – Active Scheduler

• Active objects can be used as normal

ActiveScheduler

Qt


Handling Symbian Leaves

• QT_TRAP_THROWING– Converts leaves to exceptions

• QT_TRYCATCH_ERROR– Converts exceptions to errors

• QT_TRYCATCH_LEAVING– Converts exceptions to leaves


RWindow, CCoeControl and QWidget

• QWidget::winId() – Returns a CCoeControl

• Always window owning:

CCoeControl *c = widget->effectiveWinId();RWindow *rw =

static_cast<RWindow*>(c->DrawableWindow());


Thank You!Questions?


Reference

• Download an SDK from:

– Forum Nokia (http://forum.nokia.com)

– Samsung Mobile Innovator (http://innovator.samsungmobile.com)

– Symbian Foundation (http://developer.symbian.com)

62

mobile development with qt for symbian

Technology

ui form qtforsymbian

ui types qtforsymbian

desktop carbides qt

use qt

imhdialablecharactersonly

imhpreferlowercase qt

imhlowercaseonly qt

imhpreferuppercase qt