Skip to content

Most visited

Recently visited

navigation

Eclipse에서 Android Studio로 마이그레이션

프로젝트를 Android Studio로 마이그레이션하려면 새 프로젝트 구조, 빌드 시스템 및 IDE 기능에 적응해야 합니다. 마이그레이션 프로세스를 단순화하기 위해 Android Studio는 가져오기 도구를 제공하므로, 기존 코드를 Android Studio 프로젝트 및 Gradle 기반 빌드 파일로 신속하게 이동할 수 있습니다.

Android Studio 기본 정보

다음은 Android Studio로의 마이그레이션을 준비하기 위해 알아야 하는 몇 가지 주요 차이점입니다.

프로젝트 및 모듈 구성

Android Studio는 IntelliJ IDEA IDE를 기반으로 합니다. 탐색, 코드 작성 및 단축키와 같은 IDE 기본 정보에 대해 알아보려면, Android Studio 만나보기를 참조하세요.

Android Studio는 작업 공간을 사용하지 않으므로, 별도의 프로젝트는 별도의 Android Studio 창에서 열립니다. Android Studio는 코드를 프로젝트에 구성하며, 프로젝트에는 앱 소스 코드, 빌드 구성 및 테스트 코드 등 Android 앱을 정의하는 모든 항목이 포함됩니다. 각 프로젝트에는 하나 이상의 모듈이 포함되며, 프로젝트를 분산된 기능 단위로 나눌 수 있습니다. 모듈은 독립적으로 빌드, 테스트 및 디버그할 수 있습니다.

Android Studio 프로젝트 및 모듈에 대한 자세한 내용은, 프로젝트 개요를 참조하세요.

Gradle 기반 빌드 시스템

Android Studio의 빌드 시스템은 Gradle을 기반으로 하며, Groovy 구문으로 작성된 빌드 구성 파일을 사용하므로 확장과 사용자 지정이 쉽습니다.

Gradle 사용 및 구성에 대한 자세한 내용은, 빌드 구성을 참조하세요.

종속성

Android Studio의 라이브러리 종속성은 Maven 좌표가 있는 잘 알려진 로컬 소스 라이브러리 및 바이너리 라이브러리에 대해 Gradle 종속성 선언과 Maven 종속성을 사용합니다. 자세한 내용은 빌드 변형 구성을 참조하세요.

테스트 코드

Eclipse ADT에서, 기기 테스트는 별도의 프로젝트로 작성되며 매니페스트 파일에 있는 <instrumentation> 요소를 통해 통합됩니다. Android Studio는 프로젝트의 기본 소스 세트에서 androidTest/ 디렉토리를 제공하므로, 동일한 프로젝트 뷰 내에서 기기 테스트 코드를 쉽게 추가하고 유지관리할 수 있습니다. Android Studio는 또한 로컬 JVM 테스트를 위해 test/ 디렉토리를 프로젝트의 기본 소스 세트에서 제공합니다.

마이그레이션 사전 요구사항

앱을 Android Studio로 마이그레이션하기 전에, 다음 단계를 진행하여 프로젝트 전환 준비가 되었는지 확인하고 Android Studio에 필요한 도구 구성이 있는지 검사합니다.

Eclipse ADT에서:

Android Studio에서:

프로젝트를 Android Studio로 가져오기

기존 Eclipse ADT 프로젝트를 가져오는 방법을 그 구조에 따라 결정해야 합니다.

프로젝트로 가져오기:

  1. Android Studio를 시작하고 열려 있는 Android Studio 프로젝트를 닫습니다.
  2. Android Studio 메뉴에서 File > New > Import Project를 클릭합니다.
    • 또는, Welcome 화면에서 Import Project (Eclipse ADT, Gradle, etc.)를 클릭합니다.
  3. AndroidManifest.xml 파일이 있는 Eclipse ADT 프로젝트 폴더를 선택하고 Ok를 클릭합니다.

  4. 대상 폴더를 선택하고 Next를 클릭합니다.

  5. 가져오기 옵션을 선택하고 Finish를 클릭합니다.
  6. 가져오기 프로세스가 라이브러리 및 프로젝트 종속성을 Android Studio로 마이그레이션하고, 종속성 선언을 build.gradle 파일에 추가하라는 메시지를 표시합니다. 이 프로세스에 대한 자세한 내용은 Android 라이브러리 만들기를 참조하세요.

    가져오기 프로세스는 또한 알려진 Maven 좌표가 있는 잘 알려진 소스 라이브러리, 바이너리 라이브러리 및 JAR 파일을 Maven 종속성으로 대체하므로, 이러한 종속성을 수동으로 유지관리할 필요가 없습니다. 또한 가져오기 프로세스를 통해 알 수 없는 상대 경로, 경로 변수 및 링크된 리소스 참조를 처리하기 위해 작업 공간 디렉토리와 실제 경로 맵을 입력할 수 있습니다.

  7. Android Studio가 앱을 가져오고 프로젝트 가져오기 요약을 표시합니다. 프로젝트 구조 변경 및 가져오기 프로세스에 대한 자세한 내용은 요약을 참조하세요.

