Unity与Android——Androidmanifest.xml文件的介绍

说明：

在Unity开发移动平台相关应用程序时，难免会涉及到一些必要的插件（如：社会化分享插件ShareSDK、Umeng；增强现实开发Vufoia；扫描二维码插件等一些列），每一种插件分开使用时特别好用，无需特殊配置，使用Example案例就能快速上手使用。然后，当有时同时需要多个插件同时使用时，由于每个插件都包含有自身的Androidmanifest.xml文件，必然会出现的问题就是后面导入到Unity工程的Androidmanifest.xml文件会自动重命名为Androidmanifest 1.xml，Androidmanifest 2.xml。。。由于同一个Android程序中，仅能识别一个“Androidmanifest”文件，后面导入并重命名的Androidmanifest.xml文件将无法识别到，也就导致了很多开发者在使用多个插件时只有一个插件功能可使用的情况。

掌握必要的Androidmanifest.xml内容：

Androidmanifest.xml介绍：

AndroidManifest.xml文件是Android系统重要文件，主要涉及到权限申请及定义配置文件，通过它可以向系统预先定义和申请应用程序运行所需要的权限。

Androidmanifest.xml的主要用途：

AndroidManifest.xml主要包含以下功能：

• 描述应用程序的相关信息——包名、命名空间、版本号、名称等
• 声明应用程序所必须具备的权限——如获取相机权限、WiFi权限等
• 声明程序的入口
• 指定应用程序所使用的SDK版本
• 指定应用程序会使用到的库文件
• 设定应用程序的硬件或一些属性——屏幕大小、是否支持旋转屏幕等

Androidmanifest.xml的详解：

Androidmanifest.xml的结构

[html] view plain copy

1. <pre name="code" class="html"><?xmlversionxmlversion="1.0"encoding="utf-8"?>  
2.   
3.     <!-- 基本配置 -->    
4. <manifest  
5.         android:versionName="1.0"   
6.         android:versionCode="1"   
7.         package="com.unity3d.player"   
8.         xmlns:android="http://schemas.android.com/apk/res/android">  
9.     <!-- 应用程序配置 -->    
10.     <application>  
11.         <!-- 活动项 -->    
12.        <activity>  
13.            <intent-filter>  
14.                <action/>  
15.                <category/>  
16.            </intent-filter>  
17.       </activity>  
18.       <!-- 后端活动项 -->    
19.        <service>  
20.            <intent-filter></intent-filter>  
21.            <meta-data/>  
22.        </service>  
23.        <!--发送广播-->  
24.        <receiver>  
25.            <intent-filter></intent-filter>  
26.            <meta-data/>  
27.        </receiver>  
28.         <!--使用的库文件-->  
29.        <uses-library/>  
30.     </application>  
31.       
32.     <!--权限配置-->  
33.     <uses-permission/>  
34.     <permission/>  
35.   
36.     <!--用于监控-->  
37.     <instrumentation/>  
38.     <!--SDK版本-->  
39.     <uses-sdk/>  
40.     <!---软硬件描述-->  
41.     <uses-configuration/>   
42.     <uses-feature/>   
43.     <!--屏幕设置-->  
44.     <supports-screens/>  
45. </manifest>  

Androidmanifest.xml的结构——(<Manifest>):(属性)

[html] view plain copy

1. <manifest  xmlns:android="http://schemas.android.com/apk/res/android"  
2.           package="com.Bruce.Xu.test"  
3.           android:sharedUserId="string"  
4.           android:sharedUserLabel="string resource"  
5.           android:versionCode="integer"  
6.           android:versionName="string"  
7.           android:installLocation=["auto" | "internalOnly" | "preferExternal"] >  
8. </manifest>  

