Cursor는 기존의 VS Code를 기반으로, AI 기능을 매우 강력하게 통합한 코드 에디터입니다.
안드로이드 개발에 사용하면 다음과 같은 장점들이 있습니다.
- 지능적인 코드 생성 및 수정: 간단한 명령만으로 클래스, 함수, UI 레이아웃 등 복잡한 코드를 생성하거나 기존 코드를 리팩토링할 수 있습니다.
- 프로젝트 전체 컨텍스트 이해: 내 프로젝트의 다른 파일이나 폴더 구조를 AI가 이해하고, 그에 맞는 코드를 추천하고 작성해 줍니다.
- 에러 해결 및 디버깅 지원: 발생한 에러 메시지를 붙여넣고 해결 방법을 물어보면, 프로젝트 상황에 맞는 해결책을 제시해 줍니다.
- 문서 검색: 웹 브라우저를 열지 않고도 에디터 내에서 공식 문서나 라이브러리 문서를 찾아 코드에 바로 적용할 수 있습니다.
Cursor로 안드로이드 개발 시작하기
1. 필수 환경 설정 (가장 중요!)
Cursor는 '코드 에디터'일 뿐, 안드로이드 개발에 필요한 모든 도구(SDK, 컴파일러, 에뮬레이터 등)를 포함하고 있지는 않습니다. 따라서 반드시 기존의 안드로이드 개발 환경이 컴퓨터에 설치되어 있어야 합니다.
- Android Studio 설치: 가장 쉬운 방법입니다. Android Studio를 설치하면 안드로이드 SDK, JDK, 커맨드 라인 도구, 에뮬레이터 등 모든 필수 요소가 한 번에 설치됩니다. 이미 설치되어 있다면 이 단계는 넘어가세요.
- 환경 변수 설정: 안드로이드 SDK 경로(ANDROID_HOME 또는 ANDROID_SDK_ROOT)가 시스템 환경 변수에 제대로 등록되어 있는지 확인하세요.
2. Cursor 설치 및 프로젝트 열기
- Cursor 다운로드: 공식 홈페이지(cursor.sh)에서 자신의 운영체제에 맞는 버전을 다운로드하여 설치합니다.
- 안드로이드 프로젝트 열기: Cursor에서 File > Open Folder... 메뉴를 통해 기존에 만들었던 안드로이드 프로젝트 폴더를 엽니다. (Gradle 빌드 파일인 build.gradle.kts가 있는 폴더입니다.)
3. 추천 확장 프로그램(Extensions) 설치
Cursor는 VS Code 기반이므로, 확장 프로그램을 설치해야 안드로이드 개발이 훨씬 편해집니다. 왼쪽 사이드바에서 Extensions 탭(네모 블록 모양 아이콘)을 열고 다음을 검색하여 설치하세요.
- 필수:
- Kotlin: Kotlin 언어 지원 (구문 강조, 자동 완성 등)
- Extension Pack for Java: Java 언어 지원
- 추천:
- Gradle for Java: Gradle 빌드 스크립트 지원
- Jetpack Compose: 컴포즈 코드 스니펫 및 유용한 기능 제공
Cursor의 핵심 AI 기능 사용법
1. AI와 대화하기 (Ctrl + L)
에디터 어디서든 Ctrl + L (Mac: Cmd + L)을 눌러 채팅창을 열 수 있습니다.
- 질문: "Jetpack Compose에서 LazyColumn 사용법 알려줘", "MVVM 아키텍처란 뭐야?"
- 에러 해결: 빌드 실패 시 출력된 에러 로그를 복사해서 붙여넣고 "이 에러 해결해줘"라고 요청
2. 코드 생성 및 편집 (Ctrl + K) - 가장 강력한 기능!
코드를 수정하거나 새로 만들고 싶을 때 사용하는 기능입니다.
- 새 코드 생성: 빈 줄에 커서를 두고 Ctrl + K (Mac: Cmd + K)를 누른 후 원하는 기능을 지시합니다.
- "이메일과 비밀번호 입력 필드, 로그인 버튼을 포함하는 로그인 화면 Composable 함수 만들어줘"
- "Retrofit을 사용해서 'https://api.example.com/'에 GET 요청을 보내는 함수 만들어줘"
- 기존 코드 수정: 수정하고 싶은 코드 블록을 선택(드래그)한 후 Ctrl + K를 누릅니다.
- (네트워크 함수를 선택하고) "이 코드에 try-catch로 예외 처리 추가해줘"
- (복잡한 함수를 선택하고) "이 코드를 더 읽기 쉽게 리팩토링해줘"
3. 컨텍스트(@)를 활용한 정확한 지시
AI에게 더 정확한 맥락을 알려주기 위해 @ 기호를 사용합니다.
- @파일이름: 특정 파일의 내용을 참고하라고 AI에게 알려줍니다.
- @UserViewModel.kt 파일을 참고해서 @UserScreen.kt 에 필요한 UI 코드를 작성해줘.
- @docs: 공식 문서를 참고하여 답변하게 합니다.
- @docs/kotlin-coroutines 내용을 기반으로 비동기 처리 코드 작성해줘.
'룰 설정'의 의미와 방법
'룰 설정'은 Cursor AI가 내 프로젝트에 대해 따라야 할 전반적인 규칙이나 가이드라인을 설정하는 것을 의미합니다. 프로젝트 루트 폴더에 .cursor 라는 숨김 폴더를 만들고 그 안에 설정 파일을 두어 관리할 수 있습니다.
.cursor/ide.json 파일 생성 및 규칙 설정
프로젝트의 루트 디렉터리에 .cursor 폴더를 만들고, 그 안에 ide.json (또는 context.json) 파일을 생성하여 다음과 같이 AI에게 지시사항을 내릴 수 있습니다.
{
"directives": [
"우리는 모든 UI를 Jetpack Compose를 사용해서 개발해.",
"상태 관리는 ViewModel과 StateFlow를 사용해줘.",
"네트워크 통신은 Retrofit과 OkHttp 라이브러리를 사용하고 있어.",
"새로운 코드를 작성할 때는 항상 코틀린 코딩 컨벤션을 지켜줘.",
"모든 클래스와 함수에는 KDoc 주석을 추가해줘."
]
}이렇게 '룰'을 설정해두면, Ctrl + K로 코드를 생성하거나 수정할 때 AI가 이 규칙들을 먼저 고려하여 결과물을 만들어줍니다. 덕분에 프로젝트의 일관성을 유지하기가 매우 용이해집니다.
요약: Android Studio vs Cursor
- Android Studio: UI 디자인, 에뮬레이터 연동, 빌드 및 배포 등 안드로이드 개발의 전반적인 관리와 실행에 있어서는 여전히 필수적이고 가장 강력합니다.
- Cursor: 코드 작성, 리팩토링, 디버깅 단계에서 AI의 도움을 받아 생산성을 폭발적으로 높이는 데 특화되어 있습니다.
추천 워크플로우: 프로젝트 생성, 빌드, 실행, 디버깅은 Android Studio를 메인으로 사용하고, 코드 작성 및 수정이 필요할 때 Cursor를 열어 AI의 도움을 받는 방식으로 함께 사용하면 최고의 효율을 낼 수 있습니다.