이 페이지는 Cloud Translation API를 통해 번역되었습니다.

Android 스튜디오 Iguana | 2023.2.1 (2024년 2월)

다음은 Android 스튜디오 Iguana의 새로운 기능입니다.

패치 출시

다음은 Android 스튜디오 Iguana 및 Android Gradle 플러그인 8.3의 패치 출시 목록입니다.

Android 스튜디오 Iguana | 2023.2.1 패치 2 및 AGP 8.3.2 (2024년 4월)

이번 소규모 업데이트는 이러한 버그 수정을 포함합니다.

Android 스튜디오 Iguana | 2023.2.1 패치 1 및 AGP 8.3.1 (2024년 3월)

이번 소규모 업데이트는 이러한 버그 수정을 포함합니다.

IntelliJ IDEA 2023.2 플랫폼 업데이트

Android 스튜디오 Iguana에는 스튜디오 IDE 환경을 개선하는 IntelliJ IDEA 2023.2 업데이트가 포함되어 있습니다. 변경사항에 관한 자세한 내용은 IntelliJ IDEA 2023.2 출시 노트를 참고하세요.

App Quality Insights의 버전 관리 시스템 통합

이제 App Quality Insights를 사용하면 충돌이 발생한 시점의 Crashlytics 스택 트레이스에서 관련 코드로 이동할 수 있습니다. AGP는 비정상 종료 보고서에 git 커밋 해시 데이터를 연결합니다. 이를 통해 Android 스튜디오에서 코드로 이동하고 문제가 발생한 버전에서 코드가 어떻게 표시되는지 확인할 수 있습니다. App Quality Insights에서 비정상 종료 보고서를 볼 때 현재 git 체크아웃의 코드 줄로 이동하거나 현재 체크아웃과 비정상 종료를 생성한 코드베이스 버전 간의 차이를 볼 수 있습니다.

버전 관리 시스템을 앱 품질 통계와 통합하려면 다음과 같은 최소 요구사항이 필요합니다.

Android 스튜디오 Iguana의 최신 Canary 버전
Android Gradle 플러그인 8.3의 최신 알파 버전
Crashlytics SDK v18.3.7(또는 Firebase Android Bill of Materials v32.0.0)

디버그 가능한 빌드 유형에 버전 관리 통합을 사용하려면 모듈 수준 빌드 파일에서 vcsInfo 플래그를 사용 설정하세요. 출시 (디버그 불가) 빌드의 경우 이 플래그는 기본적으로 사용 설정되어 있습니다.

Kotlin

android {
  buildTypes {
    getByName("debug") {
      vcsInfo {
        include = true
      }
    }
  }
}

Groovy

android {
  buildTypes {
    debug {
      vcsInfo {
        include true
      }
    }
  }
}

이제 앱을 빌드하고 Google Play에 게시하면 비정상 종료 보고서에 IDE가 스택 트레이스에서 이전 버전의 앱에 연결하는 데 필요한 데이터가 포함됩니다.

앱 품질 통계에서 Crashlytics 비정상 종료 변형 보기

비정상 종료의 근본 원인을 분석하는 데 도움이 되도록 이제 앱 품질 통계를 사용하여 문제 변형별 이벤트 또는 유사한 스택 트레이스를 공유하는 이벤트 그룹을 확인할 수 있습니다. 비정상 종료 보고서의 각 변형에서 이벤트를 보려면 드롭다운에서 변형을 선택합니다. 모든 변형에 대한 정보를 집계하려면 모두를 선택합니다.

Compose UI 검사

개발자가 Jetpack Compose에서 더 적응력이 높고 접근성이 뛰어난 UI를 빌드할 수 있도록 Android 스튜디오 Iguana Canary 5에서는 Compose 미리보기에 새로운 UI 검사 모드를 도입했습니다. 이 기능은 뷰의 시각적 린팅 및 접근성 확인 통합과 유사하게 작동합니다. Compose UI 검사 모드를 활성화하면 Android 스튜디오에서 Compose UI를 자동으로 감사하고 대형 화면에서 늘어난 텍스트나 낮은 색상 대비와 같은 다양한 화면 크기에서 적응 및 접근성 문제를 확인합니다. 이 모드는 다양한 미리보기 구성에서 발견된 문제를 강조표시하고 문제 패널에 나열합니다.

