1/28/2018

Eclipse Oxygen 설치 및 설정 및 소스분석

1. 기본개발환경 구축 

이전 Version Eclipse CDT에서의 개발환경구축 
만약 Linux Server를 별도로 두고 Window에서 Samba로 볼경우 

  • Eclipse CDT의 사용방법 - 1. Project 생성전 확인사항
  1. Virtual Box : Linux Server 설치 및 SSH Server 및 Samba 설정 
  2. Window    :  Eclipse CDT 설치 및 관련설정 
  https://ahyuo.blogspot.kr/2016/04/eclipse-neon-cc.html


1.1 Eclipse Oxygen for Window 설치 

Eclipse 새 버전 Oxygen을 아래의 사이트에서 Download하여 Window에 설치를 진행하자
그리고, 요즘 Chip Vendor에서 나오는 개발툴을 대체적으로 보면 대부분 Eclipse 기반으로 구성이 되어있다 (TI의 CCS)


  • Eclipse Oxygen Download 

  https://www.eclipse.org/downloads/

이미 Eclipse Neon을 설치한 상태에서 진행을 했으며,eclipse-inst-win64.exe 실행을 하면 아래와 같이 나오면 당연히 Eclipse IDE for C/C++ 선택

아래의 PATH로 가면 기존의 cpp-neon도 확인 가능하며 지울때 이곳과 본인의 workspace를 지우자




설치후 첫화면 동일 Neon 과 동일


Help->about Eclipse 에서 각 아이콘을 확인하자 (CDT 부분 확인)




1.2 Eclipse 추가 설정 및 기능확장 

Help->Eclipse Marketplace 가보면 추가로 설치가능
기본전체구성을 보면 아래의 Marketplaces를 3군데를 선택가능
  1. Search : 검색 
  2. Recent : 최근 나온것들 
  3. Favorites:  선호하는 것들 
  4. installed : 현재 설치된 플러그인 확인 

아래와 같이 유명한 프로그램들을 설치해보자. (개발관리툴 및 SVN 기타 등등)





2.  Project 생성 및 제거 

크게 변경된 것이 없으므로 아래와 동일하게 구축을 하자
  • Eclipse CDT의 사용방법 - 1.1 Project 생성 및 제거 참고 
  https://ahyuo.blogspot.kr/2016/04/eclipse-neon-cc.html



3. Project의 생성후 및 Eclipse 설정 

Eclipse의 설정은 전에도 설명했듯이 아래의 두군데에서 설정이 보통하는데  두 설정이 공통되는 부분이 많기 때문에 다 봐야 한다.

KERNEL or UBOOT 분석을 한다고 하면 대부분 Index가 완벽하게 동작하기를 바라지만 완벽히 동작하지 않기에
아래와 같이 세부설정을 아래와 같이 해야한다

Index 관련부분은 본인의 workspace의 아래 부분에 저장되며, Project delete를 하면 다 지워진다.
만약 문제가 발생한다면 제대로 지워 졌는지 확인하자

.metadata\.plugins\org.eclipse.cdt.core

  1. Window->Preferences :  전체 설정 
  2. Project->Properties : Project 만 관련 설정 
이 곳에서는 Project의 Properties 설정만 보기로 하겠다 아래의 참고를 참고 

  • Eclipse CDT의 사용방법 - 2. Eclipse 설정 참고 
  https://ahyuo.blogspot.kr/2016/04/eclipse-neon-cc.html


3.1. Project->Properties 설정

기존에는 아래와 같이 생성된 Project의 세부설정을 모르고 살았지만, 최근에 세부설정을 하는 법을 알아서 아래와 같이 설정을 해본다.

거의 모든 Index는 대부분 거의 알아서 찾지만 못찾거나 특수한 경우 아래와 같이 설정하여 보자

  • Resource
UTF8/MS949 로 설정을 하여, 본인 소스 수정시 파일이 깨지는 일이 주의하도록 하자
이부분은 특히 한글로 주석을 할 경우 조심해야한다.



  • Resource->Linked Resources
아래와 같이 Project 의 설정된 PATH를 확인 (Window의 네트워크 드라이브 연결됨 확인)
PROJECT_LOC 확인



  • C/C++ General->Code Analysis 
Editor View 를 보면 아래와 같이 Code를 분석을 해주어서 에러인지 파악을 쉽게 해준다. 
본인이 원하는 기능만 선택하여 사용 가능하다.

Code Analysis 생성하여 코드의 오류를 감지하는 기능이다.
이부분은 Indexer 처럼 처음에 만들어주어야 한다. (시간이 많이 걸림) 



  • C/C++ General->Indexer 
