Android specific properties

Transcription

1 Applicatin prperties Andrid specific prperties These prperties are lcated in the Andrid ptins tab n the right f the prperty explrer. Package name The package name serves as unique identifier fr yur applicatin. By default it's cm.yurcmpany.yurapplicatin. It can be als rg.yurrganizatin.yurapplicatin. Replace yurcmpany by the name f yur cmpany, and yurapplicatin by the name f yur applicatin. Minimum Andrid versin This ptin allws yu t set the minimum versin number f Andrid required t run yur applicatin. Yur applicatin wn't be executed n devices with a lwer versin f Andrid. Target Andrid versin This ptin allws yu t set the target versin number f Andrid. This target versin is the main versin yur applicatin has been tested with and develped fr (see dcumentatin f targetsdkversin prperty in the Andrid SDK). Build & Run : install t... This ptin specifies where t install the.apk file t n the cnnected Andrid device r emulatr when yu use the Build and Run cmmand. Yu can install it either t the internal strage r t the SD card. Emulatr Click this buttn t pen the Emulatr dialg bx. This dialg bx allws yu t run the Andrid emulatr (use the Andrid SDK Manager t create virtual devices). When the Andrid emulatr is running, the Build & Run cmmand will install and execute yur applicatin in the emulatr. Warning: the emulatr may take a cuple f minutes t display the Hme screen, be patient. Smetimes Build & Run fails the first time after the emulatr was launched; in this case just try again. The Build & Run cmmand is als smewhat slwer than the nrmal Build cmmand, as the applicatin has t be transfered t the emulatr (r device). Yur applicatin will appear in the emulatr as sn as the build prgress bar disappears in Clickteam Fusin 2.5. Release mde If this ptin is nt selected, the.apk file will be signed with a debug certificate, s that yu can test it n a device. If yu want t release yur applicatin yu need t sign it with a valid certificat. In this case select the Release mde ptin and enter a key stre pathname and key name. Certificate Keystre name Enter the pathname f the keystre that cntains the key t sign yur applicatin. T generate a keystre yu can use the Keytl tl prvided in the bin directry f the JDK. This is a cmmand line tl. Fr example, the fllwing cmmand line will generate the "d:\great-release-key.keystre" file that cntains the "great_key_name" key: keytl -genkey -v -keystre d:\great-release-key.keystre -alias great_key_name - keyalg RSA -keysize validity 10000

2 Keytl asks yu fr yur name, rganizatin, cuntry, the keystre passwrd and key passwrd. Mre inf here. Keystre passwrd Enter the passwrd f the keystre that yu have entered when yu've created it. Key name Enter the name f the key that will be used t sign yur applicatin. See abve fr mre inf. Key passwrd Enter the passwrd f the key yu have entered when creating the keystre. Display mde This ptin allws yu t select either OpenGL ES 1.1 r OpenGL ES 2.0 as graphic renderer. OpenGL ES 2.0 is ften slwer (it depends n the applicatin thugh). Nte: quick backdrp bjects with an ellipse shape require OpenGL ES 2.0. Screen rtatin This ptin allws yu t select the rientatin f yur applicatin windw n the device. Display This ptin allws yu t chse the way yur applicatin is displayed n screen. 6 pssibilities: Center N zming will ccur regardless f the device. The windw will be centered in the screen. Expand/Adjust windw size N scaling will ccur with this ptin, it will expand the windw size t fill the remainder f the screen s n black areas shw. Nte that this will shw mre f yur frame. The actual windw size will be exactly the same as the device reslutin and the frame must be large enugh t supprt this. Tip: Yu can resize yur frame size at runtime at the start f the frame if needed. Fit inside with brders This ptin will scale the game-cntents t tuch the inside f the screen while maintaining the aspect rati. If yur game windw aspect rati isn't the same as the device aspect rati, the cntents will be centered and black brders will shw. This is the default ptin.

