Application properties

These properties are located in the Android options tab on the right of the property explorer.

• Package name
  The package name serves as unique identifier for your application. By default it’s com.yourcompany.yourapplication. It can be also org.yourorganization.yourapplication. Replace yourcompany by the name of your company, and yourapplication by the name of your application.
• Minimum Android version
  This option allows you to set the minimum version number of Android required to run your application. Your application won’t be executed on devices with a lower version of Android.
• Target Android version
  This option allows you to set the target version number of Android. This target version is the main version your application has been tested with and developed for (see documentation of targetSdkVersion property in the Android SDK).
• Build & Run : install to …
  This option specifies where to install the .apk file to on the connected Android device or emulator when you use the Build and Run command. You can install it either to the internal storage or to the SD card.
• Emulator
  Click this button to open the Emulator dialog box. This dialog box allows you to run the Android emulator (use the Android SDK Manager to create virtual devices). When the Android emulator is running, the Build & Run command will install and execute your application in the emulator. Warning: the emulator may take a couple of minutes to display the Home screen, be patient. Sometimes Build & Run fails the first time after the emulator was launched; in this case just try again. The Build & Run command is also somewhat slower than the normal Build command, as the application has to be transfered to the emulator (or device). Your application will appear in the emulator as soon as the build progress bar disappears in Clickteam Fusion 2.5.
• Release mode
  If this option is not selected, the .apk file will be signed with a debug certificate, so that you can test it on a device. If you want to release your application you need to sign it with a valid certificate. In this case select the Release mode option and enter a key store pathname and key name.
• Certificate
  • Keystore name
    Enter the pathname of the keystore that contains the key to sign your application. To generate a keystore you can use the Keytool tool provided in the bin directory of the JDK. This is a command line tool. For example, the following command line will generate the “d:\great-release-key.keystore” file that contains the “great_key_name” key:keytool -genkey -v -keystore d:\great-release-key.keystore -alias great_key_name -keyalg RSA -keysize 2048 -validity 10000Keytool asks you for your name, organization, country, the keystore password and key password. More info here.
  • Keystore password
    Enter the password of the keystore that you have entered when you’ve created it.
  • Key name
    Enter the name of the key that will be used to sign your application. See above for more info.
  • Key password
    Enter the password of the key you have entered when creating the keystore.
• Display mode
  This option allows you to select either OpenGL ES 1.1 or OpenGL ES 2.0 as graphic renderer. OpenGL ES 2.0 is often slower (it depends on the application though). Note: quick backdrop objects with an ellipse shape require OpenGL ES 2.0.
• Screen rotation
  This option allows you to select the orientation of your application window on the device.
• Display
  This option allows you to choose the way your application is displayed on screen. 6 possibilities:

  	Center No zooming will occur regardless of the device. The window will be centered in the screen.
  	Expand/Adjust window size No scaling will occur with this option, it will expand the window size to fill the remainder of the screen so no black areas show. Note that this will show more of your frame. The actual window size will be exactly the same as the device resolution and the frame must be large enough to support this. Tip: You can resize your frame size at runtime at the start of the frame if needed.
  	Fit inside with borders This option will scale the game-contents to touch the inside of the screen while maintaining the aspect ratio. If your game window aspect ratio isn’t the same as the device aspect ratio, the contents will be centered and black borders will show. This is the default option.
  	Fit inside and adjust window This option will scale the game-contents to touch the inside of the screen while maintaining the aspect ratio. If your game window aspect ratio isn’t the same as the device aspect ratio, the game window will be expanded to fill the remaining of the screen so no black borders show. Note that this will show more of your frame. This requires that your frame is large enough to display the new area.
  	Fit outside This will scale the game to fill the entire screen so that no black borders show. This will crop the remaining areas that go outside the screen away.
  	Stretch Ignores any aspect ratio and just stretches the contents to fill the entire display. Graphics can look squashed if the aspect ratios of the game window and the device don’t match.

• Smooth resizing
  If this option is selected, graphics are anti-aliazed when the application window is resized.
