Documentation 3.0.3

8/17/2019 Documentation 3.0.3

1/24

Spatullr User Guide

Version 3.0.3


2/24


3/24

3

Revision History

Author Remarks Version Date

Tauan 5. $dated hole docu'entaon content 3.,.+ 22 6anuary

2,+"

Tauan 5. $dated change log 3.,.2 +2 February

2,+"

Tauan 5. $dated change log 3.,.3 7 8arch 2,+"

S$atullr co$yright 2,+". All rights reserved. $ongodev.


4/24

4

Introduction

Than( you or $urchasing our ite'9 S$atullr :$reviously (no!n as Reci$es A$$ or Android;. I you

have any quesons that are beyond the sco$e o this user guide9 $lease eel ree to $ost the

quesons via $ongodev su$$ort oru'.


5/24

"

Dhen you $urchase this ite' you !ill get the ollo!ing assets

+. A$$ source code

2. ser guide

Change Log version 3.0.3:

• 8a(e it su$$ort unicode language

• /hange ty$ogra$hy rule !ith 'aterial design rule

• /hange $adding si0e !ith 'aterial design rule

Installing Required SoftwaresAs this $ro&ect no! use Android Studio9 you need to do!nload Android Studio Erst in order to be

able to conEgure the a$$. Besides Android Studio9 you also need to install the latest version o 6ava

*evelo$'ent it :6*;.


6/24

C

3. A ne! !indo! !ill o$en Android $ro&ect and the $ro&ect !ill a$$ear on %ro&ect !indo! on

the le side.

4.


7/24

)

). Dhen running this a$$ you !ill End that the a$$ sll co'es !ith du''y data. on.

