微软 编程 Android Ubuntu mysql 开源 apache 程序员 linux nginx google 云计算 shell Firefox php wordpress Windows java Python centos

Android特色開發之桌面組件

本文節選於機械工業出版社推出的《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。代碼如下:


<intent-filter> 
     <action android:name= "android.intent.action.CREATE_LIVE_FOLDER" />   
     <category android:name= "android.intent.category.DEFAULT" />   
</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所示。

延伸阅读

    评论