| **Navigation:**  [[clarion.htm|Clarion.Net (Clarion#)]] > [[clarion net language reference.htm|Clarion# Language Extensions]] > Clarion.NET FAQs > Compact Forms >====== Compact Forms Quick Start ====== | [[clarion net faqs.htm|{{btn_prev_n.gif|Previous page}}]][[clarion net language reference.htm|{{btn_home_n.gif|Return to chapter overview}}]][[creating a dess file.htm|{{btn_next_n.gif|Next page}}]] |
|  ||

To get started with building and deploying a Compact Framework application in Clarion.NET, there are two setup categories which must be followed; machine setup, and verification of connectivity to the target device and test emulator.

**Machine Setup**

In order to properly configure and test your Compact Forms application, the following components need to be installed on your development machine:

**.NET Framework 2.0 SDK**

**.NET Compact Framework version 2 service pack 2**

**ActiveSync 4.5 (for XP), or Windows Mobile Device Center 6.1 (for Vista)**

**Device Emulator v3.0**

**Mobile Device SDKs**

__**Step 1**__

First, install the [[http://www.microsoft.com/downloads/details.aspx?FamilyID=fe6f2099-b7b4-4f47-a244-c96d69c35dec&displaylang=en|.NET Framework 2.0 SDK]]**.**

__**Step 2**__

Next, install the [[http://www.microsoft.com/downloads/details.aspx?familyid=aea55f2f-07b5-4a8c-8a44-b4e1b196d5c0&displaylang=en|.NET Compact Framework version 2]]**. **At press time, Service Pack 2 was the latest version.

__**Step 3**__

Install [[http://www.microsoft.com/windowsmobile/activesync/activesync45.mspx|ActiveSync 4.5 ( for XP )]] or [[http://www.microsoft.com/windowsmobile/devicecenter.mspx|Windows Mobile Device Center 6.1 (WMDC)]] (for Vista)

It is important to install ActiveSync or WMDC before installing the Emulator that follows, otherwise you will not see the "DMA" option in the dropdown list shown below.

__**Step 4**__

[[http://www.microsoft.com/downloads/details.aspx?FamilyID=A6F6ADAF-12E3-4B2F-A394-356E2C2FB114&displaylang=en|Download and Install the Device Emulator 3.0]]

__**Step 5**__

**Windows Mobile SDK Installer**

There is a special setup program to assist you with configuring your system for the development of Pocket PC 2003 and Windows Mobile Device applications. The program is named //wmSDKInstaller//.

The install creates a shortcut in the Clarion.NET Programs Menu; "Windows Mobile SDK Install Tool". This program can install any of the Compact Framework SDKs without requiring you have Visual Studio on your machine.

After downloading any of the Compact Framework SDKs run this program and let it install the SDK for you.

Click on the shortcut to run the install.

{{mobilesdk.jpg|MobileSDK.jpg}}

The Help button provides additional details on using the installer. Make sure that each Mobile SDK install is installed in its own unique destination folder (//Path to Clarion folder//).

Here are links to other important Mobile SDKs:

[[http://www.microsoft.com/downloads/details.aspx?familyid=83A52AF2-F524-4EC5-9155-717CBE5D25ED&displaylang=en|Windows Mobile 5.0 Pocket PC SDK]]

[[http://www.microsoft.com/downloads/details.aspx?familyid=06111A3A-A651-4745-88EF-3D48091A390B&displaylang=en#Instructions|Windows Mobile 6 Standard SDK Refresh]]

[[http://www.microsoft.com/downloads/details.aspx?familyid=06111A3A-A651-4745-88EF-3D48091A390B&displaylang=en#Instructions|Windows Mobile 6 Professional SDK Refresh]]

Note: Click here if the SDK Installer is having problems finding the CoreCon Libraries.

We recommend that all of the above also be installed, and that you uninstall any prior install before applying the new install.

__**Step 6**__

After installing all of the above, set a connection from ActiveSync or WMDC to the Device Emulator via DMA in the ActiveSync settings

To do this, start ActiveSync or WMDC. From the main menu select **File->Connection Settings**, and set it as shown here:

{{activesyncsettings.jpg|ActiveSyncSettings.jpg}}

**Verification of Connectivity**

Open the following folder:

| **\Clarion.Net\bin\Addins\BackendBindings\ClarionBinding\ClarionNet\CFFormsDesigner\Data** |

In this folder locate and then double-click on //{52ADC494-264B-42a4-AEEA-32049B5265A4}.dess// to start the //Device Emulator//.

Next, open the **\Program Files\Microsoft Device Emulator\1.0\** folder and run dvcemumanager.exe.

The //Device Emulator Manager// runs, displaying an icon indicating that //Pocket PC 2003 SE Emulator// is launched. Select it, right-click and choose **Cradle** from the pop up menu.

At that point an ActiveSync or WMDC icon in the taskbar should become green and start rolling, and a dialog opens asking to set up a partnership with the device. Choose //Guest// partnership and press **Next**. ActiveSync should show a dialog displaying //Connected//.

If the last step does not occur. please open the ActiveSync or WMDC //Connection Settings// and access the **Connect'** dialog.

In the //Get Connected// dialog press **Next**. COM ports checking starts. Here you can just press **Cancel**. ActiveSync should then start connecting to the emulator.

After verifying those steps close the //Device Emulator// and then try the following steps;

**Deploying a Compact Framework Program from the IDE:**

Open a Compact Framework project.

Press the //Starts without debugger (Builds Solution)// button.

{{makerunbut.jpg|MakeRunBut.jpg}}

The //Deploy// dialog appears with the list of available devices. You can choose an emulator at this time, or deploy directly to a device.

If you choose an emulator, select the appropriate type, and press the **Deploy **button. The device emulator is launched and a message box with '"Please wait until the OS image is deployed to the device emulator" appears. Initially the device emulator's window is black while the OS image is being loaded onto the emulator. Typically it takes about 20-30 seconds and then the emulator's window will change to blue with the "Windows Mobile" welcome text, but the OS image is still being loaded. The process of loading the OS is finished when you see the **Start** button. Only after that you can press **OK** on the message box with "Please wait until the OS image is deployed to the device emulator".

Press **OK**. The device emulator is cradled. A Connection is set via ActiveSync or WMDC. Deploying of your program files is then started.

Finally, press the **Deploy** button. At that time the device emulator is loaded and the connection is set. The process of the application files deploying starts. In about 10-20 seconds the application is launched.

When deploying to an emulator, it's a good idea to create a DESS to speed up deployment and testing.

**See also:** [[creating a dess file.htm|Creating a DESS File]].