Andorid桌面小部件AppWidgetProvider应用

/**
 * 桌面小部件 AppWidget配置
 * 
 * @description：
 * @author ldm
 * @date 2016-5-16 下午1:57:16
 */
public class ExampleAppWidgetConfigure extends Activity {
    static final String TAG = "ExampleAppWidgetConfigure";
    // 保存的文件名
    private static final String PREFS_NAME = "com.example.android.apis.appwidget.ExampleAppWidgetProvider";
    // 保存的字段KEY
    private static final String PREF_PREFIX_KEY = "prefix_";
    // 小部件 对应ID
    int mAppWidgetId = AppWidgetManager.INVALID_APPWIDGET_ID;
    // 输入框
    EditText mAppWidgetPrefix;

    public ExampleAppWidgetConfigure() {
        super();
    }

    @Override
    public void onCreate(Bundle icicle) {
        super.onCreate(icicle);
        setResult(RESULT_CANCELED);
        // 设置布局
        setContentView(R.layout.appwidget_configure);
        mAppWidgetPrefix = (EditText) findViewById(R.id.appwidget_prefix);
        // 设置监听
        findViewById(R.id.save_button).setOnClickListener(mOnClickListener);
        // 获取intent传递过来的数据
        Intent intent = getIntent();
        Bundle extras = intent.getExtras();
        if (extras != null) {
            mAppWidgetId = extras.getInt(AppWidgetManager.EXTRA_APPWIDGET_ID,
                    AppWidgetManager.INVALID_APPWIDGET_ID);
        }

        if (mAppWidgetId == AppWidgetManager.INVALID_APPWIDGET_ID) {
            finish();
        }

        mAppWidgetPrefix.setText(loadTitlePref(ExampleAppWidgetConfigure.this,
                mAppWidgetId));
    }

    View.OnClickListener mOnClickListener = new View.OnClickListener() {
        public void onClick(View v) {
            final Context context = ExampleAppWidgetConfigure.this;
            String titlePrefix = mAppWidgetPrefix.getText().toString();
            //保存到SharedPreferences文件
            saveTitlePref(context, mAppWidgetId, titlePrefix);
            AppWidgetManager appWidgetManager = AppWidgetManager
                    .getInstance(context);
            //更新小部件 
            ExampleAppWidgetProvider.updateAppWidget(context, appWidgetManager,
                    mAppWidgetId, titlePrefix);

            Intent resultValue = new Intent();
            resultValue.putExtra(AppWidgetManager.EXTRA_APPWIDGET_ID,
                    mAppWidgetId);
            setResult(RESULT_OK, resultValue);
            finish();
        }
    };

    static void saveTitlePref(Context context, int appWidgetId, String text) {
        SharedPreferences.Editor prefs = context.getSharedPreferences(
                PREFS_NAME, 0).edit();
        prefs.putString(PREF_PREFIX_KEY + appWidgetId, text);
        prefs.commit();
    }

    static String loadTitlePref(Context context, int appWidgetId) {
        SharedPreferences prefs = context.getSharedPreferences(PREFS_NAME, 0);
        String prefix = prefs.getString(PREF_PREFIX_KEY + appWidgetId, null);
        if (prefix != null) {
            return prefix;
        } else {
            return context.getString(R.string.appwidget_prefix_default);
        }
    }

    static void deleteTitlePref(Context context, int appWidgetId) {
    }

    static void loadAllTitlePrefs(Context context,
            ArrayList<Integer> appWidgetIds, ArrayList<String> texts) {
    }
}

---

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:orientation="vertical" >

    <TextView
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:text="This text will be shown before the date in our example widget." />

    <EditText
        android:id="@+id/appwidget_prefix"
        android:layout_width="match_parent"
        android:layout_height="wrap_content" />

    <Button
        android:id="@+id/save_button"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="@android:string/ok" />

</LinearLayout>

---

/**
 * AppWidgetProvider小部件广播组件使用：
 * 1， 实现AppWidgetProvider的子类，并至少override onUpdate()方法
 * 2，在AndroidManifest.xml中，声明上述的AppWidgetProvider的子类是一个Receiver，并且：
 * 该Receiver的intent-filter的Action必须包含“android.appwidget.action.APPWIDGET_UPDATE”；
 * 该Receiver的meta-data为“android.appwidget.provider”，并用一个xml文件来描述布局属性。
 * 3， 在第2点中的xml文件中描述布局属性的节点名称必须为“appwidget-provider”。
 * 
 * @description：
 * @author ldm
 * @date 2016-5-16 下午1:43:31
 */
public class ExampleAppWidgetProvider extends AppWidgetProvider {
    // Log打印日志标签
    private static final String TAG = "ExampleAppWidgetProvider";

    /**
     * onUpdate() 处理AppWidgetManager.ACTION_APPWIDGET_UPDATE广播。
     * 该广播在需要AppWidgetProvider提供RemoteViews数据时
     * ，由AppWidgetService.sendUpdateIntentLocked()发出。
     */
    @Override
    public void onUpdate(Context context, AppWidgetManager appWidgetManager,
            int[] appWidgetIds) {
        Log.d(TAG, "onUpdate");

        final int N = appWidgetIds.length;
        for (int i = 0; i < N; i++) {
            //获取到id
            int appWidgetId = appWidgetIds[i];
            //设置标题
            String titlePrefix = ExampleAppWidgetConfigure.loadTitlePref(
                    context, appWidgetId);
            //更新AppWidget
            updateAppWidget(context, appWidgetManager, appWidgetId, titlePrefix);
        }
    }

