bada basics fundamentals & ui

Copyright © 2010 Samsung Electronics Co., Ltd. All rights reserved.

Basics:Fundamentals & UI


Contents

bada API overview– bada namespaces and privileges

Coding idioms– Exception handling– Two phase construction– Memory handling– Virtual path

bada UI basicsApplication life cycle

2*This material is based on bada SDK 1.0.0b3


bada API overview

1. bada namespaces2. Privilege levels and groups

3


bada namespaces

4

User interactive features Service oriented featuresBasic bada featuresOsp::App

Osp::Base

Osp::IoOsp::LocalesOsp::Net

Osp::SecurityOsp::SystemOsp::Telephony

Osp::GraphicsOsp::MediaOsp::Ui

Osp::Uix

Osp::Web

Osp::CommerceOsp::ContentOsp::Locations

Osp::Messaging

Osp::Social

Osp::Text

KernelDevice

Service


Namespaces – basic bada

5


Osp::Base




Osp::Uix

Osp::Web


Osp::Messaging

Osp::Social

Osp::Text

KernelDevice

Service

Osp::Base

Fundamental badaclasses:

String, ArrayList, Thread,Math …

Basic bada features

Osp::AppOsp::BaseOsp::IoOsp::LocalesOsp::NetOsp::SecurityOsp::SystemOsp::TelephonyOsp::Text


Namespaces – User Interactive

6


Osp::Base




Osp::Uix

Osp::Web


Osp::Messaging

Osp::Social

Osp::Text

KernelDevice

Service

User interactive features

Osp::GraphicsOsp::MediaOsp::UiOsp::UixOsp::Web

Osp::Uix

Extended user interaction functions:

Touch, snap, Sensors …


Namespaces – User Interactive

7


Osp::Base




Osp::Uix

Osp::Web


Osp::Messaging

Osp::Social

Osp::Text

KernelDevice

Service

User interactive features

Osp::GraphicsOsp::MediaOsp::UiOsp::UixOsp::Web

Osp::Web

Browser control API


Namespaces – Service Oriented

8


Osp::Base




Osp::Uix

Osp::Web


Osp::Messaging

Osp::Social

Osp::Text

KernelDevice

Service

Service oriented features

Osp::CommerceOsp::ContentOsp::LocationsOsp::MessagingOsp::Social

Osp::Content

Local and remote content

management


Namespaces – Service Oriented

9


Osp::Base




Osp::Uix

Osp::Web


Osp::Messaging

Osp::Social

Osp::Text

KernelDevice

Service

Service oriented features

Osp::CommerceOsp::ContentOsp::LocationsOsp::MessagingOsp::Social

Osp::Locations

Interaction, visualisation of

locations and maps


Privilege levels

Privilege levels are related to your developer membership

Regulate access to the platform and user-sensitive data

Every privilege level allows access to different privilege groups (= functionalities)

10

Level DescriptionNone-privileged Does not require any privileges.Normal Usable by all bada developer.System Usable only by Samsung developer partners.


Coding idioms

1. Exception handling

2. Two phase construction

3. Memory handling

4. Virtual path

11


Exception handling (1/3)

bada does not use standard C++ exception handling

All exceptions are caught by using the badaspecific result type

Examples for result error types:

12

Error Type DescriptionE_SUCCESS The method was successfulE_OUT_OF_MEMORY Insufficient memoryE_SYSTEM A system error occurred



Check the result return value– Exceptions are indicated by the return value:

result r = E_SUCCESS;

r = Camera::StartPreview( null, false );

if(IsFailed(r)){

// process the error condition

}else {// continue normally

}

13



Check the last result using GetLastResult()– If an operation returns null:

DirEnumerator* pEnum = dir.ReadN();

if(pEnum == null){

AppLog("Directory::ReadN() failed with error: %s", GetErrorMessage(GetLastResult()));

return false;}

14


Two phase construction (1/2)

bada uses a two phase constructionWhy?– bada does not use standard C++ exception

mechanism to increase runtime efficiency– And to prevent resource leaks in C++

How?– The resource allocation logic is performed in

an extra Construct() method– The destructor follows traditional C++

conventions

15


Two phase construction (2/2)

Example:result r = E_SUCCESS;

// 1. Phase: create objectCallManager *pCallManager = new CallManager();

// 2. Phase: initialize object (+allocations)r = pCallManager->Construct();

if(IsFailed(r)){delete pCallManager;

}

16


Memory handling (1/3)

Ownership policy:– The “owner” of an object is responsible for

deleting dynamically allocated memory

Image* pImage = new Image();

// Some code ...

delete pImage;

Must be deleted to avoid a memory leak!

17



Rules for 'N' postfix methods:– The caller must delete the returned instance

after an ‘N’ postfix method is called– Change of “ownership”

Examples for ‘N’ postfix methods:– GetContentInfoN()– DecodeN()– GetValueListN()– SearchN()– OnLandMarkReceivedN()

