Samsung Electronics

Samsung Mobile Innovator Device Emulator Skins Installation Guide

Version 1.0 February 2009

Device Emulator Skins

Copyright Copyright © 2009 Samsung Electronics Co. Ltd. All Rights Reserved. Though every care has been taken to ensure the accuracy of this document, Samsung Electronics Co. Ltd. cannot accept responsibility for any errors or omissions or for any loss occurred to any person, whether legal or natural, from acting, or refraining from action, as a result of the information contained herein. Information in this document is subject to change at any time without obligation to notify any person of such changes. Samsung Electronics Co. Ltd. may have patents or patent pending applications, trademarks copyrights or other intellectual property rights covering subject matter in this document. The furnishing of this document does not give the recipient or reader any license to these patents, trademarks copyrights or other intellectual property rights. No part of this document may be communicated, distributed, reproduced or transmitted in any form or by any means, electronic or mechanical or otherwise, for any purpose, without the prior written permission of Samsung Electronics Co. Ltd. The document is subject to revision without further notice. All brand names and product names mentioned in this document are trademarks or registered trademarks of their respective owners. For more information, please visit http://innovator.samsungmobile.com.

Device Emulator Skins Installation Guide – v 1.0

Page 2 of 8

Device Emulator Skins

Table of Contents 1.

INTRODUCTION ............................................................................................................................................. 4

2.

DEVICE SKIN INSTALLATION ........................................................................................................................... 5 2.1. 2.2. 2.3. 2.4.

OVERVIEW .......................................................................................................................................................5 PREREQUISITES .................................................................................................................................................5 INSTALLATION...................................................................................................................................................5 REMOVAL ........................................................................................................................................................6

3.

USING SKINS IN THE DEVICE EMULATOR ....................................................................................................... 7

4.

USING SKINS IN THE FORMS DESIGNER ......................................................................................................... 8

Device Emulator Skins Installation Guide – v 1.0

Page 3 of 8

Device Emulator Skins

1. Introduction Device Emulator skins enable you to change the physical appearance of the Device Emulator in Microsoft Visual Studio. By default, Visual Studio ships with skins depicting generic phones. When installed, the Samsung Device Emulator skins will enable you to run the emulator with the appearance of a Samsung phone. It will also enable you to use the Forms Designer in Visual Studio and design forms using a Samsung phone image. The Device Emulator skin archive contains skins for the following phones: • • • • • •

SGH-i617 BlackJack II SGH-i907 Epix [and SGH-i780 Mirage] SCH-i760 Robin SCH-i770 Saga SPH-i325 ACE SGH-i900 Omnia [and SCH-i910 Omnia]

Please note that there are the following known issues: •

•

• •

Samsung’s device skins do not change the actual functionality of Microsoft’s emulator. The emulators will still use generic Microsoft-provided phone ROM images, and will not have any custom Samsung software installed. Some keyboard mapping is not correct. Specifically, key combinations, such as shift or functionkey combinations may send incorrect keys to the emulator. As a workaround, you can still use the PC keyboard to send keystrokes to the emulator. Custom phone keys, such as the camera key, are not supported. On Pocket PC phones, the Today screen’s text may not be readable in the default color scheme. However, this does not affect the display of other applications, and does not happen when you select a different color scheme.

Device Emulator Skins Installation Guide – v 1.0

Page 4 of 8

Device Emulator Skins

2. Device Skin Installation 2.1.

Overview

Device skins for the Microsoft Visual Studio device emulator consist of four files: • •

An XML file that contains the definitions of screen size, keyboard mapping, and other configuration options. Three PNG image files, containing images of the front of the phone. The images include a regular view of the phone, a color mask that defines the key areas, and a view of the phone with keys depressed.

The Device Skin package consists of a ZIP archive containing folders for each phone. Each folder contains the four files for each phone. Note: The SGH-i900 Omnia and SCH-i910 Omnia use a common set of files in a single folder; the SGHi907 Epix and SGH-i780 Mirage also share a common folder and set of files.

2.2.

Prerequisites

Before installing skins, you will need a PC with the following installed: • • •

