Android 4.2 API

API 수준: 17

Android 4.2 (JELLY_BEAN_MR1)는 사용자와 앱 개발자에게 새로운 기능을 제공하는 Jelly Bean 버전 업데이트입니다. 이 문서에서는 개발자를 위한 가장 주목하고 유용한 새로운 API를 소개합니다.

앱 개발자는 최대한 빨리 SDK Manager에서 Android 4.2 시스템 이미지와 SDK 플랫폼을 다운로드해야 합니다. 앱을 테스트할 Android 4.2를 실행하는 기기가 없다면 Android 4.2 시스템 이미지를 사용하여 Android Emulator에서 앱을 테스트합니다. 그런 다음 Android 4.2 플랫폼을 대상으로 앱을 빌드하고 최신 API를 사용하세요.

Android 4.2를 실행하는 기기에서 앱을 더 효과적으로 최적화하려면 targetSdkVersion를 "17"로 설정하고 Android 4.2 시스템 이미지에 설치하고 테스트한 다음 이 변경사항으로 업데이트를 게시해야 합니다.

minSdkVersion에서 지원하지 않는 API를 실행하기 전에 시스템 API 수준을 확인하는 조건을 코드에 추가하여 Android 4.2의 API를 사용하면서 이전 버전도 지원할 수 있습니다. 이전 버전과의 호환성 유지에 관한 자세한 내용은 이전 버전과 호환되는 UI 만들기를 참고하세요.

API 수준의 작동 방식에 관한 자세한 내용은 API 수준이란 무엇인가요?에서 확인할 수 있습니다.

중요한 동작 변경 사항

이전에 Android용 앱을 게시한 적이 있다면 앱 동작에 영향을 줄 수 있는 다음 변경사항에 유의하세요.

• 콘텐츠 제공자는 더 이상 기본적으로 내보내지 않습니다. 즉, android:exported 속성의 기본값은 이제 “false"입니다. 다른 앱이 콘텐츠 제공자에 액세스할 수 있어야 한다면 이제 명시적으로 android:exported="true"를 설정해야 합니다.

  이 변경사항은 android:targetSdkVersion 또는 android:minSdkVersion을 17 이상으로 설정한 경우에만 적용됩니다. 그 외의 경우 Android 4.2 이상에서 실행되는 경우에도 기본값은 여전히 “true"입니다.

• 이전 버전의 Android와 비교할 때 앱에서 ACCESS_COARSE_LOCATION 권한을 요청하지만 ACCESS_FINE_LOCATION 권한을 요청하지 않으면 사용자 위치 결과의 정확도가 떨어질 수 있습니다.

  앱에서 상세 위치가 아닌 대략적인 위치에 관한 권한을 요청할 때 사용자의 개인 정보 보호 기대치를 충족하기 위해 시스템은 도시 블록보다 정확한 사용자 위치 추정치를 제공하지 않습니다.

• Settings.System에 의해 정의된 일부 기기 설정이 이제 읽기 전용입니다. 앱이 Settings.System에 정의되어 있고 Settings.Global로 이동한 설정의 변경사항을 쓰려고 하면 Android 4.2 이상에서 실행될 때 쓰기 작업이 자동으로 실패합니다.

  android:targetSdkVersion 및 android:minSdkVersion 값이 17보다 작더라도 앱은 Android 4.2 이상에서 실행할 때 Settings.Global로 이동한 설정을 수정할 수 없습니다.

• 앱에서 WebView를 사용하는 경우 Android 4.2는 추가 보안 계층을 추가하므로 더 안전하게 자바스크립트를 Android 코드에 결합할 수 있습니다. targetSdkVersion을 17 이상으로 설정한 경우 이제 JavaScript에서 사용할 수 있도록 하려는 모든 메서드에 @JavascriptInterface 주석을 추가해야 합니다 (메서드도 공개 메서드여야 함). 주석을 제공하지 않으면 Android 4.2 이상에서 실행될 때 WebView의 웹페이지에서 메서드에 액세스할 수 없습니다. targetSdkVersion을 16 이하로 설정하면 주석이 필요하지 않지만, 보안 강화를 위해 타겟 버전을 업데이트하고 주석을 추가하는 것이 좋습니다.

  Android 코드에 JavaScript 코드 결합에 관해 자세히 알아보세요.

