FAQ CE 5.0 and WM 5.0 Application Development

Transcription

1 FAQ CE 5.0 and WM 5.0 Application Development Revision 03 This document contains frequently asked questions (or FAQ s) related to application development for Windows Mobile 5.0 and Windows CE 5.0 devices. SMDK for C 1. Q: Can I use Visual Studio 2005 to develop C/C++ applications for my Windows CE 4.2 device? A: No, Visual Studio 2005 supports smart device development for Pocket PC 2003, Windows Mobile 5.0 and Windows CE 5.0. Windows CE 4.2 is not a supported platform in Visual Studio You must use embedded visual C to develop C/C++ applications for your Windows CE 4.2 device. 2. Q: Can I use embedded visual C to develop C/C++ applications for my Windows Mobile 5.0 device? A: No, embedded Visual C supports smart device development for Pocket PC 2003, Windows CE 4.2 and Windows CE 5.0. Windows Mobile 5.0 is not a supported platform in embedded Visual C You must use Visual Studio 2005 to develop C/C++ applications for your Windows Mobile 5.0 device. 3. Q: Can I use an Express version of Visual Studio 2005 to develop C/C++ applications for my devices? A: No, the Express versions of Visual Studio do not support Smart device development. You must use one of the full versions of Visual Studio 2005 to develop C/C++ applications for your device. 4. Q: In addition to Visual Studio 2005, what else do I need to develop C/C++ applications for a Windows Mobile 5.0 device from Symbol Technologies? A: In addition to Visual Studio 2005, you will need the Microsoft Windows Mobile 5.0 SDK and the Symbol Mobility Developer Kit for C (SMDK for C). For debugging devices, ActiveSync 4.1 is also required. 5. Q: In addition to Visual Studio 2005, what else do I need to develop C/C++ applications for a Windows CE 5.0 device from Symbol Technologies? A: In addition to Visual Studio 2005, you will need the Windows CE platform SDK (PSDK) for the device and the Symbol Mobility Developer Kit for C (SMDK for C). For debugging devices, ActiveSync 4.1 is also required. Symbol Technologies, Inc. Page 1 Copyright 2006

2 6. Q: Where can I get visual Studio 2005? A: Unlike embedded visual C++ 4.0; which was a free download from Microsoft, Visual Studio 2005 must be purchased from a qualified retailer. The cost varies depending on the license purchased. Visual Studio 2005 is also available in certain licenses of MSDN (Microsoft Developer Network). 7. Q: Where do I get the Windows Mobile 5.0 SDK? A: The Windows Mobile 5.0 SDK is available as a free download from Microsoft at: and search for the string Windows Mobile 5.0 SDK for Pocket PC. 8. Q: Where can I get ActiveSync 4.1? A: ActiveSync 4.1 is available as a free download from Microsoft at: d2d180a42dfa&DisplayLang=en. If this link does not work, go to and search for the string ActiveSync 4.1 download. 9. Q: Can I open my projects that were created using embedded visual C in Visual Studio 2005? A: Yes, when the VCW or DSP project files from embedded visual C are opened in Visual Studio 2005, a conversion wizard is launched. The conversion wizard guides you through the steps required to convert your project files for use in Visual Studio Q: Where can I get more information on migrating embedded Visual C++ projects to Visual Studio 2005? A: Q: My application was building without errors using VS2005 and SMDK for C. I installed evc4 to build for an older CE 4.2 device, and I am no longer able to build my application for CE 5.0 when I go back to Visual Studio How can I fix this? A: If you need to install "SMDK for evc4" and "SMDK for C" on the same PC, make sure that "SMDK for evc4" is installed first. Both SMDK packages install a version of Platform Integrator, with its associated library files. By installing SMDK Symbol Technologies, Inc. Page 2 Copyright 2006