3 Fit inside and adjust windw This ptin will scale the game-cntents t tuch the inside f the screen while maintaining the aspect rati. If yur game windw aspect rati isn't the same as the device aspect rati, the game windw will be expanded t fill the remaining f the screen s n black brders shw. Nte that this will shw mre f yur frame. This requires that yur frame is large enugh t display the new area. Fit utside This will scale the game t fill the entire screen s that n black brders shw. This will crp the remaining areas that g utside the screen away. Stretch Ignres any aspect rati and just stretches the cntents t fill the entire display. Graphics can lk squashed if the aspect ratis f the game windw and the device dn't match. Smth resizing If this ptin is selected, graphics are anti-aliazed when the applicatin windw is resized. Display status bar If this ptin is selected, the Andrid status bar will be displayed abve yur applicatin windw. Optins menu Click this ptin t edit the Optins menu f yur applicatin, if any. The Optins menu is displayed when the user clicks the Optins buttn n the devices that have ne. Each menu item cnsist f a text, an icn and an identifier. The identifier allws yu t identify the menu item in the cnditins and expressins f the Andrid bject that allw yu t receive ntificatins when the user selects a menu entry. The icn has a predefined size: the bitmap shuld be 48x48 in size and centered in the image whse size is 72x72. Disable default back buttn behavir This ptin allws yu t disable the default behavir f the Back buttn. Yu can detect if the user presses the Back buttn with a cnditin f the Andrid bject. End applicatin when nt in fregrund If this ptin is selected, the applicatin will be autmatically clsed when the user returns t the hme screen.

4 Require GPU The applicatins created with Clickteam Fusin 2.5 wrk even if the device has n GPU (graphic prcessing unit), hwever mst f them will be very slw if this is the case. Unselect this ptin nly if yur applicatin wrks fine withut GPU. If this ptin is selected, the applicatin wn't start n devices withut GPU. Enable nline crash reprting This ptin nly wrks in Debug mde. When it's selected, when yur applicatin crashes a bug reprt will be autmatically sent t Clickteam's server. Frce 'Play frm disk' fr sunds larger than X secnds This ptin allws yu t save memry. Sunds are preladed int memry, except if their duratin is greater than the time specified in this prperty r if yu have selected their "Play frm disk" ptin in the Data Elements editr. Nte that nly sunds played frm disk are seekable. Seeking desn't wrk fr preladed sunds. Image cmpressin The graphic memry n Andrid devices is limited. The image cmpressin ptin allws yu t reduce the size f the graphics f yur applicatin in memry. Tw ptins are available : Nne and Clr Cmpressin. If yu select "Clr Cmpressin", the images are autmatically cnverted t either clrs (paque images), clrs (unique transparent clr) r 4096 clrs (alpha channel with multiple transparency levels).this ptin will divide the size f yur images by tw. This can reduce the quality f the images, but yu can chse t ignre this ptin fr specific bjects; refer t the bject prperties belw. Images Launcher icn 96x96 image, that represents yur applicatin n an Andrid device's Hme screen. Jystick images This prperty cntains the images f the tuch jystick. Refer t the Jystick ptins in the Frame prperties belw fr mre infrmatin. Versin inf Versin cde Internal versin number. Increment this number each time yu release a new versin. Versin name A string value that represents the release versin f the applicatin, as it shuld be shwn t users. Permissins This list allws yu t select the Andrid permissins required by yur applicatin. Usually these permissins are required by sme features f 3rd party bjects. Lk at the dcumentatin f these bjects t see what features require what permissins, and if yu use these features select the crrespnding permissins. The list f permissins is described in the Andrid SDK. Fr example if yu use the Get bject, yu'll need t select the INTERNET permissin.

5 Frame prperties These prperties are lcated in an ios flder n the right f the prperty explrer. Jystick / Device Clickteam Fusin 2.5 allws yu t emulate a jystick in the Andrid applicatin. With this, yu can use Clickteam Fusin 2.5 default mvements, cntrlled by a jystick n the device. This cmb bx ffers yu the chice f jysticks : Nne N jystick is displayed. Only use this prperty when yur frame des nt cntain any jystick-cntrlled mvement Tuch jystick The jystick is emulated n the bttm f the screen f the device. Using yur fingers, yu can cntrl the mvements. The jystick cnsists f a paddle buttn and tw fire buttns. Accelermeters The mvements are cntrlled by the psitin f the device. Tw fire buttns are available n the screen. Cntrlled by an extensin Chse this prperty t manually start r stp the jystick using the Jystick Cntrl bject. Please nte that this bject will nt wrk if this prperty is nt set t this value. Fire 1 buttn Check this bx if yu want the Fire 1 buttn t be displayed Fire 2 buttn Check this bx if yu want the Fire 2 buttn t be displayed. Left handed Check this bx t have the paddle n the right and the fire buttns n the left f the screen. Object prperties These prperties are lcated in an Andrid flder n the right f the prperty explrer. Image cmpressin This ptin allws yu t frce the cmpressin mde f the bjects images. 3 ptins : Default : the Image Cmpressin mde f the applicatin will be used. Refer t the prperties f the applicatin abve fr mre inf. Nne : the images f the bject wn't be cmpressed even if the Image Cmpressin prperty f the applicatin is set t Clr Reductin. Clr Reductin : the images f the bject will be cmpressed even if the Image Cmpressin prperty f the applicatin is set t Nne.