本文节选于机械工业出版社推出的《Android应用开发揭秘》一书,作者为杨丰盛。本书内容全面,详细讲解了Android框架、Android组件、用户界面开发、游戏开发、数据存储、多媒体开发和网络开发等基础知识,而且还深入阐述了传感器、语音识别、桌面组件开发、Android游戏引擎设计、Android应用优化、OpenGL等高级知识。另外,本书还全面介绍了如何利用原生的C/C++(NDK)和Python、Lua等脚本语言(Android Scripting Environment)来开发Android应用,并以迭代的方式重现了各种常用的Android应用和经典Android游戏的开发全过程。

9.4  桌面组件

第一次启动Android模拟器时,可以看到在桌面上有很多图标,如图9-18所示的Google搜索框、时钟、联系人、浏览器等,点击这些图标,系统就会执行相应的程序,与PC操作系统桌面上的快捷方式很像,但是它不完全是快捷方式,还包括了实时文件夹(Live Folder)和桌面插件(Widget),这样既美观又方便用户操作。本节将学习这每一种桌面组件的开发,让我们自己的应用程序也能轻松地放置到桌面上。

图9-18 Android桌面组件

9.4.1  快捷方式

首先我们学习最基本的桌面组件快捷方式,它和PC上的快捷方式一样,用于启动某一应用程序的某个组件(如Activity、Service等)。其实要在桌面上添加一个快捷方式很简单,只需要长按桌面或者点击“Menu”按键(如图9-19所示),就可以弹出添加桌面组件的选项,如图9-20所示,“Shortcuts”为添加快捷方式,“Widgets”为Widget开发的桌面插件,“Folders”为实时文件夹,进入相应的选项后即可添加相应的桌面组件。

图9-19  Menu菜单 图9-20  添加桌面组件

本小节重点介绍在应用程序中通过代码来将一个应用程序添加到图9-20的Shortcuts列表中,这里添加一个发送邮件的应用到快捷方式列表上去(参见本书所附代码:第9章\Examples_09_05)。
首先需要在Activity注册时添加一个Action为android.intent.action.CREATE_SHORTCUT的IntentFilter,如代码清单9-7所示,添加之后列表中就会出现该应用的图标和名字了。
代码清单9-7  第9章\Examples_09_05\AndroidManifest.xml

  1. <?xml version="1.0" encoding="utf-8"?> 
  2. <manifest xmlns:android="http://schemas.android.com/apk/res/android" 
  3.    package="com.yarin.android.Examples_09_05" 
  4.    android:versionCode="1" 
  5.    android:versionName="1.0"> 
  6.  <application android:icon="@drawable/icon" android:label="@string/app_name"> 
  7.      <activity android:name=".Activity01" 
  8.                android:label="@string/app_name"> 
  9.          <intent-filter> 
  10.            <action android:name="android.intent.action.MAIN" /> 
  11.            <category android:name="android.intent.category.LAUNCHER" /> 
  12.         <action android:name="android.intent.action.CREATE_SHORTCUT"/>   
  13.          </intent-filter> 
  14.      </activity> 
  15.  </application> 
  16.  <uses-sdk android:minSdkVersion="5" /> 
  17. </manifest> 

