Knowledge Base/GameMaker: Studio/Tizen

Getting Started With Tizen

Mark Alexander
posted this on August 05, 2013 12:29

Tizen is an open-source operating system co-developed by The Linux Foundation and Intel (along with some major mobile manufacturers) made up of the popular Linux kernel and WebKit runtime, and it is designed to be fast and flexible across a very wide range of low end devices. To get started using this module with GameMaker:Studio you must first fulfill the necessary requisites outlined below.

Getting Started

Before going any further it is worth noting that the current SDK is best used on a PC running Windows 7, Vista or XP, as the current 64bit version of the SDK does not officially work with Windows 8 and may not install on the 64bit version of Windows 7 either. This means that if your development machine is Windows 8, you may have to dual boot to an earlier windows version in order to work with it (we say may as it is possible to get the sdk and the Tizen emulator to work on Windows 8 machines), and if your are running Windows 7 64 bit, you will need do a couple of extra steps. See the Troubleshooting article for further details.

To develop a mobile application using Tizen on your PC using GameMaker:Studio, you will need the following:

    • The Tizen SDK (available here)
    • Microsoft Windows® XP (32-bit), Microsoft Windows® 7 (32- or 64-bit)
    • At least a dual-core 2 GHz CPU (Intel is recommended)
    • At least 2 GB of RAM
    • At least 3 GB of free disk space
    • Java v6 JRE or later (you can get this here)
    • Local administrator authority

To use the Tizen Emulator, you will also need the following:

    • Intel VTx supported by CPU
    • At least 1280 x 1024 screen resolution
    • Latest vendor-provided version of the graphic card driver for OpenGL® ES acceleration

NOTE: Intel Motherboard integrated video cards (Q33/Q35/Q43/Q45) are not supported, and nor are first generation Intel HD Graphics cards.

When installing the SDK, it will install Intels HAXM as part of the process. This is a hardware-assisted virtualization engine (hypervisor) that uses Intel virtualization technology to speed up Tizen application emulation on a Windows or Mac host machine. In combination with Tizen x86 emulator images and the Tizen SDK, Intel HAXM allows for faster Tizen emulation on Intel VT-x enabled systems. If you are not sure whether your development machine is VTx enabled, or you have problems installing HAXM, please see the article on Troubleshooting Tizen.

NOTE: If you do not need virtualization (ie: you have a Tizen device) you need not worry about installing HAXM.

If you are installing the SDK for the first time, you should run the Tizen IDE once before going any further. You will be requested to create a "Workspace" folder to hold Tizen projects. While GameMaker:Studio does not use this location, it does require a file that is created there (see the section Getting The Profile.xml below) so make sure to remember where you create it.

Preparing GameMaker:Studio

Now that you have the SDK installed, you will have to set the Preferences for the Tizen module within GameMaker:Studio. You need to start GameMaker:Studio and open a project then go to the File > Preferences windows and select the Tizen tab from there.

Tizen_Prefs.png

The first thing to do is point GameMaker:Studio to the install location for the Tizen SDK, and then link to the Java JDK that you previously installed too. Once you have located the necessary files, you should proceed to Check the Tizen SDK by pressing the appropriate button on this tab, as this will get GameMaker:Studio to check that the components are installed and communicating with the program properly. If this shows SDK + JRE OK then you can begin to test your games on the Tizen target platform.

If your development setup permits the creation of a virtual Tizen device and you do not have access to an actual test device, you should also press the Create Emulator VM to initialise the Tizen emulator and create a "template" of the GameMaker:Studio virtual Tizen device, otherwise your game will not run correctly (if at all). If you are unable to create a Virtual Machine through the GameMaker:Studio interface, please see the article on Troubleshooting Tizen.

You should then open the Tizen Emulator Manager (you can find it within the SDK: ..\tizen-sdk\tools\emulator\bin\emulator-manager.exe) and check that the VM template uses Hardware Virtualisation and the GPU. These should be activated if they are not (and if your machine permits it) otherwise the emulator will have limited performance, so click the Modify button at the bottom and check.

TizenEmulator.png

The final section of the preferences is for you to supply GameMaker:Studio with two signing certificates - the profiles.xml file that is required by Tizen to be included with all JavaScript (JS) apps that are submitted to their store, and the *.p12 file that is needed for Native games. These files are similar to the "certificates" that iOS require, or the "Keystore" that Android requires, but you do not need these files for testing games with the Tizen module, nor do you need them to create final *.wgt files for Tizen devices, but if you want to use the official distribution channels then they are essential.

Getting The Profile.xml and *.p12 Files

To get the *.p12 and profile.xml files for your Tizen games, you must use the Certificate Generator Tool supplied with the Tizen SDK. The Certificate Generator tool is a cross-platform command line tool used to generate developer private keys and certificates from their intermediate CA certificates. The private keys and certificates are used for signing and verifying your applications when uploading to the Tizen store.

Certificate Generator Tool

The certificate generator tool is present in the ..\tizen-sdk\tools\certificate-generator directory, and to run the tool double click the certificate-generator.sh or certificate-generator.bat file. The tool output is a pkcs12 file, which is generated based on a set of input values (shown in the image below) and the generated private key and certificate are stored in the pkcs12 file.

Tizen_CertTool.png

The following values that you will be requested to input are optional and can be left blank if you wish:

Country name - This is the two letter country code
State or province name - The state or province where you (or your company) is based
City name - The name of the city where you (or your company) is based
Developer name - Your name
Organization name - The name of your company
Department name - The name of your department within the company
Email address - A contact email

Apart from these optional values, you will also have to supply the following obligatory information for the pkcs12 file:

Password - A secure password for the file
Alias - An "alias" by which the file can be known
File name - The actual file name, ending with the .p12 extension.

Once you have this file, you should copy it to a safe location. This *.p12 file can now be added into the Preferences Tab in GameMaker:Studio, along with the password that was given when you created it. This will now enable you to build games for the official Tizen Store.

You can now continue on to create the Profile.xml using the Tizen SDK itself.

Creating The Profile.xml

The Tizen SDK refers to the previously created *.p12 file as the Author Certificate and you must now link the SDK to that to generate a secure profile *.xml file. To set your author certificate, open the Tizen SDK and then go to Window > Preferences > Tizen SDK and scroll down to the Secure Profiles section.

Tizen_Prefs_SecureCert.png

Click on the blank area beneath Certificate Path and point the SDK to the previously created *.p12 file (which should be located in the same directory as the Certificate Generator tool). you should then click the button Apply and can close the SDK manager.

Now in GameMaker:Studio, you must open the Preferences tab and click on the Profile File. This will open a file window where you can select the newly created profile.xml file. This can be found in a hidden folder within the Tizen Workspace folder that you created when you installed the SDK (so you will need to make sure that Windows is configured to show hidden files). The exact location should be ..\WORKSPACE NAME\.metadata\.plugins\org.tizen.common.sign\, where "Workspace Name" is the name of the folder that you created.

Troubleshooting

If you have any problems with setting up the Tizen module for GameMaker:Studio (including getting the emulator to run on a Windows 8 machine) you can get some help from the following page:

Troubleshooting Tizen

You can also get further help from the official Tizen pages themselves:

Tizen Developers Help
Tizen Developers Main Site

 
Topic is closed for comments