지금 바로 Compose 미리보기에서 UI 확인 버튼 을 클릭하고 이 기능을 사용해 보고 의견을 보내 주세요.

UI 검사 모드의 알려진 문제:

문제 패널에서 선택한 문제의 포커스가 사라질 수 있음
'규칙 숨기기'가 작동하지 않음

문제 패널에 세부정보와 함께 Compose UI 검사 모드가 활성화되었습니다.

Compose 미리보기의 점진적 렌더링

Android 스튜디오 Iguana Canary 3의 Compose 미리보기에 프로그레시브 렌더링이 도입되었습니다. 미리보기의 성능을 개선하기 위한 지속적인 노력의 일환으로 이제는 표시되지 않는 미리보기의 렌더링 품질을 의도적으로 낮춰 사용되는 메모리를 절약합니다.

이 기능은 파일에서 더 많은 미리보기를 동시에 처리할 수 있어 미리보기의 사용성을 더욱 개선하기 위해 개발되었습니다. 지금 사용해 보고 의견을 제출해 주세요.

기준 프로필 모듈 마법사

Android 스튜디오 Iguana부터 새 모듈 마법사(File > New > New Module)의 기준 프로필 생성기 템플릿을 사용하여 앱의 기준 프로필을 생성할 수 있습니다.

이 템플릿은 기준 프로필을 지원할 수 있도록 프로젝트를 설정합니다. 이 도구는 하나의 Gradle 작업으로 필요한 방식으로 프로젝트를 설정하는 프로세스를 자동화하는 새로운 기준 프로필 Gradle 플러그인을 사용합니다.

이 템플릿은 Select Run/Debug Configuration 드롭다운 목록에서 한 번의 클릭으로 기준 프로필을 생성할 수 있는 실행 구성도 만듭니다.

Espresso Device API를 사용하여 구성 변경사항 테스트

기기에 회전 및 화면 펼치기와 같은 일반적인 구성 변경이 있을 때 Espresso Device API를 사용하여 앱을 테스트합니다. Espresso Device API를 사용하면 가상 기기에서 이러한 구성 변경사항을 시뮬레이션하고 테스트를 동기식으로 실행할 수 있으므로 한 번에 하나의 UI 작업 또는 어설션만 발생하고 테스트 결과가 더 안정적입니다. Espresso로 UI 테스트를 작성하는 방법을 자세히 알아보세요.

Espresso Device API를 사용하려면 다음이 필요합니다.

Android 스튜디오 Iguana 이상
Android Gradle 플러그인 8.3 이상
Android Emulator 33.1.10 이상
API 수준 24 이상을 실행하는 Android Virtual Device

Espresso Device API용 프로젝트 설정

Espresso Device API를 지원하도록 프로젝트를 설정하려면 다음을 실행하세요.

테스트에서 테스트 기기로 명령어를 전달하도록 하려면 INTERNET 및 ACCESS_NETWORK_STATE 권한을 androidTest 소스 세트의 매니페스트 파일에 추가합니다.
```
  <uses-permission android:name="android.permission.INTERNET" />
  <uses-permission android:name="android.permissions.ACCESS_NETWORK_STATE" />
```
gradle.properties 파일에서 enableEmulatorControl 실험용 플래그를 사용 설정합니다.
```
  android.experimental.androidTest.enableEmulatorControl=true
```

모듈 수준 빌드 스크립트에서 emulatorControl 옵션을 사용 설정합니다.

Kotlin

  testOptions {
    emulatorControl {
      enable = true
    }
  }

Groovy

  testOptions {
    emulatorControl {
      enable = true
    }
  }

