컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
문법:
<activity android:allowEmbedded=["true" | "false"]
          android:allowTaskReparenting=["true" | "false"]
          android:alwaysRetainTaskState=["true" | "false"]
          android:autoRemoveFromRecents=["true" | "false"]
          android:banner="drawable resource"
          android:clearTaskOnLaunch=["true" | "false"]
          android:colorMode=[ "hdr" | "wideColorGamut"]
          android:configChanges=["mcc", "mnc", "locale",
                                 "touchscreen", "keyboard", "keyboardHidden",
                                 "navigation", "screenLayout", "fontScale",
                                 "uiMode", "orientation", "density",
                                 "screenSize", "smallestScreenSize"]
          android:directBootAware=["true" | "false"]
          android:documentLaunchMode=["intoExisting" | "always" |
                                  "none" | "never"]
          android:enabled=["true" | "false"]
          android:excludeFromRecents=["true" | "false"]
          android:exported=["true" | "false"]
          android:finishOnTaskLaunch=["true" | "false"]
          android:hardwareAccelerated=["true" | "false"]
          android:icon="drawable resource"
          android:immersive=["true" | "false"]
          android:label="string resource"
          android:launchMode=["standard" | "singleTop" |
                              "singleTask" | "singleInstance" | "singleInstancePerTask"]
          android:lockTaskMode=["normal" | "never" |
                              "if_whitelisted" | "always"]
          android:maxRecents="integer"
          android:maxAspectRatio="float"
          android:multiprocess=["true" | "false"]
          android:name="string"
          android:noHistory=["true" | "false"]  
          android:parentActivityName="string" 
          android:persistableMode=["persistRootOnly" | 
                                   "persistAcrossReboots" | "persistNever"]
          android:permission="string"
          android:process="string"
          android:relinquishTaskIdentity=["true" | "false"]
          android:resizeableActivity=["true" | "false"]
          android:screenOrientation=["unspecified" | "behind" |
                                     "landscape" | "portrait" |
                                     "reverseLandscape" | "reversePortrait" |
                                     "sensorLandscape" | "sensorPortrait" |
                                     "userLandscape" | "userPortrait" |
                                     "sensor" | "fullSensor" | "nosensor" |
                                     "user" | "fullUser" | "locked"]
          android:showForAllUsers=["true" | "false"]
          android:stateNotNeeded=["true" | "false"]
          android:supportsPictureInPicture=["true" | "false"]
          android:taskAffinity="string"
          android:theme="resource or theme"
          android:uiOptions=["none" | "splitActionBarWhenNarrow"]
          android:windowSoftInputMode=["stateUnspecified",
                                       "stateUnchanged", "stateHidden",
                                       "stateAlwaysHidden", "stateVisible",
                                       "stateAlwaysVisible", "adjustUnspecified",
                                       "adjustResize", "adjustPan"] >   
    . . .
</activity>
포함된 위치:
<application>
포함 가능한 요소:
<intent-filter>
<meta-data>
<layout>
설명
애플리케이션의 시각적 사용자 인터페이스 요소를 구현하는 활동(Activity 서브클래스)을 선언합니다. 모든 활동은 매니페스트 파일의 <activity> 요소로 나타내야 합니다. 여기에 선언되지 않은 활동은 시스템에 표시되지 않으며 실행되지 않습니다.
속성
android:allowEmbedded
활동이 다른 활동의 삽입된 하위 요소로 실행될 수 있음을 나타냅니다. 특히 하위 요소가 다른 활동이 소유하는 Display와 같은 컨테이너에 상주하는 경우에 그러합니다. 예를 들어 Wear 맞춤 알림용으로 사용되는 활동은 Wear가 다른 프로세스에 있는 컨텍스트 스트림에 활동을 표시할 수 있도록 이 속성을 선언해야 합니다.

이 속성의 기본값은 false입니다.

android:allowTaskReparenting
활동을 시작한 태스크에서 해당 태스크가 다음에 앞으로 나올 때 활동을 어피니티가 있는 그다음 태스크로 이동할 수 있는지를 나타냅니다. 이동할 수 있으면 'true', 시작한 태스크에 그대로 있어야 하면 'false'입니다.

이 속성을 설정하지 않는 경우 <application> 요소의 상응하는 allowTaskReparenting 속성에서 설정한 값이 활동에 적용됩니다. 기본값은 'false'입니다.

일반적으로 활동이 시작되면 활동을 시작한 태스크와 연결되어 전체 기간이 끝날 때까지 그대로 남아 있습니다. 이 속성을 사용하여 현재 태스크가 더 이상 표시되지 않을 때 활동의 상위 요소로 어피니티가 있는 태스크를 강제 재지정할 수 있습니다. 보통 애플리케이션의 활동을 애플리케이션과 관련된 주요 태스크로 이동시키기 위해 이 속성을 사용합니다.

예를 들어 이메일 메시지가 웹페이지 링크를 포함하는 경우 링크를 클릭하면 페이지를 표시할 수 있는 활동을 표시합니다. 이 활동은 브라우저 애플리케이션이 정의하지만 이메일 태스크의 일부로 실행됩니다. 상위 활동을 브라우저 태스크로 재지정할 경우 활동은 브라우저가 다음에 앞으로 올 때 표시되며 이메일 태스크가 다시 앞으로 올 때 표시되지 않습니다.

taskAffinity 속성이 활동의 어피니티를 정의합니다. 태스크의 어피니티는 루트 활동의 어피니티에 의해 결정됩니다. 따라서 정의상 루트 활동은 항상 어피니티가 같은 태스크에 있습니다. 시작 모드가 'singleTask' 또는 'singleInstance'인 활동은 태스크의 루트에만 있을 수 있으므로 상위 요소로의 재지정은 'standard' 및 'singleTop' 모드로 제한됩니다. launchMode 속성도 참고하세요.

android:alwaysRetainTaskState
시스템이 활동의 태스크 상태를 항상 유지관리하는지를 나타냅니다. 항상 유지관리하면 "true", 시스템이 특정 상황에서 태스크를 초기 상태로 재설정할 수 있으면 "false"입니다. 기본값은 'false'입니다. 이 속성은 태스크의 루트 활동에만 의미가 있습니다. 다른 모든 활동에서는 무시됩니다.

보통 시스템은 사용자가 홈 화면에서 태스크를 다시 선택하는 특정 상황에서 태스크를 지웁니다(루트 활동 위 스택에서 모든 활동을 제거함). 일반적으로 지우기는 사용자가 30분과 같이 특정 시간 동안 태스크를 방문하지 않는 경우 실행됩니다.

그러나 이 속성이 "true"인 경우 사용자는 도착 방법과 상관없이 항상 마지막 상태의 태스크로 돌아갑니다. 이는 예컨대 사용자가 손실을 원하지 않는 상태(예: 복수의 열린 탭)가 많은 웹브라우저와 같은 애플리케이션에서 유용합니다.

android:autoRemoveFromRecents
이 속성이 포함된 활동에서 시작한 태스크가 태스크의 마지막 활동이 완료될 때까지 개요 화면에서 유지되는지를 나타냅니다. 이 값이 true인 경우 태스크는 개요 화면에서 자동으로 제거됩니다. 이는 호출자의 FLAG_ACTIVITY_RETAIN_IN_RECENTS 사용을 재정의합니다. 부울 값('true' 또는 'false')이어야 합니다.
android:banner
연결된 항목에 확장 그래픽 배너를 제공하는 드로어블 리소스입니다. <activity> 태그와 함께 사용하여 특정 활동의 기본 배너를 제공하거나 <application> 태그와 함께 사용하여 모든 애플리케이션 활동의 배너를 제공합니다.

