关于Android Manifest.xml

Android Manifest.xml

简述:

每一个andriod程序都包含了AndriodManifest.xml文件,一个应用程序可以有1个或多个活动,而没有任何限制。每个为应用程序所定义的活动都需要在AndroidManifest.xml中声明。以下是官方列出的作用:

  • 为应用的 Java 软件包命名。软件包名称充当应用的唯一标识符。
  • 描述应用的各个组件,包括构成应用的 Activity、服务、广播接收器和内容提供程序。它还为实现每个组件的类命名并发布其功能,例如它们可以处理的 Intent 消息。这些声明向 Android 系统告知有关组件以及可以启动这些组件的条件的信息。
  • 确定托管应用组件的进程。
  • 声明应用必须具备哪些权限才能访问 API 中受保护的部分并与其他应用交互。还声明其他应用与该应用组件交互所需具备的权限
  • 列出 Instrumentation类,这些类可在应用运行时提供分析和其他信息。这些声明只会在应用处于开发阶段时出现在清单中,在应用发布之前将移除。
  • 声明应用所需的最低 Android API 级别
  • 列出应用必须链接到的库

以下是样例代码:

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
   package="com.example.helloworld"
   android:versionCode="1"
   android:versionName="1.0" >

   <uses-sdk
      android:minSdkVersion="8"
      android:targetSdkVersion="22" />

   <application
       android:icon="@drawable/ic_launcher"
       android:label="@string/app_name"
       android:theme="@style/AppTheme" >

       <activity
          android:name=".MainActivity"
          android:label="@string/title_activity_main" >

          <intent-filter>
             <action android:name="android.intent.action.MAIN" />
             <category android:name="android.intent.category.LAUNCHER"/>
          </intent-filter>

       </activity>

   </application>
</manifest>

层次结构

Manifest.xml的层次结构基本由 等构成,至少三层的嵌套是Manifest.xml中必须存在的

<manifest>元素

首先,所有的xml都必须包含元素。这是文件的根节点。它必须要包含元素,并且指明xmlns:android和package属性

<manifest>元素中的属性
  • xmlns:android

    这个属性定义了Android命名空间。必须设置成"http://schemas.android.com/apk/res/android"。不要手动修改。

  • package

    这是一个完整的Java语言风格包名。包名由英文字母(大小写均可)、数字和下划线组成。每个独立的名字必须以字母开头。

    构建APK的时候,构建系统使用这个属性来做两件事:

  1. 生成R.java类时用这个名字作为命名空间(用于访问APP的资源)
    比如:package被设置成com.sample.teapot,那么生成的R类就是:com.sample.teapot.R

  2. 用来生成在manifest文件中定义的类的完整类名。比如package被设置成com.sample.teapot,并且activity元素被声明成,完整的类名就是com.sample.teapot.MainActivity。

    包名也代表着唯一的application ID,用来发布应用。但是,要注意的一点是:在APK构建过程的最后一步,package名会被build.gradle文件中的applicationId属性取代。如果这两个属性值一样,那么万事大吉,如果不一样,那就要小心了。

  • android:versionCode

    内部的版本号。用来表明哪个版本更新。这个数字不会显示给用户。显示给用户的是versionName。这个数字必须是整数。不能用16进制,也就是说不接受"0x1"这种参数

  • android:versionName

    显示给用户看的版本号。

<manifest>元素中的元素
  • <uses-feature>元素
    uses-feature只是对外提供了这样一组信息,表明它所依赖的软硬件特征,这个信息通常是给应用市场使用的,应用市场会读取app的uses-feature设置,然后只给那些满足这组软硬件特征的设备分发这个app。
    这种限制在从android应用市场下载时便会体现,一个要求匹配蓝牙设备的apk将无法被不支持蓝牙的设备所下载。但是,通过其他渠道下载的apk将不受这样的限制
    使用的时候要注意,必须在单独的元素中指定每个功能,如果要多个功能,需要多个元素。比如要求设备同时具有蓝牙和相机功能:
    Google Play利用这个元素的值从不符合应用需要的设备上将应用过滤。

