uTools CE 用戶使用指南

1、uTools CE用戶開發(fā)與使用指南福建 HYPERLINK . :/ nlscan / 新大陸自動識別技術(shù)版本號： V1.1地址： 福州市馬尾區(qū)儒江大道1號新大陸科技園 ： 350015 ：：公司主頁： HYPERLINK .mailto:supportmail.nlscan nlscan 電子郵件： HYPERLINK mailto:supportmail.nlscan supportmail.nlscan 鄭春光作者單位：技術(shù)部文檔編號：提交檔案文檔名稱及存放路徑名稱uTools_CE用戶使用指南.doc時間 SAVEDATE

2、yyyy年M月d日星期W * MERGEFORMAT 2021年3月2日星期一大小489,472 字節(jié)存放ReleaseDoc98x_doc uTools_CE用戶使用指南.doc修改記錄版本日期修改內(nèi)容姓名V 1.02008/12/25創(chuàng)立此文件鄭春光V 1.12009/03/02最新修訂版李志雄此文檔已由以上人員編輯修改。審閱記錄日期姓名職務(wù)備注簽字此文檔已由以上人員審閱通過。分發(fā)派送日期部門姓名職務(wù)此文檔已分發(fā)派送以上人員。目 錄 TOC o 1-4 h z u HYPERLINK l _Toc223757728 1uTools CE介紹 PAGEREF _Toc223757728 h

3、1 HYPERLINK l _Toc223757729 2uTools CE安裝指南 PAGEREF _Toc223757729 h 1 HYPERLINK l _Toc223757730 3編寫一個應(yīng)用程序 PAGEREF _Toc223757730 h 2 HYPERLINK l _Toc223757731 4如何執(zhí)行編譯好的程序 PAGEREF _Toc223757731 h 3 HYPERLINK l _Toc223757732 5如何調(diào)試程序 PAGEREF _Toc223757732 h 4 HYPERLINK l _Toc223757733 5.1在線調(diào)試 PAGEREF _To

4、c223757733 h 4 HYPERLINK l _Toc223757734 5.2如何輸出調(diào)試信息 PAGEREF _Toc223757734 h 4 HYPERLINK l _Toc223757735 6如何創(chuàng)立CAB安裝包與布署 PAGEREF _Toc223757735 h 6 HYPERLINK l _Toc223757736 6.1創(chuàng)立CAB安裝包 PAGEREF _Toc223757736 h 6 HYPERLINK l _Toc223757737 6.2布署并安裝CAB安裝文件 PAGEREF _Toc223757737 h 6 HYPERLINK l _Toc223757

5、738 7常見問題解決方法 PAGEREF _Toc223757738 h 7 HYPERLINK l _Toc223757739 7.1常見編譯與調(diào)試問題 PAGEREF _Toc223757739 h 7 HYPERLINK l _Toc223757740 7.2如何移植用于其它設(shè)備上的CE程序 PAGEREF _Toc223757740 h 8 HYPERLINK l _Toc223757741 7.3其它常見問題 PAGEREF _Toc223757741 h 8 HYPERLINK l _Toc223757742 8附錄 PAGEREF _Toc223757742 h 9 HYPER

6、LINK l _Toc223757743 8.1PT980設(shè)備按鍵與鍵值對應(yīng)表 PAGEREF _Toc223757743 h 9 HYPERLINK l _Toc223757744 8.2重定義PT98x鍵盤按鍵功能 PAGEREF _Toc223757744 h 10uTools CE介紹uTools CE 是一款依托于Visual Studio .net 2005的Add-On擴展插件型軟件，是專門用于開發(fā)Newland公司CE平臺應(yīng)用軟件的工具。通過uTools可以編寫出更高效的，適用于我司CE平臺設(shè)備的軟件。uTools CE只能使用C+語言開發(fā)，它支持標準的CE內(nèi)核編程接口，并集成

7、了MFC類庫，使用戶開發(fā)應(yīng)用程序的界面時更方便快捷，并且減少再學(xué)習(xí)所需要花費的時間與人力本錢，提高效率。在我們的CE設(shè)備上使用C#或VB語言開發(fā) .NET 應(yīng)用程序，如果需要用到讀碼、撥號、獲取系統(tǒng)信息的API接口，需要安裝uTools CE .Net，可以從我們公司的網(wǎng)站上得到。uTools CE安裝指南安裝uTools CE之前，您必須確保滿足以下的條件：Windows 2000或Windows XP以上版本操作系統(tǒng)。Visual Studio 2005，并且選中了“Visual C+ 與“Smart Device Programmability選項，如下列圖所示。Visual Studi

