Android xml application属性详解


例子:java

<application
     android:allowClearUserData=["true" | "false"]
     android:allowTaskReparenting=["true" | "false"]
     android:backupAgent="string"
     android:debuggable=["true" | "false"]
     android:description="string resource"
     android:enabled=["true" | "false"]
     android:hasCode=["true" | "false"]
     android:icon="drawable resource"
     android:killAfterRestore=["true" | "false"]
     android:label="string resource"
     android:manageSpaceActivity="string"
     android:name="string"
     android:permission="string"
     android:persistent=["true" | "false"]
     android:process="string"
     android:restoreAnyVersion=["true" | "false"]
     android:taskAffinity="string"
     android:theme="resource or theme" >
     . . .
</application>

描述:android

应用的声明。这个元素包含了子元素,这些子元素声明了应用的组件,元素的属性将会影响应用下的全部组件。不少属性为组件设置了默认值。有些属性设置了全局值而且不能被组件修改。app

属性:函数

一、android:allowClearUserData工具

是否给以用户删除用户数据的权限,若是为true应用管理者就拥有清除数据的权限;false没有。默认为true。测试

二、android:allowTaskReparentingui

应用定义的activities是否能够被从启动的任务转移到和他有相同而且将被带到前台的任务。true他们能够被转移,若是为false,他们必须和启动他们的任务保持在一块儿。默认为false。编码

主要做用是activity的迁移,即从一个task迁移到另外一个task,这个迁移跟activity的taskAffinity有关,必须是将该activity从旧的 taskAffinity迁移到新的taskAffinity中.只有设置了FLAG_ACTIVITY_RESET_TASK_IF_NEEDED标识才会用到该属性。从home上启动的程序都会设置该Flag,会进行task reset.spa

下面举个例子,有两个apk
debug

apk1中含有个Activity:MainActivityA和ActivityB, ActivityB设置了allowTaskReparenting为false.
apk2中含有两一个activity:MainActivityB,MainActivityB点击的时候会启动ActivityB

首先咱们启动apk2,进入MainActivityB,点击MainActivityB会进入ActivityB, 按home键,再从Home键启动apk1,用dumpsys工具获得这个时候的堆栈:

图中蓝色线框部分表示对应的Activity所属的task

能够看到,然从Home启动apk1的时候带有FLAG_ACTIVITY_RESET_TASK_IF_NEEDED,但在任务重置的过程当中什么事也没有作。 
咱们把ActivityB的allowTaskReparenting改成true,这个时候前面的步骤同样,当咱们从Home启动apk1时,咱们惊奇的发现,启动的居然是ActivityB,能够看到此时的堆栈:


这是因为重置任务的时候把它迁移到了新启动的task中。分析android源码中的resetTaskIfNeededLocked函数时就会明白这个是怎么回事了。

三、android:backupAgent

实现应用的备份代理的类名,BackupAgent的子类。这个属性的名称因该是全限定类名(如,"com.example.project.MyBackupAgent")。可是,若是名称的首字母被设置为点号,也能够为类名(如,".MyBackupAgent"),他将被追加到在<manifest>元素中定义的包名后。没有默认值。

四、android:debuggable

应用是否可使用debug,甚至运行在用户模式下。true能够,false不能。默认为false。

五、android:description

用户可读的,比应用标签更长、更多的应用描述。此值必须是一个引用字符串。不像标签,他不能被设置为硬编码字符串。没有默认值。

六、android:enabled

Android系统是否能够实例化应用的组件。若是为true能够,若是为false不能够。若是为true时,每一个组件的enabled属性决定了此组件

是否可用。若是为false,他重写了组件指定值,全部的组件将不还用。默认为true。

七、android:hasCode

应用是否包含代码。true表示包含,false表示不包含。当值为false时,在启动组件是系统不会试着加载应用的任何代码。默认为true。

八、android:icon

整个应用的图标,仍是每一个组件的默认图标。这个属性值必须被设置为drawable资源的引用。没有默认值。

九、android:killAfterRestore

在整型系统重置操做中,当他的设置被重置后,应用是否应该被终止。单个包的重置操做不会引发应用被关闭。整个系统的恢复操做仅表明性的发生一次,当电话第一次被设置时。第三方应用将不会常用此属性。

默认值为true,意思是,当整个系统被恢复时,应用运行玩他的数据后,将会终止。

十、android:label

一个易读的应用标签,而且仍是应用的每一个组件的默认标签。这个标签应该被设置为引用字符串资源,固然他也能够像其余字符串同样在用户接口中指定。可是为了方便,在应用开发时,能够被设置未定义字符串。

十一、android:manageSpaceActivity

一个Activity子类的全限定名称,这个Activity能够被系统启动让用户管理此应用占有的存储空间。这个Activity也应该用<activity>元素声明。

十二、android:name

为这个应用实现的Application子类的全限定名称。当应用启动时,这个类将在应用的其余组件以前被实例化。

这个子类是可选的;大多数应用不须要。在缺省时,Android使用基本Application类的实例。

1三、android:permission

客户为了和应用交互必须设置的许可的名称。这个属性是一个便利的途径为应用的组件设置许可。他能够被组件的permission属性重写。

1四、android:persistent

应用是否在全部时间下都保持运行。true是,false不是。默认为false。一般状况下应用不该该设置此标识。持久模式仅仅被几个系统应用指定。

1五、android:process

