文档章节

从问题到解决方案到应用-android-ApiDemo入口源代码学习及应用

代码会说话
 代码会说话
发布于 2012/11/24 03:32
字数 2965
阅读 7437
收藏 49

一.问题

在android的学习中我们经常需要做做一些小demo。

(1)一个demo建立一个项目:

     demo多了,项目就多了,会有各种不方便。

(2)于是,建立一个demo项目来,然后,第一个Activity呢,主界面是一个Activity.里面是各个具体的Activity的入口。

 这个时候我的做法是。主界面的布局是一个LinearLayout然后里面多一个具体的Demo就多一个Button入口。

布局如下:

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    android:id="@+id/root_view"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical" >

    <Button
        android:id="@+id/button1"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:text="Demo1" />

    <Button
        android:id="@+id/button2"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:text="Demo2" />

    <Button
        android:id="@+id/button3"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:text="Demo3" />

</LinearLayout>

然后,在代码里为Button注册点击事件,处理事件,启动对应具体的Demo界面。

一般来说,这样的解决方案是够了。

但是有没有简洁,更具有扩展性的解决方案呢?

这个时候,我想到了Android的ApiDemos。我想看看Android自己是怎么做的。

于是我发现了一个一个更优雅更具有技术含量,更具有Android的技术特色的解决方案:

主要是这个Activity子类:

com.example.android.apis.ApiDemos
它也是一个ListActivity子类,整个类文件100多行代码。比较优雅的实现了问题的主要功能。

这是我首先要告诉大家的是,当我们运行ApiDemos时,首次运行看到的界面(我称之为根目录)是ApiDemos这个Activity,

子目录的显示也是这个ApiDemos这个Activity.

提示:其实,如果你自己单步调试下,应该很快就可以了解了。就不用再往下看了。不是吗?

我们知道,根目录显示的入口如下:

清单一:

/-Accessibility
 -Animation
 -App
 -Content
 -Graphics
 -Media
 -NFC
 -OS
 -Preference
 -Text
 -Views
App子目录显示的入口如下:

清单二:

/-App
     -ActionBar
     -Activity
     -Alarm
     -Alert Dialogs
     -Device Admin
     -Fragment
     -Launcher Shortcuts
     -Loader
     -Menu
     -Notification
     -Search
     -Service
     -Text-To-Speech
     -Voice Recognition

在这里,我们就有几个疑问:

 (0)ApiDemos是如何知道本应用中的所有Activity的呢?

(1)ApiDemos是如何知道,当前是应该显示根目录呢?还是子目录呢?

 (2)ApiDemos是如何知道当前目录应该显示哪些入口条目呢?即ApiDemos是如何确定Activity的层级关系的呢?

  (3)ApiDemos是如何让点击条目进去是显示子目录呢?还是显示具体的Demo的Activity呢?


我们所有的问题,都可以从代码中找出答案:

 问题(0):

 我们想是不是android平台提供了某种方法让我们可以直接查询出本应用的所有Activity.

好像没有但是android为我们了Intent这样一个东西。我们可以根据某一个Intent来查询所有符合些Intent条件的Activity.

我们可以从ApiDemos的Manifest可以看到,几乎所有的除ApiDemos这个Activity之外的Activity都有如下的一个Intent-filter:

清单三:

<intent-filter>
    <action android:name="android.intent.action.MAIN" />
    <category android:name="android.intent.category.SAMPLE_CODE" />
 </intent-filter>
如是可以通过构造出符合此intent-filter的intent了如下:

清单四:

Intent mainIntent = new Intent(Intent.ACTION_MAIN, null);
mainIntent.addCategory(Intent.CATEGORY_SAMPLE_CODE);
然后利用android的包管理器类(PackageManager)就可以查询出符合条件的的Activity的信息了,代码如下:

清单五:

PackageManager pm = getPackageManager();
List<ResolveInfo> list = pm.queryIntentActivities(mainIntent, 0);
得到了所有的Demo的Activity的信息的列表。

到此,问题(0)基本解决。关于PackageManger后面还会讲到。这里暂时不表。

接下来要做的就是为这些Activity组织显示层级入口了。

在所有的数据中查找某一个层级的目录入口。所以都可以算是查找工作了。

 关于这个确定层级,我们可以想到的一种方案是以包名的层级来确定:

 对于第一层子目录来说确实是可以这样的。但是对于这二层目录就不可以了。

就比如com.example.android.apis.app就没有子包了,但是还有不实际应用中还有几个层级的子目录呢。

所以,因为代码不是我们写所以这个层级确实方案不可行。但是如果是自己写代码倒还是可行的。

但是,android采用了一种类似的,但是我觉得更麻烦的方案,就是为每一个Activity设置一个label.

这样。在label中标明了此Activity的层级:

例如:HelloWorld这个Activity的在Manifest中声明如下:

清单六:

<activity
android:name=".app.HelloWorld"
android:label="@string/activity_hello_world" >
  <intent-filter>
     <action android:name="android.intent.action.MAIN" />
     <category android:name="android.intent.category.SAMPLE_CODE" />
  </intent-filter>
</activity>
其中@string/activity_hello_world这个标签值如下:

清单七:

<string name="activity_hello_world">
    App/Activity/<b>Hello <i>World</i></b>
</string>
这个label告诉我们,HelloWorld这个Activity可以在App目录下的Activity目录下找到。

事实也是如此。

于是当我们点击App时,我们可以向ApiDemos传递App这样一个标签前缀。只要其它的Activity的label的前缀也是

App/那么就是App下的子目录下的项了。

下面来看看具体的代码吧:

 (a)组织根目录入口显示,(即,清单一 所显示的入口列表)

 根目录,特殊一点,因为标签没有前缀。

先看onCreate()方法中的代码

清单八:

Intent intent = getIntent();
String path =intent.getStringExtra("com.example.android.apis.Path");
        
if (path == null) {
    path = "";
}
上面的代码首先获得启动ApiDemos这个Activity的Intent.

然后尝试从intent读取指定标签前缀信息。

由于是第一个启动的Activity因此没有相信信息。path也就为null.

即标签前缀为空是根目录。

然后是根据这个前缀path来获得列表要显示的数据。

清单九:

setListAdapter(new SimpleAdapter(
                this,
                getData(path),
                android.R.layout.simple_list_item_1, 
                new String[] { "title" },
                new int[] { android.R.id.text1 }
                )
);
我们主要是关注getData(path)这个方法:

getData(path)中获得整个应用demo Activity的代码在清单四,清单五中有说明:

然后是处理activity信息的标签信息:

清单十:

String[] prefixPath;
String prefixWithSlash = prefix;
        
if (prefix.equals("")) {
    prefixPath = null;
} else {
    prefixPath = prefix.split("/");
    prefixWithSlash = prefix + "/";
}
其中,prefixPath数组是来存放如果activity的label字符串以'/'分隔的字标签前缀数组:

例如当prefix为"App/Activity"时,

那么prefixPath就等于:数组{"App","Activity"}

    prefixWithSlash为"App/Activity/"

(提示:我想我应该提醒一下,slash就是斜杠的意思。

而prefixWithSlash就是因为如果prefix为App而以此作为前缀时,

可能会与前缀为AppThis,AppThat等等前缀弄混。虽然在ApiDemos目前没有这种情况。

所以加了一个slash.因为名称是不能有slash )


但是我们的组织根目录入口时,prefix为空字符串,所以prefixPath为null.

然后是一个for循环来查找所需要根目录入口:

首先是:

 获得activity信息的标签信息,如果此activity没有声明标签信息则用activity名作为标签信息:

清单十一:

ResolveInfo info = list.get(i);
CharSequence labelSeq = info.loadLabel(pm);
String label = ( (labelSeq != null) ? 
                  labelSeq.toString()
		: info.activityInfo.name);

对于HelloWorld这个Activity来说其activityInfo.name为“com.example.android.apis.app.HelloWorld”

即其类的全名。对于HelloWorld来说我们知道有标签的:

于是label为:“App/Activity/Hello World”,

得到label之后,接下来是一个if语句:

清单十二:

if (prefixWithSlash.length() == 0 || label.startsWith(prefixWithSlash))


 prefixWithSlash.length() == 0也就是说此时是查找根目录的入口。

 label.startsWith(prefixWithSlash)也就是说,查找查看prefix为前缀的子Activity。

然后是找出为下一次传递给ApiDemos的标签前缀:

清单十三:

String[] labelPath = label.split("/");

String nextLabel = prefixPath == null ? labelPath[0]
		: labelPath[prefixPath.length];

还是以HelloWorld这个Acitivity的标签信息为例:

label为"App/Activity/Hello World"

则labelPath为{"App","Activity","Hello World"}

显然对于根目录,prefixPath为空,所以取数组第一项作为一个子目录入口项:

于是,此入口项要传递给子目录的标签前缀

nextLabel为labelPath[0],

此时如下是查找App目录下的子目录,prefixPath为{"App"},数组长度为1.

则下一个标签则为“App",到App/Activity这一个层级的话,

nextLabel为"Activity"

传递过去的应该是:prefixPath+"/"+nextLabel.

下面会有。

清单十四:

if ((prefixPath != null ? prefixPath.length : 0) == labelPath.length - 1)
上面的代码要判断是,这个条目要打开是一个具体的Demo的Activity呢?

还是用于浏览子目录呢?

还是以HelloWorld为例,

label为"App/Activity/Hello World"

labelPath为{"App","Activity","Hello World"} ,数组长度为3

如果此时:prefixPath为{"App","Activity"} ,数组长度为2

2 == (3-1)于是此时入口应该是打开HelloWorld这个Activity

对于们根目录来说,prefixPath为null,

此时如果一个Activity的label为例如"JustADemo"

那么 0 = 1 - 1,

这也是一个应该直接打开的具体的Demo的Activity入口。

否则就是要打开一个子目录入口的目录项了:

将此项添加进列表中:

清单十六:

if (entries.get(nextLabel) == null) {
   String nextPrefixLabel = prefix.equals("") ? nextLabel : prefix + "/"
								+ nextLabel;
   addItem(myData, nextLabel, browseIntent(nextPrefixLabel));

   entries.put(nextLabel, true);
}
因为根目录的入口只有那么几个,整个的Activity确有292个左右,所以很多肯定有同一个第一级子目录标签。

如"App"如果已经从之前的Activity的标签中找出App这个子目录入口了,就不需要添加了。

因为使用了entries这样一个Map<String,Boolean>这样一个数据结构来判断。

如果还没有得到子目录需要传递的下一个标签前缀。然后得到将下一个目录项添加进列表中。


我们来看看browseIntent()这个方法:

清单十七:

protected Intent browseIntent(String path) {
        Intent result = new Intent();
        result.setClass(this, ApiDemos.class);
        result.putExtra("com.example.android.apis.Path", path);
        return result;
    }

这个方法构造出一个用于打开浏览子目录项的Intent.

显然可以看出,是用ApiDemos这个Activity来浏览的。

然后是:activityIntent()

清单十八:

protected Intent activityIntent(String pkg, String componentName) {
        Intent result = new Intent();
        result.setClassName(pkg, componentName);
        return result;
    }
得到某启动某一个具体的Demo的Activity的Intent.


清单十九:

protected void addItem(List<Map<String, Object>> data, String name, Intent intent) {
        Map<String, Object> temp = new HashMap<String, Object>();
        temp.put("title", name);
        temp.put("intent", intent);
        data.add(temp);
 }

组织用于List显示的item.


清单二十:

@Override
    @SuppressWarnings("unchecked")
    protected void onListItemClick(ListView l, View v, int position, long id) {
        Map<String, Object> map = (Map<String, Object>)l.getItemAtPosition(position);

        Intent intent = (Intent) map.get("intent");
        startActivity(intent);
    }

当用户点击某一个列表项时,启动对应Intent的Activity.


相信如果你看到这里,对于ApiDemos应该有相当的了解了吧。前面提供了问题都有答案了吧。

其实,如果你自己单步调试下,应该很快就可以了解了。不是吗?


如果你了解了,下面分享一个具体的应用场景:android指定分享到新浪微博



再回到我们之前提到的PackageManager。

一般的分享我们是这样做的:

private void share() {
	Intent intent = new Intent(Intent.ACTION_SEND);
	intent.setType("text/plain");
	intent.putExtra(Intent.EXTRA_SUBJECT, "分享我的文章");
	intent.putExtra(
			Intent.EXTRA_TEXT,"我刚发表的文章,来看看吧,地址:http://aa.bb.cc/a.html");
	intent.putExtra(Intent.EXTRA_TITLE, "分享我的文章");
	String title = "分享我的文章给好友";

	Intent chooser = Intent.createChooser(intent, title);
	startActivity(chooser);
}

这段代码会弹出一个可以用于分享的选择器,然后选择某一项来分享。

但是我们需要直接分享到新浪微博呢?

首先,我们可以通在安装有新浪微博的设备上运行,

Intent intent = new Intent(Intent.ACTION_SEND);
    intent.setType("text/plain");
    PackageManager pm = getPackageManager();
    List<ResolveInfo> list = pm.queryIntentActivities(intent, 0);

还得到所以可以用于分享的组件,然后不管是通过调试或者打印得出来,某你所想要分享的组件的信息。

如新浪微博的的包名为"com.sina.weibo"

于是可以通过判断包名,来打开指定的分享intent,代码如下:

PackageManager pm = getPackageManager();
		List<ResolveInfo> matches = pm.queryIntentActivities(intent,
				PackageManager.MATCH_DEFAULT_ONLY);
		String packageName = "com.sina.weibo";
		ResolveInfo info = null;
		for (ResolveInfo each : matches) {
			String pkgName = each.activityInfo.applicationInfo.packageName;
			if (packageName.equals(pkgName)) {
				info = each;
				break;
			}
		}
		if (info == null) {
			ToastUtils.showShort(context, "没有找到新浪微博");
			return;
		} else {
			intent.setClassName(packageName, info.activityInfo.name);
		}

		startActivity(intent);