Enable project specific settings 설정이 기본으로 안되어있지만, 이를 설정하고 아래와 같이 설정을 해준다.
원래대로 하고싶다면, Enable project specific settings 제거

아래와 같이 사용되지 않은 header들의 index하지 않는으며, 실제 위치를 찾아준다





C/C++ Indexer로 진행이 되며,  시간이 많이 걸림

  • 에러가 발생할 경우 에러원인을 제거
/TEST_LINUX_AM/ 의 PATH 아래와 동일하며, .setting 부분을 제거 해주자.

$ cd ~/am335x/ti-processor-sdk-linux-am335x-evm-03.00.00.04/board-support/linux-4.4.12+gitAUTOINC+3639bea54a-g3639bea54a
$ rm -rf .setting 

Error: Exception occurred while saving project preferences: /TEST_LINUX_AM/.settings/org.eclipse.cdt.core.prefs.
Exception occurred while saving project preferences: /TEST_LINUX_AM/.settings/org.eclipse.cdt.core.prefs.




  Project->Properties
  https://help.eclipse.org/luna/index.jsp?topic=%2Forg.eclipse.cdt.doc.user%2Freference%2Fcdt_u_prop_general_idx.htm

  Window->Preference
  https://help.eclipse.org/mars/index.jsp?topic=%2Forg.eclipse.cdt.doc.user%2Freference%2Fcdt_u_indexer_preference.html


  • C/C++ General->Paths and Symbols  (중요)
Index는 생성 되었지만, 정확한 #define 과 include 파일들을 인식을 못하는 경우가 발생한다.
이를 인식하기 위해서 아래에 강제로 include directory를 추가하자

  1. Includes 파트 선택 
  2. GNU C 선택 및 ADD 
  3. Workspace 선택 
  4. 해당 소스파일에서 include 파일 선택 

Uboot 분석 할 경우의 예

Source Location 선택후 빌드 PATH 확인 (UBOOT) 후 그 기반으로 추가 


커널 분석 할 경우의 예

Source Location 선택후 빌드 PATH 확인 (TEST_LINUX_AM) 후 그 기반으로 추가


아래와 같이 필요한 include를 상위 Source Location 기반으로 넣지만, 필요 없다면 넣지 말자.(index시간이 너무길다)

include
include/uapi
arch/arm/include
arch/arm/include/uapi


본인이 원할 경우만 사용 (세부설정)

Uboot or Kernel 일 경우 내부 header에 __KERNEL__ 이라고 되어 있는 것들이 있다.
이 것은 대부분 make 할 때 외부옵션으로 -D 로 넣어주는데 이것을 넣어주는 역할이다.
  1. #Symbols 파트 선택 
  2. GNU C 선택 및 ADD 
  3. Name 에 #define 할 이름 과 Value 값 설정 



분명 Eclipse를 사용하다 보면 잘못 인식하는 부분이 발생하는데, 이를 위해 Include or Symbols에 수정해주자.

  • C/C++ General->Preprocessor Include Paths,Maros etc. 
프로젝트에 전체 해당되는 #include 파일 인식안될 경우 아래에서 이를 처리하자
이곳도 상위 부분과 유사한 것 같은데, 좀 더 자세히 설정을 하는 것 같다.

  1. Entries->GNU C 선택 
  2. CDT User Setting Entries 선택 및 ADD 
  3. Add 창에서 Preprocessor Macros File 변경 
  4. include/linux/kconfig.h  추가 
  5. include/generated/autoconf.h 추가 (kconfig.h 에 include 되어있음, 옵션) 

Linux Kernel make menuconfig를 하면  config file은 .config 에 저장하며, 이것을
다시 #define 으로 변경하는 것은 autoconf.h 파일이므로 이부분을 추가하는 것이다.


본인이 설정된 Define만 볼경우

그리고 이 부분을 Kernel source에 적용하여 필요 없는 부분을 안보려는 것이다.
요즘 Uboot , Linux Kernel 설정과 동일하게 변경이 되어 위와 같이 하면 된다.



  • 기타 설정사항 
C/C++ General->File Types :  간혹 확장자가 잘못된것도 넣어야 할 경우 이곳을 보자. 
C/C++ General->Formatter :  본인이 보기 원하는 스타일로 변경  


  • Task 관련 설정 사항 (아래 다시 설명)
