documentation 3.0.3
TRANSCRIPT
-
8/17/2019 Documentation 3.0.3
1/24
Spatullr User Guide
Version 3.0.3
-
8/17/2019 Documentation 3.0.3
2/24
-
8/17/2019 Documentation 3.0.3
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.
-
8/17/2019 Documentation 3.0.3
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'.
-
8/17/2019 Documentation 3.0.3
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*;.
-
8/17/2019 Documentation 3.0.3
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.
-
8/17/2019 Documentation 3.0.3
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.
S$atullr co$yright 2,+". All rights reserved. $ongodev.
Illustraon 3: Sync gradle le
Illustraon !: Create new pac"age
-
8/17/2019 Documentation 3.0.3
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.
-
8/17/2019 Documentation 3.0.3
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
-
8/17/2019 Documentation 3.0.3
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.
S$atullr co$yright 2,+". All rights reserved. $ongodev.
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/
-
8/17/2019 Documentation 3.0.3
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.
S$atullr co$yright 2,+". All rights reserved. $ongodev.
Illustraon 12: Open s4lite data0ase
Illustraon 13: Add new data to t0l5categories
-
8/17/2019 Documentation 3.0.3
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.
S$atullr co$yright 2,+". All rights reserved. $ongodev.
Illustraon 1!: pdate e-isng data
Illustraon 1#: Insert data to t0l5recipes
-
8/17/2019 Documentation 3.0.3
13/24
+3
). Three other Eelds that you need to $ay a>enon are ingredients9 ste$s9 and i'age.
-
8/17/2019 Documentation 3.0.3
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
-
8/17/2019 Documentation 3.0.3
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.
S$atullr co$yright 2,+". All rights reserved. $ongodev.
Illustraon 2/: Clic"ing *one6e new app 0u7on
Illustraon 21: 8illing App na)e and %la9or) +or)
-
8/17/2019 Documentation 3.0.3
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.
S$atullr co$yright 2,+". All rights reserved. $ongodev.
Illustraon 22: Selecng ad +or)at and conguraon
Illustraon 23: Copying Ad unit ID
-
8/17/2019 Documentation 3.0.3
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.
-
8/17/2019 Documentation 3.0.3
18/24
-
8/17/2019 Documentation 3.0.3
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.
-
8/17/2019 Documentation 3.0.3
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
S$atullr co$yright 2,+". All rights reserved. $ongodev.
Illustraon 2.: Access drawa0le directories via window e-plorer
-
8/17/2019 Documentation 3.0.3
21/24
-
8/17/2019 Documentation 3.0.3
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.
-
8/17/2019 Documentation 3.0.3
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.
S$atullr co$yright 2,+". All rights reserved. $ongodev.
Illustraon 33: 8ill re4uired +or) in $ew =ey Store window
-
8/17/2019 Documentation 3.0.3
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
S$atullr co$yright 2,+". All rights reserved. $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