3 for C last, you insure that the latest library files are being used with all of your projects. 12. Q: I was using evc4 to build my CE5.0 applications. I installed VS2005, but I am unable to see the CE5.0 platforms in Configuration Manager of Visual Studio. How do I make these CE 5.0 platforms visible? A: For Windows CE SDK's (or Platform SDK's) to be recognized by Visual Studio 2005, they must be installed after Visual Studio 2005 is installed. To fix this, uninstall each 5.0 PSDK and re-install it. 13. Q: Why can t I install the Windows Mobile 5.0 SDK on my PC. A: The Windows Mobile 5.0 SDK will only install if Visual Studio 2005 is already installed. Install Visual Studio first. 14. Q: I installed Visual Studio 2005, then the SMDK v1.0 for C, and opened a sample solution. When I select Windows Mobile 5.0 in the Active configuration field of the toolbar, why can t I build the sample application? A: Although it appears in the user interface of VS2005, the Windows Mobile 5.0 must be installed before the application can be built. 15. Q: Why do I get compiler or link errors when trying to build the SMDK for C samples for Windows Mobile 2005 or PPC2003? A: The Microsoft Windows Mobile SDK's should be installed before the SMDK for C. This will ensure that the Symbol Platform Integrator adds the Symbol Include and Library files to this Microsoft SDK. If the Microsoft SDK's for Windows Mobile are installed after the SMDK for C, you will need to run the Symbol Platform Integrator manually using the shortcut in the SMDK for C Start Menu program group 16. Q: I have installed a PSDK for the MC3000c50b and added it to my solution using configuration manager, but my project will not build for MC3000c50b. How can I fix this? A: SMDK v1.0 for C includes various sample applications that provide examples of how to interface with the Symbol API functions. Each sample project contains a Visual Studio 2005 solution file. When opened in Visual Studio, the solution file allows developers to rebuild the sample for different target platforms. By default, each solution includes settings for targeting Pocket PC 2003 and Windows Mobile 5.0. If you need to build a project for a Windows CE device; such as the MC3000, the Platform SDK (or PSDK) for that device must be installed and a new platform configuration must be added to the solution. Symbol Technologies, Inc. Page 3 Copyright 2006

4 17. Q: Why do I get the linker error fatal error LNK1181: cannot open input file 'secchk.lib after I install a PSDK, create a new platform and build a sample application? A: After installing a new PSDK from Symbol, you can add that platform to your project by creating a new platform using the configuration manager. In the configuration manager you must choose the option Windows Mobile 5.0 Pocket PC SDK (ARMV4I) for the field Copy settings from. If you choose the option Pocket PC 2003 (ARMV4) you will get the secchk.lib linker error. 18. Q: I am using VS2005 to create my application. I just installed the PSDK for the MC3000c50b. Why can t I see the MC3000c50b as a device to target in my solution? A: SMDK v1.0 for C includes various sample applications that provide examples of how to interface with the Symbol API functions. Each sample project contains a Visual Studio 2005 solution file. When opened in Visual Studio, the solution file allows developers to rebuild the sample for different target platforms. By default, each solution includes settings for targeting Pocket PC 2003 and Windows Mobile 5.0. If you need to build a project for a Windows CE device; such as the MC3000, the Platform SDK (or PSDK) for that device must be installed and a new platform configuration must be added to the solution. 19. Q: Why do I get the build warning "$(CeConfigName)" environment variable not found" when I build my project in Visual Studio 2005? A: This warning does not affect the behavior of the application when executed, and can be ignored. It is a result of using the visual Studio project conversion wizard to upgrade a project that was created in embedded Visual C Q: Why do I get the error message Not a valid Windows CE application when I run my program on a Windows Mobile or Windows CE device? A: A common cause of this runtime error is the absence of a called function in the API DLL file installed on the device. The Symbol export libraries provided with SMDK for C allow access to the latest set of API functions. If you are developing for an older device that may not implement all of the new functions listed in the help file, you will not know this until runtime. The source will compile and link successfully, but may not run. Calling a function that exists in the export library but does not exist in the DLL on the device will cause a failure when the application is launched. You will receive an error message that states Not a valid Windows CE application. The CheckAPI utility provided in the SMDK for C can be used to determine which API functions are present on a device. To avoid receiving the runtime error, use LoadLibarary and GetProcAddress within you application to call functions. This will allow you to determine at runtime if an API function is implemented. Symbol Technologies, Inc. Page 4 Copyright 2006

