--- title: "ZPL 뷰어 단위 테스트 " slug: "zpl-viewer-unit-test" tags: ["ZPL Viewer", "Unit Test", "Library", "Plugin", "Custom Widget"] updated: 2025-05-27T15:36:47Z published: 2025-05-27T15:36:47Z canonical: "support.tulip.co/zpl-viewer-unit-test" --- > ## Documentation Index > Fetch the complete documentation index at: https://support.tulip.co/llms.txt > Use this file to discover all available pages before exploring further. # ZPL 뷰어 단위 테스트 ## ZPL 뷰어 단위 테스트 *이 애플리케이션은 ZPL 뷰어 커스텀 위젯 플러그인을 설정하고 사용하는 방법을 설명합니다.* ### 목적 ZPL 뷰어 유닛 테스트의 목적은 사용자가 자신의 Tulip 애플리케이션에서 ZPL 뷰어 사용자 지정 위젯 플러그인을 설정하고 사용하는 방법을 배우고 이해할 수 있도록 하는 것입니다. 사용자 지정 위젯 플러그인은 현재 기본 플랫폼에 포함되지 않은 추가 기능을 제공하기 위해 Tulip 플랫폼 위에 위치하는 코딩된 위젯입니다. ZPL 코드 렌더 위젯은 Tulip 애플리케이션에서 사용할 수 있도록 ZPL 코드를 이미지로 렌더링합니다. 이 위젯은 인쇄하기 전에 ZPL 라벨을 미리 보거나 ZPL이 아닌 프린터에서 ZPL 라벨을 인쇄하는 데 사용할 수 있습니다. #### 설정 사용자 지정 위젯 플러그인은 속성 및 이벤트를 사용하여 애플리케이션과 상호 작용합니다. 속성은 애플리케이션과 위젯 사이에 존재하는 공유 데이터이며, 이벤트는 위젯이 애플리케이션에 보낼 수 있는 신호입니다. 앱 에디터에서 이러한 이벤트를 기반으로 트리거를 만들 수 있습니다. 이벤트도 애플리케이션에 데이터를 전송하도록 만들 수 있습니다. ZPL 뷰어 사용자 지정 위젯 플러그인은 하나의 프로퍼티와 0개의 이벤트를 사용합니다. 이 위젯에서 사용되는 프로퍼티의 이름은 'ZPL 코드'이며 텍스트 유형이고 읽기 전용입니다. 이 속성을 사용하면 텍스트 형식의 ZPL 코드를 입력할 수 있습니다. #### 추가 매개 변수 **Width너비**입력 필드(이중 유형)가 표시되고 레이블이 있습니다.*기본값: 5.2사용자가*레이블 너비를*설정하면*미리 보기 창에 입력한 값에 따라 적절한 인쇄 레이블 너비가 표시됩니다. **높이높이**입력 필드(이중 유형)가 표시되고 라벨이 있습니다."라벨 높이"*기본값: 8사용자가*라벨의 높이를 설정하면 미리보기 창에 입력한 값에 따라 적절한 인쇄 라벨 높이가 표시됩니다. **측정 단위측정**드롭다운 필드에는 제목 레이블이 "측정 단위"로 표시됩니다. 선택 가능한 값: in, cm, mm*.기본값: in사용자가*측정 단위를*설정하면*원하는 측정 단위로 입력한 너비, 높이 값에 따라 적절한 인쇄 라벨 너비와 높이가 미리 보기 창에 표시됩니다. **해상도해상도**드롭다운은 "해상도(mm당 도트 수)"라는 제목 레이블과 함께 표시됩니다. 값: 6, 8, 12, 24. *기본값: 6사용자가*드롭다운에서 해상도를 설정하면 미리보기 창에 적절한 해상도의 인쇄 라벨이 표시됩니다. **레이블**맞춤레이블 맞춤이라는 레이블이 있는 확인란이 표시됩니다*.기본값: 체크이 확인란을 선택하면*미리보기 창에 경계 상자에 맞는 레이블이 표시되고, 확인란을 선택 취소하면 미리보기 창에 레이블의 왼쪽 상단 부분만 표시됩니다. **중앙**레이블"중앙 레이블"레이블이 있는 확인란이 표시됩니다*.기본값:*선택됨확인란을*선택하면*미리보기 창에 레이블이 바운딩 상자의 가로 및 세로 중앙에 표시되고 확인란을 선택 취소하면 미리보기 창에 레이블이 왼쪽 상단 모서리에 정렬된 상태로 표시됩니다. ### 작동 방식 ZPL 뷰어 단위 테스트는 변수 데이터 소스와 테이블 데이터 소스를 사용하여 ZPL 코드를 전달하는 방법에 대한 예제를 제공하며, 텍스트 입력에서 ZPL 코드를 작성하는 방법에 대한 예제도 제공합니다. 처음 두 예제에서는 사용자 정의 위젯 플러그인의 'ZPL 코드' 속성에 ZPL 코드를 전달하면 위젯이 이 ZPL 코드를 렌더링하고 이미지로 렌더링된 ZPL 레이블을 표시합니다. 세 번째 예에서는 위젯에 텍스트가 전달되고 'ZPL 생성' 버튼을 누르면 이 텍스트에 대한 ZPL 코드가 생성되고 사용자 정의 위젯 플러그인이 이 ZPL 코드를 사용하여 ZPL 라벨을 작성합니다.