Daydream

Daydream은 Android 기기용 새로운 대화형 화면 보호기 모드입니다. 기기가 도크에 삽입되거나 충전기에 연결되어 있는 동안 유휴 상태일 때 (화면이 꺼지지 않음) 자동으로 활성화됩니다. Daydream은 한 번에 하나의 꿈을 표시하며, 순전히 시각적인 수동 디스플레이로 터치 시 닫히거나 대화형으로 전체 입력 이벤트 모음에 반응할 수도 있습니다. 꿈은 앱의 프로세스에서 실행되며 뷰, 레이아웃, 애니메이션을 비롯한 Android UI 도구 키트에 대한 전체 액세스 권한을 가지므로 라이브 배경화면이나 앱 위젯보다 유연하고 강력합니다.

DreamService의 서브클래스를 구현하여 Daydream의 꿈을 만들 수 있습니다. DreamService API는 Activity의 API와 유사하게 설계되었습니다. 창의 UI를 지정하려면 창이 생성된 후 언제든지(예: onAttachedToWindow() 콜백에서) 레이아웃 리소스 ID 또는 View를 setContentView()에 전달합니다.

DreamService 클래스는 기본 Service API 외에 다른 중요한 수명 주기 콜백 메서드(예: onDreamingStarted(), onDreamingStopped(), onDetachedFromWindow())를 제공합니다. 앱에서 DreamService를 시작할 수는 없습니다. 시스템에 의해 자동으로 시작됩니다.

꿈이 대화형인 경우 드림에서 활동을 시작하여 사용자를 앱의 전체 UI로 보내 더 자세히 알아보거나 제어할 수 있습니다. 사용자가 새 활동을 볼 수 있도록 finish()를 사용하여 드림을 종료할 수 있습니다.

시스템에서 Daydream을 사용할 수 있도록 하려면 매니페스트 파일에서 <service> 요소를 사용하여 DreamService를 선언합니다. 그런 다음 "android.service.dreams.DreamService" 작업과 함께 인텐트 필터를 포함해야 합니다. 예:

<service android:name=".MyDream" android:exported="true"
    android:icon="@drawable/dream_icon" android:label="@string/dream_label" >
    <intent-filter>
        <action android:name="android.service.dreams.DreamService" />
        <category android:name="android.intent.category.DEFAULT" />
    </intent-filter>
</service>

DreamService에는 알고 있어야 할 다른 유용한 메서드가 있습니다.

• setInteractive(boolean)은 꿈이 입력 이벤트를 수신할지 아니면 사용자 입력 즉시 종료되는지를 제어합니다. 드림이 대화형인 경우 사용자는 뒤로 또는 홈 버튼을 사용하여 드림을 종료하거나 finish()를 호출하여 드림을 중지할 수 있습니다.
• 몰입도 높은 디스플레이를 원하는 경우 setFullscreen()를 호출하여 상태 표시줄을 숨길 수 있습니다.
• Daydream이 시작되기 전에 유휴 시간 제한에 가까워지고 있음을 사용자에게 알리기 위해 디스플레이가 어두워집니다. setScreenBright(true)를 호출하면 디스플레이를 평소의 밝기로 설정할 수 있습니다.

자세한 내용은 DreamService 문서를 참조하세요.

보조 디스플레이

이제 Android에서 앱이 유선 연결이나 Wi-Fi를 통해 사용자 기기에 연결된 추가 화면에 고유한 콘텐츠를 표시할 수 있습니다. 보조 디스플레이를 위한 고유한 콘텐츠를 생성하려면 Presentation 클래스를 확장하고 onCreate() 콜백을 구현합니다. onCreate() 내에서 setContentView()를 호출하여 보조 디스플레이의 UI를 지정합니다. Dialog 클래스의 확장 프로그램인 Presentation 클래스는 앱이 보조 디스플레이에 고유한 UI를 표시할 수 있는 영역을 제공합니다.