시스템에서는 배너를 사용하여 Android TV 홈 화면에서 앱을 나타냅니다. 배너는 홈 화면에서만 표시되므로 CATEGORY_LEANBACK_LAUNCHER 인텐트를 처리하는 활동이 있는 애플리케이션에서 배너를 지정해야 합니다.

이 속성은 이미지가 포함된 드로어블 리소스의 참조로 설정해야 합니다(예: "@drawable/banner"). 기본 배너는 없습니다.

자세히 알아보려면 TV 앱 시작하기에서 홈 화면 배너 제공을 참고하세요.

android:clearTaskOnLaunch
홈 화면에서 다시 시작할 때마다 루트 활동을 제외한 모든 활동을 태스크에서 제거할지 여부를 나타냅니다. 항상 루트 활동까지 태스크를 제거하면 'true', 제거하지 않으면 'false'입니다. 기본값은 'false'입니다. 이 속성은 새 태스크를 시작하는 활동(루트 활동)에만 의미가 있으며 태스크의 다른 모든 활동에서는 무시됩니다.

이 값이 'true'인 경우 사용자가 태스크를 다시 시작할 때마다 마지막으로 실행한 태스크와 상관없이 그리고 뒤로 버튼이나 버튼을 눌러 태스크 중인 화면을 떠났는지 여부와 상관없이 루트 활동으로 이동합니다. 이 값이 'false'인 경우 어떤 상황이 되면 경우에 따라 활동에서 태스크를 지울 수 있습니다(alwaysRetainTaskState 속성 참고).

예를 들어 사용자가 홈 화면에서 활동 P를 시작한 후 여기서 활동 Q로 이동한다고 가정해 보겠습니다. 그런 다음 사용자는 을 누르고 활동 P로 돌아갑니다. 일반적으로 사용자에게는 활동 Q가 표시됩니다. P의 태스크에서 마지막으로 실행했기 때문입니다. 그러나 P에서 이 플래그를 'true'로 설정하면 사용자가 홈 화면에서 활동 P를 실행할 때 이 위에 있는 모든 활동(이 경우 Q)이 삭제됩니다. 따라서 사용자가 태스크로 돌아갈 때 P만 표시됩니다.

이 속성과 allowTaskReparenting이 모두 'true'이면 상위 요소로 재지정할 수 있는 모든 활동은 어피니티를 공유하는 태스크로 이동됩니다. 그런 다음 위에 설명된 대로 나머지 활동이 삭제됩니다.

이 속성은 FLAG_ACTIVITY_RESET_TASK_IF_NEEDED가 설정되어 있지 않으면 무시됩니다.

android:colorMode

호환되는 기기에서 넓은 색 공간 모드로 활동이 표시되도록 요청합니다. 넓은 색 공간 모드에서 창은 SRGB 공간 밖을 렌더링하여 더욱 선명한 색을 표시할 수 있습니다. 기기가 넓은 색 공간 렌더링을 지원하지 않으면 이 속성은 아무런 효과가 없습니다. 넓은 색 모드 렌더링에 관한 자세한 내용은 넓은 색 콘텐츠로 그래픽 향상을 참고하세요.

android:configChanges
활동이 처리하는 구성 변경을 나열합니다. 구성 변경이 런타임에 발생하는 경우 기본적으로 활동이 종료되었다가 다시 시작하지만 이 속성을 사용하여 구성을 선언하면 활동이 다시 시작하는 것을 방지합니다. 그 대신 활동은 여전히 실행 상태에 있고 onConfigurationChanged() 메서드가 호출됩니다.

참고: 이 속성은 마지막 수단으로만 사용하고 가급적 사용하지 않아야 합니다. 구성 변경으로 인한 다시 시작을 적절히 처리하는 방법에 관한 자세한 내용은 런타임 변경 처리를 참고하세요.

다음 문자열의 일부 또는 전부는 이 속성의 유효한 값입니다. 여러 값이 '|'로 구분됩니다(예: 'locale|navigation|orientation').

설명
"density" 디스플레이 밀도가 변경되었습니다. 사용자가 다른 디스플레이 크기를 지정하였거나 다른 디스플레이가 활성화되었을 수 있습니다.

API 수준 24에 추가되었습니다.

"fontScale" 글꼴 배율이 변경되었습니다. 사용자가 새 전역 글꼴 크기를 선택했습니다.
"keyboard" 키보드 유형이 변경되었습니다. 예를 들어 사용자가 외부 키보드를 연결했습니다.
"keyboardHidden" 키보드 접근성이 변경되었습니다. 예를 들어 사용자가 하드웨어 키보드를 표시했습니다.
"layoutDirection" 레이아웃 방향이 예를 들어 '왼쪽에서 오른쪽으로(LTR)'에서 '오른쪽에서 왼쪽으로(RTL)'로 변경되었습니다.

API 수준 17에 추가되었습니다.

"locale" 언어가 변경되었습니다. 사용자가 텍스트를 표시할 새 언어를 선택했습니다.
"mcc" IMSI 모바일 국가 코드(MCC)가 변경되었습니다. SIM이 감지되었고 MCC를 업데이트했습니다.
"mnc" IMSI 모바일 네트워크 코드(MNC)가 변경되었습니다. SIM이 감지되었고 MNC를 업데이트했습니다.
"navigation" 탐색 유형(트랙볼/방향 패드)이 변경되었습니다. 이는 일반적으로 발생해서는 안 됩니다.
"orientation"

화면 방향이 변경되었습니다. 사용자가 기기를 회전했습니다.

참고: 애플리케이션이 Android 3.2(API 수준 13) 이상을 타겟팅하는 경우 "screenLayout""screenSize" 구성도 선언해야 합니다. 기기가 세로 방향과 가로 방향 간에 전환될 때 화면 레이아웃과 화면의 크기가 변경될 수도 있기 때문입니다.

'screenLayout' 화면 레이아웃이 변경되었습니다. 다른 디스플레이가 활성화되었을 수 있습니다.
"screenSize" 사용 가능한 현재 화면 크기가 변경되었습니다.

이는 현재 가로세로 비율에 비례하는 현재 사용 가능한 크기의 변경을 나타내므로 사용자가 가로 모드와 세로 모드 간에 전환할 때 변경됩니다.

API 수준 13에 추가되었습니다.

"smallestScreenSize" 물리적 화면 크기가 변경되었습니다.

이는 방향에 상관없는 크기 변경을 나타내므로 외부 디스플레이로 전환하는 등 실제 물리적 화면 크기가 변경될 때만 변경됩니다. 이 구성 변경은 smallestWidth 구성 변경에 상응합니다.

API 수준 13에 추가되었습니다.

"touchscreen" 터치스크린이 변경되었습니다. 이는 일반적으로 발생해서는 안 됩니다.
"uiMode" 사용자 인터페이스 모드가 변경되었습니다. 사용자가 기기를 책상 또는 차량용 도크에 놓았거나 야간 모드가 변경되었습니다. 각 UI 모드에 관한 자세한 내용은 UiModeManager를 참고하세요.

API 수준 8에 추가되었습니다.

이와 같은 모든 구성 변경은 애플리케이션이 표시하는 리소스 값에 영향을 미칠 수 있습니다. 따라서 onConfigurationChanged()를 호출할 경우 일반적으로 모든 리소스(예: 뷰 레이아웃, 드로어블 등)를 다시 검색하여 변경사항을 올바르게 처리해야 합니다.