• xmlns:android——定义android命名空间，一般为http://schemas.android.com/apk/res/android，这样使得Android中各种标准属性能在文件中使用，提供了大部分元素中的数据。
• package——指定本应用内java主程序包的包名，它也是一个应用进程的默认名称
• sharedUserId——表明数据权限，因为默认情况下，Android给每个APK分配一个唯一的UserID，所以是默认禁止不同APK访问共享数据的。若要共享数据，第一可以采用Share Preference方法，第二种就可以采用sharedUserId了，将不同APK的sharedUserId都设为一样，则这些APK之间就可以互相共享数据了。
• sharedUserLabel——一个共享的用户名，它只有在设置了sharedUserId属性的前提下才会有意义
• versionCode——是给设备程序识别版本(升级)用的必须是一个interger值代表app更新过多少次
• versionName——显示出来的版本名称
• installLocation——安装参数，installLocation有三个值：internalOnly、auto、preferExternal
• 选择preferExternal,系统会优先考虑将APK安装到SD卡上(当然最终用户可以选择为内部ROM存储上，如果SD存储已满，也会安装到内部存储上)
• 选择auto，系统将会根据存储空间自己去适应
• 选择internalOnly是指必须安装到内部才能运行

Androidmanifest.xml的结构——(<Application>):属性

一个AndroidManifest.xml中必须含有一个Application标签，这个标签声明了每一个应用程序的组件及其属性(如icon,label,permission等)

[html] view plain copy

1. <application  android:allowClearUserData=["true" | "false"]  
2.              android:allowTaskReparenting=["true" | "false"]  
3.              android:backupAgent="string"  
4.              android:debuggable=["true" | "false"]  
5.              android:description="string resource"  
6.              android:enabled=["true" | "false"]  
7.              android:hasCode=["true" | "false"]  
8.              android:icon="drawable resource"  
9.              android:killAfterRestore=["true" | "false"]  
10.              android:label="string resource"  
11.              android:manageSpaceActivity="string"  
12.              android:name="string"  
13.              android:permission="string"  
14.              android:persistent=["true" | "false"]  
15.              android:process="string"  
16.              android:restoreAnyVersion=["true" | "false"]  
17.              android:taskAffinity="string"  
18.              android:theme="resource or theme" >  
19. </application>  

• android:allowClearUserData('true' or 'false')——用户是否能选择自行清除数据，默认为true，程序管理器包含一个选择允许用户清除数据。当为true时，用户可自己清理用户数据，反之亦然
• android:allowTaskReparenting('true' or 'false')——是否允许activity更换从属的任务，比如从短信息任务切换到浏览器任务
• android:backupAgent——这也是Android2.2中的一个新特性，设置该APP的备份，属性值应该是一个完整的类名，如com.project.TestCase，此属性并没有默认值，并且类名必须得指定(就是个备份工具，将数据备份到云端的操作)
• 
  
• 
  
• android:debuggable——这个从字面上就可以看出是什么作用的，当设置为true时，表明该APP在手机上可以被调试。默认为false,在false的情况下调试该APP，就会报以下错误：
• 
  
• 
  
• android:description/android:label——此两个属性都是为许可提供的，均为字符串资源，当用户去看许可列表(android:label)或者某个许可的详细信息(android:description)时，这些字符串资源就可以显示给用户。label应当尽量简短，之需要告知用户该许可是在保护什么功能就行。而description可以用于具体描述获取该许可的程序可以做哪些事情，实际上让用户可以知道如果他们同意程序获取该权限的话，该程序可以做什么。我们通常用两句话来描述许可，第一句描述该许可，第二句警告用户如果批准该权限会可能有什么不好的事情发生
• 
  
• 
  
• android:enabled——Android系统是否能够实例化该应用程序的组件，如果为true，每个组件的enabled属性决定那个组件是否可以被 enabled。如果为false，它覆盖组件指定的值；所有组件都是disabled。
• 
  
• 
  
• android:hasCode('true' or 'false')——表示此APP是否包含任何的代码，默认为true，若为false，则系统在运行组件时，不会去尝试加载任何的APP代码
• 一个应用程序自身不会含有任何的代码，除非内置组件类，比如Activity类，此类使用了AliasActivity类，当然这是个罕见的现象
• (在Android2.3可以用标准C来开发应用程序，可在androidManifest.xml中将此属性设置为false,因为这个APP本身已经不含有任何的JAVA代码了)
• 
  
• 
  
• android:icon——这个很简单，就是声明整个APP的图标，图片一般都放在drawable文件夹下
• 
  
• 
  