Windows XP SP2 (or later service pack) or Windows Vista Visual Studio 2008 Professional edition (or above) or Visual Studio 2005 Standard edition (or above) The Windows Mobile 6 SDK Refresh (http://www.microsoft.com/downloads/details.aspx?FamilyID=06111a3a-a651-4745-88ef3d48091a390b&DisplayLang=en) Note: There are currently two versions of the Windows Mobile 6 SDK available. The Windows Mobile 6 Standard SDK is for Smartphone application development. Windows Mobile 6 Professional is for developing Pocket PC applications. Each version is a separate download. If your development targets both platforms, you’ll need to install both versions.

2.3.

Installation

To install a skin: 1. Unzip the DeviceSkins.zip file on your PC. 2. Copy the files to a convenient location. By default, skins are stored in a folder per phone in C:\Program Files\Windows Mobile 6 SDK\PocketPC\Deviceemulation or C:\Program Files\Windows Mobile 6 SDK\Smartphone\Deviceemulation. However, you can store your skin files in any other folder.

Device Emulator Skins Installation Guide – v 1.0

Page 5 of 8

Device Emulator Skins 3. Start Visual Studio, and select Tools > Options. 4. Select Device Tools > Devices. 5. In the Devices list, select a generic phone similar to the phone you are installing. For example:

6. 7. 8. 9. 10. 11. 12. 13. 14.

2.4.

Samsung Phone

Windows Mobile generic phone

SGH-i617 BlackJack II, SPH-i325 ACE

Windows Mobile 6 Standard Landscape QVGA Emulator

All other phones

Windows Mobile 6 Professional Emulator

Click Save As. Name the device with the name of the Samsung phone you are emulating. Select the Samsung phone and click Properties. Click Emulator Options. Click the Display tab. Change the value of Skin to the location of the XML file in the phone’s skin folder. Click OK. In Options, select Device Tools > Form Factors. Click Save As. Name the device with the name of the Samsung phone you are emulating. Select the Samsung phone and click Properties. Change the value of Skin to the location of the XML file in the phone’s skin folder. Click OK.

Removal

To remove a skin: 1. 2. 3. 4.

Start Visual Studio, and select Tools > Options. Select Device Tools > Devices. Click the skin in the list and click Delete. Remove the folder and files you copied to your PC during installation.

Device Emulator Skins Installation Guide – v 1.0

Page 6 of 8

Device Emulator Skins

3. Using Skins in the Device Emulator To use the Skins in the Device Emulator, you can deploy your application to the Device Emulator, or you can run a standalone emulator from the Device Emulator Manager. To run an emulator from the Device Emulator Manager: 1. In Visual Studio, select Tools > Device Emulator Manager. 2. Find the emulator you wish to run in the emulator list. 3. Right-click and select Connect. To deploy your application to the Device Emulator: 1. In your solution, select Debug > Start Debugging. 2. Select the phone you wish to emulate, and click Deploy.

Device Emulator Skins Installation Guide – v 1.0

Page 7 of 8

Device Emulator Skins

4. Using Skins in the Forms Designer You can also use device emulator skins to change the appearance of the Forms Designer in Visual Studio. This involves two steps: adding a new form factor that uses an installed Samsung skin, and switching to that form factor in the Forms Designer. To add a new form factor: 1. 2. 3. 4. 5. 6.

In Visual Studio, select Tools > Options > Device Tools > Form Factors. Select any of the listed Form factors. Click Save As. Name the new form factor and click OK. Click Properties. Click the browse button and change the Skin XML file to the XML file of a Samsung skin. By default, skins are located at C:\Program Files\Windows Mobile 6 SDK\PocketPC\Deviceemulation\ or C:\Program Files\Windows Mobile 6 SDK\Smartphone\Deviceemulation\. 7. Click OK, and then click OK again. 8. Restart Visual Studio. Tip: At Tools > Options > Device Tools > Form Factors, you can set the default form factor, to always open a Samsung skin in the Forms Designer. To change form factors in the Forms Designer: 1. Open a form in Visual Studio. 2. Right-click the form and select Properties. 3. In the Properties window, change the value of FormFactor by clicking it and selecting a new form factor. Note: Because the Omnia supports a 240x400 resolution, its skin will not display properly in the Forms Designer. As a workaround, you can change the value of Size in the Properties window to 240x400 and extend the size of the displayed form.

Device Emulator Skins Installation Guide – v 1.0

Page 8 of 8