Presentation를 표시할 수 있는 보조 디스플레이를 감지하려면 DisplayManager 또는 MediaRouter API를 사용합니다. DisplayManager API를 사용하면 한 번에 연결할 수 있는 여러 디스플레이를 열거할 수 있지만, 일반적으로 프레젠테이션을 위한 시스템의 기본 디스플레이에 빠르게 액세스하려면 대신 MediaRouter를 사용해야 합니다.

프레젠테이션의 기본 디스플레이를 가져오려면 MediaRouter.getSelectedRoute()을 호출하고 ROUTE_TYPE_LIVE_VIDEO를 전달합니다. 이렇게 하면 시스템에서 현재 선택된 동영상 프레젠테이션 경로를 설명하는 MediaRouter.RouteInfo 객체가 반환됩니다. MediaRouter.RouteInfo가 null이 아니면 getPresentationDisplay()를 호출하여 연결된 디스플레이를 나타내는 Display를 가져옵니다.

그런 다음 Display 객체를 Presentation 클래스의 생성자에 전달하여 프레젠테이션을 표시할 수 있습니다. 이제 프레젠테이션이 보조 디스플레이에 표시됩니다.

새 디스플레이가 연결되었을 때 런타임 시 감지하려면 새 프레젠테이션 디스플레이가 연결될 때 시스템에서 호출하는 onRoutePresentationDisplayChanged() 콜백 메서드를 구현하는 MediaRouter.SimpleCallback의 인스턴스를 만듭니다. 그런 다음 ROUTE_TYPE_LIVE_VIDEO 경로 유형과 함께 MediaRouter.addCallback()에 전달하여 MediaRouter.SimpleCallback를 등록합니다. onRoutePresentationDisplayChanged() 호출을 수신하면 위에서 언급한 대로 MediaRouter.getSelectedRoute()를 호출하기만 하면 됩니다.

Presentation에서 보조 화면에 맞게 UI를 더욱 최적화하려면 애플리케이션 또는 활동에 적용한 <style>에서 android:presentationTheme 속성을 지정하여 다른 테마를 적용하면 됩니다.

사용자 기기에 연결된 화면은 대개 화면 크기가 크고 화면 밀도가 다를 수 있습니다. 화면 특성이 다를 수 있으므로 큰 디스플레이에 특별히 최적화된 리소스를 제공해야 합니다. Presentation에서 추가 리소스를 요청해야 한다면 getContext().getResources()를 호출하여 디스플레이에 상응하는 Resources 객체를 가져옵니다. 이렇게 하면 보조 디스플레이의 화면 크기와 밀도에 가장 적합한 앱의 적절한 리소스가 제공됩니다.

자세한 내용과 일부 코드 샘플은 Presentation 클래스 문서를 참고하세요.

잠금 화면 위젯

이제 Android에서는 사용자가 잠금 화면에 앱 위젯을 추가할 수 있습니다. 앱 위젯을 잠금 화면에서 사용할 수 있도록 하려면 AppWidgetProviderInfo를 지정하는 android:widgetCategory 속성을 XML 파일에 추가합니다. 이 속성은 home_screen과 keyguard의 두 가지 값을 지원합니다. 기본적으로 이 속성은 home_screen로 설정되므로 사용자가 홈 화면에 앱 위젯을 추가할 수 있습니다. 잠금 화면에서도 앱 위젯을 사용할 수 있도록 하려면 keyguard 값을 추가합니다.

<appwidget-provider xmlns:android="http://schemas.android.com/apk/res/android"
    ...
    android:widgetCategory="keyguard|home_screen">
</appwidget-provider>

또한 잠금 화면에 있을 때 앱 위젯의 초기 레이아웃을 android:initialKeyguardLayout 속성을 사용하여 지정해야 합니다. 이는 앱 위젯이 초기화되고 레이아웃을 업데이트할 수 있을 때까지 즉시 표시될 수 있는 레이아웃을 제공한다는 점에서 android:initialLayout과 동일하게 작동합니다.

잠금 화면에 있을 때 앱 위젯의 크기를 적절하게 조정하는 등 잠금 화면용 앱 위젯을 빌드하는 방법에 관한 자세한 내용은 앱 위젯 가이드를 참고하세요.