Task Repository :Task 확장기능으로 Bugzillar 와 이슈를 연동하여 이를 설정
Task Tags  : 아래세부 설명 


  • Kernel Source 분석
  아래 사이트 에서 감사하게 좋은 정보를 주어서, 저도 이것을 적용해보게 되었다.
  http://nophotoplease.tistory.com/129
  https://wiki.eclipse.org/HowTo_use_the_CDT_to_navigate_Linux_kernel_source


  •   참고자료 
  http://copyx.tistory.com/8
  http://ezkorry.tistory.com/185
  http://rinovation.tistory.com/68


3.2 Project Property의 Index 설정보완

만약 상위 설정에도 Index가 잘 찾지 못한다면 아래의 설정에서 전체 부족하다면 Index를 좀 더 보완 해보자
우선 Index를 다시 만들어 보고, 문제가 있다면 이제 다시 분석해서 보완해보자

  • 전체 Index의 Refresh 및 분석기능 
  1. Project->C/C++ Index 선택 
  2. Rebuild : 다시 Index를 만드는 기능같다. 
  3. Freshen All Files : 새로 생긴 파일들을 추가하는 기능같다 
  4. Update with Modified Files : 변경된 파일만 다시 Index에 추가해보자 
  5. Re-resolve Unresolved Include:  아래 인식 못한 include를 다시 동작되는 확인기능
  6. Search for Unresolved Include :  현재 분석을 못하는 Include파일을 이것을 이용하여 파악 
  7. Create Parser Log File



  • Index 문제 분석 및 보완 (상위 참조 ) 
  1. Project->Search for Unresolved Include   문제 파악 확인 
  2. Project->Properties->C/C++ General->Paths and Symbols 이를 보완 
  3. Project->Re-resolve Unresolved Include:  문제해결 확인 
   아래와 같이 찾지 header 파일을 찾지 못하는 경우 발생



  • Index 부분 설정 이용 
Index 작업은 시간이 많이 걸리므로 부분작업으로 해도 괜찮은 것은 아래와 같이 진행하자
  1. 좌측의 Project 창에서 우측 마우스와 함께 Index 선택 
  2. 상위 메뉴와 동일메뉴 선택가능 
  3. 이 적용부위는 폴더 단위로 설정이 가능


상위 방법으로 해도 안되는 것들이 많이 존재하는데, 이유는 Kernel or Uboot 경우 여러 ARCH를 사용을 하고 여러 Board를 지원을 하다보니 include 파일이 제대로 연결이 안되는 경우는 발생한다.

완벽하게 하고자 한다면, 본인의 ARCH와 Board를 정보를 알고 나머지를 Project에서 제외하는 것이 좋을 것이다.

3.3 Project에서 필요 없는 파일제외

소스가 너무 많아 필요 없는 파일이 많을 경우가 있을 경우 아래와 같이 분석한 다음 이를 제거하여 혼란을 줄이자
여기서 제거하는 것은 실제 소스를 지우는 것이 아니라 Project에서 제외만 하는 것이다.

Linux Kernel의 경우를 보면 Project 위치로 간 후 상위 File을 찾아 보면 AM335x와 상관이 없는 파일이다.
SSH로 로그인하여 아래와 같이 쉽게 빌드된 소스만을 쉽게 파악이 가능하다

$ cd ~/am335x/ti-processor-sdk-linux-am335x-evm-03.00.00.04/board-support/u-boot-2016.05+gitAUTOINC+b4e185a8c3-gb4e185a8c3/arch
$ find . -name *.o
./arm/lib/bootm-fdt.o
./arm/lib/bootm.o
./arm/lib/eabi_compat.o
./arm/lib/interrupts.o
./arm/lib/reset.o
./arm/lib/vectors.o
./arm/lib/sections.o
./arm/lib/crt0.o
./arm/lib/stack.o
./arm/lib/built-in.o
./arm/lib/relocate.o
./arm/lib/cache.o
./arm/lib/cache-cp15.o
./arm/cpu/built-in.o
./arm/cpu/armv7/am33xx/board.o
./arm/cpu/armv7/am33xx/mux.o
./arm/cpu/armv7/am33xx/emif4.o
./arm/cpu/armv7/am33xx/built-in.o
./arm/cpu/armv7/am33xx/clock.o
./arm/cpu/armv7/am33xx/clock_am33xx.o
./arm/cpu/armv7/am33xx/sys_info.o
./arm/cpu/armv7/am33xx/ddr.o
./arm/cpu/armv7/am33xx/clk_synthesizer.o
./arm/cpu/armv7/built-in.o
./arm/cpu/armv7/omap-common/reset.o
./arm/cpu/armv7/omap-common/boot-common.o
./arm/cpu/armv7/omap-common/utils.o
./arm/cpu/armv7/omap-common/mem-common.o
./arm/cpu/armv7/omap-common/built-in.o
./arm/cpu/armv7/omap-common/lowlevel_init.o
./arm/cpu/armv7/omap-common/omap-cache.o
./arm/cpu/armv7/cache_v7_asm.o
./arm/cpu/armv7/syslib.o
./arm/cpu/armv7/start.o
./arm/cpu/armv7/cache_v7.o
./arm/cpu/armv7/cp15.o
./arm/cpu/armv7/cpu.o

