모바일 개발자는 보통 앱의 UI를 단계적으로 개발하기보다는 한 번에 모든 것을 개발하는 것보다 Android 스튜디오는 Jetpack Compose는 검사를 위해 전체 빌드가 필요하지 않은 도구를 제공하여 최종 결과를 확인합니다.
실시간 편집
실시간 편집은 에뮬레이터와 실시간으로 제공할 수 있습니다. 이 기능은 컨텍스트 전환을 최소화하여 시간을 단축할 수 있으므로 코드 작성에 더 오래 집중할 수 있습니다. 방해받지 않고 즐길 수 있습니다.
<ph type="x-smartling-placeholder">실시간 편집에는 세 가지 모드가 있습니다.
- 수동: 코드 변경사항이 Control+' (macOS에서는 Command+')
- 저장 시 수동: 다음을 사용하여 수동으로 저장할 때 코드 변경사항이 적용됨 Control+S (macOS에서는 Command+S)를 누릅니다.
- 자동: 업데이트 시 기기나 에뮬레이터에 변경사항이 적용됨 구성 가능한 함수입니다.
실시간 편집은 UI 및 UX 관련 코드 변경사항에 중점을 둡니다. 메서드 서명 업데이트 또는 새 메서드 추가, 클래스 계층 구조 변경과 같은 변경사항은 지원하지 않습니다. 자세한 내용은 실시간 편집 제한사항 목록을 참고하세요.
이 기능은 앱 빌드 및 실행 또는 Apply Changes를 대체하지 않습니다. 대신 Compose UI 개발을 위해 빌드, 배포, 반복할 때 워크플로를 최적화하도록 설계되었습니다.
권장사항 워크플로는 다음과 같습니다.
- 애플리케이션이 실행될 수 있도록 설정합니다.
- 실시간 편집이 지원하지 않는 변경(예: 앱이 실행되는 동안 새 메서드 추가)을 해야 할 때까지 실시간 편집을 가능한 한 많이 사용합니다.
- 지원되지 않는 변경을 한 후 Run
을 클릭하여 다시 시작합니다. 실시간 편집을 재개하세요.
실시간 편집 시작
시작하려면 다음 단계에 따라 빈 Compose 활동을 만들고 실시간 편집을 클릭하고 실시간 편집으로 변경합니다.
새 프로젝트 설정
시작하기 전에 Android 스튜디오 Giraffe 이상이 설치되어 있는지 확인하세요. 물리적 서비스의 API 수준을 최소 30 이상입니다.
Android 스튜디오를 열고 Welcome to Android Studio 대화상자에서 New Project를 선택합니다. 이미 프로젝트가 열려 있다면 새 먼저 파일 > 신규 > 새 프로젝트.
Phone and Tablet용 Empty Compose Activity 템플릿을 선택한 후 Next를 클릭합니다.
그림 1. 선택 가능한 템플릿. 실시간 편집의 경우 Empty Compose Activity를 선택합니다. 이름, 패키지 이름, 저장 위치, 최소 SDK, 빌드 구성 언어와 같은 필수 정보로 New Project 대화상자를 채웁니다.
그림 2. 프로젝트 설정 예시 Finish를 클릭합니다.
실시간 편집 사용 설정
설정으로 이동하여 실시간 편집을 사용 설정합니다.
- Windows 또는 Linux의 경우 File > Settings > Editor > Live Edit으로 이동합니다.
- macOS에서는 Android Studio > Settings > Editor > Live Edit으로 이동합니다.
설정에서 Live Edit 옵션과 실행할 모드를 선택합니다.
수동 모드에서는 키를 누를 때마다 코드 변경사항이 푸시됩니다. Control+' (macOS에서는 Command+')를 누릅니다. 수동 모드 사용 저장하면 수동으로 저장할 때마다 코드 변경사항이 적용되며 Ctrl+S (Command+S를 눌러 macOS). 자동 모드에서는 코드 변경사항이 기기 또는 에뮬레이터에서 확인할 수 있습니다.
그림 3. 실시간 편집 설정. 편집기에서 앱의 진입점인
MainActivity
파일을 엽니다.Run
을 클릭하여 앱을 배포합니다.
실시간 편집을 사용 설정하면 왼쪽 상단에 최신 녹색 체크표시가 Running Devices 도구 창의 오른쪽 상단에서 다음을 실행합니다.
변경 및 검토
편집기에서 지원되는 변경사항을 적용할 때 가상 또는 실제 테스트 기기는 자동으로 업데이트됩니다.
예를 들어 MainActivity
의 기존 Greeting
메서드를
있습니다.
@Composable fun Greeting(name: String) { Text( text = "Hello $name!", Modifier .padding(80.dp) // Outer padding; outside background .background(color = Color.Cyan) // Solid element background color .padding(16.dp) // Inner padding; inside background, around text) ) }
그림 4와 같이 변경사항이 테스트 기기에 즉시 표시됩니다.
<ph type="x-smartling-placeholder">![기기에 적용된 Greeting 메서드 변경사항](https://developer.android.com/static/studio/images/run/device-le-example.png?authuser=0000&hl=ko)
Greeting
메서드실시간 편집 문제 해결
테스트 기기에 수정사항이 표시되지 않으면 Android 스튜디오가 실패했을 수 있습니다. 수정사항을 업데이트합니다. 실시간 편집 표시기에 다음과 같은 메시지가 표시되는지 확인합니다. Out Of Date(오래된)로 표시되며 이는 컴파일 오류를 나타냅니다. 오류 정보와 해결 방법에 관한 제안을 보려면 표시기를 클릭하세요.
![실시간 편집의 out of date 아이콘](https://developer.android.com/static/studio/images/run/live-edit-out-of-date.png?authuser=0000&hl=ko)
실시간 편집 제한사항
다음은 현재 제한사항 목록입니다.
[Android 스튜디오 Giraffe 이상에만 적용] 실시간 편집에는 Compose 런타임이 필요함 1.3.0 이상 프로젝트에서 더 낮은 버전의 Compose를 사용하는 경우 실시간 편집은 사용 중지됩니다.
[Android 스튜디오 Giraffe 이상에만 적용] 실시간 편집을 사용하려면 AGP 8.1.0-alpha05 또는 더 높습니다. 프로젝트에서 더 낮은 버전을 사용하는 경우 실시간 편집이 사용 중지됩니다.
실시간 편집을 사용하려면 API 수준을 실행하는 실제 기기나 에뮬레이터가 필요합니다. 30 이상
실시간 편집은 함수 본문의 수정만 지원합니다. 즉, 함수 이름 또는 서명을 변경하거나 함수를 추가 또는 제거하거나 함수가 아닌 필드를 변경할 수 없습니다.
실시간 편집은 Compose 함수를 처음 변경할 때 앱의 상태를 재설정함 할 수 있습니다. 이는 첫 번째 코드 변경 후에만 발생합니다. 즉, 앱 상태는 사용자가 이 파일의 Compose 함수에 적용한 후속 코드 변경으로 재설정되는 것입니다.
실시간 편집으로 수정된 클래스로 인해 성능 저하가 발생할 수 있습니다. 다음을 실행합니다. 애플리케이션의 성능을 평가하고 있다면 클린 릴리스 빌드를 실적을 살펴보세요.
디버거가 자신이 생성한 클래스에서 작동하려면 전체 실행을 수행해야 합니다. 실시간 편집으로 수정한 동영상
실행 중인 앱을 실시간 편집으로 수정하면 앱이 다운될 수 있습니다. 이 경우 Run
버튼을 사용하여 앱을 다시 배포할 수 있습니다.
실시간 편집은 실시간 편집에 정의된 바이트 코드 조작을 빌드 파일(예: 필요한 바이트 코드 조작)을 Build 메뉴의 옵션을 사용하여 프로젝트를 빌드할 때 또는 Build 또는 Run 버튼을 클릭하여 앱을 빌드할 수 있습니다.
구성 불가능한 함수는 기기나 에뮬레이터에서 실시간으로 업데이트됩니다. 전체 리컴포지션이 트리거됩니다. 전체 재구성에서는 업데이트된 함수를 호출하지 않을 수 있습니다. 구성 불가능한 함수의 경우 새로 업데이트된 함수를 트리거하거나 앱을 다시 실행해야 합니다.
실시간 편집은 앱을 다시 시작해도 재개되지 않습니다. 앱을 다시 실행해야 합니다.
실시간 편집은 디버그 가능한 프로세스만 지원합니다.
실시간 편집은 빌드 구성의
kotlinOptions
에서moduleName
에 맞춤 값을 사용하는 프로젝트를 지원하지 않습니다.실시간 편집은 다중 배포에서 작동하지 않습니다. 즉, 한 기기에 배포한 다음 다른 기기에 배포할 수 없습니다. 실시간 편집은 다음 기기에서만 활성화됩니다. 앱이 배포된 마지막 기기 세트입니다.
실시간 편집은 멀티스크린 배포 (여러 기기에 배포) 대상의 여러 기기 선택을 통해 생성된 기기 기기 드롭다운). 하지만 공식적으로 지원되지는 않으며 있습니다 문제가 발생하는 경우 신고해 주세요.
Apply Changes/Apply Code Changes가 실시간 편집과 호환되지 않음 실행 중인 앱을 다시 시작해야 합니다
실시간 편집은 현재 Android Automotive 프로젝트를 지원하지 않습니다.
실시간 편집에 관해 자주 묻는 질문(FAQ)
실시간 편집의 현재 상태는 무엇인가요?
실시간 편집은 Android 스튜디오 Giraffe에서 사용할 수 있습니다. 이 기능을 사용 설정하려면 다음 단계를 따르세요. 파일로 이동합니다. 설정 > 편집자 > 실시간 편집 (Android 스튜디오 > 설정 > 편집자 > 실시간 편집(macOS)).
실시간 편집은 언제 사용해야 하나요?
UX 업데이트의 효과를 빠르게 확인하려면 실시간 편집을 사용하세요. 전체 앱의 요소 (예: 수정자 업데이트, 애니메이션) 경험해 볼 수 있습니다
실시간 편집을 사용하면 안 되는 경우는 언제인가요?
실시간 편집은 UI 및 UX 관련 코드 변경사항에 중점을 둡니다. 지원하지 않음 메서드 서명 업데이트, 새 메서드 추가 또는 클래스와 같은 변경 사항이 계층 구조를 변경할 수 있습니다 자세한 내용은 라이브 스트리밍의 제한사항을 참조하세요. 수정을 클릭합니다.
Compose 미리보기는 언제 사용해야 하나요?
개별 컴포저블을 개발할 때 Compose 미리보기를 사용하세요. 미리보기 Compose 요소를 시각화하고 자동으로 새로고침하여 영향을 줄 수 있습니다 미리보기는 다음 위치에서 UI 요소 보기도 지원합니다. 다양한 구성 및 상태(예: 어두운 테마, 언어, 글꼴) 제공합니다
리터럴 실시간 편집 (지원 중단됨)
Android 스튜디오는 미리보기, 에뮬레이터 및 실제 기기 내 컴포저블에 사용되는 상수 리터럴을 실시간으로 업데이트할 수 있습니다. 지원되는 유형은 다음과 같습니다.
Int
String
Color
Dp
Boolean
다음 함수를 사용하지 않고 실시간 업데이트를 트리거하는 상수 리터럴을 확인할 수 있습니다. 실시간 편집을 통해 리터럴 장식을 사용 설정하여 컴파일 단계를 리터럴 UI 표시기:
변경사항 적용
Apply Changes를 사용하면 코드 및 리소스를 업데이트할 수 있습니다. 앱을 에뮬레이터나 실제 기기에 재배포할 필요 없이 (일부 제한사항)이 있습니다.
컴포저블을 추가, 수정 또는 삭제할 때마다 Apply Code Changes 버튼을 클릭하여 다시 배포해야 합니다.
추천 서비스
- 참고: JavaScript가 사용 중지되어 있으면 링크 텍스트가 표시됩니다.
- 애니메이션 맞춤설정{:#customize-animations}
- 가치 기반 애니메이션
- 매개변수 추가