여러 사용자

이제 Android는 태블릿과 같이 공유 가능한 기기에서 여러 사용자 공간을 허용합니다. 기기의 각 사용자에게는 자체 계정, 앱, 시스템 설정, 파일 및 기타 사용자 관련 데이터 세트가 있습니다.

앱 개발자가 하나의 기기에서 여러 사용자와 앱이 제대로 작동하기 위해 별도로 취해야 할 조치는 없습니다. 기기에 있는 사용자 수와 관계없이 특정 사용자를 위해 앱이 저장하는 데이터는 앱이 다른 사용자를 위해 저장하는 데이터와 별도로 유지됩니다. 시스템은 어떤 사용자 데이터가 앱이 실행되는 사용자 프로세스에 속하는지 추적하고, 앱이 해당 사용자의 데이터에만 액세스할 수 있도록 하고 다른 사용자의 데이터에는 액세스를 허용하지 않습니다.

멀티 사용자 환경에 데이터 저장

앱이 사용자 환경설정을 저장하거나, 데이터베이스를 만들거나, 사용자의 내부 또는 외부 저장소 공간에 파일을 쓸 때마다 해당 데이터는 해당 사용자로 실행되는 동안에만 액세스할 수 있습니다.

앱이 멀티 사용자 환경에서 제대로 작동하도록 하려면 하드 코딩된 경로를 사용하여 내부 앱 디렉터리나 외부 저장소 위치를 참조하지 말고 대신 항상 적절한 API를 사용하세요.

• 내부 저장소에 액세스하려면 getFilesDir(), getCacheDir() 또는 openFileOutput()를 사용합니다.
• 외부 저장소에 액세스하려면 getExternalFilesDir() 또는 getExternalStoragePublicDirectory()를 사용합니다.

이러한 API 중 어떤 API를 사용하여 특정 사용자의 데이터를 저장하든, 다른 사용자로 실행하는 동안에는 데이터에 액세스할 수 없습니다. 앱의 관점에서 각 사용자는 완전히 별도의 기기에서 실행됩니다.

멀티 사용자 환경에서 사용자 식별

앱에서 분석을 수집하거나 다른 계정 연결을 만드는 등 순 사용자를 식별하려면 고유 설치 식별 권장사항을 따라야 합니다. 앱을 처음 시작할 때 새 UUID를 만들면 단일 기기에 앱을 설치한 사용자 수와 관계없이 각 사용자를 추적하기 위한 고유 ID를 얻을 수 있습니다. 또는 서버에서 가져온 로컬 토큰을 저장하거나 Google 클라우드 메시징에서 제공하는 등록 ID를 사용할 수 있습니다.

앱에서 하드웨어 기기 식별자 (예: Wi-Fi MAC 주소 또는 SERIAL 번호) 중 하나를 요청하면 이러한 식별자는 각 사용자에게 동일한 값을 제공합니다. 이러한 식별자는 사용자가 아닌 하드웨어와 연결되어 있기 때문입니다. 앱 설치 식별 블로그 게시물에서 설명한 대로 이러한 식별자로 인해 발생하는 다른 문제는 말할 것도 없습니다.

새 전체 설정

Settings.Global를 추가하여 여러 사용자를 지원할 수 있도록 시스템 설정이 업데이트되었습니다. 이 설정 모음은 읽기 전용이지만 기기의 모든 사용자 공간에 전역적으로 적용된다는 점에서 Settings.Secure 설정과 유사합니다.

여러 기존 설정이 Settings.System 또는 Settings.Secure에서 여기로 재배치되었습니다. 앱이 현재 이전에 Settings.System에 정의된 설정(예: AIRPLANE_MODE_ON)을 변경하고 있다면 이러한 설정이 Settings.Global로 옮겨졌다면 Android 4.2 이상을 실행하는 기기에서 더 이상 변경사항이 작동하지 않습니다. Settings.Global에 있는 설정을 계속 읽을 수 있지만, 설정이 더 이상 앱에서 변경하기에 안전하지 않은 것으로 간주되기 때문에 그렇게 하려고 하면 자동으로 실패하고 Android 4.2 이상에서 앱을 실행할 때 시스템이 시스템 로그에 경고를 씁니다.