接下来还要为快捷方式设置名字、图标、事件等属性。Intent.EXTRA_SHORTCUT_NAME对应快捷方式的名字;Intent.EXTRA_SHORTCUT_ICON_RESOURCE对应快捷方式的图标;Intent. EXTRA_SHORTCUT_INTENT对应快捷方式执行的事件。需要说明的是,Android专门提供了Intent.ShortcutIconResource.fromContext来创建快捷方式的图标,最后通过setResult来返回,构建一个快捷方式,如代码清单9-8所示。
代码清单9-8  第9章\Examples_09_05\src\com\yarin\android\Examples_09_05\Activity01.java

  1. public class Activity01 extends Activity  
  2. {  
  3. public void onCreate(Bundle savedInstanceState)  
  4. {  
  5.     super.onCreate(savedInstanceState);  
  6.     //要添加的快捷方式的Intent  
  7.     Intent addShortcut;   
  8.     //判断是否要添加快捷方式  
  9.     if (getIntent().getAction().equals(Intent.ACTION_CREATE_SHORTCUT))  
  10.     {  
  11.         addShortcut = new Intent();   
  12.         //设置快捷方式的名字  
  13.         addShortcut.putExtra(Intent.EXTRA_SHORTCUT_NAME,"发送邮件");  
  14.         //构建快捷方式中专门的图标  
  15.         Parcelable icon = Intent.ShortcutIconResource.fromContext(this,R.drawable.mail_edit);    
  16.         //添加快捷方式图标  
  17.         addShortcut.putExtra(Intent.EXTRA_SHORTCUT_ICON_RESOURCE,icon);  
  18.         //构建快捷方式执行的Intent  
  19.         Intent mailto=new  Intent(Intent.ACTION_SENDTO, Uri.parse("mailto:xxx@xxx.com" ));   
  20.         //添加快捷方式Intent  
  21.         addShortcut.putExtra(Intent.EXTRA_SHORTCUT_INTENT,mailto);    
  22.         //正常  
  23.         setResult(RESULT_OK,addShortcut);    
  24.     }  
  25.     else 
  26.     {  
  27.         //取消  
  28.         setResult(RESULT_CANCELED);    
  29.     }  
  30.     //关闭  
  31.     finish();    
  32. }  
  33. }    

现在我们启动模拟器,就可以在Shortcuts列表中找到所添加的快捷方式,将其添加到桌面,如图9-21所示。

图9-21  桌面快捷方式

9.4.2  实时文件夹

在Android 1.5中,Live Folders无疑是一个备受关注的新功能。简单地说,Live Folders就是一个查看你的手机中所有电子书、电子邮件、rss订阅、播放列表的快捷方式,并且这些内容是实时更新的。比如你不再需要单独打开电子邮件软件查看邮件,打开通讯录找联系人等。Live Folders自带了列出所有联系人、所有有电话号码的联系人以及Starred联系人的功能,我们还可以使用Live Folders API开发出更多的新颖应用。
由于Live Folders本身不存储任何信息,都是以映射的方式查看其ContentProvider所指向的数据信息,并可以自定义显示格式,所以当源数据发生改变后,Live Folders可以实时更新显示内容。那么在开发时,我们要确保所指定数据信息URI的ContentProvider支持实时文件夹的查询。
其添加方式和添加快捷方式一样,只是在选择时要选择“Folders”。本小节我们通过Live Folders调用电话本中的信息,当点击其中一条信息时,便执行呼叫该联系人的动作(本书所附代码:第9章\ Examples_09_06)。
和创建快捷方式一样,我们需要在Activity注册时添加一个Action动作为android.intent.action. CREATE_LIVE_FOLDER的IntentFilter。代码如下:

  1. <intent-filter> 
  2.      <action android:name"android.intent.action.CREATE_LIVE_FOLDER" />   
  3.      <category android:name"android.intent.category.DEFAULT" />   
  4. </intent-filter> 

我们需要在程序中设置该实时文件夹的数据源、图标、名字的信息。可以通过intent.setData方法来设置要读取的数据源,该例中我们设置数据源为“content://contacts/live_folders/people”,即联系人信息。其他信息的设置如表9-2所示。
表9-2  Live Folders的常用属性

在设置图标时,Android专门提供了Intent.ShortcutIconResource.fromContext来设置实时文件夹的图标。下面我们将实时文件夹添加到桌面(如图9-22所示),运行效果如图9-23所示。

图9-22 “电话本”实时文件夹