为应用下的组件定一个运行进程名称。每一个组件能够定义本身的进程名称经过设置本身的process属性。

在默认状况下,Android为应用建立一个进程,当应用的第一个组件须要运行时。全部的组件在同一个进程下运行。这个进程的名称和在<manifest>元素设置的backage属性名相同。经过设置这个属性在能够在其余应用中共享,你能够协调应用的组件在同一个进程中运行,可是只有两应用也共享用户ID和签定相同的证书。若是这个属性的名称一个冒号(":")开始,一个新的私有的进程将被建立。若是一个进程的名称以小写字母开头,一个公共的进程将被建立。一个公共的进程能够被其余应用共享,来减小资源的使用。

1六、android:restoreAnyVersion

代表这个应用准备尝试恢复全部的备份数据集合,甚至若是备份数据是比当前安装的应用高的编号存储的。设置为true将容许备份管理者去尝试恢复当版本不匹配,意思是数据冲突。要当心使用。默认为false。

1七、android:taskAffinity

提供给应用下全部组件的类同名称,除了设置了本身的taskAffinity属性的组件。默认状况下全部的组件使用相同的affinity。Affinity的名称和在<manifest>元素中设置的包名相同。

Activity的归属,也就是Activity应该在哪一个Task中,Activity与Task的吸附关系。默认若是没有设置taskAffinity,则taskAffinity跟包名是同样的
taskAffinity 和 FLAG_ACTIVITY_NEW_TASK可用来决定activity启动时是否须要新建一个task。咱们分四种状况看一下这两个标志对启动activity的影响:(前提:从MainActivity中启动ActivityA)
1)、两个标志都不设置
2)、有FLAG_ACTIVITY_NEW_TASK  
3)、无FLAG_ACTIVITY_NEW_TASK有taskAffinity (不一样于MainActivity)
4)、有FLAG_ACTIVITY_NEW_TASK有taskAffinity
注意上面的标志都是针对于启动的ActivityA,FLAG_ACTIVITY_NEW_TASK  是在启动ActivityA的Intent中设置的,taskAffinity 是在AndroidManifest中ActivityA中设置,另外注意这里两个actiity的启动模式都设置为standard
①、先看第一中状况:

主要代码:

<activity android:name=".ActivityA"    
			android:launchMode="standard"  
			android:label="@string/title_activityA">    
  <intent-filter>    
	  <action android:name="com.leaves.ipanel.ActivityA"/>    
	  <category android:name="android.intent.category.DEFAULT"/>    
  </intent-filter>    
</activity>

MainActivity启动activity

public void onClick(View arg0) {  
	// TODO Auto-generated method stub  
	Log.i(TAG, "--onClick--task id = " + getCurrentTaskId());  
	Intent intent = new Intent("com.leaves.ipanel.ActivityA");      

	startActivity(intent);   
}

启动A以后的堆栈:

②、有FLAG_ACTIVITY_NEW_TASK  
咱们添加FLAG_ACTIVITY_NEW_TASK  

public void onClick(View arg0) {  
	// TODO Auto-generated method stub  
	Log.i(TAG, "--onClick--task id = " + getCurrentTaskId());  
	Intent intent = new Intent("com.leaves.ipanel.ActivityA");      
	intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);  
	startActivity(intent);   
}

启动A以后的堆栈:

③、无FLAG_ACTIVITY_NEW_TASK有taskAffinity (不一样于MainActivity)

<activity android:name=".ActivityA"    
            android:launchMode="standard"  
            android:taskAffinity="com.leaves.test.ActivityA"  
          android:label="@string/title_activityA">    
       <intent-filter>    
           <action android:name="com.leaves.ipanel.ActivityA"/>    
           <category android:name="android.intent.category.DEFAULT"/>    
       </intent-filter>    
</activity>
public void onClick(View arg0) {  
    // TODO Auto-generated method stub  
    Log.i(TAG, "--onClick--task id = " + getCurrentTaskId());  
    Intent intent = new Intent("com.leaves.ipanel.ActivityA");      
          
    startActivity(intent);   
}

查看一下启动A以后的堆栈:

④、有FLAG_ACTIVITY_NEW_TASK有taskAffinity

把FLAG_ACTIVITY_NEW_TASK添加上去    

public void onClick(View arg0) {  
	// TODO Auto-generated method stub  
	Log.i(TAG, "--onClick--task id = " + getCurrentTaskId());  
	Intent intent = new Intent("com.leaves.ipanel.ActivityA");      
	intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);  
	startActivity(intent);   
}

查看一下启动A以后的堆栈:

上面咱们测试的两个Activity是在同一个应用中,若是他们在不一样的应用中呢,例如ActivityA跟MainActivity不在一个apk中,其实状况仍是同样的.由于默认若是没有设置taskAffinity,则taskAffinity跟包名是同样的。若不考虑android:allowTaskReparenting,若是ActivityA跟MainActivity不在一个apk中,当没有FLAG_ACTIVITY_NEW_TASK时,则二者应该是在同一个task,可是若是有FLAG_ACTIVITY_NEW_TASK,则二者应该会在不一样的task中。 

1八、android:theme

为应用下的组件定义一个引用自样式资源的主题。个别的activities能够设置本身的主题,经过设置本身的theme属性。

1九、android:uiOptions

这个属性设置了Activity的UI的额外选项。它必须是下表中的一个值: