공유 라이브러리 파일에서 함수 반입하기

공유 라이브러리 반입 마법사를 사용하여, 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를 편집하고 생성하려는 대부분의 VI 정보를 컨트롤할 수 있습니다. 아이콘은 각 컨트롤의 데이터 타입을 나타냅니다. 느낌표 문양이 LabVIEW가 처리할 수 없는 데이터 타입 옆에 나타납니다. LabVIEW가 지원하지 않는 데이터 타입의 경우, 마법사를 완료한 후 사용자 컨트롤을 생성하고 컨트롤을 생성된 라이브러리에 추가합니다.
5. 다음 버튼을 클릭하여 생성 요약 페이지를 디스플레이합니다.
6. 요약 생성을 검토합니다. 변경을 하려면 뒤로 버튼을 클릭하여 마법사에서 탐색합니다.
7. 생성 요약 페이지에서, 다음 버튼을 클릭하여 특정 공유 라이브러리에서 선택한 함수의 래퍼 VI를 생성합니다. 생성 진행 페이지는 래퍼 VI를 생성할 때 마법사의 진행 정도를 보여줍니다. 생성이 완료되면, 종료 페이지가 나타납니다.
8. 마법사가 닫힐 때 생성된 라이브러리 파일을 열려면, 생성된 라이브러리 열기 확인란에 확인 표시를 합니다.
9. 마법사가 닫힐 때 리포트 생성을 보려면, 리포트 보기 확인란에 확인 표시를 합니다. 이 옵션을 선택하면 리포트가 기본 웹 브라우저에서 열립니다.
10. 마침 버튼을 클릭하여 어플리케이션을 닫습니다.
11. 프로젝트 라이브러리 파일과 생성된 래퍼 VI를 검토합니다. 개별 에러 핸들링 VI를 호출하는 에러 핸들링 모드 VI를 선택하였을 경우 반드시 에러 VI를 열어서 수정해야 합니다.

예제: 공유 라이브러리 파일에서 함수 반입하기를 참고하여 예제 공유 라이브러리 파일 ImportSharedLibraryExample.dll에 포함된 함수에 기반한 VI의 라이브러리를 생성하거나 업데이트할 수 있습니다.