图9-23  实时文件夹运行效果
下面需要在onCreate方法中将实时文件夹的相关信息装入Intent对象,并通过setResult方法设置为结果Intent,最后调用finish方法结束Activity,把结果返回给Home应用程序,以添加实时文件夹,如代码清单9-9所示。
代码清单9-9  第9章\Examples_09_06\src\com\yarin\android\Examples_09_06\Activity01.java

  1. public class Activity01 extends Activity  
  2. {  
  3. public void onCreate(Bundle savedInstanceState)  
  4. {  
  5.     super.onCreate(savedInstanceState);  
  6.     // setContentView(R.layout.main);  
  7.     // 判断是否创建实时文件夹  
  8.     if (getIntent().getAction().equals(LiveFolders.ACTION_CREATE_LIVE_FOLDER))  
  9.     {  
  10.         Intent intent = new Intent();  
  11.         // 设置数据地址  
  12.         intent.setData(Uri.parse("content://contacts/live_folders/people"));  
  13.         // 设置单击之后的事件,这里单击一个联系人后,呼叫  
  14.         intent.putExtra(LiveFolders.EXTRA_LIVE_FOLDER_BASE_INTENT,new Intent(Intent.ACTION_CALL,Contacts.People.CONTENT_URI));  
  15.         // 设置实时文件夹的名字  
  16.         intent.putExtra(LiveFolders.EXTRA_LIVE_FOLDER_NAME,"电话本");  
  17.         // 设置实施文件夹的图标  
  18.         intent.putExtra(LiveFolders.EXTRA_LIVE_FOLDER_ICON, Intent.  
  19.         ShortcutIconResource.fromContext(this,R.drawable.contacts));  
  20.         // 设置显示模式为列表  
  21.         intent.putExtra(LiveFolders.EXTRA_LIVE_FOLDER_DISPLAY_MODE,LiveFolders.DISPLAY_MODE_LIST);  
  22.         // 完成  
  23.         setResult(RESULT_OK, intent);  
  24.     }  
  25.     else 
  26.     {  
  27.         setResult(RESULT_CANCELED);  
  28.     }  
  29.     finish();  
  30. }  

9.4.3  Widget开发

Widget是一种很小的应用程序,主要作为Web 2.0服务或互联网内容的前端。Web设计人员与开发者可以使用Widget来创造最受欢迎的互联网体验。在Android 1.5中加入了AppWidget framework框架,开发者可以使用该框架开发Widget,这些Widget可以拖到用户的桌面并且可以交互。Widget可以提供一个full-featured apps的预览,例如可以显示即将到来的日历事件,或者一首后台播放的歌曲的详细信息。当Widget被拖到桌面上时,指定一个保留的空间来显示应用提供的自定义内容。用户可以通过这个Widget来和应用交互,例如暂停或切换歌曲。如果你有一个后台服务,可以按照你自己的Schedule更新你的Widget,或者使用AppWidget framework提供一个自动的更新机制。
每个Widget就是一个BroadcastReceiver,它们用XML metadata来描述Widget的细节。AppWidget framework通过Broadcast intents和Widget通信, Widget的更新使用RemoteViews来发送。RemoteViews被包装成一个layout和特定内容来显示到桌面上。下面我们通过一个示例来学习Widget开发(本书所附代码:第9章\Examples_09_07)。
首先需要在res\layout目录下创建桌面组件的布局文件appwidget_provider.xml,用来显示桌面布局,这里我们创建一个TextView用来显示一段文字,如代码清单9-10所示。
代码清单9-10  第9章\Examples_09_07\res\layout\appwidget_provider.xml

  1. <?xml version="1.0" encoding="utf-8"?> 
  2. <TextView xmlns:android="http://schemas.android.com/apk/res/android" 
  3.  android:id="@+id/appwidget_text"   
  4.  android:textColor="#ff000000" 
  5.  android:layout_width="wrap_content" 
  6.  android:layout_height="wrap_content" 
  7. /> 

然后需要创建一个描述这个桌面组件属性的文件,存放到res\xml文件夹下,如代码清单9-11所示。
代码清单9-11  第9章\Examples_09_07\res\xmlappwidget_provider.xml

  1. <?xml version="1.0" encoding="utf-8"?> 
  2. <appwidget-provider xmlns:android="http://schemas.android.com/apk/res/android" 
  3.  android:minWidth="100dp" 
  4.  android:minHeight="50dp" 
  5.  android:updatePeriodMillis="86400000" 
  6.  android:initialLayout="@layout/appwidget_provider" 
  7.  android:configure="com.yarin.android.Examples_09_07.Activity01" 
  8.  > 
  9. </appwidget-provider> 

其中android:minWidth和android:minHeight分别指定了桌面组件的最小宽度和最小高度,其值可以根据期望的单元格数量并使用前面介绍过的公式来计算(最小尺寸=(单元格数×74)?2),android:updatePeriodMillis是自动更新的时间间隔,android:initialLayout是Widget的界面描述文件。Android:configure是可选的,如果你的Widget需要在启动前先启动一个Activity,则需要设定该项为你的Activity。这里我们需要先输入一段文字,然后显示在Widget上。
然后要建立一个Widget,创建一个类,让其继承类AppWidgetProvider。在AppWidgetProvider中有许多方法,包括onUpdate(周期更新时调用)、onDeleted(删除组件时调用)、onEnabled(当第一个组件创建时调用)、onDisabled(当最后一个组件删除时调用),如代码清单9-12所示。
代码清单9-12  第9章\Examples_09_07\src\com\yarin\android\Examples_09_07\ExampleAppWidget- Provider.java

  1. public class ExampleAppWidgetProvider extends AppWidgetProvider  
  2. {  
  3. //周期更新时调用  
  4. public void onUpdate(Context context,AppWidgetManager appWidgetManager,int[] appWidgetIds)  
  5. {  
  6.     final int N = appWidgetIds.length;  
  7.     for (int i = 0; i < N; i++)  
  8.     {  
  9.         int appWidgetId = appWidgetIds[i];  
  10.         String titlePrefix=Activity01.loadTitlePref(context,appWidgetId);  
  11.         updateAppWidget(context, appWidgetManager, appWidgetId, titlePrefix);  
  12.     }  
  13. }  
  14. //当桌面组件删除时调用  
  15. public void onDeleted(Context context, int[] appWidgetIds)  
  16. {  
  17.     //删除appWidget  
  18.     final int N = appWidgetIds.length;  
  19.     for (int i = 0; i < N; i++)  
  20.     {  
  21.         Activity01.deleteTitlePref(context, appWidgetIds[i]);  
  22.     }  
  23. }  
  24. //当AppWidgetProvider提供的第一个组件创建时调用  
  25. public void onEnabled(Context context)  
  26. {  
  27.     PackageManager pm = context.getPackageManager();  
  28.     pm.setComponentEnabledSetting(new ComponentName("com.yarin.android.Examples_09_07"".ExampleBroadcastReceiver"),  
  29.         PackageManager.COMPONENT_ENABLED_STATE_ENABLED,   
  30.         PackageManager.DONT_KILL_APP);  
  31. }  
  32. //当AppWidgetProvider提供的最后一个组件删除时调用  
  33. public void onDisabled(Context context)  
  34. {  
  35.     PackageManager pm = context.getPackageManager();  
  36.     pm.setComponentEnabledSetting(new ComponentName("com.yarin.  
  37.     android.Examples_09_07", ".ExampleBroadcastReceiver"),  
  38.         PackageManager.COMPONENT_ENABLED_STATE_ENABLED,   
  39.         PackageManager.DONT_KILL_APP);  
  40. }  
  41. //更新  
  42. static void updateAppWidget(Context context, AppWidgetManager   
  43. appWidgetManager, int appWidgetId, String titlePrefix)  
  44. {  
  45.     //构建RemoteViews对象来对桌面组件进行更新  
  46.     RemoteViews views = new RemoteViews(context.getPackageName(),   
  47.     R.layout.appwidget_provider);  
  48.     //更新文本内容,指定布局的组件  
  49.     views.setTextViewText(R.id.appwidget_text, titlePrefix);  
  50.     //将RemoteViews的更新传入AppWidget进行更新  
  51.     appWidgetManager.updateAppWidget(appWidgetId, views);  
  52. }  

其中,在updateAppWidget方法中我们构建了一个RemoteViews对象来对桌面组件进行更新,通过setTextViewText方法来更新一个文本的显示,然后通过updateAppWidget方法来将更新提供给AppWidget使其更新到桌面。在onDisabled和onEnabled方法中我们用ComponentName来表示应用程序中某个组件的完整名字。
最后,创建一个BroadcastReceiver类来接收更新的信息,在收到更新的信息之后就更新这个桌面Widget组件,如代码清单9-13所示。
代码清单9-13  第9章\Examples_09_07\src\com\yarin\android\Examples_09_07\ExampleBroadcast- Receiver.java

  1. public class ExampleBroadcastReceiver extends BroadcastReceiver  
  2. {  
  3. public void onReceive(Context context, Intent intent)  
  4. {  
  5.     //通过BroadcastReceiver来更新AppWidget  
  6.     String action = intent.getAction();  
  7.     if (action.equals(Intent.ACTION_TIMEZONE_CHANGED) || action.equals(Intent.ACTION_TIME_CHANGED))  
  8.     {  
  9.         AppWidgetManager gm = AppWidgetManager.getInstance(context);  
  10.         ArrayList<Integer> appWidgetIds = new ArrayList<Integer>();  
  11.         ArrayList<String> texts = new ArrayList<String>();  
  12.         Activity01.loadAllTitlePrefs(context, appWidgetIds, texts);  
  13.         //更新所有AppWidget  
  14.         final int N = appWidgetIds.size();  
  15.         for (int i = 0; i < N; i++)  
  16.         {  
  17.             ExampleAppWidgetProvider.updateAppWidget(context,gm, appWidgetIds.get(i), texts.get(i));  
  18.         }  
  19.     }  
  20. }  

接下来,处理Android:configure指定的类,用来输入信息,在该类中我们监听这个按钮,当点击按钮之后,创建一个AppWidgetManager实例,然后调用ExampleAppWidgetProvider.updateAppWidget方法来更新这个Widget,通过以下代码可以取得一个AppWidgetManager实例:
AppWidgetManager appWidgetManager = AppWidgetManager.getInstance(context);
注意,还需要在AndroidManifest.xml中注册AppWidget、BroadcastReceiver和用来输入信息的Activity,如代码清单9-14所示。
代码清单9-14  第9章\Examples_09_07\AndroidManifest.xml

  1. <?xml version="1.0" encoding="utf-8"?> 
  2. <manifest xmlns:android="http://schemas.android.com/apk/res/android" 
  3.    package="com.yarin.android.Examples_09_07" 
  4.    android:versionCode="1" 
  5.    android:versionName="1.0"> 
  6.  <application android:icon="@drawable/icon" android:label="@string/app_name"> 
  7.      <receiver android:name=".ExampleAppWidgetProvider"> 
  8.          <meta-data android:name="android.appwidget.provider" 
  9.                  android:resource="@xml/appwidget_provider" /> 
  10.          <intent-filter> 
  11.              <action android:name="android.appwidget.action.APPWIDGET_UPDATE" /> 
  12.          </intent-filter> 
  13.      </receiver> 
  14.      <activity android:name=".Activity01"> 
  15.          <intent-filter> 
  16.              <action android:name="android.appwidget.action.APPWIDGET_CONFIGURE" /> 
  17.          </intent-filter> 
  18.      </activity> 
  19.      <receiver android:name=".ExampleBroadcastReceiver" android:enabled="false"> 
  20.          <intent-filter> 
  21.              <action android:name="android.intent.ACTION_TIMEZONE_CHANGED" /> 
  22.              <action android:name="android.intent.ACTION_TIME" /> 
  23.          </intent-filter> 
  24.      </receiver> 
  25.  </application> 
  26.  <uses-sdk android:minSdkVersion="5" /> 
  27. </manifest> 

下面将该Widget添加到桌面上,和添加快捷方式一样,如图9-24所示,然后输入要显示的文字,如图9-25所示,点击“确定”按钮之后,桌面即显示我们输入的信息,如图9-26所示。