Add-in

애드인크리에이터를사용하면 RoboDK 애드인 패키지를 쉽게만들고수정할수있습니다. Add-in Creator 도구는 Add-in Manager의일부입니다.

도구-애드인관리자를선택한다음애드인관리자하단의애드인 만들기 버튼을클릭하면애드인크리에이터가열립니다.

Add-in Creator 마법사를열면다음옵션중에서선택할수있습니다:

●새 Add-in을 처음부터 새로 만들기: 이렇게하면새 RoboDK 패키지(RDKP 파일)가생성됩니다.

●폴더 또는 레거시 애플리케이션에서 새 추가 기능 만들기: 이경우추가기능의파일이있는폴더경로를지정할수있습니다. 패키지 생성 안 함 옵션을사용하면 RoboDK 패키지(RDKP 파일)를만들지않고도추가기능이있는폴더에서직접추가기능을편집할수있습니다.

●기존 Add-in 수정: 기존 RoboDK 패키지를열어새버전을수정및생성합니다.

Add-in 생성 또는 편집하기

유형, 이름, 작성자정보등의기본정보를입력하여새 Add-in을쉽게만들수있습니다.

Add-on Creator 창에서필수필드는굵은글씨로표시되어있습니다. 총 5개가있습니다:

1.유형: 유형: 앱, 로봇드라이버, 언어등과같은 Add-in의유형입니다.

2.이름: Add-in의 이름입니다.

3.고유 식별자: 이특정 Add-on에속하는고유식별자입니다. 이필드옆의확인란을선택하면편집모드를활성화하고라틴문자, 숫자및빼기기호, 점, 밑줄과같은추가문자를포함할수있는임의의식별자를설정할수있습니다.

4.버전: 버전: 버전은시맨틱버전관리형식(major.minor.patch)으로작성해야합니다.

5.개정: Add-in의변경횟수이며, 1 이상의숫자값을사용합니다.

나머지필드는선택사항이지만 Add-in에대한보다정확한설명을입력할수있습니다:

6.작성자: 작성자: 작성자의이름과성또는회사또는팀이름(작성자가여러명인경우)을입력합니다.

7.회사: 회사: 회사이름입니다.

8.언어: Add-in에서사용되는언어입니다. IETF BCP 47 표준의모든언어가나열됩니다.

9.콘텐츠 상태: Add-in의상태(예: 최종, 내부 테스트, 베타 등)를표시합니다.

10.설명: Add-in에대한간략한설명입니다.

11.수정한 사람: 이필드는다른작성자의 Add-in을수정한사람이수정한작성자로언급되기를원할때사용할수있습니다.

12.생성됨: 생성됨: Add-in의첫번째버전이생성된날짜(자동으로입력됨).

13.수정됨: 수정된날짜: Add-in의수정날짜(자동으로입력됨).

14.이메일: 영업, 지원또는피드백을위한이메일주소입니다.

15.웹사이트: 회사 웹사이트(Add-in 개발자).

16.문서 링크: Add-in의 문서 링크입니다.

17.리포지토리 링크: 오픈소스 Add-in의경우해당 Add-in이있는 GitHub 리포지토리또는기타공개리포지토리로연결되는링크입니다.

18.키워드: 키워드: Add-in 마켓플레이스에서 Add-in을쉽게검색할수있는키워드(태그) 목록입니다.

Add-in에 에셋 추가하기

Add-in에는하나이상의자산이포함되어야합니다. 에셋은 Add-in의동작을정의하는스크립트및아이콘일수있습니다.

Add-in 자산페이지는세가지기능영역으로나뉩니다:

1.패키지아이콘선택영역.

2.파일트리영역.

3.파일콘텐츠의미리보기영역입니다.

이페이지의버튼과확인란의용도에대해설명합니다:

●TargetPath: 대상 경로 버튼은현재아이콘파일의속성창을열고대상 속성을설정할수있습니다(패키지내부의해당 섹션 참조).

●아이콘 변경... 버튼을사용하면현재패키지아이콘을새아이콘으로바꿀수있습니다.

●아이콘 제거 버튼은패키지의현재아이콘을삭제하고생성중인패키지유형에해당하는기본아이콘을설정합니다.

●새 폴더 버튼은파일트리의선택한브랜치에새하위폴더를만듭니다.

●자산 추가... 버튼은파일트리의선택한분기에새파일을추가합니다.

●제거 버튼은잠긴항목을제외하고선택한항목을파일트리에서제거합니다.

●Python 패키지 만들기 확인란은프로젝트에 __init__.py 파일을추가하여 Python 인터프리터가프로젝트파일을외부에서로드가능한모듈로사용할수있도록합니다.

