本文介紹了通過“Hello World”來掌握ProE二次開發的一些經驗。

　　如同各種開發語言的學習一樣，我們也從“ Hello World ”開始 Pro/Engineer 的二次開發的學習。通過這個小程序我們將對基于 Pro/TOOLKIT 的 Pro/Engineer 二次開發有一個感性的認識，同時熟悉基于 Pro/TOOLKIT 的 Pro/Engineer 二次開發的開發流程。該程序的主要功能是在 Pro/Engineer 的當前窗口中顯示“ Hello World ”歡迎信息。在開始學習之前要說一下，本系列主要是以 C 語言開發為主，所以我們假設您有一定的 C 語言基礎了。

　　一、 系統要求和軟件安裝

　　Pro/TOOLKIT 是 Pro/Engineer 系統的客戶化開發工具包，即應用程序接口( API )。它提供了大量的 C 語言庫函數，能夠使外部應用程序(客戶應用程序)安全有效地訪問 Pro/Engineer 的數據庫和應用程序。通過 C 語言編程及應用程序與 Pro/Engineer 系統的無縫集成，客戶和第三方能夠在 Pro/Engineer 系統中添加所需地功能。

　　想要利用 Pro/TOOLKIT 進行 Pro/Engineer 二次開發，首先必須正確安裝 Pro/TOOLKIT ，所以下面先介紹如何安裝 Pro/TOOLKIT ，然后再介紹如何測試 Pro/TOOLKIT 是否已經安裝成功。

　　1. 1 Pro/TOOLKIT 的安裝

　　安裝 Pro/Engineer 的時候，在選擇安裝組件步驟，打開組件 API Toolkits ，選中 Pro/TOOLKIT 選項，如圖 所示， Pro/TOOLKIT 就會隨著 Pro/Engineer 一起安裝在用戶的機器上。

　　1 . 2 測試 Pro/TOOLKIT

　　當安裝完 Pro/TOOLKIT 后，應該馬上通過編譯、連接和運行一個簡單的 Pro/TOOLKIT 程序來檢驗 Pro/TOOLKIT 是否安裝成功，以免給后面的開發工作帶來不必要的麻煩。

　　Pro/TOOLKIT 軟件包提供了一個簡單的測試程序 pt_install_test, 下面通過此程序敘述測試過程。

　　1. 編譯和連接

　　根據 Pro/TOOLKIT 提供的 Makefile 文件“ make_install ”進行編譯和連接。此文件位于 ( Pro/Engineer 的安裝目錄) protoolkitprotk_appls 目錄下。

　　有兩種編譯方法，一種方法是采用 MS-DOS 方式，利用 MS-DOS 方式進行編譯步驟如下：

　　(1) 將 protoolkitobj 目錄下的 make_install 文件拷貝至一個新的目錄下，假設拷貝至 D: est 目錄下。

　　(2) 用寫字板打開 make_install 文件，修改下列區域的語句：

　　# Pro/Toolkit Source & Machine Loadpoint (EXTERNAL USE_DEFAULT)

　　PROTOOL_SRC = ../..

　　PROTOOL_SYS = $(PROTOOL_SRC)/$(PRO_MACHINE_TYPE)

　　將 PROTOOL_SRC 改為本機 Pro/TOOLKIT 的安裝路徑，例如：

　　PROTOOL_SRC = D:PTCproewildfireprotoolkit

　　修改后保存文件。

　　(3) 打開 MS_DOS 命令提示符，設置 MS_DOS 狀態下的編譯環境為運行 VC 6.0 的 vcvars32.bat 程序。

　　(4) 在 MS_DOS 命令提示符中輸入以下語句：

　　nmake –f make_install

　　就開始根據 make_install 文件進行編譯、連接，最后生成可執行文件 pt_install_test.exe。

　　另一種編譯方法是在VC 環境中進行編譯，首先將文件 make_install 改名為make_install.mak ，然后利用VC開發環境打開此文件，生成 VC 工程項目文件，然后執行 Build 命令編譯連接，最后生成一名為 pt_install_test.exe 的文件。

　　兩種方法最后生成的 pt_install_test.exe 文件完全一樣，只是這兩種方法的調試環境不同，一般推薦采用 VC 開發環境作為調試方法，主要是因為在 VC 調試環境下可以反復修改源程序。

　　2 . 注冊

　　在此工作目錄下，建立一個注冊文件 protk.dat 文件。注冊文件是一個專門用來告知 Pro/ENGINEER 系統應用程序相關信息的文件，以便 Pro/ENGINEER 系統能夠識別并執行我們的 Pro/TOOLKIT 應用程序。

　　此 protk.dat 文件的內容如下：

　　name install_test

　　exec_file D: estpt_install_test.exe

　　text_dir D:PTCproewildfireprotoolkitprotk_appls

　　pt_install_test ext

　　revision 24

　　end

　　3 . 程序的執行

