Sprint P

ropie

tary

and C

onfidential

Gettin

g S

tart

ed G

uid

e for

Usin

g S

print

WT

K a

nd N

etb

eans for

Cre

ating J

ava A

pps

for

Sam

sung Instinct

Sprint P

ropie

tary

and C

onfidential

Overv

iew

•T

his

guid

e is a

pic

torial based tuto

rial on h

ow

to c

reate

a S

am

sung

Instinct pro

ject

–1:

Insta

lling S

print

WT

K 3

.3

–2:

Addin

g S

pri

nt

WT

K 3

.3 into

Netb

ea

ns

–3:

Cre

ating S

am

sung I

nstinct

Sam

ple

Pro

ject

in S

print

WT

K 3

.3

–4:

Import

ing S

am

sung I

nstinct

SW

IL J

AR

to y

our

Netb

eans lib

rary

(1

x

only

)•

Lin

kin

g in S

am

sung Instinct Java D

ocs fro

m the

Sprint W

TK

3.3

–5:

Import

ing S

print

WT

K p

roje

ct

into

Netb

ean

s•

How

to a

ssig

n S

am

sung e

mula

tor

–6:

Cre

ating c

on

figura

tio

ns f

or

Sam

sung I

nstinct

Pro

ject

•P

ackage u

p to r

un o

n S

am

sung In

stinct H

andset (w

/o S

WIL

JA

R f

ilein

clu

ded

in

your

pro

ject)

–7: T

esting

•A

ppendix

–A

: C

reating I

nstinct

pro

jects

in

Sprint

WT

K f

rom

sam

ple

JA

R/J

AD

–B

: C

reating I

nstinct

pro

ject

in N

etb

ea

ns

Sprint P

ropie

tary

and C

onfidential

1: In

sta

lling S

print W

TK

3.3

•P

re-C

on

ditio

ns

–D

ow

nlo

ad a

nd insta

ll JD

K

1.5

+ f

rom

Sun w

ebsite

–D

ow

nlo

ad a

nd insta

ll

Quic

kT

ime t

o s

upport

multi-

media

co

decs a

nd R

TS

P

•D

ow

nlo

ad a

nd I

nsta

ll S

print

WT

K

3.3 –

WT

K a

vaila

ble

at

htt

p:/

/develo

pe

r.sprint.

com

–W

ill a

uto

matica

lly d

ete

ct

JD

K

and Q

uic

kT

ime o

n insta

llation

•S

tart

up W

TK

by s

ele

ctin

g t

he K

-

Toolb

ar

from

you q

uic

k s

tart

menu

Sprint P

ropie

tary

and C

onfidential

2: A

ddin

g S

print W

TK

Into

Netb

eans

•S

tart

up N

etb

eans�

Clic

k o

n T

ools�

Java P

latform

s�

Add

Pla

tform

s�

Java M

E P

latform

Em

ula

tor�

Sprint W

TK

3.3

Sprint P

ropie

tary

and C

onfidential

3: C

reate

New

Instinct P

roje

ct in

Sprint W

TK

3.3

•R

ecom

me

nd c

reating p

roje

ct

in

Sprint

WT

K f

irst

(vs

in N

etb

ea

ns)

as

it w

ill c

reate

a s

am

ple

mid

let,

that

decla

res t

he p

roper

decla

ratio

ns t

o

use t

he S

WIL

(S

am

sung W

idg

et

Instinct

Lib

rary

) –

then im

port

the

pro

ject

into

Netb

eans f

or

your

develo

pm

ent

–O

pen S

print

WT

K 3

.3

–S

ele

ct

‘Open P

roje

ct’

•S

ele

ct S

am

sung Instinct P

roje

ct

•M

ake s

ure

gene

rate

s s

am

ple

mid

let

Sprint P

ropie

tary

and C

onfidential

3: C

reate

New

Instinct P

roje

ct in

S

print W

TK

3.3

(settin

g J

SR

s/P

erm

issio

ns)

•O

nce

you

ha

ve

cre

ate

d y

ou

r p

roje

ct,

define

wh

ich

JS

Rs

/ S

prin

t E

xte

nsio

ns y

ou

wis

h to

use

in

you

r ha

nd

se

t

–L

ist

of

supp

ort

ed

JS

Rs

are

:•

JS

R 7

5 P

IM

•JS

R 8

2 B

lueto

oth

