meta-data

本文详细介绍了Android中如何在清单文件中使用meta-data来为组件提供额外数据,包括使用方式、属性介绍及如何在Java代码中获取这些数据。

meta-data的使用


在使用社会化分享Sdk的时候,经常会看到需要在我们的清单文件中使用 meta-data。下面就总结下meta-data的使用方式。

使用方式如下:

<meta-data   android:name="string"  android:resource="resource specification"   android:value="string"/>


它可以被包括在如下组件中:

<activity>
<activity-alias>
<service>
<receiver>



meta-data使用name-value名值对的格式给其父组件提供任意可选的数据。一个组件元素能够包含任意多个<meta-data>子元素,所有这些元素中定义的值会被收集到一个Bundle对象中,并且提供给组件的PackageItemInfo.metaData属性字段。


通常值是通过其value属性来指定的。但是,也可以使用resource属性来代替,把一个资源ID跟值进行关联。
例如,下面的代码就是把存储在@string/kangaroo资源中的值跟”zoo”名称进行关联:<meta-data android:name="zoo" android:value="@string/kangaroo" />
另一个方面,使用resource属性会给zoo分配一个数字资源ID,而不是保存在资源中的值。例如:<meta-data android:name="zoo" android:resource="@string/kangaroo" />

注意:这里保存的是对应的Id,而不是保存的Id对应的资源。 所以要取得android:resource对应的值得话,首先通过Bundle的getInt()方式取得对应的Id,然后根据这个资源Id获取资源文件中的值。


注意:要避免使用多个独立的<meta-data>实体来提供相关的数据。相反如果有复杂的数据要跟组件关联,那么把数据作为资源来保存,并使用resource属性,把相关的资源ID通知给组件。


属性介绍如下:

android:name   唯一名称。使用Java样式的命名规则来确保名称的唯一性,例如:com.example.project.activity.fred。
android:resource 要引用的资源。资源的ID会跟这个项目进行关联。通过Bundle.getInt()方法能够从meta-data的Bundle对象中获取这个ID。
android:value   对应的值



下表列出了可能分配的数据的数据类型,以及获取这些数据的方法:

类型                                                                                                                                                                    Bundle对象方法
字符串。对于一个Unicode字符,要使用双斜线(\\)来进行转义,如\\n和\\uxxxx                                   getString()
整数值,如100                                                                                                                                                     getInt()
布尔值,true或false                                                                                                                                        getBoolean()
颜色值,如#rgb、#argb、#rrggbb、#aarrggbb                                                                                        getString()
浮点值,如1.23                                                                                                                                                 getFloat()


被引入版本(INTRODUCED IN):
API Level 1



在清单文件中设置过后,在java文件中获取相应的值,不同的父元素,在应用时读取的方法略有不同。

1 :在Activity中:

   
   <activity...>
       <meta-data android:name="name" android:value="value"></meta-data>
    </activity>
    

   ActivityInfo info=this.getPackageManager()
                          .getActivityInfo(getComponentName(),
                          PackageManager.GET_META_DATA);
    String value=info.metaData.getString("name");



2:在application中

  <application...>
       <meta-data  android:name="name" android:value="value" ></meta-data>
   </application>
   
    ApplicationInfo appInfo = this.getPackageManager()
                                  .getApplicationInfo(getPackageName(), 
                          PackageManager.GET_META_DATA);
    String value=appInfo.metaData.getString("name");



3:在service中:


   <service android:name=".MetaDataService">
      <meta-data android:name="name" android:value="value" ></meta-data>
   </service>


   ComponentName cn=new ComponentName(this, MetaDataService.class);
   ServiceInfo info=this.getPackageManager()
                        .getServiceInfo(cn, PackageManager.GET_META_DATA);
    String value=info.metaData.getString("name");




4: 在receiver中:

    <receiver android:name=".MetaDataReceiver">
            <meta-data android:value="value" android:name="name"></meta-data>
            <intent-filter>
                <action android:name="android.intent.action.PHONE_STATE"></action>
            </intent-filter>
    </receiver>

    ComponentName cn=new ComponentName(context, MetaDataReceiver.class);
    ActivityInfo info=context.getPackageManager()
                             .getReceiverInfo(cn, PackageManager.GET_META_DATA);
    String value=info.metaData.getString("name");
 