　　以包含上面的 protk.dat 文件的目錄為啟動目錄啟動 Pro/ENGINEER 系統， Pro/ENGINEER 將啟動應用程序 pt_install_test 。 當該程序正確執行時，在 Pro/ENGINEER 系統的 File 菜單下會增添一個新的命令 -Install Test 。

　　當用戶單擊此命令時，就會在 Pro/ENGINEER 窗口中彈出一個對話框，在該對話框中顯示出“ The Pro/TOOLKIT Installation Test succeeded ”的信息。

　　4 . 以 DLL 方式重新測試此程序

　　以 DLL 方式編譯和連接此應用程序， make_install 文件無需修改，只是在 MS-DOS 命令提示符中輸入的是：

　　nmake –f make_install dll

　　完成編譯和連接后，會生成一動態連接庫文件 pt_install_test.dll 。

　　在注冊此應用程序時，需要對 protk.dat 文件進行如下修改：

　　name install_test

　　startup dll

　　exec_file D: estpt_install_test.dll

　　text_dir D:PTCproewildfireprotoolkitprotk_applspt_install_test ext

　　revision 24

　　end

　　所做的修改是在此文件的第二行加入了一句“ startup dll ”，表示此程序以 dll 方式啟動。

　　程序注冊后，在包含 protk.dat 的目錄下啟動 Pro/ENGINEER ，程序執行結果同 1.2.2 節的第 3 小節中的結果完全一樣。

　　二、“ Hello World ”的編寫與編譯

　　2. 1 編寫源文件

　　源文件包括資源文件和程序源文件：資源文件包括菜單資源文件、窗口信息資源文件、對話框資源文件(分別用來完成創建和修改 Pro/ENGINEER 菜單、窗口信息和對話框等功能)等;程序源文件指我們所要編寫的 C 語言程序，它是整個 Pro/TOOLKIT 程序開發的核心部分。

　　“ Hello World ”程序非常簡單，其功能只是在 Pro/ENGINEER 窗口內顯示歡迎信息，沒有對菜單資源等進行的修改，所以此程序沒有資源文件。該程序的程序源代碼如下：

　　/* hello_world.c */

　　// 頭文件包含

　　#include "ProToolkit.h"

　　#include "ProGraphics.h"

　　/* 函數： int user_initialize */

　　/* 功能：用戶初始化函數 */

　　int user_initialize(int argc, char *argv[])

　　{

　　// 函數聲明

　　int hello_function();

　　// 調用函數 hello_function

　　hello_function();

　　return (0);

　　}

　　/* 函數： user_terminate */

　　/* 功能：用戶結束中斷函數 */

　　void user_terminate()

　　{

　　printf("Pro/Toolkit application terminated successfully ");

　　return ;

　　}

　　/* 函數： hello_function */

　　/* 功能：顯示出“ Hello World ”歡迎信息 */

　　int hello_function()

　　{

　　wchar_t wtext[64];

　　double pt[3];

　　pt[0] = 150.0;

　　pt[1] = 375.0;

　　/* 設置變量 wtext 內容為“ Hello World ” */

　　ProStringToWstring(wtext, "Hello World");

　　/* 顯示出“ Hello World ”信息 */

　　ProGraphicsTextDisplay(pt, wtext);

　　return (0);

　　}

　　這個程序是非常簡單的，但從中可以看出 Pro/TOOLKIT 程序的基本結構。整個程序由文件包含部分、用戶初始化函數 user_initialize() 和用戶結束中斷函數 user_terminate() 組成。關于用戶初始化函數 user_initialize() 和用戶結束中斷函數 user_terminate() 的作用以及具體用法，我將會在后續的文章中進行介紹。

　　2 . 2 程序的編譯和連接

　　為了編譯連接所編制的程序代碼，一般需要制作 Makefile 工程文件，可以根據 Pro/TOOLKIT 自帶的 Makefile 修改。該文件主要指定庫文件、頭文件、源文件的位置及要生成的可執行文件和動態連接庫名稱等。也就是說，此文件是用來說明如何進行應用程序編譯和連接的，當然也可以在 VC++6.0 環境中指定上述各種項目。

　　“ Hello World ”程序的 Makefile 文件 make_hello 內容如下：

　　// 文件開始

　　# File Name // 定義 make 文件名稱

　　MAKEFILENAME = make_hello

　　# Machine Type // 定義機器類型

　　PRO_MACHINE_TYPE = i486_nt

　　# Executable names // 定義生成的執行文件

　　EXE = hello.exe

　　EXE_DLL = hello.dll

　　# Pro/Toolkit Source & Machine Loadpoint (EXTERNAL USE - DEFAULT) // 定義 # Pro/Toolkit 安裝根目錄

　　PTC_DIR = D:PTCproeWildfire

　　PROTOOL_SRC = $(PTC_DIR)/protoolkit

　　PROTOOL_SYS = $(PROTOOL_SRC)/$(PRO_MACHINE_TYPE)

　　PRODEV_SRC = $(PTC_DIR)/prodevelop

　　PRODEV_SYS = $(PRODEV_SRC)/$(PRO_MACHINE_TYPE)

