LiveFolders

public final class LiveFolders
extends Object implements BaseColumns

此类在API级别14中已被弃用。
Android不再支持实时文件夹。 这些已被HONEYCOMB中引入的新的AppWidget Collection API HONEYCOMB 。 这些提供了活动文件夹的所有功能以及更多功能。 由于他们介绍的安全问题，使用活动文件夹大大受到阻碍 - 发布活动文件夹需要将活动文件夹的所有数据显示为可供所有应用程序使用，而无需保护它们的权限。

LiveFolder是一个特殊的文件夹，其内容由ContentProvider提供。 要创建活动文件夹，需要两个组件：

• An activity that can respond to the intent action ACTION_CREATE_LIVE_FOLDER. The activity is responsible for creating the live folder.
• A ContentProvider to provide the live folder items.

Lifecycle

当用户想要创建活动文件夹时，系统将使用意向过滤器操作ACTION_CREATE_LIVE_FOLDER查找所有活动，并将列表呈现给用户。 当用户选择其中一个活动时，将使用ACTION_CREATE_LIVE_FOLDER操作调用该活动。 然后，该活动将创建活动文件夹，并通过将其设置为activity result将其传回系统。 活动文件夹由内容提供者URI，名称，图标和显示模式描述。 最后，当用户打开活动文件夹时，系统查询内容提供者以检索文件夹的内容。

Setting up the live folder activity

以下代码示例演示如何编写一个创建活动文件夹的活动：

 public static class MyLiveFolder extends Activity {
     public static final Uri CONTENT_URI = Uri.parse("content://my.app/live");

     protected void onCreate(Bundle savedInstanceState) {
         super.onCreate(savedInstanceState);

         final Intent intent = getIntent();
         final String action = intent.getAction();

         if (LiveFolders.ACTION_CREATE_LIVE_FOLDER.equals(action)) {
             setResult(RESULT_OK, createLiveFolder(this, CONTENT_URI, "My LiveFolder",
                     R.drawable.ic_launcher_contacts_phones));
         } else {
             setResult(RESULT_CANCELED);
         }

         finish();
     }

     private static Intent createLiveFolder(Context context, Uri uri, String name,
             int icon) {

         final Intent intent = new Intent();

         intent.setData(uri);
         intent.putExtra(LiveFolders.EXTRA_LIVE_FOLDER_NAME, name);
         intent.putExtra(LiveFolders.EXTRA_LIVE_FOLDER_ICON,
                 Intent.ShortcutIconResource.fromContext(context, icon));
         intent.putExtra(LiveFolders.EXTRA_LIVE_FOLDER_DISPLAY_MODE, LiveFolders.DISPLAY_MODE_LIST);

         return intent;
     }
 }
 

活动文件夹由 Intent描述如下：

Setting up the content provider

活动文件夹的内容提供者在查询后必须返回一个 Cursor其列与以下名称匹配：

Summary

Inherited constants
From interface android.provider.BaseColumns String _COUNT 目录中的行数。 String _ID 一行的唯一ID。

Inherited methods

From class java.lang.Object Object clone() 创建并返回此对象的副本。 boolean equals(Object obj) 指示其他某个对象是否“等于”这一个。 void finalize() 当垃圾收集确定没有更多对该对象的引用时，由对象上的垃圾回收器调用。 final Class<?> getClass() 返回此 Object的运行时类。 int hashCode() 返回对象的哈希码值。 final void notify() 唤醒正在等待该对象监视器的单个线程。 final void notifyAll() 唤醒在该对象监视器上等待的所有线程。 String toString() 返回对象的字符串表示形式。 final void wait(long millis, int nanos) 导致当前线程等待，直到另一个线程为此对象调用方法 notify()或 notifyAll()方法，或者其他线程中断当前线程，或者经过一定的实时时间。 final void wait(long millis) 导致当前线程等待，直到另一个线程调用此对象的 notify()方法或 notifyAll()方法，或经过指定的时间量。 final void wait() 导致当前线程等待，直到另一个线程调用此对象的方法 notify()或方法 notifyAll() 。

Constants

String ACTION_CREATE_LIVE_FOLDER

String DESCRIPTION

int DISPLAY_MODE_GRID

int DISPLAY_MODE_LIST

String EXTRA_LIVE_FOLDER_BASE_INTENT

String EXTRA_LIVE_FOLDER_DISPLAY_MODE

String EXTRA_LIVE_FOLDER_ICON

String EXTRA_LIVE_FOLDER_NAME

String ICON_BITMAP

String ICON_PACKAGE

String ICON_RESOURCE

String INTENT

String NAME