Python 스크립트는나중에확장자가 .pyc인파일로컴파일하기위해마크업할수있습니다. 컴파일프로세스는마법사의다음페이지에표시됩니다.

대상 경로 필드에서는각파일에대한대상 속성을설정할수있습니다. 원하는경로와변수이름을수동으로입력하거나대상경로에서기어버튼을클릭하면속성창을호출하여이작업을수행할수있습니다:

파일속성대화상자에서는대상 속성의값을설정할수있으며사용가능한변수의편리한목록을제공합니다. 또한파일을배포할대상플랫폼의매개변수(OS 유형및버전, CPU 모델)를정의할수있습니다.

Python 스크립트 컴파일하기

Add-in 에셋을추가할때하나이상의 Python 스크립트를선택했다면 Python 컴파일 페이지가열립니다.

컴파일은사용가능한모든 Python 인터프리터가수행합니다. 사용가능한인터프리터및사용중인인터프리터목록은 Add-in 관리자설정창에서편집할수있습니다. 컴파일프로세스자체에는사용자개입이필요하지않으며, 페이지에자세한컴파일로그가표시되어잠재적인문제를파악할수있습니다.

앱 구성

앱구성페이지에서는 RoboDK 사용자인터페이스(메뉴및도구모음)에서동작또는스크립트가연결되는방식을사용자지정할수있습니다. 앱유형의 Add-in을만드는경우앱 구성 창이표시됩니다.

이페이지의매개변수는 AppConfig.ini 파일의내용을정의합니다. 사용가능한키와값이 이 페이지에 나열되어있습니다. RoboDK에는각앱마다고유한메뉴와툴바가있습니다. 툴바의메뉴항목과버튼을앱용어로는액션이라고 합니다. 메뉴에서액션을표시하는조건과순서를정의하고핫키를할당할수있습니다.

기본매개변수세트에는다음이포함됩니다:

●메뉴 이름: RoboDK의 메인 메뉴에 있는 항목의 이름입니다.

●표시: 이확인란을선택취소하면RoboDK의기본메뉴에메뉴가표시되지않습니다.

●상위 메뉴: 앱하위메뉴가생성될주메뉴항목을선택하거나주를 선택하여새주메뉴항목을만듭니다.

●우선순위: 이앱의메뉴가다른앱의메뉴와관련하여표시되는순서를결정하는우선순위를설정합니다(아래쪽이먼저표시됨).

●도구 모음 영역: 앱툴바가위치할 RoboDK 메인창의위치(측면)를지정합니다.

●도구 모음 배율: RoboDK 툴바아이콘의현재크기대비툴바아이콘의비율입니다.

●명령: Add-in이활성화될때실행되는 RoboDK API 명령입니다.

AppConfig.ini 파일과같은폴더에있는각 Python 스크립트에대해액션이생성됩니다. 스크립트가보조적인성격의스크립트인경우 Visible 속성을사용하여이러한동작을억제할수있습니다.

작업속성은다음목록으로표시됩니다:

●이름: 메뉴와도구모음에표시되는작업의이름입니다.

●설명: 메뉴항목이나툴바버튼위에마우스포인터를가져갔을때표시되는툴팁텍스트입니다.

●우선순위: 이앱의다른동작과관련하여동작이표시되는순서(아래쪽이먼저표시됨)입니다.

●바로 가기

●가시성

●개발자 전용: 이작업은 RoboDK가개발자모드로전환된경우에만표시됩니다(Ctrl+Alt+Shift+G).

●메뉴에 표시

●도구 모음에 표시

●확인 가능: 확인가능한작업을만들고, 확인가능한작업은숫자로그룹화할수도있습니다.

●컨텍스트 메뉴 필터: 이작업이컨텍스트메뉴에추가될 RoboDK 트리의요소유형을정의합니다.

●더블 클릭 필터: 더블클릭시이동작이호출될 RoboDK 트리의요소유형을정의합니다.

Add-in 패키지 만들기

RoboDK 패키지를 RDKP 파일로빌드하면 Add-in 생성이완료됩니다. 이것이 Add-in 생성의마지막단계입니다.

패키지를만들기직전의마지막단계에서다음옵션을사용할수있습니다:

●패키지 암호화: 위협탐지시스템을우회하여이메일로쉽게보낼수있도록파일을암호화합니다(Google 메일서비스는첨부파일에실행파일및 Python 스크립트의전송을직접금지합니다).

●빌드 후 설치: Add-in 관리자가새로만든패키지를설치하도록합니다.

●포함 폴더 열기: 패키지가생성된폴더를엽니다.