API Demos 导入指南

来源：互联网发布：无锡淘宝美工培训编辑：程序博客网时间：2024/06/02 03:41

前言

API Demos 是什么呢？

API Demos 是 Google 为了 Android 开发者所提供的一个 Android API 合集，其中包含了很多的 API 范例，同时遵循了良好的代码规范，是一个值得开发者研究和学习的典型。

但是，对于刚刚接触 Android 开发的人来说，导入 API Demos 可是一个让人头疼的活。因为版本的不断升级，曾经的各种办法都已经随着时间失效了，所以就有了这篇指南来指导大家一步一步的导入 API Demos。

本文使用的 Android Studio 版本：2.1.2

导入过程

下载 API Demos

经过版本升级，发现现在已经无法通过 SDK Manager 直接下载和配置 API Demos 了。

所以就需要通过自己手动下载，这里提供百度网盘的下载链接，如果失效可以去http://www.androiddevtools.cn/找 SDK Samples 列表，或者通过留言通知我，我发现后会尽快更新。

Android 6.0 (API 23) : http://pan.baidu.com/s/1c10Ig1a
Android 5.1 (API 22) : http://pan.baidu.com/s/1dFJTkzB
Android 5.0 (API 21) : http://pan.baidu.com/s/1dDD19XB
Android L : http://pan.baidu.com/s/1gdpEan5
Android 4.4W (API 20) : http://pan.baidu.com/s/1ntLVN9B
Android 4.4.2 (API 19) : http://pan.baidu.com/s/1dDeSKt7
Android 4.3 (API 18) : http://pan.baidu.com/s/1pJHicjx
Android 4.2.2 (API 17) : http://pan.baidu.com/s/1hqGavMc
Android 4.1.2 (API 16) : http://pan.baidu.com/s/1eYPL8
Android 4.0.3 (API 15) : http://pan.baidu.com/s/1i3mScXv
Android 4.0 (API 14) : http://pan.baidu.com/s/1kTiKqZP
Android 3.2 (API 13) : http://pan.baidu.com/s/1eQpafgI
Android 3.1 (API 12) : http://pan.baidu.com/s/1haIPw
Android 3.0 (API 11) : http://pan.baidu.com/s/1ntx9qFR
Android 2.3.3 (API 10) : http://pan.baidu.com/s/1hqiQw1Q
Android 2.2 (API 9) : http://pan.baidu.com/s/1ntv7wut

上面是我能搜集到的所有版本。初学者不需要下载所有版本的 API Demos ，只需要下载一个用于学习就可以啦。

导入到 Android Studio

首先解压下载文件。然后打开 Android Studio。

1.在菜单栏中选择 File --- New ---Import Project…

菜单选项.png

2.在弹出的 Select 窗口中，找到自己刚刚解压的文件夹。API 18版本之前的，可以直接看到 ApiDemos 这个文件夹。API 18版本后的在其中找到 legacy 文件夹，其中就可以看到 ApiDemos 这个项目啦。

选择文件.png

3.找到 ApiDemos 文件夹后，点击界面上的 OK 。就会弹出来如下对话框。

导入向导.png

此时只需要选择 NEXT 。会出现如下界面，按照默认选项，点击 FINISH 。就完成了导入过程。

导入完成.png

常见问题修复

有人可能会奇怪，不都已经导入完成了么，为什么还不能运行。那是因为手动下载下来的 API Demos 是存在一些小问题的。这些小问题每个人都会遇到，所以不需要小题大做，觉得自己下载错了或者自己电脑出了什么问题。只要继续按照文章解决下去就好啦。

Error:Error: The file name must end with .xml

must end with .xml.png

该错误是因为文件没有以 .xml 结尾。我们双击这个错误提示，就会跳转到这个错误出现的地方，这时候右键点击文件名字，选择 Rename File...

Rename File.png

在弹出的窗口中给文件添加上后缀 .xml，点击 Refactor 就可以啦。

Rename.png

此时 Android Studio 的错误提示窗口可能还存在，这时候点击菜单栏中的 Build --- Rebuild Project

Rebuild.png