RTL 레이아웃 지원

Android는 이제 아랍어, 히브리어 등 오른쪽에서 왼쪽 (RTL) UI와 읽기 방향을 사용하는 언어를 지원하도록 레이아웃 방향을 적절하게 변환하는 사용자 인터페이스를 빌드할 수 있는 여러 API를 제공합니다.

앱에서 RTL 레이아웃 지원을 시작하려면 매니페스트 파일에서 android:supportsRtl 속성을 <application> 요소로 설정하고 “true"로 설정합니다. 이 API를 사용 설정하면 시스템은 다양한 RTL API를 통해 앱을 RTL 레이아웃으로 표시할 수 있습니다. 예를 들어 작업 모음은 오른쪽에 아이콘과 제목을 표시하고 왼쪽에 작업 버튼을 표시하고 프레임워크에서 제공하는 View 클래스를 사용하여 만든 레이아웃도 모두 취소됩니다.

RTL 레이아웃으로 표시될 때 앱의 모양을 추가로 최적화해야 하는 경우 다음과 같은 두 가지 기본 최적화 수준이 있습니다.

1. 왼쪽 및 오른쪽 레이아웃 속성을 시작 및 끝 방향 레이아웃 속성으로 변환합니다.

   예를 들어 android:layout_marginLeft 대신 android:layout_marginStart를 사용하고 android:layout_marginRight 대신 android:layout_marginEnd를 사용합니다.

   RelativeLayout 클래스는 왼쪽/오른쪽 위치를 대체하는 상응하는 레이아웃 속성도 제공합니다. 예를 들어 android:layout_toLeftOf 대신 android:layout_alignParentLeft 및 android:layout_toStartOf를 대체하는 android:layout_alignParentStart를 제공합니다.

2. 또는 RTL 레이아웃을 완전히 최적화하기 위해 ldrtl 리소스 한정자 (ldrtl는 layout-direction-right-to-left를 의미함)를 사용하여 완전히 별도의 레이아웃 파일을 제공할 수 있습니다. 예를 들어 기본 레이아웃 파일을 res/layout/에 저장하고 RTL 최적화 레이아웃을 res/layout-ldrtl/에 저장할 수 있습니다.

   ldrtl 한정자는 드로어블 리소스에 적합하므로 읽기 방향에 해당하는 방향의 그래픽을 제공할 수 있습니다.

맞춤 뷰의 적절한 동작을 구현할 수 있도록 View 클래스에서, 현재 레이아웃 방향을 쿼리하는 Configuration에서와 같이, 프레임워크 전반에서 RTL 레이아웃을 지원하기 위해 다양한 기타 API를 사용할 수 있습니다.

참고: SQlite를 사용 중이며 테이블 또는 열 이름이 '숫자만'인 경우 주의해야 합니다. String.format(String, Object...)를 사용하면 기기가 아랍어 언어로 설정된 경우 숫자가 아랍어와 동등한 값으로 변환되는 오류가 발생할 수 있습니다. 숫자가 ASCII로 유지되도록 하려면 String.format(Locale,String,Object...)를 사용해야 합니다. 또한 숫자 형식을 지정하는 데 String.valueOf(int)를 사용하는 대신 String.format("%d", int)를 사용합니다.

중첩된 프래그먼트

이제 프래그먼트 안에 프래그먼트를 삽입할 수 있습니다. 이는 재사용 가능한 동적 UI 구성요소를 그 자체가 동적이고 재사용 가능한 UI 구성요소에 배치하려는 다양한 상황에 유용합니다. 예를 들어 ViewPager를 사용하여 왼쪽과 오른쪽으로 스와이프하고 화면 공간의 대부분을 사용하는 프래그먼트를 만드는 경우 이제 각 프래그먼트 페이지에 프래그먼트를 삽입할 수 있습니다.