8、o .net 2005 Service Pack 1，它包含了一些Visual Studio .net 2005的Bug修正，提高了兼容性，并且使程序更穩(wěn)定。Microsoft ActiveSync 4.5，它包含了Smart Device設(shè)備的USB驅(qū)動與文件瀏覽器，如果需要使用在線調(diào)試或傳輸文件的功能就必須安裝此軟件。以上幾個安裝完了即可安裝uTools CE。注意：如果您是用Visual Studio 2021 開發(fā)，uTools CE，那么在安裝時必須把“.Net Compact Framework與“Document選項去除，否那么安裝過程將會出錯。如下所示：安裝時，點Custom，

9、彈出如下界面：把“.Net Framework與“Document選項去除Visual Studio 2021環(huán)境下編寫一個應(yīng)用程序新建一個Visual C+工程，把工程類型設(shè)置為Smart Device，模板選擇MFC Smart Device Application，如下列圖所示：在確定Platform時，選擇NewlandPT98x，并且把其它的設(shè)備去掉，如下列圖所示：在選擇以何種方式使用MFC庫時，建議用戶選擇Use MFC in a static library方式來使用MFC動態(tài)鏈接庫，因為我們的設(shè)備端只提供了Release版的MFC動態(tài)鏈接庫，如果用Use MFC in a sh

10、ared DLL選項，將導(dǎo)致Debug版本的程序無法在設(shè)備上運行與調(diào)試。剩下的工程參數(shù)可以根據(jù)用戶自己的需求來確定，沒有特別要求。至此，一個應(yīng)用程序的框架就建立起來了。如何執(zhí)行編譯好的程序在程序編譯完成之后，我們就可以布署程序并運行了。布署程序有兩種方式這里指的是開發(fā)與測試過程中的布署。一種是把編譯生成的目標文件通過ActiveSync軟件復(fù)制到設(shè)備的文件系統(tǒng)上，然后從設(shè)備的文件瀏覽器我的設(shè)備中翻開應(yīng)用程序，這里就可以看到程序運行起來的界面與結(jié)果了。二是通過Debug菜單的Start Without Debugging選項來運行程序。如下列圖所示：這種方法要求設(shè)備必須已經(jīng)通過USB連接到了PC

11、上。且ActiveSync 狀態(tài)是已連接。運行時，Visual Studio會先把相應(yīng)的文件復(fù)制到設(shè)備的Program FilesProject Name目錄下，然后再調(diào)用程序運行。如果程序有用到額外的數(shù)據(jù)庫、動態(tài)庫或圖片之類的文件，需要手工拷貝到Program FilesProject Name目錄下。如何調(diào)試程序程序調(diào)試有兩種手段，一種是直接聯(lián)機在線調(diào)試，通過設(shè)置程序運行斷點等方法進行單步運行調(diào)試，另外一種是不中斷程序的運行，而通過程序輸出的調(diào)試信息來觀察參數(shù)與定位錯誤位置。兩種模式各有優(yōu)點與用處，用戶可以依據(jù)自己的需要選擇適當?shù)恼{(diào)試方法。在線調(diào)試點擊運行之后可以在Output窗口可以看到

12、如下信息：“Deploy started: Project: xxx, Configuratior xxx這表示Visual Studio正在向設(shè)備布署應(yīng)用程序，在這過程中，Visual Studio將把應(yīng)用程序復(fù)制到設(shè)備的“Program FilesProject Name目錄下，并且把一些應(yīng)用程序需要的動態(tài)鏈接庫傳輸?shù)皆O(shè)備上，然后就會開始以調(diào)試模式運行應(yīng)用程序。這一布署過程在第一次調(diào)試時需要的時間比擬長，可能需要將近1分鐘，但之后再進行調(diào)試時，布署速度將會有很大的提高。如何輸出調(diào)試信息除了聯(lián)機在線單步調(diào)試之外，有時需要輸出一些調(diào)試信息，當調(diào)試信息的量比擬小時還可以顯示在程序的界面上，但信息

13、量大的時候就需要用其它的解決方法了。Windows CE提供了三個接口來輸出調(diào)試信息，它們的函數(shù)原型如下：void TRACE(LPCWSTR lpFmtStr, );要使用TRACE接口，必須參加MFC庫的支持，否那么無法使用。實際上TRACE接口是一個宏定義，它只在Debug版時起作用，生成Release版時將不會有任何操作與信息輸出。通常情況下，我們推薦用戶使用這個接口。void NKDbgPrintfW(LPCWSTR lpFmtStr, );NKDbgPrintfW接口是一個真實存在的內(nèi)核接口，一量調(diào)用它就將輸出指定的信息，而不管是Debug版還是Release版。如果用戶的應(yīng)用程序

