<activity-alias>

문법:
<activity-alias android:enabled=["true" | "false"]
                android:exported=["true" | "false"]
                android:icon="drawable resource"
                android:intentMatchingFlags=["none" | "enforceIntentFilter" | "allowNullAction"]
                android:label="string resource"
                android:name="string"
                android:permission="string"
                android:targetActivity="string" >
    ...
</activity-alias>
포함된 위치:
<application>
포함 가능한 요소:
<intent-filter>
<meta-data>
<property>
설명
활동의 별칭으로, targetActivity 속성에서 이름이 지정됩니다. 타겟은 별칭과 동일한 애플리케이션에 있어야 하며 매니페스트에서 별칭보다 먼저 선언됩니다.

별칭은 타겟 활동을 독립된 항목으로 나타내며, 고유한 인텐트 필터 세트가 있을 수 있습니다. 타겟 활동 자체의 인텐트 필터가 아닌 이러한 인텐트 필터 세트에서 어떤 인텐트가 별칭을 통해 타겟을 활성화할 수 있는지와 시스템에서 어떻게 별칭을 처리할지 결정합니다.

예를 들어 별칭의 인텐트 필터가 "android.intent.action.MAIN" 및 "android.intent.category.LAUNCHER" 플래그를 지정하면 타겟 활동 자체의 필터가 이 플래그를 설정하지 않았더라도 활동이 애플리케이션 런처에 표시될 수 있습니다.

targetActivity를 제외하고 <activity-alias> 속성은 <activity> 속성의 하위 집합입니다. 하위 집합에 있는 속성의 경우 타겟에 설정된 어떤 값도 별칭에 적용되지 않습니다. 그러나 하위 집합에 없는 속성의 경우 타겟 활동에 설정된 값이 별칭에도 적용됩니다.

속성:
android:enabled
시스템에서 이 별칭을 통해 타겟 활동을 인스턴스화할 수 있는지 여부입니다. 인스턴스화할 수 있으면 "true"이고 인스턴스화할 수 없으면 "false"입니다. 기본값은 "true"입니다.

<application> 요소에는 활동 별칭을 포함한 모든 애플리케이션 구성요소에 적용되는 고유한 enabled 속성이 있습니다. <application> 및 <activity-alias> 속성이 모두 "true"여야 시스템에서 별칭을 통해 타겟 활동을 인스턴스화할 수 있습니다. 둘 중 하나가 "false"이면 별칭을 사용할 수 없습니다.

android:exported
다른 애플리케이션의 구성요소가 이 별칭을 통해 타겟 활동을 시작할 수 있는지 여부입니다. 시작할 수 있으면 "true"이고 시작할 수 없으면 "false"입니다. "false"이면 별칭과 동일한 애플리케이션 또는 사용자 ID가 동일한 애플리케이션의 구성요소만 별칭을 통해 타겟 활동을 시작할 수 있습니다.

기본값은 별칭에 인텐트 필터가 포함되는지 여부에 따라 다릅니다. 필터가 없는 경우에는 정확한 별칭 이름을 지정해야만 별칭을 통해 활동을 호출할 수 있습니다. 이는 별칭이 애플리케이션 내부용으로만 사용된다는 것을 의미하므로(다른 애플리케이션이 별칭 이름을 알지 못함) 기본값은 "false"입니다. 반면 필터가 한 개 이상 있으면 별칭이 외부용이라는 것을 의미하므로 기본값은 "true"입니다.

android:icon
별칭을 통해 사용자에게 표시되는 타겟 활동의 아이콘입니다. 자세한 내용은 <activity> 요소의 icon 속성을 참고하세요.
android:intentMatchingFlags

이 속성을 사용하여 시스템이 수신 인텐트를 앱 구성요소에 매칭하는 방식을 미세 조정합니다. 기본적으로 특별한 일치 규칙은 적용되지 않습니다.

<activity-alias> 태그에 설정된 값은 타겟 <activity>에 설정되거나 해당 특정 별칭의 <application>에서 상속된 값을 재정의합니다. 별칭에 명시적으로 정의되지 않은 경우 타겟 활동이나 애플리케이션의 동작을 상속합니다.

값은 다음 플래그 중 하나 이상(|로 구분됨)이어야 합니다.

플래그 설명
none 수신 인텐트의 모든 특수 일치 규칙을 사용 중지합니다. 여러 플래그를 지정할 때 충돌하는 값은 none 플래그에 우선순위를 부여하여 해결됩니다.
enforceIntentFilter

수신 인텐트에 더 엄격한 매칭을 적용합니다.

  • 명시적 인텐트는 타겟 구성요소의 인텐트 필터와 일치해야 합니다.
  • 작업이 없는 인텐트는 인텐트 필터와 일치하지 않습니다.
allowNullAction

작업이 없는 인텐트가 일치하도록 일치 규칙을 완화합니다. 이 플래그는 enforceIntentFilter와 함께 사용하여 다음 동작을 실행합니다.

  • 명시적 인텐트는 타겟 구성요소의 인텐트 필터와 일치해야 합니다.
  • 작업이 없는 인텐트는 모든 인텐트 필터와 일치할 수 있습니다.

자세한 내용은 Android 16 (API 수준 36) 동작 변경사항의 더 안전한 인텐트 섹션을 참고하세요.

android:label
별칭을 통해 활동이 사용자에게 표시될 때 사용자가 읽을 수 있는 별칭 라벨입니다. 자세한 내용은 <activity> 요소의 label 속성을 참고하세요.
android:name
별칭의 고유한 이름입니다. 이름은 정규화된 클래스 이름과 비슷합니다. 타겟 활동 이름과 달리 별칭 이름은 임의적입니다. 실제 클래스를 가리키지 않습니다.
android:permission
클라이언트가 타겟 활동을 시작하거나 별칭을 통해 타겟 활동이 무언가를 하도록 만드는 데 필요한 권한의 이름입니다. startActivity() 또는 startActivityForResult() 호출자에 지정 권한이 부여되지 않았다면 타겟 활동이 활성화되지 않습니다.

이 속성은 타겟 활동 자체에 설정된 모든 권한을 대체합니다. 이 속성을 설정하지 않으면 별칭을 통해 타겟을 활성화하는 데 권한이 필요하지 않습니다.

권한에 관한 자세한 내용은 앱 매니페스트 개요의 권한 섹션을 참고하세요.

android:targetActivity
별칭을 통해 활성화할 수 있는 활동의 이름입니다. 이 이름은 매니페스트에서 별칭 앞에 나오는 <activity> 요소의 name 속성과 일치해야 합니다.
도입 수준:
API 수준 1
참고 항목:
<activity>