프래그먼트를 중첩하려면 프래그먼트를 추가하려는 Fragment에서 getChildFragmentManager()를 호출하기만 하면 됩니다. 이렇게 하면 프래그먼트 트랜잭션을 만들기 위해 최상위 수준 활동에서 일반적으로 하는 것처럼 사용할 수 있는 FragmentManager가 반환됩니다. 예를 들어 다음은 기존 Fragment 클래스 내에서 프래그먼트를 추가하는 코드입니다.

val videoFragment = VideoPlayerFragment()
childFragmentManager.beginTransaction().apply {
    add(R.id.video_fragment, videoFragment)
    commit()
}

Fragment videoFragment = new VideoPlayerFragment();
FragmentTransaction transaction = getChildFragmentManager().beginTransaction();
transaction.add(R.id.video_fragment, videoFragment).commit();

중첩된 프래그먼트 내에서 getParentFragment()를 호출하여 상위 프래그먼트 참조를 가져올 수 있습니다.

이제 Android 지원 라이브러리에서 중첩된 프래그먼트도 지원하므로 Android 1.6 이상에서 중첩 프래그먼트 디자인을 구현할 수 있습니다.

참고: 레이아웃에 <fragment>가 포함된 경우 이 레이아웃을 프래그먼트로 확장할 수 없습니다. 중첩된 프래그먼트는 프래그먼트에 동적으로 추가될 때만 지원됩니다.

Renderscript

Renderscript 계산 기능이 다음 기능으로 개선되었습니다.

스크립트 내장 기능

다음과 같은 일반적인 작업을 구현하는 Renderscript의 내장 스크립트 내장 기능을 사용할 수 있습니다.

• Blends
• Blur
• Color matrix
• 3x3 convolve
• 5x5 convolve
• Per-channel lookup table
• Converting an Android YUV buffer to RGB

스크립트 고유 기능을 사용하려면 각 내장 기능의 정적 create() 메서드를 호출하여 스크립트의 인스턴스를 만드세요. 그런 다음 각 스크립트 고유의 사용 가능한 set() 메서드를 호출하여 필요한 입력 및 옵션을 설정합니다. 마지막으로 forEach() 메서드를 호출하여 스크립트를 실행합니다.

스크립트 그룹

ScriptGroup를 사용하면 관련된 Renderscript 스크립트를 함께 연결하고 호출 한 번으로 실행할 수 있습니다.

ScriptGroup.Builder를 사용하고 addKernel()를 호출하여 모든 스크립트를 그룹에 추가합니다. 모든 스크립트를 추가한 후 addConnection()를 호출하여 스크립트 간의 연결을 생성합니다. 연결 추가를 완료했으면 create()를 호출하여 스크립트 그룹을 만듭니다. 스크립트 그룹을 실행하기 전에 setInput(Script.KernelID, Allocation) 메서드로 실행할 입력 Allocation 및 초기 스크립트를 지정하고 결과가 기록될 Allocation 출력과 setOutput()로 실행할 최종 스크립트를 제공합니다. 마지막으로 execute()를 호출하여 스크립트 그룹을 실행합니다.

Filterscript

Filterscript는 결과 코드를 더 다양한 프로세서 (CPU, GPU, DSP)에서 실행할 수 있도록 기존 Renderscript API의 제약 조건을 정의합니다. Filterscript 파일을 만들려면 .rs 파일 대신 .fs 파일을 만들고 #pragma rs_fp_relaxed를 지정하여 Renderscript 런타임에 스크립트에 엄격한 IEEE 754-2008 부동 소수점 정밀도가 필요하지 않음을 알립니다. 이 정밀도는 플러시-제로(Few-to-zero)(비정상의 경우 0으로 플러시하고 0에 가까운 라운드 운임)를 허용합니다. 또한 Filterscript 스크립트는 32비트 내장 유형을 사용해서는 안 되며 __attribute__((kernel)) 속성을 사용하여 커스텀 루트 함수를 지정해야 합니다. Filterscript는 root() 함수의 기본 서명이 정의하는 포인터를 지원하지 않기 때문입니다.

참고: Filterscript는 플랫폼에서 지원되지만 SDK 도구 출시 21.0.1부터 개발자 지원이 제공됩니다.

Android 4.2의 모든 API 변경사항에 관한 자세한 내용은 API 차이점 보고서를 참고하세요.