• Display status bar
  If this option is selected, the Android status bar will be displayed above your application window.
• Options menu
  Click this option to edit the Options menu of your application, if any. The Options menu is displayed when the user clicks the Options button on the devices that have one. Each menu item consist of a text, an icon and an identifier. The identifier allows you to identify the menu item in the conditions and expressions of the Android object that allow you to receive notifications when the user selects a menu entry. The icon has a predefined size: the bitmap should be 48×48 in size and centered in the image whose size is 72×72.
• Disable default back button behavior
  This option allows you to disable the default behavior of the Back button. You can detect if the user presses the Back button with a condition of the Android object.
• End application when not in foreground
  If this option is selected, the application will be automatically closed when the user returns to the home screen.
• Require GPU
  The applications created with Clickteam Fusion 2.5 work even if the device has no GPU (graphic processing unit), however most of them will be very slow if this is the case. Unselect this option only if your application works fine without GPU. If this option is selected, the application won’t start on devices without GPU.
• Enable online crash reporting
  This option only works in Debug mode. When it’s selected, when your application crashes a bug report will be automatically sent to Clickteam’s server.
• Force ‘Play from disk’ for sounds larger than X seconds
  This option allows you to save memory. Sounds are preloaded into memory, except if their duration is greater than the time specified in this property or if you have selected their “Play from disk” option in the Data Elements editor. Note that only sounds played from disk are seekable. Seeking doesn’t work for preloaded sounds.
• Image compression
  The graphic memory on Android devices is limited. The image compression option allows you to reduce the size of the graphics of your application in memory. Two options are available : None and Color Compression. If you select “Color Compression”, the images are automatically converted to either 65536 colors (opaque images), 32768 colors (unique transparent color) or 4096 colors (alpha channel with multiple transparency levels).This option will divide the size of your images by two. This can reduce the quality of the images, but you can choose to ignore this option for specific objects; refer to the object properties below.
• Images
  • Launcher icon
    96×96 image, that represents your application on an Android device’s Home screen.
  • Joystick images
    This property contains the images of the touch joystick. Refer to the Joystick options in the Frame properties below for more information.
• Version info
  • Version code
    Internal version number. Increment this number each time you release a new version.
  • Version name
    A string value that represents the release version of the application, as it should be shown to users.
• Permissions
  This list allows you to select the Android permissions required by your application. Usually these permissions are required by some features of 3rd party objects. Look at the documentation of these objects to see what features require what permissions, and if you use these features select the corresponding permissions. The list of permissions is described in the Android SDK. For example if you use the Get object, you’ll need to select the INTERNET permission.

Frame properties

These properties are located in an iOS folder on the right of the property explorer.

• Joystick / Device
  Clickteam Fusion 2.5 allows you to emulate a joystick in the Android application. With this, you can use Clickteam Fusion 2.5 default movements, controlled by a joystick on the device. This combo box offers you the choice of joysticks :
  • None
    No joystick is displayed. Only use this property when your frame does not contain any joystick-controlled movement
  • Touch joystick
    The joystick is emulated on the bottom of the screen of the device. Using your fingers, you can control the movements. The joystick consists of a paddle button and two fire buttons.
  • Accelerometers
    The movements are controlled by the position of the device. Two fire buttons are available on the screen.
  • Controlled by an extension
    Choose this property to manually start or stop the joystick using the Joystick Control object. Please note that this object will not work if this property is not set to this value.
• Fire 1 button
  Check this box if you want the Fire 1 button to be displayed
• Fire 2 button
  Check this box if you want the Fire 2 button to be displayed.
• Left handed
  Check this box to have the paddle on the right and the fire buttons on the left of the screen.

Object properties

These properties are located in an Android folder on the right of the property explorer.

• Image compression
  This option allows you to force the compression mode of the objects images. 3 options :
  • Default : the Image Compression mode of the application will be used. Refer to the properties of the application above for more info.
  • None : the images of the object won’t be compressed even if the Image Compression property of the application is set to Color Reduction.
  • Color Reduction : the images of the object will be compressed even if the Image Compression property of the application is set to None.