Go Launcher Template V1.2

15
GO Launcher EX Theme Template Release V1.2 Important This guidance is for windows systems. Please make sure that Java JDK has been installed, and the packaging tool will use it later. JDK download link http://www.oracle.com/technetwork/java/javase/downloads/index.html or http://www.onlinedown.net/soft/61003.htm 1. Template’s files list Unzip the zip file Theme_Template.zip, you can see the files list. And the usage for each directory and each file is showed below. 2. Make your own theme step by step. 2.1 Change the AndroidManifest.xml

Transcript of Go Launcher Template V1.2

Page 1: Go Launcher Template V1.2

GO Launcher EX Theme Template

Release V1.2

Important: This guidance is for windows systems. Please make sure that Java JDK has been

installed, and the packaging tool will use it later.

JDK download link http://www.oracle.com/technetwork/java/javase/downloads/index.html

or http://www.onlinedown.net/soft/61003.htm

1. Template’s files list

Unzip the zip file Theme_Template.zip, you can see the files list. And the usage for

each directory and each file is showed below.

2. Make your own theme step by step.

2.1 Change the AndroidManifest.xml

Page 2: Go Launcher Template V1.2

2.2 Change the SRC

Remember the package name you modify in previous chapter.

\src\com\gau\go\launcherex\theme\template\R.java

\src\com\gau\go\launcherex\theme\template\template.java

Page 3: Go Launcher Template V1.2

2.3 Change the files in \assets

A. themecfg.xml

B. app_func_theme.xml

This xml is complicated, if you don’t want to modify the app drawer’s structure, you can

just read this part as reference, once you have question in app drawer, you can back to

this chapter to find the answer.

Page 4: Go Launcher Template V1.2

Some conventions of the label: (A)、Use a 32 bits to express Hexadecimal color value,Specific for #ARGB,A:alpha; R:Red; G:Green; B:Blue.Each element uses 8 bits.

(B)、There are three kinds of drawing mode:0:Tiled 1:Stretched 2:Center,but these modes are not for 9 patch map.

(C)、Distance unit is pixel <Folder>

“bg_frame_way_of_drawing”: Drawing mode of folderopenback.png “line_enabled”:Draw a cut-off rule in a folder? 0:no;1:yes “folder_open_bg_color”:The background color when folder is open “bg_frame_image_bottom_heigth”:The distance from icon to background bottom inside a folder .

</Folder>

<AllTabs >

“bg_v_image”:The background image of the entire Tab bar (Vertical screen),“none”for no pictures,can be replaced to \res\drawable-hdpi folde’s image name(Without extension ),and the selected images will be used as tab bar background image. “bg_h_image”:The background image of the entire Tab bar (Horizontal screen) “bg_way_of_drawing”:Mode to draw the background image </AllTabs>

Within the meaning of this tag <Tab> background image is referred to in the <AllTabs> tag

on background image, that is a single Tab's background picture

<Tab>

“bg_way_of_drawing”:A single Tab background image tab_v.9.png and tab_h.9.png drawing way.

“selected_way_of_drawing”:A single Tab selected background image tablight_v.9.png and tablight_h.9.png drawing way

“focused_way_of_drawing”: A single Tab clicked or focused background image

tabfocused_v.9.png and tabfocused_h.9.png drawing mode.

“cutLine_enabled”:Draw a cut-off rule in Tab? “0”:no;“1”:yes. </Tab>

<TabTitle>

“unselected”:Tab column not selected,the color of Tab column name “selected”: Tab column selected,the color of Tab column name “gap_v”:The distance between Name and bottom (Vertical screen) “gap_h”:The distance between Name and bottom (Horizontal screen) </TabTitle>

<Home>

“bg_way_of_drawing”: The way of drawing the background of the bottom of the home

Page 5: Go Launcher Template V1.2

field homebg.png

“bg_color”: home area color </Home>

<MoveToDesk>

“bg_way_of_drawing”: Mode of drawing background appfunc_movetodesk.png “bg_color”: Color of text "Move to Screen" </MoveToDesk>

<ClearHistory>

“bg_selected_way_of_drawing” : The drawing mdoe of the background image

button_v2.9.png and button_h2.9.png when the button was being selected .

“bg_unselected_way_of_drawing”: The drawing method of the background image

button_v.9.png and button_h.9.png when the button is not selected

</ClearHistory>

<CloseRunning>

In the Template "running" Tab bar "close all programs" button and "Clear History" button

are the same pictures. If the "Close all programs" button image need to be used in

difference, it needs to set the new pictures under the /res/drawable-hdpi folder, and modify