(note

only

JS

R b

y d

efa

ult n

ot

sele

cte

d –

ple

ase m

ake s

ure

to c

heck this

if

you

wis

h to u

se b

lueto

oth

in y

ou

r app)

–A

lso

re

fer

to th

e b

lueto

oth

sa

mp

le a

pp

pro

vid

ed

o

n t

he

AD

P w

eb

site

•JS

R 1

20 M

essagin

g

•JS

R 1

35 M

ulti-

Media

•JS

R 1

77 S

AT

SA

•JS

R 1

79 L

BS

•JS

R 1

84 3

D

•S

print E

xte

nsio

ns 2

.0 a

re s

upport

ed

•O

nce y

ou h

ave s

ele

cte

d w

hic

h J

SR

syou w

ish

to u

tiliz

e in y

our

applic

ation, th

e S

print W

TK

3.3

in

clu

des a

wiz

ard

for

you to a

dd the r

equired

perm

issio

ns a

ssocia

ted w

ith those c

apabili

ties

–P

lea

se

refe

r to

th

e S

prin

t M

IDP

2.0

CD

MA

code

sig

nin

g d

ocu

men

t to

und

ers

tan

d w

hic

h J

SR

sa

re

restr

icte

d a

nd

ho

w t

o e

na

ble

the

de

ve

lop

men

t m

ode

on

the

In

stin

ct

–If

yo

u u

se

re

str

icte

d A

PIs

an

d d

on

’t d

ecla

re t

he

m

pro

pe

rly,

yo

u w

ill s

ee

a 9

09

do

wn

load

err

or

on

yo

ur

han

dse

t w

he

n t

ryin

g t

o in

sta

ll th

e c

om

pile

d

ap

p

Sprint P

ropie

tary

and C

onfidential

3: C

reate

New

Instinct P

roje

ct in

S

print W

TK

3.3

(lo

okin

g a

t genera

ted c

ode)

•W

hen y

ou h

ave c

om

ple

ted

cre

ating y

our

pro

ject you w

ill

see the p

roje

ct and a

ssocia

ted

fold

ers

•C

lick in the s

ourc

e file

fold

er

and y

ou c

an s

ee the s

am

ple

app g

enera

ted c

ode

Sprint P

ropie

tary

and C

onfidential

3: C

reate

New

Instinct P

roje

ct in

S

print W

TK

3.3

(S

tart

ing u

p in E

mula

tor)

•T

o r

un y

our

sam

ple

pro

ject in

th

e e

mula

tor

–1:

Sele

ct

the D

evic

es T

ab

–2:

Sele

ct

the M

IDP

2.0

MV

M

dro

p d

ow

n t

ab

–3:

Sele

ct

the d

evic

e la

bele

d

Sam

sung M

80

0 (

Instinct)

–4:

Sele

ct

Run

–5: T

he I

nstinct E

mula

tor

win

do

w w

ill p

op u

p w

ith y

our

sam

ple

applic

ation r

unn

ing

Sprint P

ropie

tary

and C

onfidential

3: C

reate

New

Instinct P

roje

ct in

S

print W

TK

3.3

(P

ackagin

g U

p)

•If y

ou w

ish to p

ackage u

p a

pp (

not

required to im

port

your

pro

ject in

to

Netb

eans)

Clic

k o

n ‘S

ettin

gs’in

main

m

enu a

nd then s

ele

ct ‘E

xte

rnal A

PIs

’

–P

lease n

ote

the d

efa

ult is t

o inclu

de t

he

Sam

sung I

nstinct

Wid

get

Lib

rary

lib

rary

into

your

JA

R f

ile.

Make s

ure

yo

u

un

ch

eck t

his

becau

se:

•If y

ou

deplo

y to

a r

eal handset an

d y

ou

r

app h

as this

inclu

ded in y

our

app

, your

app w

ill e

rror

out

as the S

am

sung instinct

handset alread

y h

as the S

WIL

capabili

ties b

urn

ed into

the h

andset

•If y

ou

wis

h to

take y

ou

r p

roje

ct an

d im

port

into

anoth

er

dev/p

ackage e

nvironm

ent

(Netb

eans,

Eclip

se,

you

r o

wn

ant

scripts

,

etc

) w

e p

rovid

e t

he S

WIL

JA

R file

as a

separa

te b

inary

dow

nlo

adable

that

you

utiliz

e a

s y

ou

r p

roje

ct needs to.

Sprint P

ropie

tary