好了,到这里整个文章结束了,欢迎指出存在的各种错误与不足。


© 著作权归作者所有

代码会说话
粉丝 184
博文 62
码字总数 58384
作品 0
南宁
后端工程师
私信 提问
加载中

评论(4)

soulsaunter
soulsaunter
谢谢楼主分享。
linshenqi
linshenqi

引用来自“李海珍”的评论

引用来自“linshenqi”的评论

这种没什么好讲的,有空讲讲ndk吧。

呵呵,我只是新手。所以。等以后我接触使用到ndk我会的。
估计ndk的话,你应该有一定经验了吧。我应该向你学习。

没经验~学习中
代码会说话
代码会说话 博主

引用来自“linshenqi”的评论

这种没什么好讲的,有空讲讲ndk吧。

呵呵,我只是新手。所以。等以后我接触使用到ndk我会的。
估计ndk的话,你应该有一定经验了吧。我应该向你学习。
linshenqi
linshenqi
这种没什么好讲的,有空讲讲ndk吧。
Multidex记录二:缺陷&解决

个人博客地址 http://dandanlove.com/ Multidex记录一:介绍和使用 Multidex记录二:缺陷&解决 记录Multidex缺陷&解决 为什么要用记录呢,因为我从开始接触Android时我们的项目就在65535的边...

静默加载
2018/10/18
0
0
Android系统源代码分析步骤

目前,互联网行业正在朝着移动互联网方向强劲地发展,而移动互联网的发展离不开背后的移动平台的支撑。众所周知,如今在移动平台市场上,苹果的iOS、谷歌的Android和微软的Windows Phone系统...

紫地瓜
2012/11/19
597
0
AndroidDev站点推荐 - 全新第一期Issue#1

原文发表于 Rocko's blog - AndroidDev站点推荐-Issue#1 Android-Dev-Bookmarks 项目目前可以生成书签文件导入到浏览器中啦,大家多多关注~ ADB 站点上的内容也是一样的,方便在线浏览。现在...

Rocko
2016/02/18
0
0
[RK3399][Android7.1] Android官方的一个测试程序ApiDemos

版权声明:本文为博主原创文章,未经博主允许不得转载。 https://blog.csdn.net/kris_fei/article/details/90179786 Platform: RK3399 OS: Android 7.1 Kernel: v4.4.83 背景: 在调试双屏异...

KrisFei
05/13
0
0
高效建立健壮的Android应用-Maven Android 开发

高效建立健壮的Android应用 第一次写(翻译)这么长的文章,请多包含.本标题纯粹是[别人][1]的广告语,它说他可以 让你开发更加迅速 让你的应用更加强壮 提高应用的质量 构建你的企业解决方案...

花米
2013/11/10
336
0

没有更多内容

加载失败,请刷新页面

加载更多

Replugin借助“UI进程”来快速释放Dex

public static boolean preload(PluginInfo pi) { if (pi == null) { return false; } // 借助“UI进程”来快速释放Dex(见PluginFastInstallProviderProxy的说明) return PluginFastInsta......

Gemini-Lin
59分钟前
4
0
Hibernate 5 的模块/包(modules/artifacts)

Hibernate 的功能被拆分成一系列的模块/包(modules/artifacts),其目的是为了对依赖进行独立(模块化)。 模块名称 说明 hibernate-core 这个是 Hibernate 的主要(main (core))模块。定义...

honeymoose
今天
4
0
CSS--属性

一、溢出 当内容多,元素区域小的时候,就会产生溢出效果,默认是纵向溢出 横向溢出:在内容和容器之间再套一层容器,并且内部容器要比外部容器宽 属性:overflow/overflow-x/overflow-y 取值...

wytao1995
今天
4
0
精华帖

第一章 jQuery简介 jQuery是一个JavaScript库 jQuery具备简洁的语法和跨平台的兼容性 简化了JavaScript的操作。 在页面中引入jQuery jQuery是一个JavaScript脚本库,不需要特别的安装,只需要...

流川偑
今天
7
0
语音对话英语翻译在线翻译成中文哪个方法好用

想要进行将中文翻译成英文,或者将英文翻译成中文的操作,其实有一个非常简单的工具就能够帮助完成将语音进行翻译转换的软件。 在应用市场或者百度手机助手等各大应用渠道里面就能够找到一款...

401恶户
今天
3
0

没有更多内容

加载失败,请刷新页面

加载更多

返回顶部
顶部