참고: 모든 멀티 윈도우 관련 구성 변경을 처리하려면 "screenLayout""smallestScreenSize"를 모두 사용하세요. 멀티 윈도우는 Android 7.0(API 수준 24) 이상에서 지원됩니다.

android:directBootAware

활동이 직접 부팅을 인식하는지 나타냅니다. 즉, 사용자가 기기를 잠금 해제하기 전에 실행할 수 있는지를 나타냅니다.

참고: 직접 부팅 시 애플리케이션의 활동은 기기 보호 저장소에 저장된 데이터에만 액세스할 수 있습니다.

기본값은 "false"입니다.

android:documentLaunchMode
시작할 때마다 새 활동 인스턴스를 태스크에 추가하는 방법을 지정합니다. 이 속성을 통해 사용자가 동일한 애플리케이션의 다중 문서를 개요 화면에 표시할 수 있습니다.

이 속성에는 사용자가 애플리케이션으로 문서를 열 때 다음과 같은 효과를 낳는 네 가지 값이 있습니다.

설명
"intoExisting" 시스템이 기본 인텐트의 ComponentName 및 데이터 URI가 시작 인텐트의 이 두 항목과 일치하는 태스크를 검색합니다. 시스템이 이러한 태스크를 찾으면 시스템은 태스크를 지우고 onNewIntent(android.content.Intent) 호출을 수신하는 루트 활동으로 다시 시작합니다. 시스템이 이러한 태스크를 찾지 못하면 새 태스크를 만듭니다.
"always" 활동이 문서에 관해 새 태스크를 생성하며 이는 문서가 이미 열려 있는 경우라도 마찬가지입니다. 이는 FLAG_ACTIVITY_NEW_DOCUMENTFLAG_ACTIVITY_MULTIPLE_TASK 플래그를 모두 설정하는 것과 같습니다.
"none" 활동이 활동에 관해 새 태스크를 생성하지 않습니다. 이는 기본값이며 FLAG_ACTIVITY_NEW_TASK를 설정하는 경우에만 새 태스크를 생성합니다. 개요 화면은 활동을 기본 상태에서와 같이 다룹니다. 즉 앱의 단일 태스크를 표시하고 이때 사용자가 마지막으로 호출한 활동이 무엇이든 그 활동부터 다시 시작합니다.
"never" 이 활동은 인텐트가 FLAG_ACTIVITY_NEW_DOCUMENT를 포함하는 경우에도 새 문서에서 시작되지 않습니다. 이를 설정하면 FLAG_ACTIVITY_NEW_DOCUMENTFLAG_ACTIVITY_MULTIPLE_TASK 플래그 중 하나가 활동에 설정되어 있는 경우 이러한 플래그의 동작을 재정의하고 개요 화면은 앱의 단일 태스크를 표시하며 이때 사용자가 마지막으로 호출한 활동부터 다시 시작합니다.

참고: 'none' 및 'never' 외의 값에서는 활동을 launchMode="standard"로 정의해야 합니다. 이 속성을 지정하지 않으면 documentLaunchMode="none"이 사용됩니다.

android:enabled
시스템에서 활동을 인스턴스화할 수 있는지를 나타냅니다. 인스턴스화할 수 있으면 "true"이고 인스턴스화할 수 없으면 "false"입니다. 기본값은 'true'입니다.

<application> 요소에는 활동을 포함한 모든 애플리케이션 구성요소에 적용되는 자체 enabled 속성이 있습니다. 시스템에서 활동을 인스턴스화할 수 있으려면 <application> 속성과 <activity> 속성이 모두 'true'여야 합니다(기본적으로 두 속성 모두). 둘 중 하나가 "false"이면 인스턴스화할 수 없습니다.

android:excludeFromRecents
최근 사용한 애플리케이션 목록을 표시한 개요 화면에서 이 활동이 시작한 태스크를 제외해야 할지를 나타냅니다. 즉, 이 활동이 새 태스크의 루트 활동인 경우 이 속성은 최근 앱 목록에 태스크를 표시하지 않을지를 결정합니다. 목록에서 태스크를 제외해야 하는 경우 "true"로 설정하고 포함해야 하는 경우 "false"로 설정합니다. 기본값은 'false'입니다.

android:exported
이 요소는 다른 애플리케이션의 구성요소에서 활동을 시작할 수 있는지를 설정합니다.

  • "true"인 경우 모든 앱에서 활동에 액세스할 수 있으며 정확한 클래스 이름으로 활동을 시작할 수 있습니다.
  • 'false'인 경우 활동은 같은 애플리케이션의 구성요소나 사용자 ID가 같은 애플리케이션, 권한이 있는 시스템 구성요소에서만 시작될 수 있습니다. 이는 인텐트 필터가 없는 경우의 기본값입니다.

앱의 활동에 인텐트 필터가 포함되면 다른 앱에서 활동을 시작할 수 있도록 이 요소를 "true"로 설정합니다. 예를 들어 활동이 앱의 기본 활동이고 category 'android.intent.category.LAUNCHER'를 포함한 경우입니다.

이 요소가 'false'로 설정되어 있고 앱에서 활동을 시작하려고 하면 시스템에서 ActivityNotFoundException이 발생합니다.

이 속성 외에도 다른 애플리케이션에 활동 노출을 제한하는 방법이 있습니다. 권한을 사용하여 활동을 호출할 수 있는 외부 항목을 제한할 수도 있습니다(permission 속성 참고).

android:finishOnTaskLaunch
사용자가 활동의 작업을 다시 시작할 때마다(홈 화면에서 작업 선택) 활동의 기존 인스턴스를 종료해야 하는지(루트 활동 제외)를 나타냅니다. 종료해야 하면 'true', 종료할 필요가 없으면 'false'입니다. 기본값은 'false'입니다.

이 속성과 allowTaskReparenting이 모두 'true'이면 이 속성이 다른 속성에 우선합니다. 활동의 어피니티는 무시됩니다. 활동은 상위 요소로 재지정되지 않고 소멸됩니다.

이 속성은 FLAG_ACTIVITY_RESET_TASK_IF_NEEDED가 설정되지 않은 경우 무시됩니다.

android:hardwareAccelerated
이 활동에 하드웨어 가속 렌더링을 사용 설정해야 하는지 여부를 나타냅니다. 사용 설정해야 하면 'true', 사용 설정할 필요가 없으면 'false'입니다. 기본값은 'false'입니다.

Android 3.0부터는 하드웨어 가속 OpenGL 렌더기를 애플리케이션에 사용할 수 있으며 이를 통해 다양한 일반적인 2D 그래픽 작업의 성능을 향상할 수 있습니다. 하드웨어 가속 렌더기를 사용 설정하면 Canvas, Paint, Xfermode, ColorFilter, Shader, Camera의 대부분의 작업이 가속화됩니다. 그 결과, 프레임워크의 OpenGL 라이브러리를 명시적으로 사용하지 않는 애플리케이션에서도 애니메이션과 스크롤이 더 매끄러워지고 전반적인 응답성이 향상됩니다. 하드웨어 가속을 사용하려면 필요한 리소스가 늘어나므로 앱에서 더 많은 RAM을 사용합니다.

OpenGL 2D 작업의 일부만 가속화됩니다. 하드웨어 가속 렌더기를 사용 설정할 때는 애플리케이션을 테스트하여 오류 없이 렌더기를 사용할 수 있는지 확인하세요.

