Using Custom Skin Layout

An Emulator skin comprises an XML meta file, which defines layout-related information, such as skin image file name, display location, and the location of hardware keys. This file is located in <TIZEN_SDK_HOME>/tools/emulator/skins/<SKIN_NAME>/default.dbi.

The following example shows the contents of the default.dbi layout file:

<?xml version="1.0" encoding="UTF-8"?>
<EmulatorUI xmlns="http://www.tizen.org/emulator/skin/dbi"
 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
      <dbi version="2.0"/>
   <rotations>
      <!-- Skin mode definition -->
      <rotation name="Portrait">
         <!-- LCD number of identification -->
         <lcd id="0">">
            <!-- LCD screen size and position -->
            <region left="35" top="86" width="480" height="800"/>
         </lcd>
         <imageList>
            <!-- Resource file name of the usual skin image -->
            <mainImage>default_0.png</mainImage>">
            <!-- Resource file name of the skin image when HW key events occur -->
            <keyPressedImage>default_0_p.png</keyPressedImage>
         </imageList>
         <keyMapList>
            <keyMap> <!-- Optional -->
               <!-- HW key region size and position -->
               <region left="238" top="887" width="74" height="74"/>
               <eventInfo>
                  <keyCode>101</keyCode> <!-- Keycode value -->
                  <keyName>HOME</keyName> <!-- HW key name -->
               </eventInfo>
               <!-- This line to be displayed when mouse hovers over the HW key region -->
               <tooltip>Home</tooltip>
            </keyMap>
         </keyMapList>
      </rotation>
   </rotations>
   <colors>
      <!-- RGB color of the HW key hover -->
      <hoverColor B="255" G="255" R="255" />
   </colors>
</EmulatorUI>

The Emulator skin also comprises a property file, which defines skin-related information, such as skin name and supported resolutions. This file is located in <TIZEN_SDK_HOME>/tools/emulator/skins/<SKIN_NAME>/info.ini.

The following example shows the contents of the info.ini property file:

skin.name=Phone 480x800
resolution.width=480
resolution.height=800

To create your own skin layout:

  1. Create a new skin folder in the <TIZEN_SDK_HOME>/tools/emulator/skins/ folder.
  2. In the skin folder, define the contents of the default.dbi and info.ini files and include the required skin image files.
  3. Select the skin name in the Emulator Manager. You can also use the Emulator start-up options in the command line.

    The image defined in your modified XML meta file is displayed when the Emulator is launched.

Note
If you re-install the Tizen IDE, the custom skin folders are reset.

Where to Go Next