介绍
AppWidgetProvider
继承自BroadcastReceiver
必须的3个元素:
AppWidgetProvider
+AppWidgetProviderInfo
+layout
步骤:
1. 创建类继承AppWidgetProvider
2. 在res/xml下创建文件my_appwidget_info.xml
(文件名随意)
3. 创建AppWidget的layout
4. 在AndroidManifest.xml
中添加已创建的AppWidgetProvider
Demo:https://git.oschina.net/AndroidUI/AppWidget01.git
步骤
Step1: AppWidgetProvider
public class MyAppWidgetProvider extends AppWidgetProvider {
//可以什么都不用写
}
Step2: AppWidgetProviderInfo
res/xml/my_appwidget_info.xm
<?xml version="1.0" encoding="utf-8"?>
<appwidget-provider
xmlns:android="http://schemas.android.com/apk/res/android"
android:initialLayout="@layout/layout_appwidget"
android:minHeight="50dp"
android:minWidth="100dp"
android:previewImage="@mipmap/ic_launcher"
android:resizeMode="horizontal|vertical"
android:updatePeriodMillis="60000"
android:widgetCategory="home_screen"/>
Step3: View layout
res/layout/layout_appwidget:
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:layout_width="match_parent"
android:layout_height="match_parent">
<TextView
android:id="@+id/tv"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:background="@color/colorPrimaryDark"
android:gravity="center"
android:maxLines="1"
android:text=""
android:textColor="@android:color/white"/>
</LinearLayout>
Step4: 在AndroidManifest.xml
注册
<receiver android:name=".MyAppWidgetProvider">
<intent-filter>
<action android:name="android.appwidget.action.APPWIDGET_UPDATE" />
</intent-filter>
<meta-data android:name="android.appwidget.provider"
android:resource="@xml/my_appwidget_info" />
</receiver>
其它
AppWidgetProvider的声明周期
public class MyAppWidgetProvider extends AppWidgetProvider {
public MyAppWidgetProvider() {
super();
}
@Override
public void onReceive(Context context, Intent intent) {
super.onReceive(context, intent);
LogUtil.d("onReceive");
}
@Override
public void onUpdate(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds) {
super.onUpdate(context, appWidgetManager, appWidgetIds);
LogUtil.d("onUpdate");
}
@Override
public void onAppWidgetOptionsChanged(Context context, AppWidgetManager appWidgetManager, int appWidgetId, Bundle newOptions) {
super.onAppWidgetOptionsChanged(context, appWidgetManager, appWidgetId, newOptions);
LogUtil.d("onAppWidgetOptionsChanged");
}
@Override
public void onDeleted(Context context, int[] appWidgetIds) {
super.onDeleted(context, appWidgetIds);
LogUtil.d("onDeleted");
}
@Override
public void onEnabled(Context context) {
super.onEnabled(context);
LogUtil.d("onEnabled");
}
@Override
public void onDisabled(Context context) {
super.onDisabled(context);
LogUtil.d("onDisabled");
}
@Override
public void onRestored(Context context, int[] oldWidgetIds, int[] newWidgetIds) {
super.onRestored(context, oldWidgetIds, newWidgetIds);
LogUtil.d("onRestored");
}
}
定时更新AppWidget
WidgetService
android:updatePeriodMillis="6000"
是无效的,一般采用Service
+Timer
实现定时更新。
如我们让AppWidget
显示时间,每隔一秒更新一次。
public class WidgetService extends Service {
private Timer timer;
@Nullable
@Override
public IBinder onBind(Intent intent) {
return null;
}
@Override
public void onCreate() {
super.onCreate();
timer = new Timer();
TimerTask task = new TimerTask() {
@Override
public void run() {
SimpleDateFormat format = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
Date date = new Date();
RemoteViews remoteViews = new RemoteViews(getPackageName(), R.layout.layout_appwidget);
remoteViews.setTextViewText(R.id.tv, format.format(date));
Intent intent = new Intent();
intent.setAction("com.cqc.appwidget01.action.UPDATE");
PendingIntent pendingIntent = PendingIntent.getBroadcast(getBaseContext(), 0, intent, 0);
remoteViews.setOnClickPendingIntent(R.id.tv, pendingIntent);
//注意:第二个参数是MyAppWidgetProvider
ComponentName name = new ComponentName(getPackageName(), "com.cqc.appwidget01.MyAppWidgetProvider");
AppWidgetManager.getInstance(getBaseContext()).updateAppWidget(name, remoteViews);
}
};
timer.schedule(task, 0, 1000);
}
@Override
public void onDestroy() {
super.onDestroy();
if (timer != null) {
timer.cancel();
timer = null;
}
}
}
不要忘记在AndroidManifest.xml
注册
<service android:name=".WidgetService"/>
下面介绍如何更新AppWidget
用RemoteViews
展示布局
RemoteViews remoteViews = new RemoteViews(getPackageName(), R.layout.layout_appwidget);
设置文字
remoteViews.setTextViewText(R.id.tv, format.format(date));
创建PendingIntent
Intent intent = new Intent();
intent.setAction("com.cqc.appwidget01.action.UPDATE");
PendingIntent pendingIntent = PendingIntent.getBroadcast(getBaseContext(), 0, intent, 0);
给RemoteViews
中的view
设置点击事件
remoteViews.setOnClickPendingIntent(R.id.tv, pendingIntent);
创建ComponentName
ComponentName name = new ComponentName(getPackageName(), "com.cqc.appwidget01.MyAppWidgetProvider");
更新AppWidget
AppWidgetManager.getInstance(getBaseContext()).updateAppWidget(name, remoteViews);
AppwidgetClickReceiver
点击AppWidget后,在广播中收到消息。
public class AppwidgetClickReceiver extends BroadcastReceiver {
@Override
public void onReceive(Context context, Intent intent) {
LogUtil.d("点击事件");
}
}
注册:
<receiver android:name=".AppwidgetClickReceiver">
<intent-filter>
<action android:name="com.cqc.appwidget01.action.UPDATE"/>
</intent-filter>
</receiver>