Android开发之Shortcuts, LiveFolder, Widget

2013-07-05

桌面组件包括：快捷方式(Shortcuts)，实时文件夹(Live Folder)，桌面插件(Widget)。

 

快捷方式用于启动应用程序的某个组件，例如Activity, Service等。

在桌面上添加快捷方式：长按桌面（或点击MENU->ADD按键）就可以弹出添加桌面组件的选项对话框。

 

在代码中将应用程序添加到Shortcuts列表中

在AndroidManifest.xml文件中注册Activity时添加android.intent.action.CREATE_SHORTCUT的IntentFilter，然后在Shortcuts列表中就会出现该应用的图标和名字了。

为快捷方式设置名字，图标，事件等

在Activity的onCreate方法中

public void onCreate(Bundle savedInstanceState) {

// 判断该Activity是否要允许添加快捷方式

if(getIntent().getAction().equals(Intent.ACTION_CREATE_SHORTCUT)) {

  Intent it = new Intent();

  // 设置名字

  it.putExtra(Intent.EXTRA_SHORTCUT_NAME, “发生邮件”);

  // 设置图标，使用系统的图标

  Parcelable icon = Intent.ShortcutIconResource.fromContext(this, R.drawable.mail_edit);

  it.putExtra(Intent.EXTRA_SHORTCUT_ICON_RESOURCE, icon);

  // 设置事件

  Intent mailIt = new Intent(Intent.ACTION_SENDTO, Uri.parse(“mailto:xxx@xxx.com”));

  it.putExtra(Intent.EXTRA_SHORTCUT_INTENT, mailIt);

  setResult(RESULT_OK, it);

} else {

  setResult(RESULT_CANCELED);

}

finish();

}

 

实时文件夹(Live Folder)是一个查看你的手机中所有电子书，电子邮件，RSS订阅，播放列表的快捷方式，并且这些内容都是实时更新的。

LiveFolder本身不存储任何信息，都是以映射的方式查看ContentProvider所指向的数据信息，并可以自定义显示格式，所以当源数据发生变化时，LiveFolder可以实时更新显示。

在开发时，我们要保证指定数据的URI的ContentProvider支持LiveFolder的查询。

通过LiveFolder调用电话薄的联系人，点击其中一条数据时，便执行呼叫该联系人的动作。

首先在Activity注册时添加Action为android.intent.action.ACTION_CREATE_LIVE_FOLDER的IntentFilter。

然后我们要在代码中设置LiveFolder的数据源，图标，名字等信息，可以通过intent.setData方法来设置。

在onCreate方法中实现