<application>的属性

  • android:allowBackup

    表示是否允许APP加入到备份还原的结构中。如果设置成false,那么应用就不会备份还原。默认值为true。

  • android:fullBackupContent

    这个属性指向了一个xml文件,该文件中包含了在进行自动备份时的完全备份规则。这些规则定义了哪些文件需要备份。此属性是一个可选属性。默认情况下,自动备份包含了大部分app文件。

  • android:supportsRtl

    声明你的APP是否支持RTL(Right To Left)布局。如果设置成true,并且targetSdkVersion被设置成17或更高。很多RTL API会被集火,这样你的应用就可以显示RTL布局了。如果设置成false或者targetSdkVersion被设置成16或更低。哪些RTL API就不起作用了。

    该属性的默认的值是false。

    关于RTL布局,RTL是对语言的一种描述。

    RTL语言即Right-to-left(从右向左)的语言.其书写习惯为从右向左,朝左继续。常见的RTL语言有阿拉伯语,希伯来语等。
    LTR语言和RTL语言刚好相反,即我们常见的Left-to-right,Top-to-bottom,从左向右,从上到下,朝右继续.这种语言很常见, 代表语言为英语等。
    双向文本( Bi-Directional Text),即RTL文本和LTR文本混合的情况.比较复杂。

    由于语言词汇自身的设计,部分语言存在RTL的阅读方式,因此android也同样支持这样的布局。

  • android:icon

    APP的图标,以及每个组件的默认图标。可以在组价中自定义图标。这个属性必须设置成一个引用,指向一个可绘制的资源,这个资源必须包含图片。系统不设置默认图标。

  • android:label

    一个用户可读的标签,以及所有组件的默认标签。子组件可以用他们的label属性定义自己的标签,如果没有定义,那么就用这个标签。

    标签必须设置成一个字符串资源的引用。这样它们就能和其他东西一样被定位,比如@string/app_name。当然,为了开发方便,你也可以定义一个原始字符串。

  • android:theme

    该属性定义了应用使用的主题的,它是一个指向style资源的引用。各个activity也可以用自己的theme属性设置自己的主题。

<activity>元素

该元素声明一个实现应用可视化界面的Activity(Activity类子类),只有由Activty驱动的xml布局文件才能够实现各种不同的功能。这是元素中必要的子元素。所有Activity都必须由清单文件中的元素表示。任何未在该处声明的Activity对系统都不可见,并且永远不会被执行。

  • android:name

    Activity类的名称,是Activity类的子类。该属性值为完全限定类名称,例如com.sample.teapot.TeapotNativeActivity。为了方便起见,如果第一个字符是点(’.’),就需要加上元素中的包名。应用一旦发布,不应更改该名称。

    没有默认值,必须指定该名称。

  • android:label

    Activity标签,可以被用户读取。该标签会在Activity激活时显示在屏幕上。如果未设置,用中的label属性。对属性的设置要求和中一样。

  • android:configChanges

    列出 Activity 将自行处理的配置更改消息。在运行时发生配置更改时,默认情况下会关闭 Activity 然后将其重新启动,但使用该属性声明配置将阻止 Activity 重新启动。 Activity 反而会保持运行状态,并且系统会调用其 onConfigurationChanged()方法。

:应避免使用该属性,并且只应在万不得已的情况下使用。 如需了解有关如何正确处理配置更改所致重新启动的详细信息,请阅读处理运行时变更

​ 这属性可以设置的项很多,这里列出常用的项:

  • orientation
    屏幕放心啊发生了变化,比如用户旋转了设备
  • keyboardHidden
    键盘无障碍功能发生了变化,比如用户显示了硬件键盘
  • android:launchMode
    关于如何启动Activity的指令。一共有四种指令:
    “standard”
    “singleTop”
    “singleTask”
    “singleInstance”
    默认情况下是standard。这些模式被分为两大类:"standard"和"singleTop"是一类。该模式的Activity可以多次实例化。实例可属于任何任务,并且可以位于Activity堆栈中的任何位置。"singleTask"和"singleInstance"是一类。该模式只能启动任务,它们始终位于Activity堆栈的根位置。此外,设备一次只能保留一个Activity实例。
    设置成singleTask后,系统在新任务的根位置创建Activity并向其传送Intent。如果已经存在一个Activity实例,则系统会通过调用该实例的onNewIntent()方法向其传送Intent而不是创建一个新的Activity实例。

<meta-data>元素

指定额外的数据项,该数据项是一个name-value对,提供给其父组件。这些数据会组成一个Bundle对象,可以由PackageItemInfo.metaData字段使用。虽然可以使用多个元素标签,但是不推荐这么使用。如果有多个数据项要指定,推荐做法是:将多个数据项合并成一个资源,然后使用一个包含进去。

该元素有三个属性:android:name android:resource android:value

<intent-filter>元素

指明这个activity可以以什么样的意图(intent)启动。

  • <action>元素

    表示上方的activity作为一个什么动作启动

         <action android:name="android.intent.action.MAIN" /> 
    

    该元素内容表示上面的activity将作为app启动时第一个启动的activity

  • <category>元素

    这是action元素的额外类别信息,android.intent.category.LAUNCHER表示这个activity为当前应用程序优先级最高的Activity。

        <category android:name="android.intent.category.LAUNCHER"/>
    
  • 1
    点赞
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值