and C

onfidential

4:

Op

en

ing

In

stin

ct P

roje

ct

Cre

ate

d w

ith

Sp

rin

t W

TK

3.3

in

to N

etb

ea

ns (

ad

d in

Sa

msu

ng

Wid

ge

t In

stin

ct L

ibra

ry in

Ne

tbe

an

s)

•Y

ou o

nly

need to

do this

ste

p 1

tim

e

for

your

firs

t In

stinct pro

ject

only

–Y

ou n

eed to

cre

ate

a n

ew

lib

rary

whic

h

conta

ins the

Sam

sung

Instinct W

idget

Lib

rary

Jar

file

Sprint P

ropie

tary

and C

onfidential

4:

Op

en

ing

In

stin

ct P

roje

ct

Cre

ate

d w

ith

Sp

rin

t W

TK

3.3

in

to N

etb

ea

ns (

Lin

kin

g t

o

Sa

msu

ng

In

stin

ct Ja

va

Do

cs)

•O

pen t

he L

ibra

ry

Manag

er

from

the

Tools

->

Lib

rari

es

menu.

•S

ele

ct

the S

am

sung

Instinct

libra

ry

•C

lick t

he J

ava

doc

tab

and c

lick o

n t

he A

dd

JA

R/F

old

er

butt

on

Sprint P

ropie

tary

and C

onfidential

4: O

penin

g Instinct P

roje

ct C

reate

d w

ith

Sprint W

TK

3.3

into

Netb

eans (

Lin

kin

g to

Sam

sung Instinct Java D

ocs)

•N

avig

ate

to the

docs f

old

er

in

the W

TK

in

sta

ll directo

ry.

•F

or

the I

nstinct

Javad

ocs

choose t

he

docs\a

pi\Java

Wid

getd

oc

fold

er

Sprint P

ropie

tary

and C

onfidential

4: O

penin

g Instinct P

roje

ct C

reate

d w

ith

Sprint W

TK

3.3

into

Netb

eans (

Lin

kin

g to

Sam

sung Instinct Java D

ocs)

•C

lick O

K t

o c

om

ple

te

the J

avadoc

libra

ry

additio

n.

Sprint P

ropie

tary

and C

onfidential

5: O

penin

g Instinct P

roje

ct C

reate

d w

ith

Sprint W

TK

3.3

into

Netb

eans

•O

pen N

etb

eans

•G

o to F

ile�

Open

Pro

ject�

Your

Pro

ject N

am

e

•Y

our

Pro

ject w

ill n

ow

be

Opened in N

etb

eans

Sprint P

ropie

tary

and C

onfidential

5: O

penin

g Instinct P

roje

ct C

reate

d w

ith

Sprint W

TK

3.3

into

Netb

eans (

Assig

nin

g

Instinct E

mula

tor

from

Sprint W

TK

3.3

)•

To a

ssig

n S

print

WT

K 3

.3

Instinct

Em

ula

tor

to y

our

pro

ject

with

in n

etb

eans

–B

uild�

Set

Main

Pro

ject

Config

ura

tio

n�

Custo

miz

e

–S

ele

ct

Sprint

WT

K 3

.3

–S

ele

ct

Sam

sun

g

M800(I

nstinct)

Sprint P

ropie

tary

and C

onfidential

5: O

penin

g Instinct P

roje

ct C

reate

d w

ith

Sprint W

TK

3.3

into

Netb

eans (

Addin

g S

am

sung

Instinct W

idget lib

rary

to y

our

pro

ject)

•R

ight clic

k o

n y

our

pro

ject, s

ele

ct

‘pro

pert

ies’

•S

ele

ct ‘L

ibra

ries a

nd R

esourc

es’

–S

ele

ct A

dd L

ibra

ry (

make s

ure

the ‘U

se V

alu

es fro

m ‘D

efa

ult C

onfig’is

UN

CH

EC

KE

D)

Sprint P

ropie

tary

and C

onfidential

5: O

penin

g Instinct P

roje

ct C

reate

d w

ith

Sprint W

TK

3.3

into

Netb

eans (

Runnin

g y

our

applic

ation)

•S

ele

ct

Run in y

our

menu o

ptio

ns

–If y

ou

have a

dded in the Instinct JA

R file

and lin

ked to t

he S

am

sun

g Instinct

handset (M

800)

then y

ou

r p

roje

ct

should

run in the e

mula

tor

image

