Android 高版本API方法在低版本系统上的兼容性处理

 更新时间:2016年09月09日 10:35:39   作者:MrlLee  
本文主要介绍Android 高版本API方法在低版本系统上的兼容性处理的问题,这里提供了解决办法,并附简单示例,来详细说明解决问题步骤,有需要的小伙伴可以参考下

Android 版本更替,新的版本带来新的特性,新的方法。

新的方法带来许多便利,但无法在低版本系统上运行,如果兼容性处理不恰当,APP在低版本系统上,运行时将会crash。

本文以一个具体的例子说明如何在使用高API level的方法时处理好兼容性问题。

例子:根据给出路径,获取此路径所在分区的总空间大小。

在安卓中的文件存储使用参考中提到:

获取文件系统用量情况,在API level 9及其以上的系统,可直接调用File对象的相关方法,以下需自行计算

一般实现

就此需求而言,API level 9及其以上,调用 File.getTotalSpace() 即可, 但是在API level 8 以下系统File对象并不存在此方法。

如以下方法:

/**
 * Returns the total size in bytes of the partition containing this path.
 * Returns 0 if this path does not exist.
 * 
 * @param path
 * @return -1 means path is null, 0 means path is not exist.
 */
public static long getTotalSpace(File path) {
  if (path == null) {
    return -1;
  }
  return path.getTotalSpace();
}

处理无法编译通过

如果minSdkVersion设置为8,那么build时候会报以下错误:

Call requires API level 9 (current min is 8)

为了编译可以通过,可以添加 @SuppressLint("NewApi") 或者 @TargeApi(9)。

用@TargeApi($API_LEVEL)显式表明方法的API level要求,而不是@SuppressLint("NewApi");

但是这样只是能编译通过,到了API level8的系统运行,将会引发 java.lang.NoSuchMethodError。

正确的做法

为了运行时不报错, 需要:

判断运行时版本,在低版本系统不调用此方法
同时为了保证功能的完整性,需要提供低版本功能实现

如下:

/**
 * Returns the total size in bytes of the partition containing this path.
 * Returns 0 if this path does not exist.
 * 
 * @param path
 * @return -1 means path is null, 0 means path is not exist.
 */
@TargetApi(Build.VERSION_CODES.GINGERBREAD) 
  // using @TargeApi instead of @SuppressLint("NewApi")
@SuppressWarnings("deprecation")
public static long getTotalSpace(File path) {
  if (path == null) {
    return -1;
  }
  if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.GINGERBREAD) {
    return path.getTotalSpace();
  }
  // implements getTotalSpace() in API lower than GINGERBREAD
  else {
    if (!path.exists()) {
      return 0;
    } else {
      final StatFs stats = new StatFs(path.getPath());
      // Using deprecated method in low API level system, 
      // add @SuppressWarnings("description") to suppress the warning
      return (long) stats.getBlockSize() * (long) stats.getBlockCount();
    }
  }
}

总结

在使用高于minSdkVersion API level的方法需要:

  1. 用@TargeApi($API_LEVEL) 使可以编译通过, 不建议使用@SuppressLint("NewApi");
  2. 运行时判断API level; 仅在足够高,有此方法的API level系统中,调用此方法;
  3. 保证功能完整性,保证低API版本通过其他方法提供功能实现。

通过此文希望能帮助到您,解决Android版本API兼容性问题!谢谢大家对本站的支持!

相关文章

  • Android开发笔记之探秘WebView

    Android开发笔记之探秘WebView

    浏览器控件是每个开发环境都具备的,这为马甲神功提供了用武之地,windows的有webbrowser,android和ios都有webview。只是其引擎不同,相对于微软的webbrowser,android及ios的webview的引擎都是webkit,对Html5提供支持。本篇主要介绍android的webview。
    2014-08-08
  • Android Studio下载与安装简易教程

    Android Studio下载与安装简易教程

    这篇文章主要为大家详细介绍了Android Studio下载与安装简易教程,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2019-07-07
  • Android编程自定义圆角半透明Dialog的方法

    Android编程自定义圆角半透明Dialog的方法

    这篇文章主要介绍了Android编程自定义圆角半透明Dialog的方法,涉及Android控件的布局及相关属性设置技巧,需要的朋友可以参考下
    2017-03-03
  • Android SQLite数据库加密的操作方法

    Android SQLite数据库加密的操作方法

    因为Android自带的SQLite数据库本身是没有实现加密的,那我们如何实现对数据库的加密呢?今天通过本文给大家介绍下Android SQLite数据库加密的操作方法,一起看看吧
    2021-09-09
  • Android中捕捉menu按键点击事件的方法

    Android中捕捉menu按键点击事件的方法

    这篇文章主要介绍了Android中捕捉menu按键点击事件的方法,涉及Android响应menu菜单项点击事件的相关技巧,具有一定参考借鉴价值,需要的朋友可以参考下
    2015-07-07
  • Android Service总结及详细介绍

    Android Service总结及详细介绍

    本文主要介绍Android Service的知识,这里整理了详细资料及简单实现示例代码,有需要的小伙伴可以参考下
    2016-09-09
  • Android 中SQLite技术实例详解

    Android 中SQLite技术实例详解

    这篇文章主要介绍了Android 中SQLite技术实例详解的相关资料,需要的朋友可以参考下
    2017-06-06
  • Android 高仿QQ 沉浸式状态栏

    Android 高仿QQ 沉浸式状态栏

    这篇文章主要介绍了Android 高仿QQ 沉浸式状态栏的相关资料,非常不错,具有参考借鉴价值,需要的朋友可以参考下
    2016-12-12
  • Android编程使用ListView实现数据列表显示的方法

    Android编程使用ListView实现数据列表显示的方法

    这篇文章主要介绍了Android编程使用ListView实现数据列表显示的方法,实例分析了Android中ListView控件的使用技巧,需要的朋友可以参考下
    2016-01-01
  • flutter 实现点击下拉栏微信右上角弹出窗功能

    flutter 实现点击下拉栏微信右上角弹出窗功能

    这篇文章主要介绍了flutter 实现弹出窗点击下拉栏微信右上角弹出窗功能,这段代码使用的是PopupRoute这个路由类进行实现 的,分步骤通过实例代码讲解的非常详细,需要的朋友可以参考下
    2021-05-05

最新评论