Eclipse ADT에서 Android Studio로 프로젝트를 가져온 후, Android Studio의 각 앱 모듈 폴더에는 해당 모듈의 전체 소스 세트가 포함되며, 여기에는 src/main/src/androidTest/ 디렉토리, 리소스, 빌드 파일 및 Android 매니페스트가 포함됩니다. 앱 개발을 시작하기 전에, 프로젝트 가져오기 요약에 나타난 문제들을 해결해야 하며 프로젝트 재구축 및 가져오기 프로세스가 올바로 완료되었는지 확인해야 합니다.

모듈로 가져오기:

  1. Android Studio를 시작하고 모듈을 추가하려는 프로젝트를 엽니다.
  2. Android Studio 메뉴에서 File > New > Import Module을 클릭합니다.
  3. AndroidManifest.xml 파일이 있는 Eclipse ADT 프로젝트 폴더를 선택하고 Ok를 클릭합니다.
  4. 원하는 경우 모듈 이름을 수정하고 Next를 클릭합니다.
  5. 가져오기 프로세스가 라이브러리 및 프로젝트 종속성을 Android Studio로 마이그레이션하고, 종속성 선언을 build.gradle 파일에 추가하라는 메시지를 표시합니다. 라이브러리 및 프로젝트 종속성 마이그레이션에 대한 자세한 내용은, Android 라이브러리 만들기를 참조하세요. 가져오기 프로세스는 또한 알려진 Maven 좌표가 있는 잘 알려진 소스 라이브러리, 바이너리 라이브러리 및 JAR 파일을 Maven 종속성으로 대체하므로, 이러한 종속성을 수동으로 유지관리할 필요가 없습니다. 또한 가져오기 프로세스를 통해 알 수 없는 상대 경로, 경로 변수 및 링크된 리소스 참조를 처리하기 위해 작업 공간 디렉토리와 실제 경로 맵을 입력할 수 있습니다.
  6. Finish를 클릭합니다.

가져온 프로젝트의 유효성 검사

가져오기 프로세스를 완료한 후, Android Studio Build 및 Run 메뉴 옵션을 사용하여 프로젝트를 빌드하고 결과를 확인합니다. 프로젝트가 올바로 빌드되지 않으면, 다음 설정을 확인합니다.

이러한 설정을 확인한 후에도 Android Studio에서 프로젝트를 빌드하고 실행할 때 여전히 예상치 못한 문제가 발생하는 경우, Eclipse ADT 프로젝트를 수정하고 가져오기 프로세스를 다시 시작해 보세요.

참고: Eclipse ADT 프로젝트를 Android Studio로 가져오면 새 Android Studio 프로젝트가 생성되고 기존 Eclipse ADT 프로젝트에는 영향을 미치지 않습니다.

다음 단계

프로젝트와 워크플로에 따라 버전 제어 사용, 종속성 관리, 앱 서명 및 패키징 또는 Android Studio 구성 및 업데이트에 대해 더 자세히 알아보고 싶을 수도 있습니다. Android Studio 사용을 시작하려면, Android Studio 만나보기를 읽어보세요.

버전 제어 구성

Android Studio에서는 다양한 버전 제어 시스템을 지원하며 여기에는 Git, GitHub, CVS, Mercurial, Subversion 및 Google Cloud Source Repositories가 포함됩니다.

앱을 Android Studio로 가져온 후에, Android Studio VCS 메뉴 옵션을 사용하여 원하는 버전 제어 시스템에 대해 VCS 지원을 활성화하고, 리포지토리를 만들고, 새 파일을 버전 제어로 가져오고, 기타 버전 제어 작업을 수행합니다.

  1. Android Studio VCS 메뉴에서 Enable Version Control Integration을 클릭합니다.
  2. 드롭다운 메뉴에서 프로젝트 루트에 연결할 버전 제어 시스템을 선택한 다음, OK를 클릭합니다. 이제 선택한 시스템에 따라 VCS 메뉴에 여러 가지 버전 제어 옵션이 표시됩니다.