the <CloseRunning> label of the app_func_theme.xml .Projects must be amended of the

label:

“bg_v_unselected_image”:The background image name of button not selected(Vertical screen)

“bg_h_selected_image”: The background image name of button selected(Vertical screen)

“bg_h_unselected_image”: The background image name of button not

selected(Horizontal screen)

“bg_h_selected_image”: The background image name of button selected(Horizontal

screen)

</CloseRunning>

<AppIcon>

“text_color”:The color of program name “text_bg_color”:the background color of program </AppIcon>

<AppSetting>

“grid_format”: The count of the ranks of menu.“1”:4×4;“2”:4×5;“3”:5×5 </AppSetting>

C. desk.xml

This xml is complicated, if you don’t want to modify the desk’s structure, you can just read

this part as reference, once you have question in desk, you can back to this chapter to find

the answer.

Page 6: Go Launcher Template V1.2

D. drawable.xml,

The form is<item drawable="icon file name">; List the picture which need to show in turn;

Users need to replace the same name file in the “\res\drawable-hdpi “document, at the

same time users can add/remove the files in both \assets\drawable.xml and

\res\drawable-hdpi

The other files in \assets will be introduced later.

Here you can just let it unchanged.

2.4 Change the files in \res

2.4.1 Change the files in \res\drawable-hdpi

All the files in this folder are corresponding to the files in \assets, you can just

replace/delete/add the image files here.

A. The images for APP Drawer. � app_func_theme.xml

You can change the APP Drawer background and icons, just make your own picture to a

specific file name, replace the same name file in \res\drawable-hdpi. Please try to use the

correct size to replace. You should know corresponding image’s size before you make

your own image. Otherwise the images may appear strangely.

Note: *.9. Png is the android picture format: nine-patch map,you can use /tools/draw9patch.bat to generate images into this format

More info please read: http://developer.android.com/guide/developing/tools/draw9patch.html

If you think this is complicated, you can just modify the color of *.9.png simply.

Page 7: Go Launcher Template V1.2

The pictures can be replaced in APP Drawer are as follows:

File Name Description

funbg.jpg The background of APP Drawer

appfunc_folderback.png The background of folder thumbnails

appfunc_folder_open.png The cover appeared on the folder icon when dragging

program icon to the folder icon.

appfunc_foloder_close_up.png:

The cover appeared on the folder icon when long

pressing folder icon.

folderopenback.png The background of open folder

folderclose.png

The button of closing folder

folder_close_light.png

The icon appeared when hide button is clicked

tab_v.9.png The background of single Tab(Vertical screen)

tab_h.9.png The background of single Tab (Horizontal screen)

tablight_v.9.png The background of the single Tab selected (vertical

screen)

tablight_h.9.png The background of the single Tab selected (Horizontal

screen)

tabfocused_v.9.png The background of the single Tab clicked or focused

(vertical screen)

tabfocused_h.9.png The background of the single Tab clicked or focused

(Horizontal screen)

allapp.png The icon of "All” Tab column not selected

allapp_selected.png The icon of "All" Tab column selected

history.png The icon of“History” Tab column not selected

history_selected.png The icon of “Recent” Tab column selected

run.png The icon of“Running” Tab column not selected

run_selected.png The icon of “Running” Tab column selected

appfunchome.png The icon of “Home” icon not selected

shortcut_light_iconbg.png The icon of “Home” icon selected

homebg.png The background of ”Home” (vertical screen)

appfunc_movetodesk.png The background of “Home” when icon moves

into( vertical screen)

button_v.9.png The background of “Clear History” button in “History”

(vertical screen)

button_v2.9.png The background of “Clear History” button selected(vertical screen) button_h.9.png The background of “Clear History” button not selected(Horizontal screen) button_h2.9.png The background of “Clear History” button selected(Horizontal screen)

Page 8: Go Launcher Template V1.2

appfunc_screennow.png The highlighting indicator icon of current screen

appfunc_screenother.png The indicator icon of other screen

B. The images for APP Drawer. � desk.xml

Users need to replace the same name file in the “\res\drawable-hdpi ” document.

The following description will describe the replaceable images:

File Name Description

folder_back.png Base map thumbnail folder on the desktop

folder_open.png When you drag the program icon to a folder icon, the cover

on the folder icon

folder_close_up.png When press the folder icon, the cover on the folder icon

screennow.png The highlighting indicator icon of current screen

screenother.png The indicator icon of other hide screen

phone.png icon “phone” in “Dock” bar shown as in the menu

contacts.png icon “contacts” in “Dock” bar shown as in the menu

d_home.png icon “APP Drawer” in “Dock” bar