Sprint P

ropie

tary

and C

onfidential

•T

o a

void

sele

ct/

rem

ove t

he I

nstinct

Wid

get

Lib

rary

bun

dle

each t

ime y

ou b

uild

the

app t

o r

un in t

he e

mula

tor

or

to d

eplo

y t

o t

he

real pho

ne,

cre

ate

2 c

onfig

ura

tions in

yo

ur

NetB

ea

ns

pro

ject.

1:

Instinct

em

ula

tor

2:

Instinct

phon

e.

Note

that

the B

uild

4P

ho

ne c

onfigura

tion h

as t

he I

nstinctW

idgets

libra

ry u

ncheck.

6: D

eplo

yin

g y

our

pro

ject w

ith tw

o d

iffe

rent

configura

tions (

Em

ula

tor

/ H

andset)

Sprint P

ropie

tary

and C

onfidential

•Use the B

uild

4P

hone c

onfigura

tion to b

uild

your

app to d

eplo

y o

nth

e

Instinct phone.

6: D

eplo

yin

g y

our

pro

ject w

ith tw

o d

iffe

rent

configura

tions (

Em

ula

tor

/ H

andset)

Sprint P

ropie

tary

and C

onfidential

•NetB

eans

will

cre

ate

a s

epara

te f

old

er

for

the B

uild

4P

ho

ne c

onfigura

tion.

Here

is w

here

to f

ind

your

JA

D/J

AR

file

to d

eplo

y t

o t

he I

nstinct

phone.

6: D

eplo

yin

g y

our

pro

ject w

ith tw

o d

iffe

rent

configura

tions (

Em

ula

tor

/ H

andset)

Sprint P

ropie

tary

and C

onfidential

•N

otice t

he J

AR

file

in t

he b

uild

for

em

ula

tor

configura

tion is s

ignific

antly la

rger,

as it

bundle

s t

he I

nstinct

Wid

gets

lib

rary

6: D

eplo

yin

g y

our

pro

ject w

ith tw

o d

iffe

rent

configura

tions (

Em

ula

tor

/ H

andset)

Sprint P

ropie

tary

and C

onfidential

7: T

esting

•T

here

are

thre

e o

ptions a

vaila

ble

to h

elp

you t

est

your

Instinct

applic

atio

n:

–In

stinct

em

ula

tor

availa

ble

thro

ugh W

TK

3.3

–A

ccess r

eal In

stinct

handset

via

the S

print

Virtu

al

Develo

per

Lab

htt

p:/

/ww

w.d

evic

ean

yw

here

.c

om

/sprint/

welc

om

e.h

tm

–D

eplo

y y

our

JA

D/J

AR

to a

Sam

sung I

nstinct

Handset

in

yo

ur

ph

ysic

al p

ossessio

n

htt

p:/

/ra.p

csla

b.c

om

/uplo

ad/in

de

x.p

hp

Sprint P

ropie

tary

and C

onfidential

Appendix

Sprint P

ropie

tary

and C

onfidential

A: Im

port

ing S

am

sung Instinct S

am

ple

Apps

into

Sprint W

TK

•S

print pro

vid

es s

am

ple

apps a

t http://d

evelo

per.

sprint.com

/instinct

•Y

ou c

an im

port

the J

AR

/JA

D file

s

into

the S

print W

TK

3.3

to c

reate

a

pro

ject th

at can b

e im

port

ed into

N

etb

eans

Sprint P

ropie

tary

and C

onfidential

B: C

reating Instinct P

roje

ct in

Netb

eans (

cont)

•C

reate

Mob

ile P

roje

ct

usin

g S

print

MID

P t

em

pla

te

•S

ee S

ection 4

to a

dd in t

he

instinct

jar

to y

our

libra

ry (

if y

ou

have n

ot

do

ne t

his

)

•S

ee S

ection 5

to a

dd t

he S

WIL

lib

rary

to y

our

pro

ject

•R

efe

rence J

ava D

oc o

r S

am

sung

Instinct

Handset

Develo

per

guid

e

for

pro

per

cod

e d

ecla

rations t

o

utiliz

e S

WIL

lib

rary

•S

ee S

ection 5

to lin

k t

o t

he

Sam

sung M

80

0 E

mula

tor

•S

ee S

ection 6

to b

uild

tw

o

diffe

rent

config

ura

tion (

em

ula

tor

and h

andset

w/o

SW

IL lib

rary

)