• android:name——为应用程序所实现的Application子类的全名。当应用程序进程开始时，该类在所有应用程序组件之前被实例化。
• 
  
• 
  
• android:permission——设置许可名，这个属性若在<application>上定义的话，是一个给应用程序的所有组件设置许可的便捷方式，当然它是被各组件设置的许可名所覆盖的
• 
  
• 
  
• android:presistent——该应用程序是否应该在任何时候都保持运行状态,默认为false。因为应用程序通常不应该设置本标识，持续模式仅仅应该设置给某些系统应用程序才是有意义的。
• 
  
• 
  
• android:process——应用程序运行的进程名，它的默认值为<manifest>元素里设置的包名，当然每个组件都可以通过设置该属性来覆盖默认值。如果你想两个应用程序共用一个进程的话，你可以设置他们的android:process相同，但前提条件是他们共享一个用户ID及被赋予了相同证书的时候
• 
  
• 
  
• android:restoreAnyVersion——同样也是android2.2的一个新特性，用来表明应用是否准备尝试恢复所有的备份，甚至该备份是比当前设备上更要新的版本，默认是false
• 
  
• 
  
• android:taskAffinity——拥有相同的affinity的Activity理论上属于相同的Task，应用程序默认的affinity的名字是<manifest>元素中设定的package名

Androidmanifest.xml的结构——(<Activity>):属性

[html] view plain copy

1. <activity android:allowTaskReparenting=["true" | "false"]  
2.           android:alwaysRetainTaskState=["true" | "false"]  
3.           android:clearTaskOnLaunch=["true" | "false"]  
4.           android:configChanges=["mcc", "mnc", "locale",  
5.                                  "touchscreen", "keyboard", "keyboardHidden",  
6.                                  "navigation", "orientation", "screenLayout",  
7.                                  "fontScale", "uiMode"]  
8.           android:enabled=["true" | "false"]  
9.           android:excludeFromRecents=["true" | "false"]  
10.           android:exported=["true" | "false"]  
11.           android:finishOnTaskLaunch=["true" | "false"]  
12.           android:icon="drawable resource"  
13.           android:label="string resource"  
14.           android:launchMode=["multiple" | "singleTop" |  
15.                               "singleTask" | "singleInstance"]  
16.           android:multiprocess=["true" | "false"]  
17.           android:name="string"  
18.           android:noHistory=["true" | "false"]    
19.           android:permission="string"  
20.           android:process="string"  
21.           android:screenOrientation=["unspecified" | "user" | "behind" |  
22.                                      "landscape" | "portrait" |  
23.                                      "sensor" | "nosensor"]  
24.           android:stateNotNeeded=["true" | "false"]  
25.           android:taskAffinity="string"  
26.           android:theme="resource or theme"  
27.           android:windowSoftInputMode=["stateUnspecified",  
28.                                        "stateUnchanged", "stateHidden",  
29.                                        "stateAlwaysHidden", "stateVisible",  
30.                                        "stateAlwaysVisible", "adjustUnspecified",  
31.                                        "adjustResize", "adjustPan"] >     
32. </activity>  