상위 파일을 보고 필요 없는 파일들을 나의 Project에서 제외시키자



4.  Eclipse 에서 Index를 이용하여 소스 분석 

상위 문서를 참조해서 Project를 생성후 Index를 만들어 졌다면 아래와 같이 Call Hierarchy 기능 및 Outline 기능을 이용하여 쉽게 분석하자.


4.1 Index기반으로 소스분석방법

소스분석을 위해서 기본으로 사용되어지는 View이며, 볼수 없다면  Window->Show View->Other 이용

  1. Project View
  2. Outline View
  3. Editor View  
  4. Outline View

  • Main Menu->Navigate 기능 
Open Declaration 부터 Open Resource 까지 기능 숙지



  • Editor View에서 함수 선택 우측 클릭 후 Open Call Hierarchy 선택 
소스에서 각 함수의 우측버튼을 누르면 다음과 같이 볼수 있다.
  1. Open Call Hierarchy : 이 함수가 어디서 호출되는지 관련함수들 
  2. Open Type Hierarchy: 이 구조체  구조를 쉽게 파악 
  3. Open Declaration : 이 함수가 정의된 곳

우측의 Outline창 이용하여 쉽게 함수를 검색하자.



4.2  OUTLINE 이용

아래와 같이 OUTLINE 창을 보면 Header 와 함수 및 기타 정보가 나오며, 그것을 클릭을 할 경우 관련된 곳으로 자동으로 이동이 된다.



4.3 Task Tag 설정방법 

Task Tags기능은 각 TAG 와 우선순위를 정하고 각 소스에 주석으로 넣어 관리하는 시스템이라고 생각하면 되겠다.

한마디로 주석(TAG)을 이용하여 빠른 검색을 하여 원하는 위치를 찾는것이다.
위와 같이 관리하기 때문에 주석을 만들때 본인이 신경써서 만들어야한다.

Task Tag는 Indexer 기반으로 하므로 설정을 변경하면 Indexer가 다시생성된다. (주의)


  • Project->Properties->Task Tags 확인
주석의 TAG를 이용하여 쉽게 위치를 찾아주는 기능으로 아래와 같이 설정하면 된다.
Task Tags 설정 후 Configure Workspace Setting 창 설정




  https://www.eclipse.org/pdt/help/html/task_tags.htm



  • Task의 Tag 설정 
Task의 에서 TAG는 프로젝트내에 존재하는 소스의 주석에 각각의 TAG라는 것을 정의하고 이에 우선순위를 부여하여 소스를 보다 쉽게 관리를 한다. 

  1. Window->Preferences 실행 
  2. C/C++ -> Task Tags 선택 
  3. 우측 New or Edit 선택 (TAG 및 우선순위변경)



표준으로 사용되는 Tags들이 존재하며 Tag에 우선순위를 부여가 가능하며, 이는 주석에서 사용되어진다
그리고, 자신이 별도로 Tag를 정의해서 사용하고 싶다면 새로 정의해서 넣으면 된다.
개별 프로젝트일 경우 유용하며 소스찾기 또한 편한다.


  • 기본사용되는 TAG들 의미 
GNU프로젝트를 대체적으로 보면 아래의 3개의 TAG들을 많이 사용을 하는데, 각각의 의미를 알아두자

TODO 
우선순위에서는 가장 낮을 것으로 생각이 되며 수정해야할 것을 주석으로 간단히 정리한다.
현재소스에서는 크게 문제가 될 부분이라고 생각하기 보다는 구현할 것에 대한 간단하게 기술을 한다.
구현할 것에 필요한 사항을 기술,
소스에 이해를 위해서 다른 내용도 첨가

FIXME
일단 우선순위는 중간즈음 되는 될 것이며, 가장 일반적으로 사용되는 주석으로 사용되는 것 같다.
소스수정을 했지만, 추후에 소스 수정이 필요
지금 동작은 하지만 본인 생각하기에 추가해야 부분 있을 것 같은 생각이든 경우
최적화 되지 않아 이부분을 최적화를 해야 할 경우