android:icon
활동을 나타내는 아이콘입니다. 화면에 활동을 표시해야 하는 경우 아이콘이 사용자에게 표시됩니다. 예를 들어 작업을 시작하는 활동의 아이콘이 런처 창에 표시됩니다. 이 아이콘은 라벨이 함께 붙는 경우가 많습니다(android:label 속성 참고).

이 속성은 이미지 정의가 포함된 드로어블 리소스의 참조로 설정해야 합니다. 이 속성이 설정되지 않은 경우 전체 애플리케이션에 지정된 아이콘이 대신 사용됩니다(<application> 요소의 icon 속성 참고).

활동의 아이콘은 여기에 설정되었는지 또는 <application> 요소에 의해 설정되었는지와 상관없이 활동의 모든 인텐트 필터의 기본 아이콘이기도 합니다(<intent-filter> 요소의 icon 속성 참고).

android:immersive
현재 활동의 몰입형 모드 설정을 지정합니다. android:immersive 속성이 앱 매니페스트 항목에서 이 활동에 true로 설정되면 ActivityInfo.flags 멤버는 항상 FLAG_IMMERSIVE 비트 세트를 가집니다. 이는 런타임에 setImmersive() 메서드를 사용하여 몰입형 모드를 변경하더라도 적용됩니다.
android:label
사용자가 읽을 수 있는 활동 라벨입니다. 사용자에게 활동을 표시해야 하는 경우 라벨이 화면에 표시됩니다. 라벨은 종종 활동 아이콘과 함께 표시됩니다.

이 속성을 설정하지 않으면 전체 애플리케이션에 설정된 라벨이 대신 사용됩니다(<application> 요소의 label 속성 참고).

활동의 라벨은 여기에 설정되었는지 또는 <application> 요소에 의해 설정되었는지와 상관없이 활동의 모든 인텐트 필터의 기본 라벨이기도 합니다(<intent-filter> 요소의 label 속성 참고).

라벨은 사용자 인터페이스의 다른 문자열처럼 현지화될 수 있도록 문자열 리소스의 참조로 설정해야 합니다. 하지만 애플리케이션을 개발하는 동안 편의를 위해 라벨을 원시 문자열로 설정할 수도 있습니다.

android:launchMode
활동을 시작하는 방법에 관한 안내입니다. 인텐트를 처리하기 위해 활동을 호출할 때 발생하는 것을 결정하기 위해 Intent 객체에서 활동 플래그(FLAG_ACTIVITY_* 상수)와 함께 작동하는 모드가 5개 있습니다. 그 모드는 다음과 같습니다.

'standard'
'singleTop'
'singleTask'
'singleInstance'
'singleInstancePerTask'

기본 모드는 'standard'입니다.

아래 표와 같이 모드는 두 가지 기본 그룹으로 분류되는데 'standard' 활동과 'singleTop' 활동이 한 그룹이고 'singleTask' 활동과 'singleInstance' 활동, 'singleInstancePerTask' 활동이 또 한 그룹입니다. 시작 모드가 'standard'나 'singleTop'인 활동은 여러 번 인스턴스화할 수 있습니다. 인스턴스는 아무 작업에나 속할 수 있으며 활동 작업의 아무 장소에나 위치할 수 있습니다. 일반적으로 인스턴스는 startActivity()를 호출한 작업에서 시작됩니다. 이는 인텐트 객체가 FLAG_ACTIVITY_NEW_TASK 안내를 포함하지 않는 경우에 해당하며 이때 여러 작업을 선택합니다. taskAffinity 속성을 참고하세요.

반면에 'singleTask', 'singleInstance' 및 'singleInstancePerTask' 활동의 동작은 서로 다릅니다. 'singleInstancePerTask'는 항상 활동 작업의 루트에 있습니다. 또한 기기는 "singleInstance" 활동의 인스턴스를 한 번에 하나만 가질 수 있는 반면 "singleInstancePerTask" 활동은 FLAG_ACTIVITY_MULTIPLE_TASK 또는 FLAG_ACTIVITY_NEW_DOCUMENT가 설정된 경우 다른 작업에서 여러 번 인스턴스화될 수 있습니다. 'singleTask' 실행 모드가 포함된 활동은 'singleInstance' 및 'singleInstancePerTask'의 동작을 결합합니다. 활동은 여러 번 인스턴스화될 수 있으며 동일한 taskAffinity 작업의 어느 곳에나 위치할 수 있습니다. 한편 기기는 활동 작업의 루트에서 'singleTask' 활동을 찾는 작업 하나만 보유할 수 있습니다.

"standard" 모드와 "singleTop" 모드는 한 가지 면에서만 서로 다릅니다. "standard" 활동의 새 인텐트가 있을 때마다 클래스의 새 인스턴스가 만들어져 이 인텐트에 응답합니다. 각 인스턴스는 단일 인텐트를 처리합니다. 마찬가지로 'singleTop' 활동의 새 인스턴스도 만들어져 새 인텐트를 처리할 수 있습니다. 다만 타겟 작업의 스택 상단에 이미 활동의 기존 인스턴스가 있는 경우 이 인스턴스는 새 인텐트를 수신하게 되며(onNewIntent() 호출에서) 새 인스턴스는 생성되지 않습니다. 다른 상황을 예로 들면 "singleTop" 활동의 기존 인스턴스가 스택 상단이 아니라 타겟 작업에 있는 경우 또는 스택 상단에 있지만 타겟 작업에는 없는 경우 새 인스턴스가 생성되고 스택에 푸시됩니다.

마찬가지로 현재 스택에서 활동으로 위로 탐색하면 상위 활동의 시작 모드가 동작을 결정합니다. 상위 활동의 시작 모드가 singleTop인 경우(또는 up 인텐트가 FLAG_ACTIVITY_CLEAR_TOP을 포함하는 경우) 상위 활동은 스택 상단으로 이동하고 상태는 보존됩니다. 상위 활동의 onNewIntent() 메서드가 탐색 인텐트를 수신합니다. 상위 활동의 시작 모드가 standard인 경우(그리고 up 인텐트가 FLAG_ACTIVITY_CLEAR_TOP을 포함하지 않는 경우) 현재 활동 및 그 상위 활동이 모두 스택에서 갑자기 사라지며 상위 활동의 새 인스턴스가 탐색 인텐트를 수신하도록 생성됩니다.

또한, 'singleInstance' 모드는 단 한 가지 측면에서 'singleTask' 및 'singleInstancePerTask'와 다릅니다. 시작 모드가 'singleTask' 또는 'singleInstancePerTask'인 활동을 사용하면 다른 활동('standard'와 'singleTop' 활동 필수)이 작업의 일부가 될 수 있습니다. 반면 'singleInstance' 활동은 다른 활동이 작업의 일부가 되는 것을 허용하지 않습니다. 이 활동이 작업의 유일한 활동이어야 합니다. 다른 활동을 시작하면 그 활동은 FLAG_ACTIVITY_NEW_TASK가 인텐트에 있던 것처럼 다른 작업에 할당됩니다.