messaging.png icon “message” in “Dock” bar shown as in the menu

browser.png icon “browser” in “Dock” bar shown as in the menu

d_add.png icon “+” in “Dock” bar

C. The images for App Icons

Here, let’s talk about \assets\appfilter.xml first.

<iconback> marks the base image of icon, the template provides five bases to be used by

applications randomly.

<iconback img1="iconback" img2="iconback2" img3="iconback3" img4="iconback4"

img5="iconback5"/>,where the first base image is iconback.png, the second is

iconback2.png ... ...

Users can make changes based on the number of base, which the naming rule is imgN =

"image file name (without extension) ", (N is the Nth base). Base pictures are in res/

drawable-hdpi.

If you have only 3 or 1 base icon(s), you should modify the code to

<iconback img1="iconback"/>

<iconback img1="iconback" img2="iconback2" img3="iconback3" />

And above code is corresponding to the icons in res / drawable-hdpi

Some commonly used programs can be set to a particular icon, the user can replace the

corresponding images in \res\drawable-hdpi , as follows:

Page 9: Go Launcher Template V1.2

File Name Description

market.png Google Market

messaging.png SMS message

contacts.png Contacts

phone.png Phone

calendar.png Calendar

clock.png Clock

settings.png Settings

browser.png Browser

camera.png Camera

music.png Music

gallery.png Gallery

calculator.png calculator

maps.png Google maps

email.png E-mail

gtalk.png Google Talk

googlesearch.png Google Search

facebook.png Facebook

twitter.png Twitter

opera.png Opera

weibo.png Sina microblogging

renren.png renren.com

handcent.png Handcent sms

operamin.png Opera mini

taskmanager.png Task Manager

skype.png Skype

kikmessenger.png Kik Messenger

meno.png Meno

picsay.png PicSay

qq.png QQ

uc.png UC browser

yahoomail.png Yahoo Mail

yahoomessenger.png Yahoo Messenger

pdf.png Adobe Reader

gochat.png Go!Chat

dropbox.png Dropbox

kakaotalk.png KakaoTalk

If you don’t want these icons to be showed, please delete these icons in \res\

drawable-hdpi. And the above icons are corresponding to the \assets\appfilter.xml

Page 10: Go Launcher Template V1.2

D. The image for your app Icon

You should replace the icon.png in \res\drawable-hdpi, \res\drawable-mdpi and

\res\drawable-ldpi with your theme’s icon; pay more attention to the different size of the

different dpi.

2.4.2 Modify the files in \res\values

A. array.xml

Page 11: Go Launcher Template V1.2

You can add the wallpaper in array.xml, if you have only one wallpaper, please remove

the unused wallpaper name in both array.xml and \res\drawable-hdpi

B. String.xml

Modify "Theme Template GO Launcher EX"

Page 12: Go Launcher Template V1.2

These changes are for the default language,but for Simplified Chinese, Traditional Hong Kong, Traditional Taiwan, respectively need to edit \res\values-zh-rCN\strings.xml, \res

\values-zh-rHK\strings.xml, \res\values-zh-rTW\strings.xml corresponding fields.

C. themeinfo.xml

Page 13: Go Launcher Template V1.2

These changes are for the default language,but for Simplified Chinese, Traditional Hong Kong, Traditional Taiwan, respectively need to edit \res\values-zh-rCN\strings.xml, \

res\values-zh-rHK\strings.xml, \res\values-zh-rTW\themeinfo.xml corresponding fields.

For the other language, you can copy the \res\values to \res\values-???, then modify it by

yourself. You can find the language info in the below link.

http://www.icanlocalize.com/site/tutorials/android-application-localization-tutorial/

2.5 Change the Do_path.bat

Page 14: Go Launcher Template V1.2

Note: If you want to sign with your own generated keystore, please set KEYSTORE_FILE,

KEYSTORE_PASS, KEYSTORE_ALIAS to the corresponding options.

See http://blog.sina.com.cn/s/blog_54b5ea250100ewn1.html or

http://developer.android.com/guide/publishing/app-signing.html

2.6 Change the theme information

In the console called "makeall.bat your own package name" will generate "your own

package name _signed.apk ",install this installation package to the phone, and then see

the effect of it!

Page 15: Go Launcher Template V1.2

3. Troubleshooting

First, check that whether it generated the theme package strictly according to the tutorial above.

And if there are problems still, turn to the console to run "Do_path", "make_res", "make_apk your

own package name", "sign your own package name," observing the output of each command and

solving your problem based on false information . The most likely problem is make_res command.

In fact we use Notepad to open makeall.bat ,we will find makeall.bat is in turn to call the four

commands above.