    /**
     * onDeleted() 处理AppWidgetManager.ACTION_APPWIDGET_DELETED广播。
     * 该广播在有该AppWidgetProvider的实例被删除时
     * ，由AppWidgetService.deleteAppWidgetLocked()发出。
     */
    @Override
    public void onDeleted(Context context, int[] appWidgetIds) {
        Log.d(TAG, "onDeleted");
        final int N = appWidgetIds.length;
        for (int i = 0; i < N; i++) {
            ExampleAppWidgetConfigure.deleteTitlePref(context, appWidgetIds[i]);
        }
    }

    /**
     * onEnabled() 处理AppWidgetManager.ACTION_APPWIDGET_ENABLED广播。
     * 该广播在该AppWidgetProvider被实例化时，由AppWidgetService.sendEnableIntentLocked()发出。
     */
    @Override
    public void onEnabled(Context context) {
        Log.d(TAG, "onEnabled");
        PackageManager pm = context.getPackageManager();
        pm.setComponentEnabledSetting(new ComponentName(
                "com.example.android.apis",
                ".appwidget.ExampleBroadcastReceiver"),
                PackageManager.COMPONENT_ENABLED_STATE_ENABLED,
                PackageManager.DONT_KILL_APP);
    }

    /**
     * onDisabled() 处理AppWidgetManager.ACTION_APPWIDGET_DISABLED广播。
     * 该广播在该AppWidgetProvider的所有实例中的最后一个实例被删除时
     * ，由AppWidgetService.deleteAppWidgetLocked()发出。
     */
    @Override
    public void onDisabled(Context context) {
        Log.d(TAG, "onDisabled");
        PackageManager pm = context.getPackageManager();
        //设置组件可用
        pm.setComponentEnabledSetting(new ComponentName(
                "com.example.android.apis",
                ".appwidget.ExampleBroadcastReceiver"),
                PackageManager.COMPONENT_ENABLED_STATE_ENABLED,
                PackageManager.DONT_KILL_APP);
    }

    static void updateAppWidget(Context context,
            AppWidgetManager appWidgetManager, int appWidgetId,
            String titlePrefix) {
        Log.d(TAG, "updateAppWidget appWidgetId=" + appWidgetId
                + " titlePrefix=" + titlePrefix);
        CharSequence text = context.getString(R.string.appwidget_text_format,
                ExampleAppWidgetConfigure.loadTitlePref(context, appWidgetId),
                "0x" + Long.toHexString(SystemClock.elapsedRealtime()));
        // 创建RemoteViews 对象
        RemoteViews views = new RemoteViews(context.getPackageName(),
                R.layout.appwidget_provider);
        // 设置RemoteViews 对象的文本
        views.setTextViewText(R.id.appwidget_text, text);
        // 告诉AppWidgetManager 显示 views对象给widget.
        appWidgetManager.updateAppWidget(appWidgetId, views);
    }
}

---

小部件布局

<?xml version="1.0" encoding="utf-8"?>
<TextView xmlns:android="http://schemas.android.com/apk/res/android"
    android:id="@+id/appwidget_text"
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    android:background="#ffff00ff"
    android:textColor="#ff000000"
/>

---

public class ExampleBroadcastReceiver extends BroadcastReceiver {

    @Override
    public void onReceive(Context context, Intent intent) {
        Log.d("ExmampleBroadcastReceiver", "intent=" + intent);
        //获取广播的ACTION
        String action = intent.getAction();
        //对ACTION进行判断
        if (action.equals(Intent.ACTION_TIMEZONE_CHANGED)
                || action.equals(Intent.ACTION_TIME_CHANGED)) {

            AppWidgetManager gm = AppWidgetManager.getInstance(context);
            ArrayList<Integer> appWidgetIds = new ArrayList<Integer>();
            ArrayList<String> texts = new ArrayList<String>();

            ExampleAppWidgetConfigure.loadAllTitlePrefs(context, appWidgetIds, texts);

            final int N = appWidgetIds.size();
            for (int i=0; i<N; i++) {
                ExampleAppWidgetProvider.updateAppWidget(context, gm, appWidgetIds.get(i), texts.get(i));
            }
        }
    }
}

在AndroidManifest.xml中添加相应组件：
ExampleAppWidgetConfigure

 <activity android:name=".appwidget.ExampleAppWidgetConfigure" >
            <intent-filter>
                <action android:name="android.appwidget.action.APPWIDGET_CONFIGURE" />
            </intent-filter>
        </activity>

ExampleAppWidgetProvider

<receiver android:name=".appwidget.ExampleAppWidgetProvider" >
            <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>

ExampleBroadcastReceiver

 <receiver
            android:name=".appwidget.ExampleBroadcastReceiver"
            android:enabled="false" >
            <intent-filter>
                <action android:name="android.intent.ACTION_TIMEZONE_CHANGED" />
                <action android:name="android.intent.ACTION_TIME" />
            </intent-filter>
        </receiver>

开源代码：https://github.com/ldm520/ANDROID_API_DEMOS