사용 사례 시작 모드 다중 인스턴스? 주석
대다수 활동의 일반적인 시작 "standard" 기본값입니다. 시스템은 항상 타겟 작업에 새 활동 인스턴스를 생성하여 인텐트를 인스턴스로 라우팅합니다.
"singleTop" 조건부 활동의 인스턴스가 이미 타겟 작업의 맨 위에 존재하는 경우 시스템은 새 활동 인스턴스를 생성하는 대신 onNewIntent() 메서드를 호출하여 인텐트를 기존 인스턴스로 라우팅합니다.
특수한 시작
(일반 용도에는 권장되지 않음)
"singleTask" 조건부 시스템은 새 작업의 루트에서 활동을 만들거나 같은 어피니티를 사용하여 기존 작업에서 활동을 찾습니다. 활동의 인스턴스가 이미 존재하고 작업의 루트에 있으면 시스템은 새 메서드를 만드는 대신 onNewIntent() 메서드를 호출하여 인텐트를 기존 인스턴스로 라우팅합니다.
"singleInstance" 아니요 singleTask"와 동일하지만 시스템이 인스턴스를 보유한 작업으로는 어떤 다른 활동도 실행하지 않는다는 점이 다릅니다. 활동은 항상 작업의 유일한 단일 멤버입니다.
"singleInstancePerTask" 조건부 이 활동은 작업의 루트 활동, 즉 작업을 생성한 첫 번째 활동으로서만 실행될 수 있습니다. 따라서, 작업에는 이 활동의 인스턴스가 하나만 존재하게 되지만, 활동은 서로 다른 작업에서 여러 번 인스턴스화될 수 있습니다.

위 표와 같이 standard는 기본 모드이며 대부분의 활동 유형에 적합합니다. SingleTop도 여러 활동 유형에 유용한 일반적인 시작 모드입니다. 다른 모드인 singleTask, singleInstance, singleInstancePerTask대부분의 애플리케이션에 적합하지 않습니다. 사용자에게 친숙하지 않고 대부분의 다른 애플리케이션과 매우 다른 상호작용 모델을 사용하기 때문입니다.

어떤 모드에서 시작하였든 시작하는 동안 그리고 뒤로 버튼을 사용하여 다른 활동 및 작업에서 다시 이동할 때 활동의 사용성을 테스트해야 합니다.

시작 모드 및 인텐트 플래그와의 상호작용에 관한 자세한 내용은 작업 및 백 스택 문서를 참고하세요.

android:lockTaskMode
기기가 잠금 작업 모드에서 실행 중일 때 시스템이 이 활동을 표시하는 방법을 결정합니다.

Android는 일명 잠금 작업 모드라는 몰입형, 키오스크와 유사한 방식으로 작업을 실행할 수 있습니다. 시스템이 잠금 작업 모드로 실행되면 기기 사용자는 보통 알림을 보거나 허용 목록에 없는 앱에 액세스하거나 홈 화면으로 돌아가는 작업을 할 수 없게 됩니다(다만 홈 앱이 허용 목록에 등록된 경우는 제외). 시스템이 잠금 작업 모드일 때는 기기 정책 컨트롤러(DPC)가 허용 목록으로 등록한 앱만 실행할 수 있습니다. 그러나 시스템과 권한이 있는 앱은 허용 목록에 등록되지 않아도 작업 잠금 모드에서 실행할 수 있습니다.

이 값은 다음 R.attr.lockTaskMode 문자열 값 중 하나가 됩니다.

설명
"normal" 기본값. 기본값입니다. 작업이 잠금 작업 모드에서 시작되지 않지만 startLockTask()를 호출하면 들어갈 수 있습니다.
"never"

작업은 잠금 작업 모드로 시작되지 않으며 기기 사용자는 개요 화면에 이러한 작업을 고정할 수 없습니다.

참고: 이 모드는 시스템 및 권한이 있는 애플리케이션에서만 사용할 수 있습니다. 이 값이 있지만 권한이 없는 앱은 normal로 간주합니다.

"if_whitelisted" DPC가 DevicePolicyManager.setLockTaskPackages()를 사용하여 이 패키지를 승인하면 이 모드가 always와 동일해집니다. 다만 활동이 마지막으로 잠긴 작업인 경우 stopLockTask()를 호출해야 종료할 수 있게 됩니다. DPC가 이 패키지를 승인하지 않으면 이 모드는 normal과 동일합니다.
"always"

이 활동에 루팅된 작업은 언제나 작업 잠금 모드로 시작됩니다. 이 작업이 시작되었을 때 시스템이 이미 잠금 작업 모드인 경우 새 작업은 현재 작업 위에서 시작됩니다. 이 모드로 시작된 작업은 finish()를 호출하여 잠금 작업 모드를 종료할 수 있습니다.

참고: 이 모드는 시스템 및 권한이 있는 애플리케이션에서만 사용할 수 있습니다. 이 값이 있지만 권한이 없는 앱은 normal로 간주합니다.

이 속성은 API 수준 23에서 도입되었습니다.

android:maxRecents
개요 화면에서 이 활동에 루팅된 작업의 최대 개수입니다. 이 항목 개수에 도달하면 시스템이 가장 오래전에 사용한 인스턴스를 개요 화면에서 제거합니다. 유효한 값은 1~50입니다(메모리가 적은 기기의 경우 최대 25). 0은 유효하지 않습니다. 이 값은 정수여야 합니다(예: 50). 기본값은 16입니다.
android:maxAspectRatio

액티비티가 지원하는 최대 화면비입니다. 앱이 더 넓은 가로세로 비율을 가진 기기에서 작동하는 경우 시스템에서는 앱을 자동으로 레터박스 처리하여 화면 중 일부를 미사용 상태로 두고 앱이 지정된 최대 가로세로 비율에서 작동할 수 있게 합니다.

최대 가로세로 비율은 기기의 긴 길이를 짧은 길이로 나눈 몫을 소수점 형식으로 표현합니다. 예를 들어 최대 가로세로 비율이 7:3이라면 이 속성의 값은 2.33으로 설정합니다.

웨어러블 기기가 아닌 경우 이 속성 값은 1.33 이상이어야 합니다. 웨어러블 기기의 경우 1.0 이상이어야 합니다. 그렇지 않으면 시스템은 설정값을 무시합니다.

참고: 활동의 resizeableActivity가 true로 설정되어 있으면 활동이 모든 크기를 지원한다는 것을 의미하므로 이 속성은 무시됩니다.

이 속성에 관한 자세한 내용은 제한된 화면 지원 선언최대 가로세로 비율 선언을 참고하세요.

android:multiprocess
활동 인스턴스가 이를 시작한 구성요소의 프로세스로 실행될 수 있는지 여부입니다. 실행될 수 있으면 "true", 없으면 "false"입니다. 기본값은 'false'입니다.

일반적으로 새 활동 인스턴스는 이를 정의한 애플리케이션의 프로세스로 시작되므로 모든 활동 인스턴스가 동일한 프로세스에서 실행됩니다. 그러나 이 플래그를 'true'로 설정하는 경우 활동 인스턴스는 다중 프로세스에서 실행될 수 있으며 시스템이 사용되는 곳과 상관없이 인스턴스를 생성할 수 있습니다(권한이 있는 경우). 이는 거의 필요하지 않거나 바람직하지 않습니다.

android:name
활동을 구현하는 클래스(Activity의 서브클래스)의 이름입니다. 속성 값은 정규화된 클래스 이름(예: 'com.example.project.ExtracurricularActivity')이어야 합니다. 그러나 이름의 첫 번째 문자가 마침표인 경우(예: '.ExtracurricularActivity') build.gradle 파일에 지정된 네임스페이스에 추가됩니다.

애플리케이션을 게시한 후에는 android:exported="false"를 설정하지 않은 경우 이 이름을 변경하면 안 됩니다.

기본값은 없으며, 이름을 지정해야 합니다.

android:noHistory
사용자가 활동에서 벗어나서 더 이상 화면에 활동이 표시되지 않을 때 활동을 활동 스택에서 삭제하고 종료(finish() 메서드 호출)해야 하는지 여부입니다. 종료해야 하면 'true', 종료하지 않아야 하면 'false'입니다. 기본값은 'false'입니다.