　　# Pro/Toolkit Source & Machine Loadpoint (PTC INTERNAL USE)

　　#PROTOOL_SRC = $(PTCSRC)/protoolkit

　　#PROTOOL_SYS = $(PTCSYS)

　　#PRODEV_SRC = $(PTCSRC)/prodevelop

　　#PRODEV_SYS = $(PTCSYS)

　　# Include File Paths

　　INCS = -I. -I$(PROTOOL_SRC)/protk_appls/includes -I$(PROTOOL_SRC)/includes

　　-I$(PRODEV_SRC)/includes

　　# Compiler Flags // 定義編譯特征值

　　CC = cl

　　MACH = -DPRO_MACHINE=29 -DPRO_OS=4

　　CCFLAGS = -Dhypot=_hypot -DMSB_LEFT -Dfar=ptc_far -Dhuge=p_huge -Dnear=p_near -c -W2 -G4 -Za -D_X86_=1 -D_WSTDIO_DEFINED

　　CFLAGS = $(CCFLAGS) $(INCS) $(MACH)

　　# Libraries // 定義庫文件路徑

　　PTCLIBS = $(PRODEV_SYS)/obj/prodevelop.lib $(PROTOOL_SYS)/obj/protoolkit.lib

　　PTCLIBS_DLL = $(PRODEV_SYS)/obj/prodev_dll.lib $(PROTOOL_SYS)/obj/protk_dll.lib

　　LIBS = libc.lib kernel32.lib user32.lib wsock32.lib advapi32.lib mpr.lib winspool.lib

　　# Object files // 定義目標文件

　　OBJS = hello.obj

　　# Linker // 編譯器

　　LINK = link

　　$(EXE) : $(OBJS) $(PTCLIBS)

　　@echo Start at `date`

　　@echo PROTOOL_SRC = $(PROTOOL_SRC)

　　@echo PROTOOL_SYS = $(PROTOOL_SYS)

　　$(LINK) /subsystem:console -out:$(EXE) /debug:none /debugtype:coff /machine:i386 @<

　　$(OBJS) $(PTCLIBS) $(LIBS)

　　<<

　　@echo Finished at `date`

　　del $(OBJS)

　　# Dll target // 定義 dll 文件

　　dll: $(EXE_DLL)

　　$(EXE_DLL) : $(OBJS) $(PTCLIBS_DLL)

　　@echo Start at `date`

　　@echo PROTOOL_SRC = $(PROTOOL_SRC)

　　@echo PROTOOL_SYS = $(PROTOOL_SYS)

　　$(LINK) /subsystem:console -out:$(EXE_DLL) /debug:none /debugtype:coff /machine:i386 /dll @<

　　$(OBJS) $(PTCLIBS_DLL) $(LIBS)

　　<<

　　@echo Finished at `date`

　　del $(OBJS)

　　# object dependencies // 定義目標文件依附關系

　　PROTK_APPLS = D:protoolkit-workhello_word

　　hello.obj: $(PROTK_APPLS)/hello.c

　　$(CC) $(CFLAGS) $(PROTK_APPLS)/hello.c

　　clean :

　　del $(OBJS)

　　del $(EXE)

　　nmake -f $(MAKEFILENAME)

　　clean_dll :

　　del $(OBJS)

　　del $(EXE_DLL)

　　nmake -f $(MAKEFILENAME) dll

　　// 文件結束

　　有關 make 文件的格式及改寫也將在以后的文章中給于詳細的介紹。修改完成后將此 make_hello 文件改名為 make_hello.mak ，打開 VC++6.0 的 File 主菜單，單擊 Open Workspace 按鈕，在打開的 Open Workspace 對話框中將文件類型改為 Makefiles(mak) ，打開文件 make_hello.mak 。 VC++6.0 就會根據 make_hello.mak 文件生成一個工程文件，編譯連接該工程，生成 hello.dll 文件。

　　2 . 3 應用程序的注冊

　　要使應用程序能夠集成到 Pro/ENGINEER 系統中運行，必須制作一個擴展名為 .dat 的注冊文件，用該文件進行應用程序的注冊。

　　“ Hello World ”程序的注冊文件為 protk.dat ，假設放在 Pro/ENGINEER 啟動目錄下，文件內容如下：

　　name hello

　　startup dll

　　exec_file D: workhello hello.dll

　　text_dir text

　　allow_stop true

　　revision 24

　　end

　　在含有 protk.dat 文件的目錄下啟動 Pro/ENGINEER ，“ Hello World ”應用程序會自動執行，執行結果為在 Pro/ENGINEER 圖形窗口內顯示出“ Hello World ”歡迎信息。

　　OK !在這里我們已經完成了第一個 Pro/TOOLKIT 應用程序“ Hello World ”的全部開發。怎么樣?看著自己的成果是不是有點想飄的感覺，原來一直只是在琢磨 PTC 還有什么，現在我們可以自己來改變它了!千萬不要現在就飄呀!以后的會更精彩! o_o