官方文档中国版: https://developer.android.google.cn/guide/topics/appwidgets/index.html
这个网站是谷歌2016年底为中国开发者提供中国版,方便访问!
一.介绍
Android Widget是桌面应用小部件,可嵌入桌面,并可周期性更新Widget界面!
例如在桌面的天气,日历类小工具就是Widget部件!
二.创建Widget广播接收器
public class ExampleAppWidgetProvider extends AppWidgetProvider {
// onEnabled(Context) widget可用触发
// onDisabled(Context) widget不可用触发
// onDeleted(Context, int[]) widget被删除触发
// widget更新触发
public void onUpdate(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds) {
final int N = appWidgetIds.length;
// Perform this loop procedure for each App Widget that belongs to this provider
for (int i=0; i<N; i++) {
int appWidgetId = appWidgetIds[i];
// Create an Intent to launch ExampleActivity
Intent intent = new Intent(context, ExampleActivity.class);
PendingIntent pendingIntent = PendingIntent.getActivity(context, 0, intent, 0);
// Get the layout for the App Widget and attach an on-click listener
// to the button
RemoteViews views = new RemoteViews(context.getPackageName(), R.layout.appwidget_provider_layout);
views.setOnClickPendingIntent(R.id.button, pendingIntent);
// Tell the AppWidgetManager to perform an update on the current app widget
appWidgetManager.updateAppWidget(appWidgetId, views);
}
}
@Override
public void onReceive(Context context, Intent intent) {
AppWidgetManager mgr = AppWidgetManager.getInstance(context);
if (intent.getAction().equals(TOAST_ACTION)) {
int appWidgetId = intent.getIntExtra(AppWidgetManager.EXTRA_APPWIDGET_ID,
AppWidgetManager.INVALID_APPWIDGET_ID);
int viewIndex = intent.getIntExtra(EXTRA_ITEM, 0);
Toast.makeText(context, "Touched view " + viewIndex, Toast.LENGTH_SHORT).show();
}
super.onReceive(context, intent);
// Intent意图:
// ACTION_APPWIDGET_UPDATE //处理更新
// ACTION_APPWIDGET_DELETED // 处理删除
// ACTION_APPWIDGET_ENABLED //可用
// ACTION_APPWIDGET_DISABLED //不可用
// ACTION_APPWIDGET_OPTIONS_CHANGED // 配置改变
}
}
三.创建Widget基本信息(如布局等)
1.在AndroidManifest.xml中
<receiver android:name="ExampleAppWidgetProvider" >
<intent-filter>
<action android:name="android.appwidget.action.APPWIDGET_UPDATE" />
</intent-filter>
<meta-data android:name="android.appwidget.provider"
android:resource="@xml/widget_info" /> xml定义Widget基本信息(如布局等)
</receiver>
2.在res/xml/widget_info.xml中
<appwidget-provider xmlns:android="http://schemas.android.com/apk/res/android"
android:minWidth="40dp"
android:minHeight="40dp"
android:updatePeriodMillis="86400000" 设置widget更新周期, 周期发广播调用AppWidgetProvider.onUpdate()
android:previewImage="@drawable/preview" 设置widget预览图标,如不设置,默认是APP图标
android:initialLayout="@layout/example_appwidget" 设置Widget布局界面
android:configure="com.example.android.ExampleAppWidgetConfigure"
android:resizeMode="horizontal|vertical" 设置一个部件resizeable水平方向和垂直方向
android:widgetCategory="home_screen|keyguard" 决定widget是否可以显示在主屏幕,锁屏
android:initialKeyguardLayout="@layout/example_keyguard"> 定义锁屏应用小部件的布局
</appwidget-provider>
3.widget布局xml
<FrameLayout
android:layout_width="match_parent"
android:layout_height="match_parent"
android:padding="@dimen/widget_margin">
.........
<LinearLayout
android:layout_width="match_parent"
android:layout_height="match_parent"
android:orientation="horizontal"
android:background="@drawable/my_widget_background">
........
</LinearLayout>
</FrameLayout>
简书: http://www.jianshu.com/p/c997b9040401
CSDN博客: http://blog.csdn.net/qq_32115439/article/details/71598901
GitHub博客:http://lioil.win/2017/05/10/Android_Widget.html
Coding博客:http://c.lioil.win/2017/05/10/Android_Widget.html
网友评论