값이 'true'인 경우 활동은 이전 트레이스를 남기지 않습니다. 활동은 작업의 활동 스택에 머무르지 않으므로 사용자는 돌아갈 수 없습니다. 이 경우 이 활동의 결과에 관한 다른 활동을 시작하면 onActivityResult()가 호출되지 않습니다.

이 속성은 API 수준 3에서 도입되었습니다.

android:parentActivityName
활동의 논리적 상위 활동의 클래스 이름입니다. 이 이름은 상응하는 <activity> 요소의 android:name 속성에 주어진 클래스 이름과 일치해야 합니다.

시스템은 이 속성을 읽고 사용자가 작업 모음에서 위로 버튼을 누르면 시작하는 활동을 결정합니다. 또한 시스템은 이 정보를 사용하여 활동의 백 스택을 TaskStackBuilder와 합성할 수 있습니다.

API 수준 4~16을 지원하도록 "android.support.PARENT_ACTIVITY" 값을 지정하는 <meta-data> 요소를 사용하여 상위 활동을 선언할 수도 있습니다. 예를 들면 다음과 같습니다.

<activity
    android:name="com.example.app.ChildActivity"
    android:label="@string/title_child_activity"
    android:parentActivityName="com.example.app.MainActivity" >
    <!-- Parent activity meta-data to support API level 4+ -->
    <meta-data
        android:name="android.support.PARENT_ACTIVITY"
        android:value="com.example.app.MainActivity" />
</activity>

위로 탐색을 지원하는 상위 활동 선언에 관한 자세한 내용은 위로 탐색 제공을 참고하세요.

이 속성은 API 수준 16에서 도입되었습니다.

android:persistableMode

기기를 다시 시작할 때 포함 작업 내에 활동의 인스턴스를 어떤 식으로 보존할지 정의합니다.

작업의 루트 활동이 이 속성 값을 persistRootOnly로 설정하면 루트 활동만 보존됩니다. 그 외 경우에는 작업의 백 스택 위쪽에 있는 활동을 탐색합니다. 이 속성 값을 persistAcrossReboots로 설정한 활동은 모두 보존됩니다.

이 속성을 사용하면 다음 중 하나로 값을 설정해야 합니다.

설명
persistRootOnly 기본값. 시스템이 다시 시작되면 활동 작업이 보존되지만 루트 활동의 시작 인텐트만 사용됩니다.

앱의 시작 인텐트가 앱의 루트 활동을 로드할 때 활동이 PersistableBundle 객체를 수신하지 않습니다. 그러므로 기기를 다시 시작할 때 앱의 루트 활동 상태를 보존하기 위해 onSaveInstanceState()를 사용하지 마세요.

참고: 이 속성 값은 앱의 루트 활동에 설정된 경우에만 앱 동작에 영향을 미칩니다.

persistAcrossReboots

이 활동의 상태가 보존되며 이와 함께 자체적인 persistableMode 속성을 persistAcrossReboots로 설정한 백 스택 위쪽의 각 활동 상태도 보존됩니다. 활동에 persistAcrossReboots로 설정된 persistableMode 속성이 없는 경우 또는 Intent.FLAG_ACTIVITY_NEW_DOCUMENT 플래그를 사용하여 시작하는 경우 활동 및 백 스택 위의 모든 활동은 보존되지 않습니다.

인텐트가 앱에서 persistableMode 속성이 persistAcrossReboots로 설정된 활동을 로드하면 활동이 onCreate() 메서드에 PersistableBundle 객체를 수신합니다. 그러므로 onSaveInstanceState()를 사용하여 기기가 다시 시작할 때 활동의 상태를 보존할 수 있습니다. 단, persistableMode 속성이 persistAcrossReboots로 설정되어야 합니다.

참고: 이 속성 값은 앱의 루트 활동 이외의 활동에 설정된 경우에도 앱 동작에 영향을 미칩니다.

persistNever

활동의 상태가 보존되지 않습니다.

참고: 이 속성 값은 앱의 루트 활동에 설정된 경우에만 앱 동작에 영향을 미칩니다.

이 속성은 API 수준 21에서 도입되었습니다.

android:permission
클라이언트가 활동을 시작하거나 인텐트에 응답하는 데 필요한 권한의 이름입니다. startActivity() 또는 startActivityForResult() 호출자가 지정된 권한이 없는 경우 인텐트는 활동에 제공되지 않습니다.

이 속성을 설정하지 않는 경우 <application> 요소의 permission 속성이 설정한 권한을 활동에 적용합니다. 둘 중 어느 속성도 설정하지 않은 경우 활동은 권한으로 보호되지 않습니다.

권한에 관한 자세한 내용은 소개의 권한 섹션과 보안 및 권한 문서를 참고하세요.

android:process
활동이 실행되어야 하는 프로세스의 이름입니다. 일반적으로 애플리케이션의 모든 구성요소는 애플리케이션을 위해 생성된 기본 프로세스 이름으로 실행되므로 이 속성을 사용할 필요가 없습니다. 그러나 필요한 경우 이 속성을 사용하여 기본 프로세스 이름을 재정의할 수 있으며 앱 구성요소를 다중 프로세스에 분배할 수 있습니다.

이 속성에 할당된 이름이 콜론(':')으로 시작되면 필요에 따라 애플리케이션 전용의 새 프로세스가 만들어지고 이 프로세스에서 활동이 실행됩니다. 프로세스 이름이 소문자로 시작되면 활동은 이 이름의 전역 프로세스에서 실행됩니다(권한이 있는 경우). 이를 통해, 서로 다른 애플리케이션의 구성요소가 한 프로세스를 공유하여 리소스 사용량을 줄일 수 있습니다.

<application> 요소의 process 속성은 모든 구성요소에 서로 다른 기본 프로세스 이름을 설정할 수 있습니다.

android:relinquishTaskIdentity
활동이 작업 스택에서 상위 활동에 관한 작업 식별자를 포기하는지 여부를 나타냅니다. 이 속성을 "true"로 설정한 루트 활동의 작업은 기본 인텐트를 작업의 다음 활동의 인텐트로 대체합니다. 다음 활동도 이 속성을 'true'로 설정한 경우 동일한 작업에서 시작한 활동에 기본 인텐트를 양도합니다. 이는 이 속성이 'false'로 설정된 활동이 발생할 때까지 각 활동에 계속 적용됩니다. 기본값은 'false'입니다.

이 속성을 'true'로 설정하면 활동에서 ActivityManager.TaskDescription을 사용하여 개요 화면의 라벨, 색상, 아이콘을 변경할 수도 있습니다.

resizeableActivity

앱이 멀티 윈도우 모드를 지원하는지 여부를 지정합니다. 이 속성은 <activity> 요소나 <application> 요소에서 설정할 수 있습니다.

이 속성을 true로 설정하면 사용자가 화면 분할 모드와 자유 형식 모드로 활동을 시작할 수 있고, 속성을 false로 설정하면 앱을 멀티 윈도우 환경에 맞게 테스트하거나 최적화할 수 없습니다. 시스템은 여전히 호환성 모드가 적용된 상태로 활동을 멀티 윈도우 모드에 둘 수 있습니다. 이 속성을 true로 설정해도 멀티 윈도우 모드의 다른 앱이 화면(예: PIP 모드)이나 다른 디스플레이에 표시되지 않는다는 보장도 없습니다. 따라서 이 플래그를 설정한다고 해서 앱에 독점적인 리소스 액세스 권한이 있는 것은 아닙니다.

