<?xml version=”1.0” encoding=”utf-8”?>
<manifest>
<uses-permission />
<permission />
<permission-tree />
<permission-group />
<instrumentation />
<uses-sdk />
<uses-configuration />
<uses-feature />
<supports-screens />
<application>
<activity>
<intent-filter>
<action />
<category />
<data />
</intent-filter>
<meta-data />
</activity>
<activity-alias>
<intent-filter> . . . </intent-filter>
<meta-data />
</activity-alias>
<service>
<intent-filter> . . . </intent-filter>
<meta-data/>
</service>
<receiver>
<intent-filter> . . . </intent-filter>
<meta-data />
</receiver>
<provider>
<grant-uri-permission />
<path-permission />
<meta-data />
</provider>
<uses-library />
</application>
</manifest>
매니패스트 파일은 어플리케이션에 대한 전반적인 정보를 담고 있는 파일로, 어플리케이션이 실행되기 전에 시스템이 알고 있어야 하는 파일이다. 이 매니페스트 파일 안에는 어플리케이션 컴포넌트(Activity, Service, intents, Content provider, Broadcast Receivers)에 대한 노드를 포함하고 있고 Intent filter와 같이 permissions을 사용해 다른 컴포넌트와 어플리케이션이 어떻게 상호 작용을 하는지를 결정한다.
</receiver>
<provider>
<grant-uri-permission />
<path-permission />
<meta-data />
</provider>
<uses-library />
</application>
</manifest>
<manifest>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
package="com.example.android.notepad"
android:versionCode="1"
android:versionName="1.0">
[어플리케이션 태그 및 Permission 태그들]
</manifest>
AndroidManifest.xml의 root element로써 <manifest> 태그가 전체를 감싸는 구조를 하고 있으며 package attribute의 값으로는 어플리케이션의 base를 지정하는 Java package 이름이 온다.
<uses-permission>
<uses-permission android:name="string" />
어플리케이션의 필요한 기능의 권한을 정의해준다. 여기에 정의된 권한은 설치 과정 중 사용자에게 보여주고 권한부여 혹은 거절이 결정된다.
android:name – 애플리케이션 안에 <permission>엘리먼트를 사용해서 정의된 퍼미션의 이름
다른 애플리케이션에 의해 정의된 퍼미션의 이름
표준 시스템 퍼미션의 이름(예 - “android.permission.INTERNET”)
<permission>
<permission android:description="string resource"
android:icon="drawable resource"
android:label="string resource"
android:name="string"
android:permissionGroup="string"
android:protectionLevel=["normal" | "dangerous" | "signature" | "signatureOrSystem"]
/>
컴포넌트를 사용하기 위한 권한 중에 안드로이드가 제공하는 권한 이외에 다른 권한이 필요할 때 정의한다. 다른 어플리케이션이 이 컴포넌트를 사용하려면 자신의 매니페스트에 uses-permission 태그를 설정해 주거나<activity android:permission>속성에 권한을 추가해 주면 된다.
android:description – 퍼미션의 설명으로 사용자에게 퍼미션을 설명하기 위해 사용 될 수도 있다.
android:icon – 퍼미션을 의미하는 아이콘의 리소스의 레퍼런스로 예를 들어 res/drawable/app_note.png라는 파일이 있다면 “@drawable/app_note”라고 쓴다.
android:label – 사용자에게 보여질 수 있는 퍼미션의 이름이다. 배포가 될때는 string.xml에 정의하고 @string/app_name 같이 사용하여야 한다.
android:name – 코드에서 사용되는 퍼미션의 이름이다. “com.example.project.PERMITTED_ACTION”과 같이 고유한 이름을 사용해야 한다.
android:permissionGroup – 그룹에 퍼미션을 할당한다. <permission-group>으로 선언되어진 그룹의 이름을 지정한다.
android:protectionLevel – 이 레벨 설정에 따라서 사용자가 퍼미션을 요구하는 애플리케이션을 알 수 있거나 해당 퍼미션을 누가 사용하는지를 알 수 있다.
normal : 디폴트 값으로 낮은 수위의 위험을 갖는다. 최소한의 위험요소를 가진 애플리케이션이 다른 애플리케이션 레벨의 기능들에 대해 접접근하는 것 부여한다.
dangerous : 높은 수위의 위험을 갖는다. 사용자의 사적 데이터 접근이나 디바이스에 대한 제어를 허용한다.
signature : 애플리케이션이 다른 애플리케이션과 같은 인증서를 가지고 사인되었을때에 한하여 시스템이 퍼미션을 부여한다.
signatureOrSystem : 시스템이 안드로이드 시스템 이미지 안에 있거나 시스템 이미지 안에 있는 것들과 같은 인증서로 사인된 애플리케이션에 한하여 부여한다.
<permission-tree>
<permission-tree android:icon="drawable resource"
android:label="string resource"
android:name="string" />
퍼미션 트리에 대한 기본적인 이름을 선언한다. 이 애플리케이션은 트리 내의 모든 이름들에 대한 소유권을 갖는다.
<permission-group>
<permission-group android:description="string resource"
android:icon="drawable resource"
android:label="string resource"
android:name="string" />
퍼미션 그룹의 이름을 선언한다.
<instrumentation>
실행 시 액티비티와 서비스를 테스트 하기 위한 프레임워크롤 제공하며, 선언된 클래스는 시스템리소스와 상호작용을 모니터링하기 위한 연결 고리를 제공한다.
Jfeature를 설치해 Test를 사용할 경우
<instrumentation android:targetPackage="com.jfeature" android:name="android.test.InstrumentationTestRunner" />
<instrumentation android:functionalTest=["true" | "false"]
android:handleProfiling=["true" | "false"]
android:icon="drawable resource"
android:label="string resource"
android:name="string"
android:targetPackage="string" />
이 엘리먼트가 매니페스트에 자동으로 생성된다.
android:functionalTest – 기능적 테스트를 위해 수행되어야 하는지 여부를 표시한다. 디폴트 값은 “false”이다.
android:handleProfiling – 프로파일링을 on, off 할 것인지의 여부를 표시한다. 프로파일링을 시작할 때와 멈출때는 결정하려면 “ture”, 프로파일링이 시행되는 모든 시간 동안 계속 하려면 false로 표시한다. 디폴트는 “false”이다.
android:targetPackage – 타겟으로 정할 패키지 주소를 입력한다.
<uses-sdk>
<uses-sdk android:minSdkVersion="integer"
android:maxSdkVersion="integer"
amdroid:targetSdkVersion="integer" />
Android Version이 아닌 API 레벨을 설정한다.
android:minSdkVersion – API의 최소레벨을 지정하는 함수로 Default값은 1이다.
시스템이 지정한 값보다 낮은 버전 이라면 시스템에 설치 되지 않는다.
android:maxSdkVersion – API의 최소레벨을 지정하는 함수이다. 시스템이 지정한 값보다 높은 버전이라면 시스템에 설치 되지 않는다. 이 애트리뷰트를 사용하는 것을 권장하지 않는다. 왜냐하면 신규 버전의 안드로이드 플렛폼 배치가 차단되고 더 높은 API 레벨로 시스템이 업데이트 된 이후 사용자의 디바이스에서 maxSdkVersion이 시스템보다 낮은 값으로 설정된 애플리케이션이 제거된다.
android:targetSdkVersion - 애플리케이션이 타겟으로 하고 있는 API 레벨을 지정하는 함수이다.
<uses-feature>
<uses-feature android:glEsVersion="integer"
android:name="string" />
SDK버전을 선언하는 것과 비슷하게 기능을 지원하지 않는 디바이스 상에는 설치가 되지 않도록 하는 옵션이다. 예를 들어 디바이스가 카메라를 지원하지 않으면 어플리케이션이 설치 되지 않는다. 애플리케이션이 특정 디바이스를 사용해야 한다면 이 옵션을 추가해야 한다.
android:glEsVersion – 애플리케이션이 필요로 하는 GLES 버전이다.
android:name – 애플리케이션이 필요로 하는 기능의 이름으로써 예로 “android.hardware.camera”와 같이 쓰이는데 이것은 애플리케이션이 카메라를 필요로 한다는 의미이다.
<supports-screens>
<supports-screens android:smallScreens=["true" | "false"]
android:normalScreens=["true" | "false"]
android:largeScreens=["true" | "false"]
android:anyDensity=["true" | "false"] />
애플리케이션이 지원하는 스크린 크기를 지정하는 옵션이다.(멀티해상도 관련)
android:smallScreens – 애플리케이션이 “normal”보다 더 작은 스크린을 지원하는지 여부이다. API 레벨 4이상에서는 디폴트 값이 “ture”이고 다른 레벨에서는 “false”이다.
android:normalScreens – 애플리케이션이 “normal” 스크린을 지원하는지 여부이다. 디폴트 값은 “true”이다.
android:largeScreens – 애플리케이션이 “normal”보다 더 큰 스크린을 지원하는지 여부이다. API 레벨 4이상에서는 디폴트 값이 “ture”이고 다른 레벨에서는 “false”이다.
android:anyDensity – 애플리케이션이 임의의 스크린 밀도를 수용할 수 있는 지에 대한 옵션이다. API레벨 4이상에서는 디폴트 값이 “true”이고 다른 레벨에서는 “false”이다.
<application>
<application android:allowClearUserData=["true" | "false”]
android:allowTaskReparenting=["true" | "false"]
android:debuggable=["true" | "false"]
android:description="string resource"
android:enabled=["true" | "false"]
android:hasCode=["true" | "false"]
android:icon="drawable resource"
android:label="string resource"
android:manageSpaceActivity="string"
android:name="string"
android:permission="string"
android:persistent=["true" | "false"]
android:process="string"
android:task="string"
android:theme="resource or theme" >
. . .
</application>
이 엘리먼트는 반드시 한번 사용되어야 한다. Application 아래에 있는 서브 엘리먼트는 없거나 순서가 바뀌어도 문제되지 않는다. 애플리케이션의 메타데이타(타이틀, 아이콘, 테마 등)을 지정한다.
android:allowClearUserData – 사용자들에게 사용자 데이터를 제거할 수 있는 옵션을 부여할 것인가에 대한 애트리뷰트이다.
android:allowTaskReparenting – 이 애트리뷰트가 “true”로 설정되어 있다면 액티비티는 시작된 태스크부터 affinity를 갖는 태스크가 된다.
예를 들어 e-mail Activity에서 web page링크를 클릭하게 되면 해당 페이지가 보여지는 브라우저가 시작되게 된다. 이 Activity는 Browser Application에 정의 되어 있지만 e-mail Task의 일부로 실행된 상태이다. 만약 android:allowTaskReparenting이 true로 되어있고 Browser Task로 Reparenting되면 Browser어플리케이션에서 그 페이지가 보여질 것이고 다시 e-mail Task가 보여지면 그 Activity는 보이지 않게 된다. 디폴트 값은 false이다.
android:debuggable – 사용자모드로 실행중일 때 디버그 될수 있는지를 설정한다. 디폴트 값은 ”false”이다. “false”로 설정한다면 Wating for Debugger화면에서 더 이상 진행되지 않는다.
android:enable – 애플리케이션의 컴포넌트를 인스턴스화 할 수 있는지를 설정한다. 디폴트 값은 “true”이다. “true”라면 각 컴포넌트의 enabled 애트리뷰트가 그 컴포넌트의 활성화 여부를 결정하고 “false”라면 모든 컴포넌트들은 비활성화 된다.
android:hasCode – 시스템 코드가 아닌 다른 코드를 포함하고 있는지를 설정한다. 디폴트 값은 “true”이다.
android:manageSpaceActivity – 디바이스상에서 애플리케이션이 점유하는 메모리를 사용자가 관리 할 수 있도록 하는 액티비티 이름이다.
adroid:permission – 클라이언트와 애플리케이션이 상호작용하기 위해 필요한 퍼미션 이름이다. 이 애트리뷰트는 애플리케이션 안의 모든 컴포넌트에 퍼미션을 적용한다.
android:persistent – 애플리케이션이 항상 실행 상태로 있는지의 설정값이다. 디폴트는 “false”이다.
android:process – 애플리케이션 프로세스의 이름이다. 애플리케이션 안에 모든 컴포넌트는 이 애트리뷰트의 프로세스로 실행이 되고 각 컴포넌트에 process 애트리뷰트를 설정 함으로써 오버라이드 할 수 있다. 디폴트로 <manifest>엘리먼트의 package이름이다. 이 애트리뷰트의 이름이 콜론(:)으로 시작되면 private하고 소문자로 시작한다면 그 이름을 가진 글로벌 프로세스가 만들어진다. 글로벌 프로세스는 공유될 수 있어 리소스 사용을 감소시킨다.
android:taskAffinity – 애플리케이션 안의 모든 액티비티에 적용되는 affinity이름이다. 액티비티 내에 taskAffinity를 설정했다면 적용되지 않는다. 디폴트로 <manifest>엘리먼트의 package 이름을 가지고 어플리케이션내에 액티비티는 동일 Affinity를 공유한다.
android:theme – 애플리케이션 안의 모든 액티비티에 적용되는 스타일 리소스에 대한 레퍼런스 이다. 각각의 액티비티는 이 설정을 override 할 수 있다.
<activity>
<activity android:allowTaskReparenting=["true" | "false"]
android:alwaysRetainTaskState=["true" | "false"]
android:clearTaskOnLaunch=["true" | "false"]
android:configChanges=[one or more of: "mcc" "mnc" "locale"
"touchscreen" "keyboard" "keyboardHidden" "navigation" "orientation" "fontScale"]
android:enabled=["true" | "false"]
android:excludeFromRecents=["true" | "false"]
android:exported=["true" | "false"]
android:finishOnTaskLaunch=["true" | "false"]
android:icon="drawable resource"
android:label="string resource"
android:launchMode=["multiple" | "singleTop" | "singleTask" | "singleInstance"]
android:multiprocess=["true" | "false"]
android:name="string"
android:permission="string"
android:process="string"
android:screenOrientation=["unspecified" | "user" | "behind" | "landscape" | "portrait" | "sensor" | "nonsensor"]
android:stateNotNeeded=["true" | "false"]
android:taskAffinity="string"
android:theme="resource or theme"
android:windowSoftInputMode=[one or more of: "stateUnspecified"
"stateUnchanged" "stateHidden"
"stateAlwaysHidden" "stateVisible"
"stateAlwaysVisible" "adjustUnspecified"
"adjustResize" "adjustPan"] >
. . .
</activity>
각각의 액티비티마다 <activity>태그가 필요하다. 매니페스트 파일에 액티비티가 정의되어 있지 않다면 해당 액티비티를 실행시킬 수 없다.(런타임 오류가 발생)
android:allowTaskReparenting – 친화력 있는 태스크 설정 애트리뷰트이다. 이 애트리뷰트가 설정되지 않으면 <application>엘리먼트의 allowTaskReparenting에 설정된 값이 액티비티에 적용된다. 디폴트 값은 “false”이다.
android:alwaysRetainTaskState – 사용자가 Task를 오랫동안 방치하면 시스템은 Root Activity를 제외한 모든 Activities의 Task를 Clear 시킨다. 이 애트리뷰트가 “true”로 설정 되어 있다면 Task는 오랜 시간이 지나도 Stack에 있는 모든 Activity를 유지한다. 디폴트 값은 “false”이다.
android:clearTaskOnLaunch – 이 속성이 “true”로 설정되어 있으면 사용자가 Task를 떠났다가 다시 돌아 올 때마다 Stack은 Root Activity로 정리된다. 디폴트 값은 “false”이다.
Android:configChanges – 시스템은 각 어플리케이션을 종료하고 재시작한 뒤 리소스 값을 다시 읽어 들임으로써 언어, 위치, 하드웨어에 대한 런타임 변경을 지원한다. 런타임 구성 변경을 감지하는 activity를 가지려면 Manifest 노드에 android: configChanges 속성을 추가 한 뒤 변경을 하고자 하는 구성 변경을 지정한다. 여러 값을 사용할 때는 ‘|’에 의해 구분된다.
mcc : IMSI 모바일 국가 코드가 변경되었다.
mnc : IMSI 모바일 네트워크 코드가 변경되었다.
locale : 사용자가 다른 언어 설정을 선택했다.
touchscreen : 터치스크린이 변경되었다.
keyboard : 키보드 종류가 바뀌었다.
keyboardHidden : 키보드가 보여졌거나 숨겨졌다.
navigation : 네비게이션 타입이 변경 되었다.
origentation : 화면이 세로 방향이나 가로 방향으로 회전됐다.
fontScale : 사용자가 선호하는 글꼴 크기를 변경했다.
/// Configuraion 객체를 사용해 새로운 구성 값을 결정하도록
/// OnConfigurationChnaged 메서드를 재정의 한다.
@Override
public void onConfigurationChanged(Configuration _newConfig) {
super.onConfigurationChanged(_newConfig);
// resource 값에 기반을 두고 있는 모든 GUI를 update를 한다.
// ....
if (_newConfig.orientation == Configuration.OPRIENTATION_LANDSCAPE)
{
// 방향이 landscape로 변경되면 해당 방향으로 반응을 한다.
}
if (_newConfig.keyboardHidden == Configuration.KEYBOARDHIDDEN_NO)
{
// 변경된 키보드의 유무에 반응을 한다.
}
}
시스템이 재시작 되지 않을 경우 다음과 같이한다.
android:excludeFromRecents – “true”이면 사용자가 볼 수 있는 최근 런치된 액티비티 리스트에서 제외되고 “false”이면 리스트에 포함된다. 디폴트 값은 “false”이다.
android:exported – 다른 애플리케이션의 컴포넌트에서 이 액티비티를 런치 할 수 있는지를 설정한다. “false”라면 이 액티비티는 같은 애플리케이션 혹은 같은 유저 ID를 가진 애플리케이션 컴포넌트만 런치 할 수 있다. 디폴트는 액티비티가 인텐트 필터를 포함하는지에 달려있다. 필터가 없다면 디폴트 값이 “false”이고 필터가 있다면 “true”이다.
MAIN/LAUNCHER 액티비티에는 절대로 “false”값을 주면 안 된다. “false”값을 주게 되면 SecurityException이 발생하고 exported 속성을 true로 설정해 달라는 메시지가 출력된다.
android:finishOnTaskLaunch – 사용자가 태스크를 런치 할 때 마다 액티비티의 기존 인스턴스가 종료 되어야 하는지의 여부를 설정한다. 종료되어야 한다면 “true”이고 종료되지 않아야 한다면 “false”이다. 디폴트 값은 “false”이다. 만약 이 애트리뷰트와 allowTaskReparenting이 모두 “true”라면 액티비티 친화력은 무시되어 액티비티는 부모를 바꾸지 않고 파괴된다.
android:launchMode – 액티비티가 어떻게 런치되어야 하는지에 대한 명령이다. 4가지 런치모드(“standard” “singleTop” “singleTask” “singleInstance” )가 있고 디폴트는 “standard”이다.
모드는 두개의 main Group으로 나뉜다(standard, singleTop / singleTask, singleInstance). “standard”, “singleTop”모드를 가지는 액티비티는 여러 번 인스턴스화 될 수 있으나(Intent Object가 “FLAG_ACTIVITY_NEW_TASK” flag를 가지고 있지 않을 경우에 해당) “singleInstance” 액티비티는 하나의 Task만 시작 할 수 있다.
“standard” vs “singleTop” : “standard” 액티비티에 대한 새로운 Intent가 발생하면 언제나 해당 Class의 Instance가 만들어 지지만 “singleTop” 액티비티의 새로운 Instance는 생성 될 수도 있다. 즉, Target Task에 이미 해당 액티비티의 인스턴스가 존재하면 새로 만들어지지 않고 기존 인스턴스가 새로운 Intent를 받게 된다.
“singleTask” vs “singleInstance” : “singleTask” 액티비티는 다른 액티비티들이 해당 Task의 일부가 되는 것을 허락하여 “singleTask” 액티비티는 액티비티 스택의 root에 존재하게 되고 다른 액티비티들은 동일한 Task에서 시작 될 수 있다. 이와 달리 “singleInstance” 액티비티는 어떤 다른 액티비티들도 해당 Task의 일부가 될 수 없다. 이로 인해 해당 Task에는 유일한 Activity만 존재하고 또 다른 Activity를 실행하려고 하면 새로운 Task로 할당이 된다.
android:multiprocess – 이 플래그가 “true”이면 액티비티 인스턴스가 다양한 프로세스에서 실행 될 수 있다. 디폴트 값은 “false”이고 “true”값은 지양한다.
android:noHistory – “true”라면 사용자가 액티비티를 떠나 화면에 보이지 않았을 때 스택에서 제거되고 종료(finish()메소드가 호출됨)된다. 기본값은 “false”이다.
android:permission – 액티비티를 런치하기 위해 혹은 인텐트에 응답하기 위해 얻어야 하는 퍼미션 이름이다. 만약 startActivity() 또는 startActivityForResult()의 호출자가 퍼미션을 부여받지 않으면 인텐트는 해당 액티비티에 전달 되지 않는다.
애트리뷰트가 설정되지 않으면 <application>엘리먼트의 퍼미션이 적용되고 <application>엘리먼트 퍼미션이 없다면 이 액티비티는 퍼미션에 의해 보호되지 않는다.
android:process – 액티비티가 실행되어야 하는 프로세스의 이름이다. 디폴트 프로세스 이름은 어플리케이션 패키지 이름이다.
android:screenOrientation – 액티비티의 방향을 설정한다.
unspecified : 시스템에서 디바이스에 따라 방향을 결정
landscape : 가로방향
portrait : 세로방향
behind : 이전 액티비티의 스택에 따라 결정
user : 사용자 설정
sensor : 가속 센서의 방향에 따라 결정
nosensor : 가속 센서를 사용하지 않음, “unspecified”와 비슷
android:stateNotNeeded – 액티비티가 임시로 종료되기 전에 리소스를 저장하기 위해 onSaveInstanceState() 메쏘드가 호출된다. 이 메쏘드는 액티비티가 재시작될 때, onCreate()에 전달되는 Bundle에 액티비티의 현재 상태를 저장한다. 만약 이 애트리뷰트가 “true”로 설정되다면 onSaveInstanceState()는 호출되지 않고 onCreate()는 bundle 대신에 null을 전달받는다. 디폴트 값은 “false”이다.
android:taskAffinity – 이곳에 다른 task name을 설정해 주면 이 액티비티는 해당 task에서 실행된다. 하나의 어플리케이션에서 실행되는 아이콘을 여러 개 만드는데 사용된다. 기본적으로 액티비티는 애플리케이션의 친화력을 상속한다. 애플리케이션의 디폴트 친화력 이름은 <manifest>엘리먼트의 패키지 이름이다.
android:theme – 액티비티의 테마를 정의하는 스타일 리소스에 대한 레퍼런스이다. 기본적으로 <application>엘리먼트의 테마를 사용하고 테마가 없으면 시스템 테마가 사용된다.
android:windowSoftInputMode – 소프트 키보드 상태 : 액티비티가 사용자 관심의 포커스를 받을 때 소프트 키보드가 보여지는지 여부를 설정한다.
액티비티 메인 윈도우에 대한 조정 : 소프트 키보드를 위한 공간을 만들기 위해 액티비티 메인 윈도우를 작게 줄일 지의 여부 또는 메인 윈도우 일부가 소프트 키보드에 의해 가려질 때 현재 포커스를 보이도록 하기 위해 메인 윈도우의 컨텐트가 상하로 움직일 지의 여부를 설정한다.
stateUnspecified : 소프트 키보드 상태에 대해 시스템이 적절한상태를 선택하거나 테마 설정값을 따른다. 소프트 키보드의 디폴트 설정 값.
stateUnchanged : 소프트 키보드는 마지막 상태로 유지
stateHidden : 사용자 액티비티를 선택할 때 소프트 키보드는 숨겨짐
stateAlwaysHidden : 액티비티의 메인 위도우가 입력 포커스를 가질 때 소프트 키보드는 항상 숨겨짐
stateVisible : 사용자가 액티비티 메인 위도우 앞으로 갈 때 소프트 키보드 보여짐
stateAlwaysVisible : 사용자가 액티비티를 선택할 때 소프트 키보드 보여짐
adjustUnspecified : 스크롤 할 수 잇는 레이아웃 뷰들을 가지고 있다면 윈도우 크기 재조정. 메인 윈도우의 디폴트 값
adjustResize : 스크린에 소프트 키보드 공간을 만들기 위해 메인 윈도우 크기가 항상 재조정 됨
adjustPan : 소프트 키보드 공간을 만들기 위해 메인 윈도우 크기가 재조정 되지 않음
<intent-filter>
수행되어야 할 Action을 서술해 놓은 정보의 묶음이다. 이 정보에는 수행되었을 때의 데이터, Action을 수행하기 위한 구성 요소의 Category, 그리고 또 다른 적절한 지시 등이 포함된다.
Android System은 Component를 구동하기 전에 Component가 다루려 하는 의도를 파악해야 하기 때문에 Intent Filters은 <intent-filter> 요소로 Manifest에 규정되어 있어야 한다. 하나의 Component는 여러 개의 Filters을 가질 수 있고 각각은 서로 다른 Capabilities를 나타내게 된다.
<intent-filter android:icon="drawable resource"
android:label="string resource"
android:priority="integer" >
. . .
</intent-filter>
Target Component를 명시적으로 명명한 Intent는 해당 Component를 활성화 시키게 되는데 이 때는 filter가 사용되지 않는다. 그러나 명시적으로 Target을 정하지 않게 되면 Component's Filters 중 하나를 통해 전달하게 된다.
android:priority – 부모 컴포넌트가 필터에 따른 인텐트 처리의 우선순위이다. 액티비티와 브로드캐스드의 경우에 해당한다.
필터와 일치하는 인텐트에 대해 응답 방법에 대한 정보를 제공하고 인텐트에 대한 잠재적 타겟으로 높은 우선순위인 액티비티만을 고려한다.
높은 우선순위의 값을 가지는 브로트캐스트 리시버가 먼저 호출된다.
<action>
<action android:name="string" />
<intent-filter>엘리먼트는 반드시 하나이상의 <action>엘리먼트를 포함해야 한다.
android:name – 액선의 이름으로써 ACTION_문자열 상수이다. 예를들어 ACTION_MAIN에 대해서는android.intent.action.MAIN, ACTION_WEB_SEARCH에 대해서는 anroid.intent.action.WEB_SEARCH를 사용한다.
안드로이드 패키지가 아닌 직접 정의한 액션에 대해서는 접두어로 패키지 이름을 사용하는 것이 좋다. 예를들어 TRANSMOGRIFY액션은 com.example.project.TRANSMOGRIFY 처럼 사용한다.
<category>
<category android:name="string" />
인텐트가 카테고리 테스트를 통과하기 위해서는 인텐트 오브젝트 안의 모든 카테고리가 필터에 있는 카테고리와 일치해야 한다.
android:name – 카테고리의 이름으로써 CATEGORY_name 상수이다. 예를들어 CATEGORY_LAUNCHER에 대한 문자열 값은 android.intent.category.LAUNCHER이다.
<data>
URI와 데이터 타입(MIME 미디어 타입)을 지정 할 수 있다. schema, host, port, path와 같은 URI 애트리뷰트들에 의해 지정된다.
scheme://host:port/path 또는 pathPrefix 또는 pathPattern
예를들어 content://com.example.project:200/folder/subfolder/etc이다.
<data android:scheme=”something” android:host=”project.example.com” />과
<data android:host="string"
android:mimeType="string"
android:path="string"
android:pathPattern="string"
android:pathPrefix="string"
android:port="string"
android:scheme="string" />
<data android:scheme=”something” /><data android:host=”project.example.com” />은 동일하다.
android:host – URI authority의 host영역이다. scheme가 없으면 이 애트리뷰트는 의미가 없다. 호스트 이름은 항상 소문자로 지정해야 한다.
android:mimType – image/jpeg 또는 audio/mpeg4-generic과 같은 MIME 미디어 타입이다. 하위타입에 대해 와일드카드(*)를 사용할수 있으면 항상 소문자를 사용해서 지정해야 한다.
android:path
android:pathPrefix
android:pathPattern – URI authority의 path영역이다. path 애트리뷰트는 인텐트 오브젝트 내의 전체 path와 일치하는 path를 지정한다. pathPrefix 애트리뷰트는 인텐트 오브젝트 내 path의 첫 머리만 일치하는 부분적인 path를 지정한다. pathPattern 애트리뷰트는 인텐트 오브젝트 내의 전체 path와 일치하는 path를 지정하지만 다음과 같은 와일드카드를 포함할 수 있다. 첫째로 별표(*)는 바로 앞에 나오는 문자가 0번 이상 발생하는 것을 나타내고 둘째로는 마침표 뒤에 별표가 나오는 것(.*)은 어떤 문자든 0번 이상 발생하는 것을 나타낸다.
XML에서 “\”은 이스케이프 문자로써 사용된다.
scheme와 host 애트리뷰트가 필터에 없으면 이 애트리뷰트는 의미가 없다.
android:port - URI authority의 port영역이다. scheme와 host 애트리뷰트가 지정될 때에만 의미를 같는다.
android:scheme – URI authority의 scheme영역이다. Scheme이 없다면 나머지 애트리뷰트는 의미가 없다. 스키마는 항상 소문자를 사용해야 한다.
<meta-data>
데이터에 대한 정의나 설명이다. 컴포넌트 엘리먼트는 <meta-data> 서브엘리먼트를 포함할 수 있다. <meta-data>의 모든 값은 하나의 Bundle로 모아지고 PackageItemInfo.metaData 필드로써 컴포넌트에서 사용할 수 있다.
<meta-data android:name="string"
android:resource="resource specification"
android:value="string" />
android:name – 아이템에 대한 고유한 이름이다. 예를들어 com.example.project.activity.fred처럼 Java 스타일 naming 규약을 사용해야 한다.
android:resource – 리소스에 대한 레퍼런스 이다. ID는 Bundle.getInt() 메쏘드에 의해 meta-data Bundle로부터 얻을수 있다.
android:value – 아이템에 할당된 값이다. 아래는 값으로 할당 할수 있는 데이터 타입과 값을 얻기 위해 사용하는 메쏘드들이다.
|
타입 |
Bundle 메쏘드 |
|
유니코드 문자를 위한 “\\n” 와 “\\uxxxxx” 같은 이스케이프(escape) 캐릭터에 더블 백슬래시(\\)를 사용하는 문자열 값 |
getString() |
|
“100”같은 정수(integer) 값 |
getInt() |
|
“참(true)” 또는 “거짓(false)” 중 하나인 boolean 값 |
getBoolean() |
|
“#rgb“,#”argb“,#”rrggbb” 또는 “#aarrggbb”형식의 컬러 값 |
getString() |
|
“1.23” 같은 부동소수점 값 |
getFloat() |
<activity-alias>
<activity-alias android:enabled=["true" | "false"]
android:exported=["true" | "false"]
android:icon="drawable resource"
android:label="string resource"
android:name="string"
android:permission="string"
android:targetActivity="string" >
. . .
</activity-alias>
<activity>를 타겟으로 지정해 그 타겟과 다른 속성으로 <activity>를 호출한다. targetActivity는 같은 <application>안에 있어야 하고 <activity-alias>보다 먼저 선언 되어 있어야 한다. targetActivity는 Activity-alias의 부모 엘리먼트이고 activity-alias는 targetActivity의 애트리뷰트를 따르지만 activity-alias안에 같은 애트리뷰트가 선언되면 activity-alias 애트리뷰트 값을 따른다.
android:exported – 다른 애플리케이션의 컴포넌트들이 이 앨리어스를 통해 타겟 액티비티를 런치할 수 있는지를 설정한다. 런치할 수 있다면 “true”이다. 인텐트 필터가 없으면 디폴트 값은 “false”이고 인텐트 필터가 있다면 디폴트 값은 “true”이다.
android:name – 앨리어스의 이름을 지정한다. 이름은 전체 클래스 이름과 비슷해야 하고 실제 클래스 이름을 참조하지 않는다.
android:permission – 이것이 설정된다면 targetActivity 퍼미션을 대체한다. 설정이 되지 않는다면 앨리어스를 통해 타겟을 활성화 하기 위한 퍼미션은 필요하지 않다.
android:targetActivity – 앨리어스를 통해 활성화 될 수 있는 액티비티의 이름을 지정한다.
<service>
<service android:enabled=["true" | "false"]
android:exported=["true" | "false"]
android:icon="drawable resource"
android:label="string resource"
android:name="string"
android:permission="string"
android:process="string" >
. . .
</service>
각 서비스마다 <service>태그가 필요하다. 서비스는 백그라운드 오퍼레이션이나 다른 애플리케이션이 호출 할 수 있는 커뮤니케이션 API를 구현하기 위해 사용된다.
android:icon – 서비스 아이콘은 이곳에서 설정하던 <application>엘리먼트에서 설정하던 모든 서비스의 인텐트 필터에 대한 디폴트 아이콘이다.
android:label – 서비스 아이콘은 이곳에서 설정하던 <application>엘리먼트에서 설정하던 모든 서비스의 인텐트 필터에 대한 디폴트 라벨이다.
android:name – 서비스를 구현하는 Service 서브클래스의 이름이다. com.example.project.RoomService 처럼 전체 클래스 이름이어야 한다. 하지만 .RoomService와 같이 단축형 이름이라면 <manifest>엘리먼트에 지정된 패키지 이름 끝에 붙여진다.
android:permission – 서비스를 런치하거나 바인드를 하기 위해 가져야 하는 퍼미션 이름이다. 만약 startsService(), bindService(), stopService()의 호출자가 이 퍼미션을 부여받지 않는다면 이 메쏘느는 작동하지 않으며 인턴트 오브젝트는 서비스에 전달되지 않는다. 이 퍼미션을 설정하지 않으면 <application>퍼미션이 적용되고 <application>퍼미션이 없다면 퍼미션이 적용되지 않는다.
<receiver>
<receiver android:enabled=["true" | "false"]
android:exported=["true" | "false"]
android:icon="drawable resource"
android:label="string resource"
android:name="string"
android:permission="string"
android:process="string" >
. . .
</receiver>
어플리케이션이 브로드캐스트 메시지를 수신할수 있도록 한다. 브로드캐스트 리시버는 애플리케이션의 다른 컴포넌트들이 실행되지 않아도 다른 애플리케이션 또는 시스템에 의해 브로드캐스트 되는 인텐트를 받기 위해 애플리케이션을 활성화 한다.
시스템에게 브로드캐스트 리시버를 알기기 위한 방법으로는 이 엘리먼트를 가지고 매니페스트 파일 안에 선언하는 것과 코드 안에서 동적으로 리시버를 만들어서 Context.registerReceiver() 메쏘드를 사용해서 등록한다.
android:exported – 브로드캐스트 리시버가 다른 애플리케이션 소스로부터 메시지를 받을수 있는지를 설정한다. 받을수 있으면 “true”이고 아니면 “false”이다. 인텐트 필터가 없으면 디폴트 값은 “false”이고 인텐트 필터가 있다면 디폴트 값은 “true”이다.
<provider>
<provider android:authorities="list"
android:enabled=["true" | "false"]
android:exported=["true" | "false"]
android:grantUriPermissions=["true" | "false"]
android:icon="drawable resource"
android:initOrder="integer"
android:label="string resource"
android:multiprocess=["true" | "false"]
android:name="string"
android:permission="string"
android:process="string"
android:readPermission="string"
android:syncable=["true" | "false"]
android:writePermission="string" >
. . .
</provider>
애플리케이션의 일부가 되는 모든 컨텐트 프로바이더를 선언해야 한다. 컨텐트 프로바이더 서브클래스에 대한 이름은 URI authority이다.
android:authorities – 데이터를 구분하는 URI authority 목록이다. Authority가 여러 개이면 세미콜론(;)으로 이름을 구분한다. 최소한 하나의 authority가 지정되어야 한다.
android:grantUriPermissions – 일시적으로 radPermission, writePermission, 데이터 접근 할수 있게 하려면 “ture”로 설정하거나 <grant-uri-permission>서브엘리먼트를 정의함으로써 이 기능을 활성화 한다. 퍼미션을 설정하지 않으려면 “false”로 한다.
android:initOrder – 컨텐트 프로바이더가 인스턴스화되어야 하는 순서를 설정한다. 높은 숫자들이 먼저 초기화 된다.
android:permission – 클라이언트가 컨텐트 프로바이더의 데이터를 읽거나 쓰기 위해 가져야 하는 퍼미션의 이름이다. 이 애트리뷰트는 읽기와 쓰기 모두에게 하나의 퍼미션을 설정한다. 하지만 readPermission과 writePermission 애트리뷰트가 이것보다 우선순위이다.
android:readPermission – 클라이언트가 컨텐트 프로바이더에 쿼리하기 위해 가져야 하는 퍼미션이다.
android:syncable – 컨텐트 프로바이더의 제어하에 있는 데이터가 서버 상의 데이터와 동기화되어져야 한다면 “true” 아니면 “false”이다.
android:writePermission – 클라이언트가 컨텐트 프로바이더에 의해 제어되는 데이터를 변경하기 위해 가져야 하는 퍼미션이다.
<uses-library>
<uses-permission android:name="string" />
어플리케이션에 링크 되어야 하는 외부 라이브러리를 지정한다.
android:name – 라이브러리 이름
디폴트 값
|
Element |
Atrribute |
디폴트 값 |
|
<instrumentation> |
android:functionalTest |
false |
|
android:handleProfiling |
false |
|
<uses-sdk> |
android:minSdkVersion |
1 |
|
android:maxSdkVersion |
없음 |
|
<supports-screens> |
android:smallScreens |
true(API Level 7 기준) |
|
android:normalScreens |
true(API Level 7 기준) |
|
android:largeScreens |
true(API Level 7 기준) |
|
android:anyDensity |
true(API Level 7 기준) |
|
<application> |
android:allowClearUserData |
|
|
android:allowTaskReparenting |
false |
|
android:debuggable |
false |
|
android:enable |
true |
|
android:hasCode |
true |
|
android:persistent |
false |
|
android:process |
<manifest>엘리먼트의 package 이름 |
|
android:taskAffinity |
<manifest>엘리먼트의 package 이름 |
|
<activity> |
android:alwaysRetainTaskState |
false |
|
android:clearTskOnLaunch |
false |
|
android:enabled |
true |
|
android:excludeFromRecents |
false |
|
android:exported |
Intent 필터가 없다면 false
Intent 필터가 있다면 true |
|
android:finishOnTaskLaunch |
false |
|
android:launchMode |
standard |
|
android:multiprocess |
false |
|
android:noHistory |
false |
|
android:permission |
<application>엘리먼트의 퍼미션
<application>퍼미션이 없다면 퍼미션에 의해 보호 되지 않음 |
|
android:process |
애플리케이션의 패키지 이름 |
|
android:stateNotNeeded |
false |
|
android:taskAffinity |
어플리케이션의 친화력을 상속.
어플리케이션의 디폴트 친화력 이름은 <manifest>엘리먼트의 패키지 이름이다. |
|
android:theme |
<application>테마
<application>테마가 없다면 시스템 테마 |
|
android:windowSoftInputMode |
소프트 키보드 : stateUnspecified
메인 윈도우 : adjustUnspecified |
|
<intent-filter> |
android:label |
부모 컴포넌트에 설정된 라벨
부모가 라벨을 설정하지 않으면 <application>라벨 |
|
<activity-alias> |
android:enabled |
true |
|
android:exported |
인텐트 필터가 없으면 false
인텐트 필터가 있으면 true |
|
android:permission |
targetActivity의 퍼미션
targetActivity의 퍼미션이 없다면 퍼미션에 의해 보호되지 않음 |
|
<service> |
android:enabled |
true |
|
android:exported |
인텐트 필터가 없으면 false
인텐트 필터가 있으면 true |
|
android:permission |
<application>엘리먼트의 퍼미션
<application>퍼미션이 없다면 퍼미션에 의해 보호되지 않음 |
|
<receiver> |
android:enabled |
true |
|
android:exported |
인텐트 필터가 없으면 false
인텐트 필터가 있으면 true |
|
android:permission |
<application>엘리먼트의 퍼미션
<application>퍼미션이 없다면 퍼미션에 의해 보호되지 않음 |
|
<provider> |
android:enabled |
true |
|
android:exported |
인텐트 필터가 없으면 false
인텐트 필터가 있으면 true |
|
android:multiprocess |
false |
|
android:process |
<application>엘리먼트의 프로세스 |
|
|
|
댓글을 달아 주세요