Starting Developer Guide for Visual C# 권 문서이해도 장 입문개발자용 스타팅디벨로퍼가이드 마지막수정일 : 2017 년 5 월 11 일 본자료는동영상자료를포함하고있습니다. 문서와함께영상을보시면빠른이해와쉬운개발환경구축에도움이됩니다. 동영상자료 : [ 홈페이지 ] [ 자료실 ] 참고
사용설명서 안내 본자료는 Visual C# 의사전지식이필요합니다. 본사용설명서는 IEC 시리즈와 SmartX Framework 을처음접하시는개발자에게빠른이해와쉬운개발환경구축을 안내합니다 본사용설명서의저작권은 에이치앤에스에있습니다. 본사용설명서의내용중일부또는전부를다른목적으로복제또는복사를할수없습니다. 본자료의내용은해당제품 ( 소프트웨어 ) 의변경또는 에이치앤에스의사정에따라다를수있으며사용자에게통보없이일부변경될수있습니다. 변경된사용설명서는저희회사홈페이지 www.hnsts.co.kr 에서확인하시기바랍니다. 본제품을사용하기이전에반드시본사용설명서를충분히읽어본뒤사용하시기바랍니다. 본사용설명서를충분히읽어보지않은상태에서발생된모든피해는당사에서일체의책임을지지않으므로주의하십시오. 지정된규격품이외의시스템을사용하여발생한손상및본사용설명서의사용방법과주의사항을지키지않아시스템을손상시켰을때는당사에서책임지지않으므로주의하십시오. 진행상문의사항은 HNS 홈페이지의자료실 > 제품관련 > IEC Series 제품매뉴얼이나 SmartX 프로그래밍가이드를 참고바랍니다. 또는커뮤니티 > 질문과답변, 자주하는질문과답변을검색해보시기바랍니다. 문의 : 02-6402-8001( 내선 3), 070-7094-5002( 직통 ) / 홈페이지 : www.hnsts.co.kr, 쇼핑몰 : www.smartx.co.kr
www.hnsts.co.kr 목 차 목차... 3 제 1 장 IEC Series 준비사항... 5 1. 설치전준비사항... 5 2. 연결하기... 5 2-1. IEC Series 전원연결... 5 2-2. PC 와 IEC-Series 연결... 6 3. IEC Series 모드 ( 개발모드와응용프로그램런타임모드 )... 7 3-1. 개발모드 (Development Mode)... 7 3-2. 응용프로그램런타임모드 (Application RunTime Mode)... 8 4. 동작모드설정방법... 10 제 2 장개발환경설정... 11 1. 설치순서... 11 2. Visual Studio 2008 설치... 13 2-1. SDK 설치... 15 2-2. Mobile Device Center(ActiveSync) 설치... 17 2-3. SmartX Framework 설치... 18 목차 3
SmartX Framework Starting Developer Guide 제 3 장프로젝트생성... 19 1. Visual C# Windows CE 장치프로젝트만들기 (Visual Studio 2008 / IEC667)... 19 2. 개발환경세부설정하기... 22 2-1. 디버깅시작과디버깅하지않고시작... 22 2-2. 디버깅 (Debug) 하지않고메뉴활성화하기... 22 2-3. 디버깅 (Debug) 모드 & 릴리즈 (Release) 모드... 23 2-4. 디버깅모드와릴리즈모드의전환... 24 2-5. Debug 폴더와 Release 폴더의위치... 25 3. 빌드배포시간단축... 25 제 4 장 SmartX 예제실행... 26 1. Smart X 예제실행... 26 2. Trouble Shooting... 27 2-1. SmartX Common 참조문제해결방법... 27 4 에이치앤에스
www.hnsts.co.kr 제 1 장 IEC Series 준비사항 IEC Series 를통한제품프로그램개발을위한구성품 1. 설치전준비사항 Visual Studio 설치 CD / IEC Series / USB 케이블 2. 연결하기 2-1. IEC Series 전원연결 IEC Series 전원연결 IEC Lite Series 전원연결 1 장개발환경설정 5
SmartX Framework Starting Developer Guide 2-2. PC 와 IEC-Series 연결 1) IEC266/667/1000-Series 개발시작키트에포함된 USB 케이블로서로연결 제품구매시 USB 케이블이포함되어있지않습니다. USB 케이블을사용하시려면, USB 케이블이포함된개발시작키트를구매하시거나 USB 케이블 을별도구매해주셔야합니다. 2) IEC-Series 사용케이블종류확인 IEC266-Series IEC667/1000-Series 사용케이블 IEC Series 개발 PC 개발PC의 USB포트에삽입개발PC의 USB포트에삽입 IEC-Series 의 USB 케이블을별도로구매원하시는경우에는 HNS 쇼핑몰 (http://www.smartx.co.kr/) 기타옵션제품 USB 케이블 [ 기본 / mini] 중에 IEC266-Series 사용자는기본을선택하고 IEC667/1000-Series 사용자는 mini 를선택하여구매하시면됩니다. 6 에이치앤에스
www.hnsts.co.kr 3) 연결완료시다음과같은화면출력 3. IEC Series 모드 ( 개발모드와응용프로그램런타임모드 ) 3-1. 개발모드 (Development Mode) Windows CE 표준 Shell 이로딩되며개발자가 Visual Studio 2005/2008 를사용하여장치응용프로그램을 개발할수있는모드입니다. 부팅순서 : 부트로고 개발화면 (Windows CE 표준 Shell) 1 장개발환경설정 7
SmartX Framework Starting Developer Guide 3-2. 응용프로그램런타임모드 (Application RunTime Mode) Windows CE 표준 Shell이로딩되지않으며개발자가지정한응용프로그램을먼저실행합니다. Flash Disk, SD Card의순서대로검색하며, 실행될응용프로그램이없는경우 Blanking 화면을표시한후에 Windows CE 표준 Shell을로딩합니다. 부팅순서 : 부트로고 응용프로그램 사용방법 부팅시자동으로실행될응용프로그램을 Flash Disk \ Run 위치에복사 실행파일관련 DLL 파일도함께복사하시기바랍니다. Run 폴더에서실행파일 (*.EXE) 은한개만존재해야하며 Flash Disk 에 Run 폴더가없는 경우폴더를새로생성해야함. 복사가완료되면딥 (DIP) 스위치를개발모드에서응용프로그램런타임모드로변경후장치를 재부팅. 부팅시응용프로그램자동실행 8 에이치앤에스
www.hnsts.co.kr Application Run Time Mode 에시작프로그램이없는경우 Windows CE 표준 Shell 이보이기전에일정시간의 블랙화면이표시되며개발모드보다시간더걸림. Flash Disk\Run 용량이부족한경우 SD 메모리카드를사용가능. 부팅시자동으로실행될응용프로그램을 SD Card \ Run 위치에복사. 만약 Flash Disk\Run 폴더에응용프로그램파일이존재시 Flash Disk 에있는응용프로그램이실행됨. 1 장개발환경설정 9
SmartX Framework Starting Developer Guide 4. 동작모드설정방법 IEC Series 은여러동작모드를지원하고있으며동작환경모드의변경은 DIP 스위치또는점퍼스위치를변경 하여설정 DIP 스위치 ON/OFF 모습 DIP 스위치핀번호 1, 2 를 OFF 로설정한모습 Pin No. 딥 (DIP) 스위치 설명 1 ON OFF Application Run Time Mode Development Mode 2 Color Depth Select (IEC1000 Series Only) 딥스위치설정사진 IEC Series 딥스위치위치 개발모드응용프로그램런타임모드非 Lite Lite 런타임모드 (Application RunTime Mode) 에서 ActiveSync(Mobile Device Center) 연결주의 런타임모드에서개발 PC 와 Active Sync(Mobile Device Center) 를연결하면응용프로그램의성능문제와비정상적인동작으로 Active Sync 연결은반드시 Development Mode 에서만연결하시기바랍니다. 또한 IEC1000-Series(WinCE7.0) 에서는 Active Sync 연결과유선랜통신을동시에사용시문제가될수있으므로연결사용시에는 Active Sync 연결을해제해주시거나 WinCE6.0 OS 가탑재된제품을사용바랍니다. 참고 IEC-Series.pdf 의 6-4. Windows Embedded Compact 7 에서네트워크관련기능디버깅주의점 런타임모드에서원격이미지캡쳐프로그램실행을지원하지않습니다. 반드시 Development Mode 에서만실행하시기바랍니다. 10 에이치앤에스
www.hnsts.co.kr 제 2 장개발환경설정 1. 설치순서 위표의순서처럼 Visual Studio 2008 Tool 을설치할것을권장합니다. 2 장개발환경설정 11
SmartX Framework Starting Developer Guide [ 중요 ] Windows 10, 8.1, 8 개발환경지원안내 -1 Windows 10, 8.1, 8에서 IEC-Series(266/667/1000) 로장치응용프로그램 (C#, VB, C++) 개발을지원하고있습니다. 다만 IEC266-Series의 C++(MFC or API) 개발은지원하지않습니다. Windows 10, 8.1, 8 환경에서 Visual Studio 2008로스마트장치응용프로젝트를생성하거나빌드시에러가발생할수있습니다. 이경우.NET Compact Framework 관련파일을설치하면문제가해결됩니다. ( 관련자료를차례대로전부설치하여주시기바랍니다.) 자료위치 : 자료실 제품관련 3.NET Compact Framework (2.0, 3.5버전 ) 자료실바로가기 [ 주의 ] Windows 10, 8.1, 8 개발환경지원안내 (SmartX Framework 관련참조오류가발생하는경우 ) -2 SmartX 를다음의순서로재설치해야합니다. [STEP-1] [SETP-2] [SETP-3] [STEP-4] [STEP-5] SmartX 설치파일에서마우스우측클릭후 " 속성 " 탭을클릭 상단의호환성탭을클릭 호환모드상자에서 " 이프로그램을 " 실행할호환모드의박스를체크하고리스트박스에서 Windows 7 선택 설정상자에서 " 관리자권한으로이프로그램실행 " 의박스를체크 " 적용 " 버튼을눌러서저장후 SmartX Framework 재설치진행 12 에이치앤에스
www.hnsts.co.kr 2. Visual Studio 2008 설치 1) 설치시작화면. Visual Studio 2008 설치 를선택 2) 설치마법사. 다음 클릭 3) 제품키및설치정보입력. 다음 클릭 4). 설치기능및설치경로설정 ( 기능은기본값선택 ) 설치 클릭 5) 설치 진행중 2 장개발환경설정 13
SmartX Framework Starting Developer Guide 6) 정상설치완료시시스템재시작 7) MSDN 설치는필수사항아님웹사이트를통해접근가능 8) MSDN 설치마법사화면동의함선택 다음 클릭 9) 사용약관동의함체크 다음 클릭 10) 설치기능및설치경로설정 ( 기능은 전체설치 선택 ) 설치 클릭 11) 설치진행중 ( 시간이많이걸릴수있음 ) 12) 설치완료 14 에이치앤에스
www.hnsts.co.kr 2-1. SDK 설치 Visual Studio2005/ 2008 에서 C++ 즉 EVC++(Embedded Visual C++) 로프로그램을개발할경우반드시 설치해야합니다. IEC1000 Series 에서는 SDK 는개발언어 C++, C#, VB.NET 에경우에도반드시설치하시기바랍니다. 1) IEC1000 SDK 설치파일을실행 2) IEC1000 SDK 설치시작화면. NEXT 클릭 3) Accept 선택 NEXT 클릭 4) 설치정보를입력 NEXT 클릭 5) 설치유형은꼭 Custom 선택 NEXT 클릭 2 장개발환경설정 15
SmartX Framework Starting Developer Guide 6) Documentation 에서 Entire feature will beunavaila ble 를선택하여항목을제거 ( 중요 ) 7) SDK 설치시작 Install 클릭 6) 부분은 IEC667 Series 인경우에만해당되는내용입니다. 이점참고하여주시기바랍니다. 8) 설치중 9) SDK 설치완료 16 에이치앤에스
www.hnsts.co.kr 2-2. Mobile Device Center(ActiveSync) 설치 본내용은개발자 PC 의운영체재가 Windows XP 일경우에해당됩니다. Windows XP 버전 Mobile Device Center(ActiveSync) 를한동기화. HNS 홈페이지에서다운로드가능 Windows Vista, Windows 7 버전 Mobile Device Center를통한동기화. OS에탑재되어있음. 없는경우마이크로소프트에서다운로드가능 Mobile Device Center(ActiveSync) 설치완료후 IEC Series 과 PC 를 USB 케이블로연결바랍니다. 1) 다운로드받은 Mobile Device Center(ActiveSync) 설치파일을실행 (Windows XP 인경우 ) 2) ActiveSync 설치를시작 다음 클릭 3) 사용권에동의함선택 다음 클릭 4) 사용자정보입력 다음 클릭 5) 설치경로지정 ( 여기서는기본위치 ) 6) 파일설치중 7) 설치완료 마침 클릭 2 장개발환경설정 17
SmartX Framework Starting Developer Guide 2-3. SmartX Framework 설치 1) 다운로드받은 Smart X 설치파일을실행 2) 개발환경에맞게선택 다음 클릭 3) INSTALL 클릭 4) 설치진행중 5) 설치완료 FINISH 클릭 위의 2. 개발환경에맞게선택 시자신의환경에맞는설치가필요합니다..NET 컴팩프레임워크 2.0 경우.NET 컴팩프레임워크 3.5 경우 지원장치 : IEC266 Series / IEC667 Series 지원툴 : Visual Studio 2005 / 2008 지원장치 : IEC667 Series / IEC1000 Series 지원툴 : Visual Studio 2008 18 에이치앤에스
www.hnsts.co.kr 제 3 장프로젝트생성 1. Visual C# Windows CE 장치프로젝트만들기 (Visual Studio 2008 / IEC667) Visual Studio 2008 이용하여 Windows CE 장치응용프로그램을개발시반드시 PC 와 IEC Series 에서 Mobile Device Center(ActiveSync) 로연결된상태에서만개발할수있습니다. 1) Microsoft Visual Studio 2008 을실행 2) 파일메뉴 프로젝트 선택 3) 프로젝트형식은 Visual C# 스마트장치 템플릿은 스마트장치프로젝트 선택하며프로젝트명 ( 이름 ) 을임의로입력 ( 여기서는 SmartWorld) 확인 클릭 4) 플랫폼과.NET Compact Framework 선택 지원장치 : IEC266 Series / IEC667 Series 지원툴 : Visual Studio 2005 / 2008 지원장치 : IEC667 Series / IEC1000 Series 지원툴 : Visual Studio 2008 Windows CE [ 선택 ].NET Compact Framework Version 2.0 [ 선택 ] 장치응용프로그램 [ 선택 ] Windows CE [ 선택 ].NET Compact Framework Version 3.5 [ 선택 ] 장치응용프로그램 [ 선택 ] 3 장프로젝트생성 19
SmartX Framework Starting Developer Guide 5) 새프로젝트생성 6) 도구상자의 SmartButton 컨트롤을 Form1 에드래그앤드롭 7) 버튼에서속성창 Text항목의값을 Button1 안녕하세요 로변경. 도구상자의 SmartLabel 컨트롤을 Form1에드래그앤드롭. 8) 안녕하세요 버튼더블클릭 버튼클릭이벤트에 smartlabel1.text = 감사합니다. ; 입력 20 에이치앤에스
www.hnsts.co.kr 9) 빌드 ( 컴파일 ) 및배포하기전에대상장치 (Windows CE 장치 ) 를설정 10) 디버깅을하지않고시작을클릭합니다. 대상장치와개발 PC 가정상적으로연결되어있다면아래와같이프 로그램이실행됩니다. 11) IEC667 장치에서응용프로그램이바로실행된모습 빌드및배포관련한사항은다음장의개발환경세부설정하기를반드시참고하시기바랍니다. 3 장프로젝트생성 21
SmartX Framework Starting Developer Guide 2. 개발환경세부설정하기 2-1. 디버깅시작과디버깅하지않고시작 디버깅시작 디버깅하지않고시작 TRACE 를위한디버깅작업시사용 실행속도가디버깅하지않고시작보다 느리다 디버깅작업이필요없는경우 실행속도가보다빠르다 2-2. 디버깅 (Debug) 하지않고메뉴활성화하기 1. 디버깅하지않고시작메뉴 ( 아이콘 ) 이없는경우풀다운메뉴의 도구 사용자지정 을선택 2. 사용자지정에서명령탭선택. 범주 (G) : 디버그선택 / 명령 (D) : 디버깅하지않고시작선택. 마우스로드래그하여그림과같이메뉴를끌어올려놓습니다. 22 에이치앤에스
www.hnsts.co.kr 2-3. 디버깅 (Debug) 모드 & 릴리즈 (Release) 모드 디버깅모드 릴리즈모드 디버깅정보포함 개발중사용하는모드 파일크기가릴리즈모드보다크다 디버깅정보미포함 개발완료후양산시사용하는모드 파일크기가디버그모드보다작다 3 장프로젝트생성 23
SmartX Framework Starting Developer Guide 2-4. 디버깅모드와릴리즈모드의전환 CASE-1. 솔루션구성메뉴가이미추가된경우는별도의작업없이사용이가능합니다. 1) 릴리즈모드와디버깅모드의전환은 솔루션구성 메뉴에서변경합니다. 만약솔루션구성메뉴가없으면사용자가추가해주셔야합니다. CASE-2. 솔루션구성메뉴가없는경우 2) 추가방법은디버깅하지않고시작에서와같습니다. 우선 도구 메뉴 사용자지정 을선택합니다. 3) 명령 탭 빌드 를선택 솔루션구성 을선택한후원하는위치에드래그앤드드롭하여메뉴를추가합니다. 솔루션구성메뉴를드래그앤드롭하기전메뉴가 비활성화된모습 CASE-3. CASE-2 에서솔루션구성메뉴가추가안되는경우 4) 솔루션구성선택해도비활성화되는경우! 도구 옵션 선택 5) 옵션설정 일반 고급빌드구성표시 체크 6) 설정완료 릴리즈모드로선택하고빌드를하면 Release 폴더에실행파일이생성되고디 버그모드로선택하고빌드를하시면 Debug 폴더에실행파일이생성됩니다. 24 에이치앤에스
www.hnsts.co.kr 2-5. Debug 폴더와 Release 폴더의위치 일반적으로생성한프로젝트의 bin 폴더아래에위치. Ex Path : \Project 이름 \ Project 이름 \bin 에 Debug 와 Release 폴더가생성됩니다. 3. 빌드배포시간단축 일반적으로배포옵션에서 최신버전의.NET Compact Framework 배포 ( 서비스팩포함 ) 가설정되어있습니다. 재배포시.NET Compact FrameWork 가포함되어빌드및배포시간이증가되므로설정을체크해지합니다. 1. 프로젝트 메뉴 프로젝트명 속성을선택 2. 장치 탭을선택 최신버전의.NET Compact Framework 배포를 ( 서비스팩포함 ) 선택해지 3 장프로젝트생성 25
SmartX Framework Starting Developer Guide 제 4 장 SmartX 예제실행 1. Smart X 예제실행 HNS 홈페이지에서 SmartX 예제프로그램다운. 여기서는 IEC1000 C# 버전으로하겠습니다. 1. HNS 홈페이지접속 자료실 제품관련 4. SmartX 예제파일 C# IEC1000 Series 에서 Download 클릭 2. 다운완료 3. 다운받은파일의압축해제후 SmartPlayer.sln 을더블클릭 4. Form1.cs 를더블클릭하여 Form1 디자인창을오픈 5. 빌드 솔루션빌드 6. 디버그 디버깅하지않고시작. 실행된화면좌측화면 26 에이치앤에스
www.hnsts.co.kr 2. Trouble Shooting 2-1. SmartX Common 참조문제해결방법 1. 참조 노란색삼각형느낌표아이콘마우스우측클릭 제거 클릭 2. 참조 마우스우측클릭 참조추가 클릭 3. -32 비트 OS 의경우파일위치 C:\Program Files\HNS\Embedded SmartX Component -64 비트 OS 의경우파일위치 C:\Program Files (x86)\hns\embedded SmartX Component 4. 파일 메뉴 모두저장 하기 꼭참조제거 / 추가하신후파일저장하신다음에실행된프로젝트파일은닫고재실행하여사용해주시기바랍니다. SmartX 의설치경로는 Smart Framework 을설치후 [ 설치정보 ] 화면에서확인가능 4 장 SmartX 예제실행 27