앱이 API 수준 24 이상을 타겟팅하지만 이 속성 값을 지정하지 않은 경우 이 속성의 기본값은 true가 됩니다.

앱이 API 수준 31 이상을 타겟팅하는 경우 이 속성은 작은 화면 및 큰 화면에서 다르게 작동합니다.

  • 큰 화면(sw >= 600dp): 모든 앱이 멀티 윈도우 모드를 지원합니다. 이 속성은 앱의 크기를 조절할 수 있는지를 나타냅니다(앱이 멀티 윈도우 모드를 지원하는지가 아님). resizeableActivity="false"인 경우 디스플레이 치수를 준수하기 위해 필요한 경우 앱이 호환성 모드로 전환됩니다.
  • 작은 화면(sw < 600dp): resizeableActivity="true" 및 활동의 최소 너비와 최소 높이가 멀티 윈도우 요구사항 내에 있다면 앱은 멀티 윈도우 모드를 지원합니다. resizeableActivity="false"이면 앱은 활동 최소 너비 및 높이와 상관없이 멀티 윈도우 모드를 지원하지 않습니다.

참고: 기기 제조업체는 API 수준 31 동작을 재정의할 수 있습니다.

이 속성은 API 수준 24에 추가되었습니다.

참고: 작업의 루트 활동 값은 작업에서 시작된 모든 추가 활동에 적용됩니다. 즉, 작업의 루트 활동의 크기를 조절할 수 있으면 시스템은 작업의 다른 모든 활동의 크기를 조절할 수 있다고 간주합니다. 루트 활동의 크기를 조절할 수 없으면 작업의 다른 활동의 크기를 조절할 수 없습니다.

android:screenOrientation
기기에서 활동의 디스플레이 방향을 나타냅니다. 활동이 멀티 윈도우 모드로 실행 중인 경우 시스템은 이 속성을 무시합니다.

이 값은 다음 문자열 중 하나일 수 있습니다.

"unspecified" 기본값입니다. 시스템이 방향을 선택합니다. 시스템이 사용하는 정책과 특정 컨텍스트에서 이루어지는 선택은 기기마다 다를 수 있습니다.
"behind" 활동 스택에서 바로 아래에 있는 활동과 동일한 방향입니다.
"landscape" 가로 모드 방향입니다(디스플레이의 높이보다 너비가 더 긺).
"portrait" 세로 모드 방향입니다(디스플레이의 너비보다 높이가 더 긺).
"reverseLandscape" 정상적인 가로 모드 방향에서 반대 방향인 가로 모드 방향입니다. API 수준 9에 추가되었습니다.
"reversePortrait" 정상적인 세로 모드 방향에서 반대 방향인 세로 모드 방향입니다. API 수준 9에 추가되었습니다.
"sensorLandscape" 기기 센서에 따라 정상적인 가로 모드 방향 또는 반전된 가로 모드 방향이 될 수 있습니다. 사용자가 센서 기반 회전을 잠갔더라도 센서가 사용됩니다. API 수준 9에 추가되었습니다.
"sensorPortrait" 기기 센서에 따라 정상적인 세로 모드 방향 또는 반전된 세로 모드 방향이 될 수 있습니다. 사용자가 센서 기반 회전을 잠갔더라도 센서가 사용됩니다. API 수준 9에 추가되었습니다.
"userLandscape" 기기 센서 및 사용자의 기본 설정에 따라 정상적인 가로 모드 방향 또는 반전된 가로 모드 방향이 될 수 있습니다. API 수준 18에 추가되었습니다.
"userPortrait" 기기 센서 및 사용자의 기본 설정에 따라 정상적인 세로 모드 방향 또는 반전된 세로 모드 방향이 될 수 있습니다. API 수준 18에 추가되었습니다.
"sensor" 기기 방향 센서가 방향을 결정합니다. 디스플레이 방향은 사용자가 기기를 잡고 있는 방법에 따라 다르며 사용자가 기기를 회전할 때 변경됩니다. 그러나 일부 기기는 기본적으로 모든 4개 방향으로 회전하지 않습니다. 모든 4개 방향을 허용하려면 "fullSensor"를 사용합니다. 사용자가 센서 기반 회전을 잠근 상태라도 센서가 사용됩니다.
"fullSensor" 기기 방향 센서가 4개 방향 중에서 결정합니다. 이는 4개 화면 방향에서 하나를 허용한다는 것을 제외하면 기기가 정상적으로 실행하는 것과 상관없이 "sensor"와 유사합니다. 예를 들어 일부 기기는 세로 모드 반전 또는 가로 모드 반전을 정상적으로 사용하지 않지만 이 속성은 정상적으로 사용합니다. API 수준 9에 추가되었습니다.
"nosensor" 물리적 방향 센서를 참조하지 않고 방향을 결정합니다. 센서가 무시되므로 사용자가 기기를 이동하는 방법에 따라 디스플레이가 회전하지 않습니다.
"user" 사용자의 현재 기본 설정 방향입니다.
"fullUser" 사용자가 센서 기반 회전을 잠금 설정한 경우 user와 동일하게 작동하고 잠금 설정을 하지 않은 경우 fullSensor와 동일하게 작동하며 화면 방향을 4개 모두 허용합니다. API 수준 18에 추가되었습니다.
"locked" 현재 회전 방향이 무엇이든 그 방향으로 잠금 설정합니다. API 수준 18에 추가되었습니다.

참고: 가로 모드 값이나 세로 모드 값 중 하나를 선언할 때 이는 활동이 실행되는 방향에 관한 어려운 요구사항으로 간주됩니다. 따라서 선언한 값은 애플리케이션이 활동에 필요한 방향을 지원하는 기기에만 사용 가능하도록 Google Play와 같은 서비스가 제공하는 필터링을 사용 설정합니다. 예를 들어 "landscape""reverseLandscape", "sensorLandscape"를 선언하는 경우 애플리케이션이 가로 모드 방향을 지원하는 기기에서만 사용 가능합니다. 그러나 <uses-feature> 요소를 사용하여 애플리케이션에 세로 모드 또는 가로 모드 방향이 필요하다고 명시적으로 선언해야 합니다. (예: <uses-feature android:name="android.hardware.screen.portrait"/>) 이는 순전히 Google Play가 제공하는 필터링 동작(및 그것을 지원하는 다른 서비스)이며 플랫폼은 기기가 특정 방향만을 지원할 때 앱 설치 여부를 제어하지 않습니다.

android:showForAllUsers

기기의 현재 사용자가 활동을 시작한 사용자와 다를 경우 활동을 표시할지를 나타냅니다. 이 속성을 리터럴 값("true" 또는 "false")으로 설정해도 되고 부울 값이 포함된 리소스 또는 테마 속성으로 설정해도 됩니다.

이 속성은 API 수준 23에 추가되었습니다.

android:stateNotNeeded
상태를 저장하지 않고 활동을 종료하고 성공적으로 다시 시작할 수 있는지를 나타냅니다. 이전 상태 참조 없이 다시 시작할 수 있으면 'true', 이전 상태가 필요하면 'false'입니다. 기본값은 'false'입니다.

일반적으로 리소스를 저장하기 위해 활동을 일시적으로 종료하기 전에 onSaveInstanceState() 메서드를 호출합니다. 이 메서드는 Bundle 객체에 활동의 현재 상태를 저장하며 이 상태는 활동이 다시 시작할 때 onCreate()로 전달됩니다. 이 속성이 "true"로 설정된 경우 onSaveInstanceState()는 호출할 수 없으며 활동을 처음으로 시작할 때처럼 null가 번들 대신 onCreate()에 전달됩니다.