18



GetContentInfoN():

OnLandmarksReceivedN():

ContentInfo* pInfo = null;pInfo = mgr.GetContentInfoN(contentId);delete pInfo;

voidLandmarkManager::OnLandmarksReceivedN(,

Osp::Base::Collection::IList* pResults,,,){

if (r == E_SUCCESS && pResults) {pMainForm->DrawLandmarks(pResults);pResults->RemoveAll(true);delete pResults;

}}

19


Virtual path

Directory Usage Permission

/HomeUsed to store application specific dataE.g.:String fileName("/Home/test.txt");

Read/Write

/Res Used to read resource files, such as for UI or music and video files Read-only

/Home/Share Used to share data with other bada applications Read/Write

/Share/[appid] Used to read data from other bada apps via their [appid] Read-only

20


bada UI basics

21

1. UI controls

2. Screen structure

3. Event handling

4. UI Builder


Controls in bada

22


UI screen structure

IndicatorTitle

Softkey

FrameThe top level windowThere is one per application

Form(s)High level container There can be multiple forms

Control(s)Controls are added to

forms

23


Create and show a Form

Step 1: Create a Form:

Step 2: Add Form to Frame:

Step 3: Show the Form:

Form1 *pForm = new Form1();pForm->Construct(FORM_STYLE_TITLE|

FORM_STYLE_SOFTKEY_0|FORM_STYLE_INDICATOR);

Frame *pFrame = GetAppFrame()->GetFrame();pFrame->AddControl(*pForm);

pFrame->SetCurrentForm(*pForm);pFrame->RequestRedraw(true); // true for Draw() & Show()

Other FORM_STYLEs: NORMAL/ TITLE/ INDICATOR/ SOFTKEY_0/ SOFTKEY_1/ OPTIONKEY/ TEXT_TAB/ ICON_TAB

24


Event handling

Events:– Controls: focus, drag and drop, touch, and key– Add EventListener to Control to handle events

TouchPressed

TouchMoved

TouchReleased

ITouchEventListener{

OnTouchPressed() {…}OnTouchMoved() {…}OnTouchReleased() {…}

OnTouchDoublePressed() {…}// …

}

25


Handling of Touch events

Step 1: Inherit from listener interface

Step 2: Implement event handler method

Step 3: Add event listener to control

class TouchListener : public ITouchEventListener{…}

void TouchListener::OnTouchPressed(…,const Point& currentPosition, …)

{…}

AddTouchEventListener(ITouchEventListener &);

26


UI Builder tool basics

27

ResourceExplorer

Design Area

Properties

Controls


Application life cycle

28


Overall application life cycle

OnAppInitializing()

Terminated

SuccessRunning

Failure OnForeground()

OnAppTerminating()

OnBackground()

Launch

29


OnAppInitializing()

Invoked as soon as application is launched

Initialize application resources

30

boolMyPlaces::OnAppInitializing(AppRegistry& appRegistry){// Initialize... …return true;

}

OnForeground()OnAppInitializing()

Launch


OnBackground()

OnBackground() is called when a base application is launched (e.g.: incoming calls or SMS messages)

Recommendation:– Release unnecessary

resources– Stop heavy operations

• Multimedia/graphics/etc.

31

OnForeground() OnBackground()

OnAppInitializing()

voidMyPlaces::OnBackground(void){}


OnForeground()

OnForeground() is called when the base application is terminated

Recommendation:– Resume normal application

processes and resource consumption

32

voidMyPlaces::OnForeground(void){}

OnForeground() OnBackground()

OnAppInitializing()


OnAppTerminating()

OnAppTerminating() is called when:– Another bada app is launched – End key is pressed – Low battery or memory

Recommendation:– Save state to the registry– Destroy unnecessary, allocated

resources

33

bool MyPlaces::OnAppTerminating(AppRegistry& appRegistry,bool forcedTermination)

{ // save app state into appRegistry …

}

OnAppTerminating()

OnBackground()OnForeground()


Summary

34


What we have learned

bada API overview– Namepaces– Privileges

bada coding idioms– Exception handling through result type– Two phase construction for runtime efficiency– Memory management and ‘N’ postfix– Virtual path (/Home, /Res, etc.)

UI basics– UI screen structure, controls, UI Builder

App life cycle– 4 states

35


Find out more

Tutorials:– bada Tutorial.Fundamentals.pdf– bada Tutorial.Application.pdf– bada Tutorial.UI and Graphics.pdf

Samples – BasicApp– UiControls

36


3D augmented reality first person shooter

Makes use of bada to its full potential

- 360° OpenGL 3D graphics- Camera- Accelerometer, compass, tilt sensors- Audio feedback- Powerful hardware- To be published in SamsungApps store

Follow us on Twitter at #ROTU

by Samsung Mobile Innovator

bada basics fundamentals & ui

Education

system osp

social osp

ui osp

locations osp

net osp

app osp

telephony osp

uix osp