• android:alwaysRetainTaskState——是否保留状态不变， 比如切换回home, 再从新打开，activity处于最后的状态。比如一个浏览器拥有很多状态(当打开了多个TAB的时候)，用户并不希望丢失这些状态时，此时可将此属性设置为true
• android:clearTaskOnLaunch——比如 P 是 activity, Q 是被P 触发的 activity, 然后返回Home, 重新启动 P，是否显示 Q
• android:configChanges——当配置list发生修改时， 是否调用 onConfigurationChanged() 方法  比如 "locale|navigation|orientation". 这个我用过,主要用来看手机方向改变的. android手机在旋转后,layout会重新布局, 如何做到呢?正常情况下. 如果手机旋转了.当前Activity后杀掉,然后根据方向重新加载这个Activity. 就会从onCreate开始重新加载.如果你设置了 这个选项, 当手机旋转后,当前Activity之后调用onConfigurationChanged() 方法. 而不跑onCreate方法等.
• android:excludeFromRecents——是否可被显示在最近打开的activity列表里，默认是false
• android:finishOnTaskLaunch——当用户重新启动这个任务的时候，是否关闭已打开的activity，默认是false。如果这个属性和allowTaskReparenting都是true,这个属性就是王牌。Activity的亲和力将被忽略。该Activity已经被摧毁并非re-parented
• android:launchMode(Activity加载模式)——在多Activity开发中，有可能是自己应用之间的Activity跳转，或者夹带其他应用的可复用Activity。可能会希望跳转到原来某个Activity实例，而不是产生大量重复的Activity。这需要为Activity配置特定的加载模式，而不是使用默认的加载模式
• Activity有四种加载模式：
• standard、singleTop、singleTask、singleInstance(其中前两个是一组、后两个是一组)，默认为standard 
• standard：就是intent将发送给新的实例，所以每次跳转都会生成新的activity。
• singleTop：也是发送新的实例，但不同standard的一点是，在请求的Activity正好位于栈顶时(配置成singleTop的Activity)，不会构造新的实例
• singleTask：和后面的singleInstance都只创建一个实例，当intent到来，需要创建设置为singleTask的Activity的时候，系统会检查栈里面是否已经有该Activity的实例。如果有直接将intent发送给它。
• singleInstance：首先说明一下task这个概念，Task可以认为是一个栈，可放入多个Activity。比如启动一个应用，那么Android就创建了一个Task，然后启动这个应用的入口Activity，那在它的界面上调用其他的Activity也只是在这个task里面。那如果在多个task中共享一个Activity的话怎么办呢。举个例来说，如果开启一个导游服务类的应用程序，里面有个Activity是开启GOOGLE地图的，当按下home键退回到主菜单又启动GOOGLE地图的应用时，显示的就是刚才的地图，实际上是同一个Activity，实际上这就引入了singleInstance。singleInstance模式就是将该Activity单独放入一个栈中，这样这个栈中只有这一个Activity，不同应用的intent都由这个Activity接收和展示，这样就做到了共享。当然前提是这些应用都没有被销毁，所以刚才是按下的HOME键，如果按下了返回键，则无效
• android:multiprocess——是否允许多进程，默认是false
• android:noHistory——当用户从Activity上离开并且它在屏幕上不再可见时，Activity是否从Activity stack中清除并结束。默认是false。Activity不会留下历史痕迹
• android:screenOrientation——activity显示的模式
• 默认为unspecified：由系统自动判断显示方向
• landscape横屏模式，宽度比高度大
• portrait竖屏模式, 高度比宽度大
• user模式，用户当前首选的方向
• behind模式：和该Activity下面的那个Activity的方向一致(在Activity堆栈中的)
• sensor模式：有物理的感应器来决定。如果用户旋转设备这屏幕会横竖屏切换
• nosensor模式：忽略物理感应器，这样就不会随着用户旋转设备而更改了
• android:stateNotNeeded——activity被销毁或者成功重启时是否保存状态
• android:windowSoftInputMode——activity主窗口与软键盘的交互模式，可以用来避免输入法面板遮挡问题，Android1.5后的一个新特性。
• 这个属性能影响两件事情：
• 【A】当有焦点产生时，软键盘是隐藏还是显示
• 【B】是否减少活动主窗口大小以便腾出空间放软键盘
• 各值的含义：
• 【A】stateUnspecified：软键盘的状态并没有指定，系统将选择一个合适的状态或依赖于主题的设置
• 【B】stateUnchanged：当这个activity出现时，软键盘将一直保持在上一个activity里的状态，无论是隐藏还是显示
• 【C】stateHidden：用户选择activity时，软键盘总是被隐藏
• 【D】stateAlwaysHidden：当该Activity主窗口获取焦点时，软键盘也总是被隐藏的
• 【E】stateVisible：软键盘通常是可见的
• 【F】stateAlwaysVisible：用户选择activity时，软键盘总是显示的状态
• 【G】adjustUnspecified：默认设置，通常由系统自行决定是隐藏还是显示
• 【H】adjustResize：该Activity总是调整屏幕的大小以便留出软键盘的空间
• 【I】adjustPan：当前窗口的内容将自动移动以便当前焦点从不被键盘覆盖和用户能总是看到输入内容的部分

Androidmanifest.xml的结构——(<intent-filter>)