'true' 설정을 사용하면 유지된 상태가 없어도 활동을 다시 시작할 수 있습니다. 예를 들어 홈 화면을 표시하는 활동은 어떤 이유로 비정상 종료되는 경우 삭제되지 않도록 이 설정을 사용합니다.

supportsPictureInPicture

활동이 PIP 모드 표시를 지원하는지를 지정합니다.

이 속성은 API 수준 24에 추가되었습니다.

android:taskAffinity
활동에 어피니티가 있는 작업입니다. 어피니티가 같은 활동은 개념적으로 같은 작업(사용자 관점에서 같은 '애플리케이션')에 속합니다. 작업의 어피니티는 루트 활동의 어피니티가 결정합니다.

어피니티는 활동이 상위 요소로 재지정된 작업(allowTaskReparenting 속성 참고)과 FLAG_ACTIVITY_NEW_TASK 플래그를 사용하여 시작할 때 활동을 수용하는 작업, 이렇게 두 가지를 결정합니다.

기본적으로 애플리케이션 내 모든 활동의 어피니티는 같습니다. 활동을 서로 다르게 그룹화하도록 이 속성을 설정할 수 있으며 서로 다른 애플리케이션에 정의된 활동을 같은 작업 안에 둘 수도 있습니다. 활동이 작업에 관한 어피니티가 없도록 지정하려면 빈 문자열로 설정하면 됩니다.

이 속성을 설정하지 않으면 활동이 애플리케이션에 관해 설정된 어피니티를 상속받습니다(<application> 요소의 taskAffinity 속성 참고). 애플리케이션의 기본 어피니티 이름은 build.gradle 파일에 설정된 네임스페이스입니다.

android:theme
활동의 전체 테마를 정의하는 스타일 리소스 참조입니다. 이는 이 테마를 사용하도록 활동 컨텍스트를 자동으로 설정하며(setTheme() 참고) 활동의 실제 모양과 더 잘 일치하도록 활동이 시작하기 전에 애니메이션을 '시작'하게 할 수도 있습니다.

이 속성을 설정하지 않으면 활동은 전체적으로 애플리케이션에 관해 설정된 테마를 상속받습니다(<application> 요소의 theme 속성에서). 또한 이 속성을 설정하지 않으면 기본 시스템 테마가 사용됩니다. 자세한 내용은 스타일 및 테마 개발자 가이드를 참고하세요.

android:uiOptions
활동의 UI에 적용되는 추가 옵션입니다.

다음 값 중 하나여야 합니다.

설명
"none"추가 UI 옵션이 없습니다. 이는 기본값입니다.
"splitActionBarWhenNarrow"가로 공간이 제한적일 때(예: 핸드셋에서 인물 사진 모드 사용) 화면 하단에 표시줄을 추가하여 앱 바(작업 모음이라고도 함)에 작업 항목을 표시합니다. 화면 상단의 앱 바에 소수의 작업 항목이 표시되는 방식 대신, 상단의 탐색 섹션과 하단의 작업 항목 표시줄로 앱 바가 나뉘게 됩니다. 이렇게 하면 작업 항목뿐 아니라 상단의 탐색 및 제목 요소에도 적정한 공간이 제공됩니다. 메뉴 항목은 표시줄 두 개로 분할되지 않고 항상 함께 표시됩니다.

앱 바에 관한 자세한 내용은 앱 바 추가하기 교육 과정을 참고하세요.

이 속성은 API 수준 14에 추가되었습니다.

android:windowSoftInputMode
활동의 기본 창이 터치형 소프트 키보드를 포함하는 창과 상호작용하는 방법을 나타냅니다. 이 속성 설정은 다음 두 가지에 영향을 미칩니다.
  • 활동이 사용자의 관심을 받는 포커스가 될 때 소프트 키보드의 상태(숨김 또는 표시)
  • 소프트 키보드를 위한 공간을 확보하도록 창의 크기를 더 작게 조절할지, 소프트 키보드가 창의 일부를 가릴 때 현재 포커스가 표시되도록 콘텐츠를 이동할지 등의 활동의 기본 창 조정

설정은 다음 표에 나열된 값 중 하나이거나 'state...' 값 하나와 'adjust...' 값 하나를 조합한 것이어야 합니다. 한 그룹에 여러 값(예: 여러 'state...' 값)을 설정하면 정의되지 않은 결과가 발생합니다. 개별 값은 세로 막대(|)로 구분됩니다. 예를 들면 다음과 같습니다.

<activity android:windowSoftInputMode="stateVisible|adjustResize" ... >

여기에 설정된 값('stateUnspecified', 'adjustUnspecified' 제외)은 테마에 설정된 값을 재정의합니다.

설명
"stateUnspecified" 소프트 키보드의 상태(숨김 또는 표시)를 지정하지 않습니다. 시스템이 적당한 상태를 선택하거나 테마 설정에 의존합니다.

이는 소프트 키보드 동작의 기본 설정입니다.

"stateUnchanged" 활동이 앞으로 나올 때 소프트 키보드가 마지막으로 사용된 상태(숨김 또는 표시)를 유지합니다.
"stateHidden" 소프트 키보드는 사용자가 활동을 선택할 때, 즉 사용자가 다른 활동을 떠나서 활동으로 다시 돌아오기보다는 활동으로 적극적으로 이동할 때 숨겨집니다.
"stateAlwaysHidden" 활동의 기본 창에 입력 포커스가 있는 경우 소프트 키보드가 항상 숨겨집니다.
"stateVisible" 소프트 키보드는 사용자가 활동을 선택할 때, 즉 사용자가 다른 활동을 떠나서 활동으로 다시 돌아오기보다는 활동으로 적극적으로 이동할 때 표시됩니다.
"stateAlwaysVisible" 창이 입력 포커스를 받으면 소프트 키보드가 표시됩니다.
"adjustUnspecified" 소프트 키보드를 위한 공간을 확보하도록 활동의 기본 창 크기를 조절하거나 현재 포커스가 화면에 표시되도록 창의 콘텐츠를 이동할지 여부를 지정하지 않습니다. 창의 콘텐츠가 콘텐츠를 스크롤할 수 있는 레이아웃 뷰를 가지고 있는지 여부에 따라 시스템이 이러한 모드 중 하나를 자동으로 선택합니다. 이러한 뷰가 있는 경우 스크롤이 모든 창의 콘텐츠를 더 작은 공간에 표시할 수 있다는 가정하에 창의 크기가 조절됩니다.

이는 기본 창 동작의 기본 설정입니다.

"adjustResize" 터치형 소프트 키보드를 위한 공간을 확보하도록 활동의 기본 창 크기를 항상 조절합니다.
"adjustPan" 소프트 키보드를 위한 공간을 확보하도록 활동의 기본 창 크기를 조절하는 작업을 실행하지 않습니다. 대신 키보드가 현재 포커스를 가리지 않고 사용자가 입력하는 것을 항상 볼 수 있도록 창의 콘텐츠가 자동으로 이동합니다. 이는 일반적으로 창의 크기를 조절하는 것보다 바람직하지 않습니다. 사용자가 소프트 키보드를 닫고 창의 가려진 부분에 가서 상호작용해야 할 수도 있기 때문입니다.

이 속성은 API 수준 3에서 도입되었습니다.

도입 시기
API 수준 3에 추가된 noHistorywindowSoftInputMode를 제외한 모든 속성의 경우 API 수준 1
참고 항목
<application>
<activity-alias>