从共享库文件导入函数

使用导入共享库向导，为Windows .dll文件、macOS .framework文件或Linux .so文件中的函数创建或更新其包装VI的LabVIEW项目库。必须提供共享库文件名和头文件(.h)以便向导解析。导入共享库向导仅支持符合C/C++语法并使用C或标准_stdcall调用规范的头文件。

按照下列步骤，通过共享库文件中的函数创建或更新包装VI。

1. 选择工具»导入»共享库，打开导入共享库向导。出现指定创建或更新模式页。
2. 如要为之前未导入的共享库创建包装VI，选择为共享库创建VI。如要为已导入的共享库创建VI，选择为共享库更新VI。

1. 单击下一步按钮，显示向导的选择共享库及头文件页。
2. 在共享库文件中输入要导入的共享库的路径，或单击浏览按钮，找到并选择文件。
3. 如要为不在本地计算机上的共享库（例如，RT终端上的共享库）创建VI，勾选共享库文件不在本地机器内复选框，并在共享库文件文本框中输入共享库文件的文件名。不必输入共享库文件的路径。

注：如果只指定文件名而不指定路径，则共享库文件必须位于包装VI的目标目录中，或者必须通过系统搜索路径可用。

1. 在头文件(.h)文本框中输入与共享库共同使用的头文件路径，或单击浏览按钮，找到并选择文件。导入共享库向导仅支持符合C/C++语法并使用C或标准(WINAPI)调用规范的头文件。
2. 单击下一步按钮，打开配置包括路径和预处理定义，输入向导解析头文件时需用到的任何包括路径或预处理定义。
3. 单击下一步按钮，显示选择待转换函数页。此时会出现一个对话框，显示LabVIEW正在解析头文件。
4. 选择待转换函数页将显示在共享库中找到的所有函数。如向导无法导入某个函数，列表中该函数的名称旁将显示一个黑色的符号。选择该函数可显示可能的错误原因。

注：如果选择共享库文件不在本地机器内选项，则该页仅列出头文件中声明的函数。如未选择共享库文件不在本地机器上选项，该页也将列出头文件中未声明，但在共享库中引用的函数。

1. （可选）如向导不能导入一个或多个函数，单击上一步按钮，添加、移除或更新现有的包括路径或预定义符号。如出现较多错误警告，考虑退出向导，并编辑头文件。使用导入共享库向导生成包装VI之前，应确保文件的良构性。
2. 在选择待转换函数页上，勾选要转换的函数旁的复选框。如要为列表中的所有函数创建VI，单击全部勾选按钮。
3. 单击下一步按钮，显示配置项目库设置页。
4. 在项目库名称(.lvlib)文本框中输入要创建的项目库文件。LabVIEW将所有生成的VI都自动包括在项目库文件中，并使用.lvlib作为文件的扩展名。
5. 在项目库路径文本框中输入保存向导产生的文件的路径。单击浏览按钮，找到并选择一个目录。
6. （可选）如需在目标路径下保存原共享库的文件，可勾选复制共享库文件至目标目录复选框。

注：向导只复制您指定的共享库文件。不复制与该共享库文件存在依赖关系的任何其他共享库文件。为了保证生成的VI没有断线，可手动将共享库依赖的所有文件复制到目标文件夹下，或将这些文件存放在系统搜索路径下。

1. 单击下一步按钮，显示选择错误处理模式页。
2. 从错误处理模式下拉菜单中选择用于大多数包装VI的错误处理模式。程序框图范例中显示向导为包装VI生成的基本程序框图。如要选择多个错误处理模式，可再次运行向导，选择为共享库更新VI选项，仅为使用不同错误处理模式的函数重新生成VI。
3. 单击下一步按钮，显示配置VI及控件页。
4. 检查要创建的VI和控件的配置。使用设置和名称及说明选项卡，为生成的大多数函数编辑具体VI和控件信息。每个控件旁的图标代表该控件的数据类型。LabVIEW不能处理的数据类型旁边将显示感叹号。对于LabVIEW不支持的数据类型，需创建一个自定义控件，完成向导后把控件添加到生成的库中。
5. 单击下一步按钮，显示生成总结页。
6. 检查生成总结。如需进行任何改动，可单击上一步按钮，返回向导。
7. 在生成总结页上，单击下一步按钮，为指定的共享库文件中选中的函数创建包装VI。生成过程页显示向导生成包装VI的进度。生成完毕后，将出现完成页。
8. 如要在共享库关闭后打开生成的库文件，勾选打开生成的库复选框。
9. 如要在共享库关闭后查看生成报告，勾选查看报告复选框。如选择了该选项，报告将在默认Web浏览器中打开。
10. 单击完成按钮，关闭向导。
11. 查看项目库文件和其中生成的包装VI。如选择的错误处理模式是调用一个独立的错误处理VI，则必须打开并修改该错误处理VI。

参考范例：从共享库文件导入函数，基于共享库文件范例ImportSharedLibraryExample.dll中的函数，创建和更新VI库。