[html] view plain copy

1. <intent-filter  android:icon="drawable resource"  
2.                android:label="string resource"  
3.                android:priority="integer" >  
4.       <action />  
5.       <category />  
6.       <data />  
7.   
8. </intent-filter>   

• android:priority(解释：有序广播主要是按照声明的优先级别，如A的级别高于B，那么，广播先传给A，再传给B。优先级别就是用设置priority属性来确定，范围是从-1000～1000，数越大优先级别越高)
• Intent filter内会设定的资料包括action,data与category三种。也就是说filter只会与intent里的这三种资料作对比动作
• action属性：
• action很简单，只有android:name这个属性。常见的android:name值为android.intent.action.MAIN，表明此activity是作为应用程序的入口。有关android:name具体有哪些值，可参照这个网址：http://hi.baidu.com/linghtway/blog/item/83713cc1c2d053170ff477a7.html
• category属性：
• category也只有android:name属性。常见的android:name值为android.intent.category.LAUNCHER(决定应用程序是否显示在程序列表里)

Androidmanifest.xml的结构——data属性

[html] view plain copy

1. <data  android:host="string"  
2.       android:mimeType="string"  
3.       android:path="string"  
4.       android:pathPattern="string"  
5.       android:pathPrefix="string"  
6.       android:port="string"  
7.       android:scheme="string"/>  

• 每个<data>元素指定一个URI和数据类型（MIME类型）。它有四个属性scheme、host、port、path对应于URI的每个部分： 
• scheme://host:port/path
• scheme的值一般为"http"，host为包名，port为端口号，path为具体地址。如：http://com.test.project:200/folder/etc
• 其中host和port合起来构成URI的凭据(authority)，如果host没有指定，则port也会被忽略
• 要让authority有意义，scheme也必须要指定。要让path有意义，scheme+authority也必须要指定
• mimeType（指定数据类型），若mimeType为'Image'，则会从content Provider的指定地址中获取image类型的数据。还有'video'啥的，若设置为video/mp4，则表示在指定地址中获取mp4格式的video文件
• 而pathPattern和PathPrefix主要是为了格式化path所使用的

Androidmanifest.xml的结构——<meta-data>

[html] view plain copy

1. <meta-data android:name="string"  
2.            android:resource="resource specification"  
3.            android:value="string"/>  

这是该元素的基本结构.可以包含在<activity> <activity-alias> <service> <receiver>四个元素中。

• android:name（解释：元数据项的名字，为了保证这个名字是唯一的，采用java风格的命名规范，如com.woody.project.fried)
• android:resource(解释：资源的一个引用，指定给这个项的值是该资源的id。该id可以通过方法Bundle.getInt()来从meta-data中找到。)
• android:value(解释：指定给这一项的值。可以作为值来指定的数据类型并且组件用来找回那些值的Bundle方法：[getString],[getInt],[getFloat],[getString],[getBoolean])

Androidmanifest.xml的结构——<service>

• 【1】service与activity同级，与activity不同的是，它不能自己启动的，运行在后台的程序，如果我们退出应用时，Service进程并没有结束，它仍然在后台运行。比如听音乐，网络下载数据等，都是由service运行的
• 【2】service生命周期：Service只继承了onCreate(),onStart(),onDestroy()三个方法，第一次启动Service时，先后调用了onCreate(),onStart()这两个方法，当停止Service时，则执行onDestroy()方法，如果Service已经启动了，当我们再次启动Service时，不会在执行onCreate()方法，而是直接执行onStart()方法
• 【3】service与activity间的通信
• Service后端的数据最终还是要呈现在前端Activity之上的，因为启动Service时，系统会重新开启一个新的进程，这就涉及到不同进程间通信的问题了(AIDL)，Activity与service间的通信主要用IBinder负责。

Androidmanifest.xml的结构——<receiver>

• receiver的属性与service一样
• BroadcastReceiver：用于发送广播，broadcast是在应用程序之间传输信息的一种机制，而BroadcastReceiver是对发送出来的 Broadcast进行过滤接受并响应的一类组件

Androidmanifest.xml的结构——<uses-library>

用户库，可自定义。所有android的包都可以引用