错误提示就会消失了。

Error:(23, 32) 错误: 程序包android.support.v4.print不存在

缺少v4包.png

这个错误会出现在 API 19 以后的 API Demos 中，是因为没有 v4 依赖包。
首先右击左侧项目管理器，点击 Open Module Settings 选项，或者直接按 F4 。

image.png

在弹出的窗口中，选择 Dependencies 选项卡。

image.png

点击右面的加号，选择 Library dependency 。

image.png

在弹出的窗口中选择 support-v4 。点击 OK。返回到刚才的窗口，再点击 OK 。这个问题就解决啦。

image.png

Manifest merger failed : uses-sdk:minSdkVersion 1 cannot be smaller than version 4 declared in library

image.png

这个报错的原因是是在gradle在构建项目的时候，没有自动生成minSdkVersion节点，所以默认的minSdkVersion就为了1了，但是v4包只能在api 版本4及以上才可以用，在gradle的配置文件加上minSdkVersion节点并且为4以上就可以了。

在项目管理器中，展开 Gradle Scripts ，打开 build.gradle 下图中左侧红色框选的文件。在其中的 defaultConfig 节点下，添加结点 minSdkVersion 4 ，如图所示。

Paste_Image.png

添加完后，报错信息不会立刻消失，这时需要按照上文中提到的 Rebuild 方法，对项目进行 Rebuild Project 操作。

错误：程序包com.google.android.mms不存在

Paste_Image.png

这个问题是因为MmsMessagingDemo用到Mms包下东西，但是系统的@hide的api，根本没办法导入，解决办法就是编译一份mms包的源码，把@hide给开放了就好了，如果不需要这部分的演示，我建议把这部分出错代码直接注释掉。

双击错误提示跳到出错的文件，然后全选所有内容，使用快捷键 Ctrl+/ 就可以注释掉所有内容。根据我的实验，这类错误是出现在图上演示的 MmsMessagingDemo.java 和 MmsWapPushReceiver.java 这两个文件上的。直接全文注释就好。

Paste_Image.png

以上就是使用 Android Studio 导入 API Demos 会出现的所有问题。

解决完上面的所有问题，

运行 API Demos

这部分就非常简单啦，运行方式也多种多样，这里说一个典型的。

首先点击如图所示中的绿色箭头。

Paste_Image.png

在弹出来的窗口中选择想要运行的设备，然后点击运行。

Paste_Image.png

编译结束后，运行效果就是这样啦。

Paste_Image.png

结语

导入程序，是程序员需要掌握的一个基础技能，而导入中会遇到各种各样的问题，这其实是导入程序的常态。并不是程序存在问题，而是从一个环境到另一个环境的时候，中间会经历很多过程，出现错误在所难免。这时候需要人必须耐心，细心。作为一个初学者，这尤为重要。

曾经导入 API Demos ，只需要在 Android Studio 的 SDK Manager 中，勾选上 Sample For SDK ，然后就配置好了，在点击导入，一路非常简单。但是不知道为什么，在新版本的 Android Studio 中，没了这个选项，我排除了国内国外网络差异，肯定了在新版本中就是移除了 API Demos 。而且截止现在 API Leave 是 24 ，但是我只能找到 API 23 的 Sample For SDK。新版本根本没了 API Demos 。

我认为根本原因是 Android Studio 2.0 推出之后。界面上出现了新的功能
Import an Android code sample。

Paste_Image.png

这个列表上可以找到一些 API Demos 中的影子，但还是代替不了 API Demos 中对大量 API 的学习。当然这是一个猜测。国外论坛上，也有人问为什么找不到 API Demos ，但是没有人给出回答。所以至今也没有找到移除的原因。如果有人知道，请留言告诉我。

不过这不影响我们使用 API Demos 来研究和学习，而且我找到了 Google 在 GitHub 上的开源代码，仍然保留着 API Demos 。

https://github.com/android/platform_development/tree/master/samples/ApiDemos

有兴趣的同学可以尝试从 GitHub 上导入。

如果发现本文有问题，或者有疑惑，可以在本文下留言，我会尽快更新。

0 0