3. Insert your ne! $ac(age na'e in Ge! %ac(age !indo! and clic( O& bu>on. De suggest to

use your !ebsite na'e ollo!ed by your a$$ na'e. For e?a'$le9 "om.e'site.,ourapp.

See Illustraon " or detail.


Illustraon 3: Sync gradle le

Illustraon !: Create new pac"age


8/24

7

4. Aer that9 'ove all directories in old $ac(age to your ne! $ac(age by selecng all

directories and drag the' to your ne! $ac(age na'e.

". on. I there is a %roble' *etected !indo! a$$ear9

&ust clic( Connue bu>on. De !ill E? it later. All directories no! are located in your ne!

$ac(age na'e.


9/24

1

Anroi)ani2est.xml in app1mani2ests directory and End "om.pongoev.re"ipesapp.

Re$lace it !ith your o!n $ac(age na'e. Scroll do!n the Ele and End the ollo!ing code9


10/24

+,

+,. #ther Eles !hich also required to change the $ac(age na'e are res1xml1sear"ha'le.xml

and !ava1"om.,our.pa"kage1uls14ls.!ava. Find "om.pongoev.re"ipesapp in both Eles

and re$lace the' !ith your ne! $ac(age na'e.

++. ast ste$9 re'ove import "om.pongoev.re"ipesapp.R5 code in all &ava Eles.

+2. Try to run the $ro&ect to see the result. I you ollo! the ste$s above correctly9 you !ill see

that the a$$ sll !or( $ro$erly.

Inserting $ata to $atabase

This a$$ use Site database to stored the data. Belo! are ste$s to store data to database

+. First9 do!nload s6lite'roser here and install it to your co'$uter.

2. Run sqlitebro!ser and o$en database dbJreci$es that located in app1sr"1main1assets

directory o your Android $ro&ect by clic(ing Open Data'ase.


Illustraon .: Change pac"age na)e in gradle le

Illustraon 1/: Change pac"age na)e in searcha0le,-)l and ls,java

Illustraon 11: e)ove i)port co),pongodev,recipesapp,

http://sqlitebrowser.org/http://sqlitebrowser.org/http://sqlitebrowser.org/


11/24

++

3. on to delete category data.

4. By deault9 there are already category data !ithin the tblJcategories9 you can delete the'

and add your o!n data or u$date the data by double clic( on categoryJna'e data. As

categoryJid is auto incre'ent you do not need to insert it9 you only need to insert

categoryJna'e data but re'e'ber to ta(e a note o all categoryJid because they !ill be

used in tblJreci$es.


Illustraon 12: Open s4lite data0ase

Illustraon 13: Add new data to t0l5categories


12/24

+2

". Aer inserng or u$dang category data9 the ne?t data you need to insert is reci$e. To

insert reci$e data select t'l7re"ipes in Table dro$do!n. %lease delete all du''y data in

that table and insert yours by clic(ing -e Re"or bu>on.

C. Fill categoryJid !ith categoryJid that available in tblJcategories. For e?a'$le9 i in

tblJcategories there is category called Beverage !ith category id "9 then !hen you create

orange &uice reci$e in tblJreci$es you need to insert ":category id o Beverage; in

categoryJid o tblJreci$es.


Illustraon 1!: pdate e-isng data

Illustraon 1#: Insert data to t0l5recipes


13/24

+3

). Three other Eelds that you need to $ay a>enon are ingredients9 ste$s9 and i'age.


14/24

+4

o the Ele only9 !ithout e?tension.

1. I you have already inserted all o your data9 do not orget to save your database. /lic(

;rite Changes bu>on at the to$ o sqlitebro!ser.

+,. Run the a$$ to see the result.

Setting %p Ad"ob

Ge! version o S$atullr co'es !ith the latest version o Ad'ob !hich has diKerent conEguraon

!ith $revious version. To set u$ ne! version o Ad'ob 'a(e sure that you have already u$graded

your Ad'ob account. @o to a$$s.ad'ob.co' and login !ith your Ad'ob account9 i you have not

u$graded your account yet $lease see this guide ro' @oogle about ho! to do it. Belo! are ste$s

to set u$ Ad'ob on Android $ro&ect

+. ogin to Ad'ob !ith your account and select )one


15/24

+"

2. Select A ,our app manuall, and Ell App name and /la=orm or'9 clic( A app bu>on

!hen done.

3. Ge?t ste$ is selecng the ad ty$e9 select 8anner and do so'e conEguraon to the banner9

clic( Save bu>on !hen Enish.


Illustraon 2/: Clic"ing *one6e new app 0u7on

Illustraon 21: 8illing App na)e and %la9or) +or)


16/24

+C

4. D9 co$y that I* and clic( Done bu>on to Enish.

". #$en strings.?'l and re$lace 8A--?R7AD74->@7>D !ith Ad unit I*.

on to create ne! ad unit.


Illustraon 22: Selecng ad +or)at and conguraon

Illustraon 23: Copying Ad unit ID


17/24

+)

). In ad or'at o$on9 select >ntersal. And the rest conEguraon is si'ilar !ith ad banner

or'at. /lic( Save bu>on !hen Enish.

7.


18/24


19/24

+1

Custo"i&ing Application Color

S$atullr has i'$le'ented 'aterial design in the user interace design so that custo'i0ing the color

o the a$$ beco'e easier. Here is ho! to change the color o the a$$

+. #$en "olors.xml that located in res1values directory.

2. "olor7primar, is used or toolbar color9 "olor7primar,7ark is used or status bar color:this

only !or( in Android "., only;9 and text7"olor7primar, is used or te?t tle color in toolbar.

3. I you !ant to change the color based on @oogle 8aterial *esign guidelines9 you can use

'aterial$ale>e.co' as reerence.

4.


20/24

2,

custo'i0aon o i'age resources and a$$ content

+. To change launcher icon o the a$$9 create your o!n icon in /-+ or'at and na'e it as

i"7laun"her.png. /reate it in 4 diKerent si0es !ith the ollo!ing s$eciEcaons

a; )2?)2 $i?els in res1raa'leEhpi directory9

