2010년 7월 29일 목요일

Using Eclipse(이클립스 사용하기)

이클립스 사용하기

이 문서에서는 Android 플랫폼 개발을 하기 위해 Eclipse IDE 를 설정하는 것을 도와줄 것이다.

주의 : 만약 이클립스로 안드로이드에서 돌아가는 어플리케이션 개발하는 방법에 대한 정보를 찾고 있다면, 이 페이지는 당신에게 적합하지 않다. the Eclipse page on developer.android.com 에서 정보를 찾는 것이 더 유용할 것이다.

이클립스에 들어가기
기본 설정
첫째로, 정규 Android 개발 시스템 설정을 확실히 해 두는 것이 중요하다.
cd /path/to/android/root
make      # 아직 실행하지 않았다면 좀 기다려라.
중요 : 당신은 여전히 에뮬레이터나 디바이스에서 실제 실행될 파일을 빌드하기 위해서 "make"를 사용할 것이다.
Eclipse는 파일 수정과 컴파일을 확인하는데 사용할 것이나, 어떤 make 해야 하는 파일을 수행할 때는 이클립스에서 저장하고, shell에서 "make"한다. 이클립스 빌드는 단지 에러 체크만 할 뿐이다.

Eclipse는 Java 파일들을 검색할 디렉토리 목록을 필요로 한다.
이것은 "Java Build Path"라 불리며 .classpath 파일에서 설정될 수 있다.  
아래에 예가 나와 있다.
cd /path/to/android/root
cp development/ide/eclipse/.classpath .
chmod u+w .classpath #make the copy writable
이제 필요하다면 .classpath의 복사본을 수정한다.

증가하는 Eclipse의 메모리 설정
Android 프로젝트는 Eclipse의 자바 VM이 컴파일 중에 종종 메모리가 부족할 정도로 크다.
이런 문제를 피하려면 eclipse.ini 파일을 수정하면 된다.
Apple OSX 에서 eclipse.ini 파일은 /Applications/eclipse/Eclipse.app/Contents/MacOS/eclipse.ini 에 위치하고 있다.

메모리 관련 기본값(Eclipse 3.4 기준)
-Xms40m
-Xms256m
-XX:MaxPermSize=256m

Android 개발에 권장되는 설정값
-Xms128m
-Xmx512m
-XX:MaxPermSize=256m

이 설정값들은 Eclipse의 최소 Java heap 사이즈를 128MB, 최대 Java heap 사이즈를 512MB, 그리고 최대 지속 생성 사이즈를 기본 256MB로 유지하도록 설정한다.

이제 이클립스를 시작한다:
eclipse    # 원한다면 아이콘을 클릭하여 실행해도 상관없다.

다음은 Android 개발을 위한 프로젝트를 생성한다:
1. Eclipse가 workspace location을 묻는다면, 디폴트로 선택한다.
2. "Welcome"스크린이 뜨면 닫는다. 그럼 Java perspective가 보일 것이다.
3. File > New > Android Project
4. Project name 란에는 "android"나 원하는 이름을 넣는다.
5. "Create project from existing source" 를 선택하고, 당신의 Android 루트 디렉토리의 경로를 입력한 후 Finish를 클릭한다.
6. 프로젝트를 세팅하는 동안 기다린다.(우측 하단 모서리에서 자세한 진행 바를 볼 수 있다)

프로젝트 워크스페이스가 생성되면, Eclipse는 빌딩을 시작한다. 이론상으로는, 에러없이 빌드 되어야 하며, 당신이 설정을 해야 한다. 필요하다면, 강제 리빌드를 위해서 Project Build Automaticallry 를 체크 해제하거나 다시 체크 한다.

주의: Eclipse 는 종종  당신의 파일들의 상단에 리소스들을 사용하는 "import android.R" 문장을 추가하기도 하는데, 특히 당신이 eclipse에 import들을 정렬(sort)이나 그 밖에 방법으로 관리하는것을 요청했을때 발생할 가능성이 높다.
이것은 당신의 make가 실패 하게 되는 원인이 될 것이므로 이런 잘못된 import문들을 찾아서 제거해야 한다.

동기화 할 때
당신이 repo sync 를 할 때마다, 또는 그 밖의 방법으로 Eclipse 밖에서 파일들을 변경할 때마다(특히 .classpath), 다음의 방법으로 Eclipse 뷰들을 새로고침 해야 한다:
1. Window > Show View > Navigator
2. "Navigator"의 프로젝트에서 마우스 오른쪽 버튼 클릭.
3. 콘텍스트 메뉴(마우스 오른쪽 버튼 클릭하면 뜨는 메뉴)에서 Refresh 클릭

빌드 패스에 앱 추가하기
기본 .classpath 는 core system과 앱들의 샘플 모음 소스들을 포함하고 있지만, 당신이 작업할 특정 앱에는 그렇지 않을 것이다.
앱을 추가 하려면, 앱의 소스 디렉토리를 추가해야 한다.
Eclipse에서는 다음과 같이 한다:
1. Project > Properties
2. "Java Build Path" 를 좌측의 메뉴에서 선택한다.
3. "Source" 탭을 고른다.
4. "Add Folder..." 를 클릭한다.
5. 당신의 앱을 "src" 디렉토리에 추가한다.
6. OK를 클릭한다.

위의 과정을 마치면, 리스트의 "source folder"에 android/packages/apps/YourAppName/src 와 같이 보여야 한다. 당신이 어떤 앱(들)을 포함시켰냐에 따라, othersrc/main/java 디렉토리들을 android/dalvik/libcore 아래에 포함시킬 필요가 있다.

.....번역중..

"Eclipse가 제대로 동작하지 않아요, 어떻게 하죠?"
다음을 확인해 보자:
    - 당신이 이 페이지의 과정을 정확히 따라한것인지
    - 당신의 문제들이 어떤 에러들을 보여주지는 않는지
    - 당신의 어플리케이션이 package/directory 구조를 지키고 있는지

그래도 문제가 있다면, 안드로이드 메일링 리스트나 IRC 채널중 한곳에 문의하도록 해보자.


원문 : http://source.android.com/source/using-eclipse.html 

댓글 없음:

댓글 쓰기