前面提到Meta-data中的内容会被收集到一个Bundle对象中,并且提供给组件的PackageItemInfo.metaData属性字段。我们可以通过调用PackageItemInfo 对象的metaData属性获得。而上边的例子中ActivityInfo ServiceInfo ApplicationInfo都是直接或者间接继承自PackageItemInfo 。
即:AppliacationInfo 直接继承自PackageItemInfo  ,而ActivityInfo ServiceInfo继承自ComponentInfo,ComponentInfo继承自PackageItemInfo 。
注意获取相应的PackageItemInfo值的时候,AppliacationInfo需要传递包名,其他的传递ComponentName,所以需要构造一个 ComponentName对象
而不应该使用getComponentName()方式,本方法返回当前组件。可能获取Meta-data值得地方不在对应的组件中。





框架内部支持中/英文(其他语言只需要在对应的string.xml中取相同的名字即可)内部对话框背景图片、按钮支持自定义了查看版本中的Log只需要过滤AppUpdate开头的Tag重点: 如果没有设置downloadPath则默认为getExternalCacheDir()目录,同时不会申请[存储]权限!目录编译问题效果图功能介绍DownloadManagerUpdateConfiguration使用步骤Demo下载体验版本更新记录结语编译问题因为适配了Android O的通知栏,所以依赖的v7包版本比较高appcompat-v7:26.1.0使用的gradle版本为gradle-4.1-all,所以建议使用Android Studio 3.0及以上的版本打开此项目效果图     功能介绍 支持断点下载 支持后台下载 支持自定义下载过程 支持 设备 >= Android M 动态权限的申请 支持通知栏进度条展示(或者自定义显示进度) 支持Android N 支持Android O 支持中/英文双语 支持自定内置对话框的样式 使用HttpURLConnection下载,未集成其他第三方框架更加详细的文档参阅此处《AppUpdate API文档》DownloadManager:配置文档初始化使用DownloadManager.getInstance(this)属性描述默认值是否必须设置context上下文nulltrueapkUrlapk的下载地址nulltrueapkNameapk下载好的名字nulltruedownloadPathapk下载的位置getExternalCacheDir()falseshowNewerToast是否提示用户 "当前已是最新版本"falsefalsesmallIcon通知栏的图标(资源id)-1trueconfiguration这个库的额外配置nullfalseapkVersionCode更新apk的versionCode (如果设置了那么库中将会进行版本判断下面的属性也就需要设置了)1falseapkVersionName更新apk的versionNamenullfalseapkDescription更新描述nullfalseapkSize新版本的安装包大小(单位M)nullfalseauthorities兼容Android N uri授权应用包名falseUpdateConfiguration:配置文档属性描述默认值notifyId通知栏消息id1011notificationChannel适配Android O的渠道通知详情查阅源码httpManager设置自己的下载过程nullbreakpointDownload是否需要支持断点下载trueenableLog是否需要日志输出trueonDownloadListener下载过程的回调nulljumpInstallPage下载完成是否自动弹出安装页面trueshowNotification是否显示通知栏进度(后台下载提示)trueforcedUpgrade是否强制升级falseonButtonClickListener按钮点击事件回调nulldialogImage对话框背景图片资源(图片规范参考demo)-1dialogButtonColor对话框按钮的颜色-1dialogButtonTextColor对话框按钮的文字颜色-1所有版本:点击查看使用步骤第一步: app/build.gradle进行依赖implementation 'com.azhon:appupdate:1.7.3'第二步:创建DownloadManager,更多用法请查看这里示例代码DownloadManager manager = DownloadManager.getInstance(this); manager.setApkName("appupdate.apk")         .setApkUrl("https://raw.githubusercontent.com/azhon/AppUpdate/master/apk/appupdate.apk")         .setSmallIcon(R.mipmap.ic_launcher)         //可设置,可不设置         .setConfiguration(configuration)         .download();第三步:兼容Android N 及以上版本,在你应用的Manifest.xml添加如下代码<--android:authorities="${applicationId}"  这个值必须与DownloadManager中的authorities一致(不设置则为应用包名)--> <provider     android:name="android.support.v4.content.FileProvider"     android:authorities="${applicationId}"     android:exported="false"     android:grantUriPermissions="true">     <meta-data         android:name="android.support.FILE_PROVIDER_PATHS"         android:resource="@xml/file_paths_public" /> </provider>第四步:资源文件res/xml/file_paths_public.xml内容<?xml version="1.0" encoding="utf-8"?> <paths>     <external-path         name="app_update_external"         path="/" />     <external-cache-path         name="app_update_cache"         path="/" /> </paths>兼容Android O及以上版本,需要设置NotificationChannel(通知渠道);库中已经写好可以前往查阅NotificationUtil.java温馨提示:升级对话框中的内容是可以上下滑动的哦!如果需要实现自己一套下载过程,只需要继承BaseHttpDownloadManager 并使用listener更新进度public class MyDownload extends BaseHttpDownloadManager {}
评论 1
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

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

抵扣说明:

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

余额充值