b; 47?47 $i?els in res1raa'leEmpi directory9

c; 1C?1C $i?els in res1raa'leExhpi directory9 and

d; +12?+12 $i?els in res1raa'leExxhpi directory.

2. %ut those Eles in each directories via !indo! e?$lorer.

3. To change logo o the a$$9 create logo in /-+ or'at and na'e it as i"7logo.png. /reate it in 4

diKerent si0es !ith the ollo!ing s$eciEcaons

a; "4?"4 $i?els in res1raa'leEhpi directory9

b; 3C?3C $i?els in res1raa'leEmpi directory9

c; )2?)2 $i?els in res1raa'leExhpi directory9 and

d; +,7?+,7 $i?els in res1raa'leExxhpi directory.

4. *o the sa'e thing li(e $revious ste$9 access dra!able directories via !indo! e?$lorer.

". The ne?t i'age is s$lash screen logo9 create i'age in /-+ or'at and na'e it as

splash7s"reen7logo.png . /reate it in 4 diKerent si0es !ith the ollo!ing s$eciEcaons


Illustraon 2.: Access drawa0le directories via window e-plorer


21/24


22/24

22

2. 5nable 4S8 De'ugging on your device9 you can read here about ho! to enable SB

debugging on android device.

3. /onnect your Android device to your co'$uter !ith SB cable.

4. Aer that9 on Android Studio select Run $ Run %app%. Select your device in /hoose *evice

!indo! and clic( O& bu>on. See Illustraon 32 or detail.

". I you can see your device on /hoose *evice !indo!9 it 'eans that driver o your Android

device is not installed on your co'$uter yet.


23/24

23

resources o the a$$ and ensuring that the a$$ has been run $ro$erly9 the last ste$ is $ublishing

your a$$ to A% Ele. Belo! are ste$ by ste$ to $ublishing Android $ro&ect to A% Ele

+. on Android Studio9 select 8uil $ +enerate Signe A/&....

2. @enerate Signed A% Di0ard !indo! !ill a$$ear. Select app in 'odule secon then clic(

-ext.

3. In the ne?t ste$9 i you have already created (ey store Ele clic( Choose exisng... and insert

your (ey store $ass!ord and alias. I have not created it yet9 clic( Create ne... to create

ne! (ey store Ele.

4. #n -e &e, Store !indo! Ell all or's that required and clic( O&. See Illustraon 33 or

detail.

". ast is set the desnaon older o A% Eles9 and Build Ty$e to release and clic( inish

bu>on.


Illustraon 33: 8ill re4uired +or) in $ew =ey Store window


24/24

24

%pdating App 'ersion

Dhen you !ant to u$date your a$$ on @oogle %lay9 'a(e sure that you change the versionCoe

and version-ame on 'uil.grale()oule: app* Ele that located in app1+rale S"ripts directory to

higher nu'ber than $revious version and clic( S,n" -o9 see Illustraon 34 or detail.

About the Author

Iello# e are pongoev# mo'ile eveloper team 2rom 9akarta# >nonesia . ounded on 2,+2 !e

started building and selling 'obile a$$licaons as a te'$late on 8ar(et$lace. our a$$s usually

ocusing on ease o use and good design.

;e'site h>$MM$ongodev.co'

Conta"t: contactN$ongodev.co'

a"e'ook h>$sMM!!!.aceboo(.co'M$ongodev

@iJer h>$sMMt!i>er.co'M$ongodev


Illustraon 3!: Change versioCode and version$a)e to update app
http://pongodev.com/http://pongodev.com/mailto:[email protected]:[email protected]://www.facebook.com/pongodevhttps://twitter.com/pongodevhttp://pongodev.com/mailto:[email protected]://www.facebook.com/pongodevhttps://twitter.com/pongodev

Date post:	06-Jul-2018
Category:	Documents
Upload:	azjolnerub
View:	223 times
Download:	0 times

Documentation 3.0.3

Documents