모듈 수준 빌드 스크립트에서 Espresso 기기 라이브러리를 프로젝트로 가져옵니다.

Kotlin

  dependencies {
    androidTestImplementation("androidx.test.espresso:espresso-device:3.6.1")
  }

Groovy

  dependencies {
    androidTestImplementation 'androidx.test.espresso:espresso-device:3.6.1'
  }

일반적인 구성 변경사항에 대한 테스트

Espresso Device API에는 기기 구성 변경을 시뮬레이션하는 데 사용할 수 있는 여러 화면 방향 및 폴더블 상태가 있습니다.

화면 회전 테스트

다음은 기기 화면이 회전할 때 앱에 어떤 일이 일어나는지 테스트하는 방법을 보여주는 예입니다.

먼저 일관된 시작 상태를 위해 기기를 세로 모드로 설정합니다.

  import androidx.test.espresso.device.action.ScreenOrientation
  import androidx.test.espresso.device.rules.ScreenOrientationRule
  ...
  @get:Rule
  val screenOrientationRule: ScreenOrientationRule = ScreenOrientationRule(ScreenOrientation.PORTRAIT)

테스트 실행 중에 기기를 가로 모드 방향으로 설정하는 테스트를 만듭니다.

  @Test
  fun myRotationTest() {
    ...
    // Sets the device to landscape orientation during test execution.
    onDevice().setScreenOrientation(ScreenOrientation.LANDSCAPE)
    ...
  }

화면이 회전한 후 UI가 예상대로 새 레이아웃에 맞게 조정되는지 확인합니다.

  @Test
  fun myRotationTest() {
    ...
    // Sets the device to landscape orientation during test execution.
    onDevice().setScreenOrientation(ScreenOrientation.LANDSCAPE)
    composeTestRule.onNodeWithTag("NavRail").assertIsDisplayed()
    composeTestRule.onNodeWithTag("BottomBar").assertDoesNotExist()
  }

화면 펼치기 테스트

다음은 앱이 폴더블 기기에 있고 화면이 펼쳐질 때 앱에 어떤 일이 일어나는지 테스트하는 방법을 보여주는 예입니다.

먼저 onDevice().setClosedMode()를 호출하여 기기가 접힌 상태에서 테스트합니다. 앱의 레이아웃이 좁은 화면 너비에 맞게 조정되는지 확인합니다.

  @Test
  fun myUnfoldedTest() {
    onDevice().setClosedMode()
    composeTestRule.onNodeWithTag("BottomBar").assetIsDisplayed()
    composeTestRule.onNodeWithTag("NavRail").assetDoesNotExist()
    ...
  }

완전히 펼쳐진 상태로 전환하려면 onDevice().setFlatMode()를 호출합니다. 앱의 레이아웃이 확장된 크기 클래스에 맞게 조정되는지 확인합니다.

  @Test
  fun myUnfoldedTest() {
    onDevice().setClosedMode()
    ...
    onDevice().setFlatMode()
    composeTestRule.onNodeWithTag("NavRail").assertIsDisplayed()
    composeTestRule.onNodeWithTag("BottomBar").assetDoesNotExist()
  }

테스트에 필요한 기기 지정

폴더블이 아닌 기기에서 접기 작업을 실행하는 테스트를 실행하면 일반적으로 테스트가 실패합니다. 실행 중인 기기와 관련된 테스트만 실행하려면 @RequiresDeviceMode 주석을 사용하세요. 테스트 실행기는 테스트 중인 구성을 지원하지 않는 기기에서 실행 중인 테스트를 자동으로 건너뜁니다. 기기 요구사항 규칙을 각 테스트 또는 전체 테스트 클래스에 추가할 수 있습니다.

예를 들어 플랫 구성으로 펼치기를 지원하는 기기에서만 테스트를 실행하도록 지정하려면 테스트에 다음 @RequiresDeviceMode 코드를 추가합니다.

@Test
@RequiresDeviceMode(mode = FLAT)
fun myUnfoldedTest() {
  ...
}