public void onCreate(Bundle savedInstanceState) {

  super.onCreate(savedInstanceState);

  if(getIntent().getAction.equals(LiveFolders.ACTION_CREATE_LIVE_FOLDER)) {

    Intent it = new Intent();

    // 设置数据

    it.setData(Uri.parse(“content://contacts/live_folders/people”));

    // 设置单击事件

    it.putExtra(LiveFolders.EXTRA_LIVE_FOLDER_BASE_INTENT, new Intent(Intent.ACTION_CALL, Contacts.People.CONTENT_URI));

    // 设置名字

    it.putExtra(LiveFolders.EXTRA_LIVE_FOLDER_NAME, “电话薄”);

    // 设置图标

    it.putExtra(LiveFolders.EXTRA_LIVE_FOLDER_ICON, Intent.ShortcutIconResource.fromContext(this, R.drawable.contacts));

    // 设置显示模式

    it.putExtra(LiveFolders.EXTRA_LIVE_FOLDER_DISPLAY_MODE, LiveFolders.DISPLAY_MODE_LIST);

    setResult(RESULT_OK, it);

  } else {

    setResult(RESULT_CANCELED);

  }

  finish();

}

 

Widget开发

Widget是一种很小的应用程序，主要作为Web2.0服务或互联网内容的前端。当Widget被拖到桌面上时，指定一个保留的空间来显示应用提供的自定义内容。用户可以通过这个Widget来和应用交互，例如暂停或切换歌曲。

每个Widget就是一个BroadcastReceiver，它们用XML metadata来描述Widget的细节。AppWidget Framework通过Broadcast intents和Widget通信，Widget的更新使用RemoteViews来发送。RemoteViews被包装成一个layout和特定内容显示到桌面上。

开发Widget步骤：

1. 创建布局文件res/layout/appwidget_provider.xml，用来显示桌面布局。

 

2. 创建一个描述Widget属性的文件res/xml/xmlappwidget_provider.xml。

在这个文件中，只有一个标签：<appwidget-provider />

属性说明：

android:minWidth, android:minHeight分别指定Widghet的最小宽度和最小高度。

android:updatePeriodMillis是自动更新的时间间隔。

android:initialLayout是Widget的布局描述文件。

android:configure是可选的，在启动Widget启动之前启动。

 

3. 创建一个继承自AppWidgetProvider的子类。

在AppWidgetProvider提供几个方法：

onUpdate, onDeleted, onEnabled, onDisabled

public class TxrjAppWidgetProvider extends AppWidgetProvider {

  public void onUpdate(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds) {

    final int n = appWidgetIds.length;

    for(int i=0; i<n; i++) {

      updateAppWidget(context, appWidgetManager, appWidgetId, titlePrefix);

    }

  }

  public void onDeleted(Context context, int[] appWidgetIds) {

    final int n = appWidgetIds.length;

    for(int i=0; i<n; i++) { }

  }

  // 第一个Widget创建时调用

  public void onEnabled(Context context) {

    PackageManager packageManager = context.getPackageManager();

    packageManager.setComponentEnabledSetting(new ComponentName(“xxx”), “.TxrjBoradcastReceiver”,

                    PackageManager.COMPONENT_ENABLED_STATE_ENABLED, PackageManager.DONT_KILL_APP);

  }

  // 最后一个Widget创建时调用

  public void onDisabled(Context context) {

    PackageManager pm = context.getPackageManager();

    packageManager.setComponentEnabledSetting(new ComponentName(“xxx”), “.TxrjReceiver”,

                    PackageManager.COMPONENT_ENABLED_STATE_ENABLED, PackageManager.DONT_KILL_APP);

  }

  // 在updateAppWidget方法中，我们构建了一个RemoteViews对象来对Widget进行更新，

  // setTextViewText用来更新一个TextView的内容

  // updateAppWidget提供给AppWidget使其更新到桌面

  public static void updateAppWidget(Context context, AppWidgetManager appWidgetManager, int appWidgetId, String titlePrefix) {

    RemoteViews views = new RemoteViews(context.getPackagetName, R.layout.appwidget_provider);

    views.setTextViewText(R.id.appwidget_text, titlePrefix);

    appWidgetManager.updateAppWidget(appWidgetId, views);

  }

}

 

4. 创建一个BroadcastReceiver来接收更新的信息，收到更新的信息之后就更新Widget。

public class TxrjBoradcastReceiver extends BroadcastReceiver {

  public void onReceive(Context context, Intent intent) {

    String action = intent.getAction();

    if(action.equals(Intent.ACTION_TIMEZONE_CHANGED) || action.equals(Intent.ACTION_TIME_CHANGED)) {

      AppWidgetManager widgetManger = AppWidgetManager.getInstance(context);

      ArrayList<Integer> appWidgetIds = new ArrayList<Integer>();

      ArrayList<String> texts = new ArrayList<String>();

      // loadAllTitleTitlePrefs(context, appWidgetIds, texts);

    }

  }

}

 

5. 处理android:configure设定的Activity。当点击按钮之后，创建一个AppWidgetManager实例，然后调用TxrjAppWidgetManager.updateAppWidget方法来更新Widget。

AppWidgetManager appWidgetManager = AppWidgetManager.getInstance(context);

 

6. 在AndroidManifest.xml文件中注册Widget, BroadcastReceiver, Activity

// 注册Widget

<receiver android:name=”.widget.TxrjAppWidgetProvider”>

  <meta-data android:name=”android.appwidget.provider” android:resource=”@xml/appwidget_provider” />

  <intent-filter>

    <action android:name=”android.appwidget.action.APPWIDGET_UPDATE” />

  </intent-filter>

</receiver>

// 注册BroadCastReceiver

<receiver android:name=”.receiver.TxrjAppWidgetProvider” android:enabled=”false”>

  <intent-filter>

    <action android:name=”android.intent.ACTION_TIMEZONE_CHANGED” />

    <action android:name=”android.intent.ACTION_TIME_CHANGED” />

  </intent-filter>

</receiver>

// 注册Activity

<activity android:name=”.activity.TxrjActivity”>

  <intent-filter>

    <action android:name=”android.appwidget.action.APPWIDGET_CONFIGURE” />

  </intent-filter>

</activity>