5 SMDK for.net 1. Q: Can I use Visual Studio 2005 (VS2005) to develop managed applications (C# or VB.NET) for my Windows CE 4.2 device? A: No, Visual Studio 2005 supports smart device development for Pocket PC 2003, Windows Mobile 5.0 and Windows CE 5.0. Windows CE 4.2 is not a supported platform in Visual Studio You must use Visual Studio.NET 2003 to develop managed applications for your Windows CE 4.2 device. 2. Q: Can I use Visual Studio 2003 (VS2003) to develop managed applications for my Windows Mobile 5.0 device? A: No, Visual Studio 2003 supports smart device development for Pocket PC 2003, Windows CE 4.2 and Windows CE 5.0. Windows Mobile 5.0 is not a supported platform in Visual Studio You must use Visual Studio 2005 to develop applications for your Windows Mobile 5.0 device. However, many developers claim they are successful in getting the applications created using Visual Studio 2003 to run on Windows Mobile 5.0 devices. 3. Q: Can I use an Express version of Visual Studio 2005 to develop managed applications for my devices? A: No, the Express versions of Visual Studio do not support Smart device development. You must use one of the full versions of Visual Studio 2005 to applications for your device. 4. Q: In addition to Visual Studio 2005, what else do I need to develop managed applications for a Windows Mobile 5.0 device from Symbol Technologies? A: In addition to Visual Studio 2005, you will need the Microsoft Windows Mobile 5.0 Pocket PC SDK and the Symbol Mobility Developer Kit for.net (SMDK for.net). For debugging devices, ActiveSync 4.1 is also required. 5. Q: In addition to Visual Studio 2005, what else do I need to develop managed applications for a Windows CE 5.0 device from Symbol Technologies? A: In addition to Visual Studio 2005, you will need the Symbol Mobility Developer Kit for.net (SMDK for.net). For debugging devices, ActiveSync 4.1 is also required. Symbol Technologies, Inc. Page 5 Copyright 2006

6 6. Q: In addition to Visual Studio 2003, what else do I need to develop managed applications for a Windows CE 5.0 device from Symbol Technologies? A: In addition to Visual Studio 2003, you will need Microsoft s Windows CE Utilities for Visual Studio.NET 2003 Add-on Pack and the Symbol Mobility Developer Kit for.net (SMDK for.net). 7. Q: Where can I get visual Studio 2005? A: Visual Studio 2005 must be purchased from a qualified retailer. The cost varies depending on the license purchased. Visual Studio 2005 is also available in certain licenses of MSDN (Microsoft Developer Network). 8. Q: Where do I get the Windows Mobile 5.0 SDK for PocketPC? A: The Windows Mobile 5.0 SDK is available as a free download from Microsoft at: If this link does not work, go to and search for the string Windows Mobile 5.0 SDK for Pocket PC. 9. Q: Where can I get ActiveSync 4.1? A: ActiveSync 4.1 is available as a free download from Microsoft at: d2d180a42dfa&DisplayLang=en. If this link does not work, go to and search for the string ActiveSync 4.1 download. 10. Q: Can I open my projects that were created using Visual Studio 2003 in Visual Studio 2005? A: Yes, when the project files from Visual Studio 2003 are opened in Visual Studio 2005, you will be prompted to upgrade the project to Visual Studio We have not experienced any problems with upgrading the projects to Visual Studio Once upgraded, the projects cannot be opened in VS Q: Can I use Visual Studio 2005 to develop applications targeted for Compact Framework 2.0? A: Yes. Visual Studio 2005 supports both 1.0 and 2.0 versions of Compact Framework. 12. Q: Can I use Visual Studio 2005 to develop applications targeted for Compact Framework 1.0? A: Yes. Visual Studio 2005 supports both 1.0 and 2.0 versions of Compact Framework. Symbol Technologies, Inc. Page 6 Copyright 2006

7 13. Q: Can I use Visual Studio 2003 to develop applications targeted for Compact Framework 2.0? A: No. Visual Studio 2003 supports only Compact Framework 1.0. You must use Visual Studio 2005 to target Compact Framework Q: Why do I get compiler errors when I use SMDK v1.2 for.net with the Release Version (RTM) of Visual Studio 2005? A: SMDK v1.2 for.net was validated for use with the Beta 2 version of Visual Studio Due to the changes made to the directory structure in the final version (RTM) Visual Studio 2005, the SMDK v1.2 for.net will not install properly. A workaround is provided on the product s webpage at DevZone Q: Is SMDK v1.2 for.net compatible with Visual Studio 2003 and Visual Studio 2005? A: Yes. SMDK for.net can be used with Visual Studio 2005 as well as Visual Studio Q: Can I install both Visual Studio 2003 and Visual Studio 2005 on the same machine? A: Yes. Microsoft reported a few issues with installing the Beta 2 version of VS2005 and Visual Studio 2003 on the same machine. But the RTM version of Visual Studio is supposed to be able to coexist with Visual Studio Q: Why does the SMDK v1.2 for.net fail to work with Visual Studio 2005 when I have Visual Studio 2005 and Visual Studio 2003 installed on the same machine? A: The SMDK for.net will install for use with Visual Studio 2003 when VS2005 and VS2003 are present on the same machine. The following steps describe how to get the SMDK to work for both versions: - Install VS Install Microsoft s Visual Studio.NET 2003 Add-on Pack - Install PocketPC2003 SDK (if required) - Install VS2005 RTM - Install Microsoft Mobile 5.0 SDK for PocketPC (if required) - Install ActiveSync Install SMDK v1.2 for.net - Copy Symbol assemblies from..program Files\ Microsoft Visual Symbol Technologies, Inc. Page 7 Copyright 2006

8 Studio.Net 2003\CompactFrameworkSDK\v \Windows CE\Symbol*.* to..\program Files\Microsoft Visual Studio 8\SmartDevices\SDK\ CompactFramework\2.0\v2.0\WindowsCE. With the above steps, the samples can be successfully compiled but you may not be able to use Visual Studio 2005 to deploy the solution to the device. In that case you will have to manually the copy the files to the device and install Symbol.All.Arm.cab if necessary. The file Symbol.All.Arm.Cab can be found at..\program Files\Microsoft Visual Studio 8\SmartDevices\SDK\ CompactFramework\2.0\v2.0\WindowsCE\wce400\armv4\. This problem will be fixed in the next version of SMDK for.net. 18. Q: Does my Windows Mobile 5.0 device come installed with the compact framework? A: Yes. The Windows Mobile 5.0 devices are usually shipped with the Compact Framework version 1.0 SP Q: Does my Windows CE 5.0 device come with the compact framework? A: No. The Windows CE devices are not shipped with the Compact Framework installed. 20. Q: How do I know what version of Compact Framework is installed on my device? A: Run the utility \Windows\cgacutil.exe on the device. You will get a message box showing you the Win32 File Version of the.net Compact Framework installed on the device. The Win32 File versions and the corresponding compact framework versions are listed below: Version Description RTM SP SP2 Recall SP2 Beta SP2 Final SP3 Beta SP3 Final CTP May Beta CTP December CTP November Beta RTM Symbol Technologies, Inc. Page 8 Copyright 2006

9 21. Q: Is there a way to determine the version of the Compact Framework installed on my device programmatically? A: To determine the version of the Compact Framework programmatically you can use System.Environment.Version.ToString(). 22. Q: My applications are targeted for Windows Mobile 5.0 and Compact Framework 2.0. How can I uninstall Compact Framework 1.0 from the device? A: You cannot uninstall Compact Framework 1.0 from the Windows Mobile 5.0 device. Microsoft bundles Compact Framework 1.0 into the operating system. Future versions of Windows Mobile may allow OEMs to choose the version of Compact Framework included with the operating system. 23. Q: How do I determine the version of SMDK for.net installed on a device? A: Locate the file \Windows\ Symbol Managed Class Libraries #.#.GAC on the device. #.# denotes the version of the SMDK installed on the device. 24. Q: Can I get an application developed for compact framework 2.0 to run on 1.0 and vice versa? A: You cannot run the application developed for the compact framework 2.0 on the compact framework 1.0. But you can run the application developed for compact framework 1.0 on compact framework Q: I need to install the released version of Visual Studio Is there any instruction on uninstalling the Beta 2 version of Visual Studio 2005? A: Yes, it is important that you uninstall the Beta version in the order suggested by Microsoft. Refer to the link Symbol Pocket Browser 1. Q: Why isn t my meta tag working; I ve double checked the syntax and it s still not working? A: This problem can be caused by using the wrong type of quotation or speech marks. For example, when copying and pasting code from a Word document, the formatting on the speech marks may be altered. 2. Q: My unit has been returned from repair. I tried to reapply my license but it is no longer working. What am I doing wrong? Symbol Technologies, Inc. Page 9 Copyright 2006

10 A: Sometimes when repairing a device it is necessary for certain parts to be replaced. If this is a component such as the motherboard the UUID of the device will change. Licenses are based on device UUID. Contact Symbol Customer Service for a new license. 3. Q: How can I license my terminal; I ve entered my UUID parts 1 & 2 which I found in Symbol settings, but cannot find the checksum? A: You need to use the UUIDs from the Symbol Pocket Browser license screen. On this screen you will also find the checksum you are looking for. 4. Q: I ve compared my UUID displaying in Symbol Pocket Browser to the UUID displayed in Symbol settings and they are noticeably different. Why? A: On Windows CE, the UUID is only 16 digits long, Symbol Pocket Browser requires a 32 digit UUID, therefore the UUID is padded with zeros. 5. Q: I ve added some JavaScript to set the focus to my input field when the page loads, but it is not always getting set. What am I doing wrong? A: Due to extra processing in Symbol Pocket Browser with features such as the battery indicator, sometimes focus gets lost. Try using the settimeout function to delay setting focus for a very short time (approx. 500 ms). 6. Q: When my device goes out of range it does not respond for up to 2 minutes. Why is this? A: By default, Symbol Pocket Browser waits for 45 seconds before prompting the user to cancel or retry. This timeout can be shortened by changing the navigationtimeout setting in the registry. This timeout cannot be lengthened. 7. Q: I ve added a default meta tag entry in my registry to make the battery indicator visible. Every time I add the tag to set the position of the indicator it is replacing my show tag. Why? A: When adding more than one parameter for the same tag, add a key for that tag then create a setting of type dword with the name set as the value of the tag. [HKEY_CURRENT_USER\Software\Symbol\SymbolPB\Tags\Battery] "right"=dword: "y=303"=dword: "x=180"=dword: Q: I have a page with bookmarks. When I try to navigate to a bookmark which is further down the screen than the visible area, it is failing to navigate. Why? Symbol Technologies, Inc. Page 10 Copyright 2006

11 A: When scroll bars are switched off, Internet Explorer and Pocket Internet Explorer will not scroll the page when you navigate to a non-visible bookmark section. Either turn on scrollbars or redesign your page to use div tags or separate files. 9. Q: I ve added a power on tag however; when I switch on the device it sometimes does not navigate. Why? A: Ensure that the URL or JavaScript function is not directing the browser to navigate to a page which is not on the device. If the network is not fully established when the navigation occurs, it will fail. 10. Q: Symbol Pocket Browser is in my start-up folder. Sometimes when starting, I get a blank screen. Why? A: When starting Symbol Pocket Browser from the start-up folder, ensure that the first page navigated to is a local file. This gives the radio enough time to start and establish a network connection. 11. Q: When I click the SIP button in Symbol Pocket Browser on my MC50 QWERTY device, the SIP appears momentarily then disappears. Why? A: There is a feature with the MC50 and MC70 that have physical keyboards where the SIP will not show until the system SIP button has been pressed. 12. Q: When I launch a process using the Symbol Pocket Browser ActiveX control, the start bar is not visible and I can still see Symbol Pocket Browser below. Why is this? A: Symbol Pocket Browser locks the user out of the Operating System by removing the start bar (amongst other things). If this looks odd, design a page to display in Symbol Pocket Browser while your process is running which shows an appropriate background. 13. Q: When I enable the scanner, the first time I scan a barcode, my scanner parameters are not taking effect. What is wrong? A: When setting parameters or disabling decoders always add the scanner enabled tag after all the parameters and decoders have been set. Symbol Technologies, Inc. Page 11 Copyright 2006

12 SMDK for Java 1. Q: Can the Sun Microsystems JVM be installed on a Symbol device and be used to run my Java applications? A: No. The SUN JVM has not been validated to run on Symbol mobile devices. The SMDK for Java has only been validated to work with the IBM J9 JVM. 2. Q: What JVM should I use to run the SMDK for Java sample applications? A: The only JVM tested with SMDK for Java is the "IBM J9 Personal Profile 1.0" which comes with "WebSphere Studio Device Developer 5.7.1". 3. Q: Why does SMDK for Java provide two sets of shortcut files for the samples; one for Windows CE devices and another for Windows Mobile devices? A: The IBM J9 JVM gets installed into different locations on these two types of devices. For this reason, two sets of shortcut files for the samples are required. 4. Q: What is JavaPOS? A: JavaPOS (or Java for Point Of Sale) is a standards committee whose purpose is to examine the ways in which Java applications can best be utilized in a retail environment. The JavaPOS standard defines a set of JavaPOS services that are used by the application developer to interface with the various components on the mobile device. 5. Q: What are the JavaPOS services currently available for Symbol Mobile Computers? A: The SMDK v1.2 for Java provides support for 2 JavaPOS services; one for MSR and one for the Scanner. Others may be provided in the future, depending on customer demand. 6. Q: The J9 JVM was included with the SMDK v1.0 for Java. Why is it no longer supplied with the newer versions of SMDK for Java? A: Symbol no longer distributes the J9 JVM with the SMDK for Java. For application development, a single copy of the JVM is included with WebSphere Studio Device Developer. Licenses for enterprise deployment are available from IBM. Symbol Technologies, Inc. Page 12 Copyright 2006

13 7. Q: I modified one of the sample shortcut files to launch my own application, but it does not work. What happened? A: A sample shortcut file is a single-line text file consisting of a length and a command line. If you modify the command line, make sure you modify the length accordingly. The length includes all of the characters following the # character. Also make sure that the length does not exceed 255 characters. The following example illustrates the shortcut file for the Audio sample application. 186#"\Program Files\J9\PPRO10\bin\j9w.exe" "-classpath" "\Java\J_AudioSample1.jar" "-jcl:ppro10" "-jcl:ppro10" "-classpath" "\Java\symbolclasses.jar;\Java\symbolsamples.jar" "J_AudioSample1" 8. Q: I installed the J9 JVM on a CE 4.2 device, and then installed the SMDK samples according to the instructions, but when I click on a sample, it does not run, giving an error. What can cause this? A: There are 2 different sets of CAB files provided with the SMDK for Java, one for Windows CE devices and another set for Windows Mobile devices. Make sure you install the correct set of CAB files. This error can be caused by inadvertently installing the CAB files intended for Windows Mobile onto a Windows CE device. Symbol Technologies, Inc. Page 13 Copyright 2006