참고: File > Settings > Version Control 메뉴 옵션을 사용하여 버전 제어 설정을 구성하고 수정할 수도 있습니다.

버전 제어 사용에 대한 자세한 내용은 IntelliJ Version Control Reference를 참조하세요.

Android 지원 리포지토리 및 Google Play 서비스 리포지토리

Eclipse ADT는 Android 지원 라이브러리 및 Google Play 서비스 라이브러리를 사용하는 반면, Android Studio는 호환되는 기능을 유지관리하고 새로운 Android 기능을 지원하기 위해 가져오기 프로세스 중에 이들 라이브러리를 Android 지원 리포지토리 및 Google 리포지토리로 대체합니다. Android Studio는 이러한 종속성을 알려진 Maven 좌표를 사용하는 Maven 종속성으로 추가하므로, 이 종속성을 수동으로 업데이트할 필요가 없습니다.

Eclipse에서 지원 라이브러리를 사용하려면, 사용하려는 각 지원 라이브러리에 대해 개발 환경 내에서 프로젝트의 클래스 경로 종속성을 수정해야 합니다. Android Studio에서는 라이브러리 소스를 자신의 프로젝트에 복사할 필요가 없으며, 종속성을 선언하기만 하면 라이브러리가 자동으로 다운로드되어 프로젝트에 병합됩니다. 여기에는 빌드 시에 리소스, 매니페스트 항목, ProGuard 제외 규칙 및 사용자 지정 lint 규칙의 자동 병합이 포함됩니다. 종속성에 대한 자세한 내용은, 빌드 변형 구성을 참조하세요.

앱 서명

Eclipse ADT에서 앱이 디버그 인증서를 사용한 경우, Android Studio는 해당 인증서를 계속해서 참조합니다. 그렇지 않은 경우, 디버그 구성이 Android Studio에서 생성된 디버그 키스토어를 사용하며, 알려진 암호와 $HOME/.android/debug.keystore에 있는 알려진 암호의 기본 키로 구성됩니다. Android Studio에서 프로젝트를 실행하거나 디버깅할 때 이 디버그 구성을 자동으로 사용하도록 디버그 빌드 유형이 설정됩니다.

릴리스를 위해 앱을 빌드할 때 Android Studio는 Eclipse ADT에 사용되는 릴리스 인증서를 적용합니다. 가져오기 프로세스 중에 릴리스 인증서를 찾지 못한 경우, 릴리스 서명 구성을 build.gradle 파일에 추가하거나 Build > Generate Signed APK 메뉴 옵션을 사용하여 Generate Signed APK Wizard를 엽니다. 앱 서명에 대한 자세한 내용은, 애플리케이션 서명을 참조하세요.

Android Studio의 최대 힙 크기 조정

기본적으로 Android Studio의 최대 힙 크기는 1280MB입니다. 큰 프로젝트에서 작업 중이거나 시스템에 RAM 용량이 많은 경우에는, Android Studio의 VM 옵션에서 최대 힙 크기를 늘려 성능을 개선할 수 있습니다.

Android Studio 설정 구성에 대한 자세한 내용은, Android Studio 구성Android Studio 구성을 참조하세요.

소프트웨어 업데이트

Android Studio는 Gradle 플러그인, 빌드 도구 및 SDK 도구를 별도로 업데이트합니다. Android Studio와 함께 사용할 버전을 지정할 수 있습니다.

기본적으로 Android Studio는 안정적인 새 버전이 릴리스될 때마다 자동 업데이트를 제공하지만, 업데이트를 더 자주 수행하거나 프리뷰나 베타 버전을 받도록 선택할 수도 있습니다.

Android Studio 업데이트와 프리뷰 및 베타 버전 사용에 대한 자세한 내용은, 최신 버전으로 업데이트를 참조하세요.

This site uses cookies to store your preferences for site-specific language and display options.

Hooray!

This class requires API level or higher

This doc is hidden because your selected API level for the documentation is . You can change the documentation API level with the selector above the left navigation.

For more information about specifying the API level your app requires, read Supporting Different Platform Versions.

Take a one-minute survey?
Help us improve Android tools and documentation.