14、不想?yún)⒓覯FC庫的支持但又想輸出調(diào)試信息的話，可以使用這個函數(shù)。void OutputDebugString(LPCWSTR lpDbgStr);OutputDebugString接口也是一個真實存在的內(nèi)核接口，一量調(diào)用將輸出指定的信息，而不管Debug版還是Release版。這三個接口中，TRACE與NKDbgPrintfW都是可變參數(shù)接口，用法與printf函數(shù)相似，解釋命令也與printf的接口相一致，方便用戶輸出某些參數(shù)的當前值，OutputDebugString那么沒有這個功能，只能輸出不經(jīng)解析的字符串。以下是這三個調(diào)試信息輸出函數(shù)的例如代碼與輸出結(jié)果。例如代碼：TRACE(_T(D

15、ebug Out 1.%drn), 1234);NKDbgPrintfW(_T(Debug out 2.%drn), 4321);OutputDebugString(_T(Debug Out 3.rn);最終顯示出來的調(diào)試信息：如果看不到Debug的Output窗口，可以從View-Output菜單調(diào)出，如下列圖所示：如何創(chuàng)立CAB安裝包與布署創(chuàng)立CAB安裝包程序開發(fā)完成之后，可以把所需要的文件打包在一起，生成一個CAB安裝文件，用于在CE設(shè)備上布署。Visual Studio里已經(jīng)提供了這個工具。要創(chuàng)立一個CAB安裝包，你需要新建一個工程，如下列圖所示，工程類型選擇Setup and Dep

16、loyment，模板選擇Smart Device CAB Project，就可以創(chuàng)立一個安裝包的工程了。關(guān)于更具體的配置與安裝包生成操作，請參考微軟的Visual Studio開發(fā)手冊。布署并安裝CAB安裝文件安裝包生成之后就可以進行布署了。布署的方法是把CAB安裝文件通過ActiveSync軟件發(fā)送到設(shè)備上，然后在設(shè)備上運行這個CAB安裝包，如果不需要更改默認的安裝路徑的話，直接按回車就可以完成安裝過程。注意：CAB文件在安裝完成之后會被系統(tǒng)自動刪除。常見問題解決方法常見編譯與調(diào)試問題為什么編譯程序都沒問題，但只有Release版的程序可以運行，Debug版的無法運行且沒有任何提示？如果你在

17、建立新工程的時候，選擇MFC運行時刻庫的鏈接與使用方式時選擇了“Use MFC in a shared DLL，那么就會出現(xiàn)這個問題。這是因為我們的設(shè)備上只提供了Release版的MFC運行時刻庫，所以導(dǎo)致Debug版的程序無法運行。解決方法是調(diào)出工程的屬性設(shè)置對話框，然后選中Configuration Properties下的General選項，然后找到右邊的Use of MFC選項，并把它修改為“Use MFC in a Static Library，如下列圖所示，最后保存設(shè)置，再編譯一遍代碼就可以解決這個問題了。可以用Visual Studio的Pocket PC平臺開發(fā)軟件嗎？如果你的

18、應(yīng)用程序并不需要進行平臺相關(guān)的操作，如控制識讀頭讀碼等操作，那么你就可以在Pocket PC平臺下開發(fā)軟件，最后再布署到我們的CE終端設(shè)備上。用uTools CE平臺編譯的軟件可以在其它公司的CE平臺，如Pocket PC上運行嗎？不保證能在其它公司的CE平臺上運行，除非用相應(yīng)平臺的SDK重新編譯過后，因為我們的設(shè)備可以兼容Pocket PC的二進制代碼，但Pocket PC或其它設(shè)備那么不一定能兼容uTools CE生成的二進制代碼。為什么編譯時總會出現(xiàn)“warning C4996警告信息？在使用uTools CE編譯程序時，會出現(xiàn)如下所示的多個類似警告信息，warning C4996: w

19、csncpy was declared deprecatedMessage: This function or variable may be unsafe. Consider using wcsncpy_s instead. To disable deprecation, use _CRT_SECURE_NO_DEPRECATE. See online help for details.這是微軟公司編譯器與頭文件導(dǎo)致的問題。因為微軟公司不推薦用戶使用這些函數(shù)，但實際上這些函數(shù)本身是沒問題的，而且簡化了需要的參數(shù)，只是使用時要求程序員要把握好它們的特性，以免寫出不夠平安與健壯的程序。如何禁止“

20、warning C4996警告信息？繁多的警告信息讓我們感覺編譯信息太多，可能會忽略掉需要關(guān)注的其它警告或出錯信息，所以用戶有時需要屏蔽掉這些警告信息。屏蔽的方法有兩種，列出如下。1.在工程的stdafx.h中尋找#pragma once語句，在它的后面參加如下所示的宏定義 ： #define _CRT_SECURE_NO_DEPRECATE2.在工程的stdafx.h中尋找#pragma once語句，在它的后面參加如下所示的編譯控制語句 ： #pragma warning(disable:4996)為什么我的程序已經(jīng)編譯通過，但無法在PC上運行？用uTools CE SDK平臺生成的應(yīng)用程

21、序只能在指定的設(shè)備上運行，而不能在PC上直接運行。為什么我無法在Visual Studio環(huán)境下調(diào)試程序？要想在Visual Studio環(huán)境下調(diào)試程序，你必須確認已經(jīng)安裝了Microsoft ActiveSync 4.5以上版本的軟件，并且設(shè)備已經(jīng)通過USB接口正確連接到PC上。否那么Output窗口將會出現(xiàn)如下出錯信息：Device is not ready. If target is an ActiveSync device, verify whether ActiveSync connection is running.Connect to device failed.如何移植用于其它

22、設(shè)備上的CE程序不同的CE設(shè)備平臺，在系統(tǒng)接口與圖形界面上的接口根本兼容，因此，移植的重點要放在有重大區(qū)別的條碼數(shù)據(jù)采集局部。我司的設(shè)備使用一套自定義的擴展接口NDSI API來支持數(shù)據(jù)采集與識讀控制，接口的具體定義與使用請參考uTools CE開發(fā)手冊的識讀頭控制局部。在進行程序移植時不建議直接在原來的工程中進行修改，建議新建一個uTools CE的工程工程，然后再把原來工程的代碼與資源添加進來，然后在這個新的工程根底上進行修改與編譯，以防止因不同平臺帶來的兼容性問題導(dǎo)致的程序出錯。其它常見問題代碼在PC上編譯通過，但復(fù)制到設(shè)備上去之后卻無法運行，也看不到任何提示。這很可能是由于設(shè)備上缺少某

23、些程序所需要的動態(tài)鏈接庫所引起的。由于沒有任何提示，你可能需要認真檢查你的程序是否有依賴于什么系統(tǒng)沒提供的動態(tài)鏈接庫或用戶自己編寫的動態(tài)鏈接庫。或者你可以使用Visual Studio提供的Depends.exe程序來查看你的應(yīng)用程序所需要的動態(tài)鏈接庫，在Visual Studio的安裝路徑下可以搜索到它。如何在PC上編輯設(shè)備上的注冊表信息？因為設(shè)備的屏幕通常較小，而且按鍵不豐富，所以在設(shè)備上進行注冊表編輯操作很煩鎖。針對這個問題，微軟在Visual Studio 2005軟件中提供了一個工具，名字為Remote Registry Editor，用這個工具軟件我們可以方便地在PC上修改設(shè)備的注

24、冊表內(nèi)容，使用方法與Regedit根本相同，只是初始化時要求選擇一個設(shè)備來進行操作。如何在截取設(shè)備上的屏幕顯示？有時需要為編寫好的軟件制作一份用戶手冊，這時就需要有一個手段來獲取設(shè)備屏幕上的顯示內(nèi)容了。針對這個問題，微軟的Visual Studio 2005提供了一個名為Remote Zoom In的工具軟件，它可以方便地截取設(shè)備上的顯示信息，并保存為BMP圖片，方便用戶的文檔編寫與制作。附錄PT980設(shè)備按鍵與鍵值對應(yīng)表PT98x KeyboardPC KeyboardWindows DefineHex Value1110 x312220 x323330 x334440 x345550 x356660 x367770 x378880 x389990 x390000 x30*F7VK_F70 x76#F8VK_F80 x77Up上VK_UP0 x26Down下VK_DOWN0 x28Left左VK_LEFT0 x25Right右VK_RIGHT0 x27OKEnterK_RETURN0 x0dCEscVK_ESCAPE0 x1bBackSpaceBackSpaceVK_BACK0 x08SpaceSpaceVK_SPACE0 x20FnF16VK_F160 x7fScanF15VK_F150 x7eLeft Side KeyF13VK_F1