XXX 
정확하게 말하면 주의 및 경고단계이며 가장 우선순위가 높을 것으로 생각된다.
소스가 정확하게 혹은 완벽하게 구현되지 않을 경우를 때를 강조
추후에 관련부분을 수정을 반드시 해야하는 경우
소스에서 관련 문제사항이 발생할 경우


  • 상위 TAG들 이외 보통 추가되는 TAG들

  1. HACK
  2. NOTE
  3. 본인이 정의하여 별도 추가가능



4.4 Task View을 이용한  TAG 관리

상위에서 TAG를 설정을 했으니, TASK View를 이용하여 Project의 TAG를 관리를 해보도록 하자.
아래와 같이 주석에 존재하는 TAG들을 이용하여 본인이 수정해야할 곳을 우선순위에 따라 쉽게 알수 있으면, 소스 관리가 좀 더 수월해진다.

  • General->Task View
Window->Show View->Other 선택 후 상위의 Task View를 실행

현재 Item을10892중  100개 밖에 보지를 못하므로 설정을 변경해주자.


Task View 의 우측 필터메뉴로 세부설정


Task View의 아래방향마크 눌러 각각 메뉴를 설정도 가능

  1. Group By-> Type 설정 
  2. Sort By  본인 원하는대로 
  3. Configure Columns ( Columns 을 지우고 싶다면 사용)



상위 TAGS들은 기본으로 들어가있지만, 현재 개발 상황에 따라 다양하게 정의하여 사용이 되어지는 것같으며 본인의 팀에 따라 별도로 TAG를 정의해서 넣어도 괜찮다.

  https://code.google.com/archive/p/editra-plugins/wikis/CommentBrowser.wiki
  https://stackoverflow.com/questions/1452934/what-is-the-meaning-of-xxx-in-code-comments?utm_medium=organic&utm_source=google_rich_qa&utm_campaign=google_rich_qa

  http://www.panozzaj.com/blog/2010/01/15/todo-fixme-hack-and-xxx/
  http://egloos.zum.com/rucaus/v/2455594
  http://devilbbong.tistory.com/13


4.5. Mylyn->Tasklist 와 ITS시스템 같이 사용  

ITS(Bugzillar, Trac,Redmine)와 함께  상위 TASK를 같이 이용하여 Issue/Ticket으로 신청을하고 각 소스에 상위 TAG를 적용하여,
ITS와 같이 사용하는 것 같으며, 아직 이용을 해보지 못하여 이부분은 추후에 테스트를 해보자
Team으로 할수 있는 일은 이 PlugIn으로 연결하여 사용을하며, Jenkis도 되는 것 같다.

기본적으로 Ecplise에서 이 동작이 가능하려면, 다음과 같은 PlugIn들이 필요하다

  1. Mylyn xxxx
  2. Mylyn Task List PlugIn
  3. Mylyn Tasks Connector-xxxx

  http://www.eclipse.org/mylyn/

  • Task List 창 보기 
  1. Window->Show View->Other->Mylyn 
  2. Task List를 선택 
  3. Task List 창에서 우측 마우스 클릭->New->Task
  4. Add Task Repository ( 본인의 ITS 시스템 선택)

Mylyn과 ITS부분 연결관련 설명 
  http://www.eclipse.org/mylyn/new/new-3.0.html#task-list
  https://www.redmine.org/projects/redmine/wiki/HowTo_Mylyn
  http://www.eclipse.org/mylyn/new/new-3.0.html#bugzilla
  http://www.eclipse.org/mylyn/new/new-3.0.html#trac
  http://www.eclipse.org/mylyn/new/new-3.0.html#jira

  • Main Menu에서 Task 관리 
  1. Navigate->Open Task
  2. Navigate->Activate Task
  3. Navigate->Deactivate Task

  • Search->Search->Task Search 확인 (상위 TASK 종합관리)
좌측을 보면 Repository 설정에 따라 Eclipse에서 진행되는 프로젝트관련사항을 볼수 있다.
그리고, 좌측의 Repository를 Myln-Mantis Support로 변경하면, 관련 기능을 나올것이다.


TASK TAGs
  https://www.lesstif.com/pages/viewpage.action?pageId=19857460


5.1 SCM-GIT 관련 설정 

아래와 같이 우측 아이콘에서 GIT 관련부분을 추가하였으며, 나의 U-BOOT 소스는 GIT 기반이지만, 내가 별도로 Update를 할일이 없다.


중요한 것은 나의 소스인 Working Tree에 문제가 없는 지 확인하고 추후에 Github or 다른 Git Server를 이용시 다시 사용해보자.

  http://jwgye.tistory.com/38
  http://www.yoctoproject.org/docs/2.4.1/mega-manual/mega-manual.html#sdk-eclipse-project

댓글 없음 :