爲App Widget提供元數據,包括佈局,更新頻率等等數據。這個對象被定義在XML文檔中;
2.AppWidgetProvider定義了App Widget的基本生命週期函數
AppWidget與主程序沒在一個進程中
創建pendingIntent的方法
1.PendingIntent pendingIntent = PendingIntent.getActivity(context, 0, intent, 0);//創建一個新的activity
2.PendingIntent pendingIntent = PendingIntent.getBroadcast(context, 0, intent, 0);//發送一個廣播
3.PendingIntent.getService(context, requestCode, intent, flags)//創建一個service
首先是AndroidManifest.xml文件
<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
package="com.yx.appwidget"
android:versionCode="1"
android:versionName="1.0" >
<uses-sdk
android:minSdkVersion="8"
android:targetSdkVersion="18" />
<application
android:allowBackup="true"
android:icon="@drawable/ic_launcher"
android:label="@string/app_name"
android:theme="@style/AppTheme" >
<activity
android:name="com.yx.appwidget.MainActivity"
android:label="@string/app_name" >
<intent-filter>
<action android:name="android.intent.action.MAIN" />
<category android:name="android.intent.category.LAUNCHER" />
</intent-filter>
</activity>
<activity
android:name="com.yx.appwidget.TargetActivity"
android:label="@string/app_name" >
</activity>
<!--ExampleAppWidgetProvider爲一個繼承AppWidgetProvider的java文件,在這個文件中實現對AppWidget的控制-->
<receiver android:name="ExampleAppWidgetProvider">
<intent-filter>
<!-- 系統action-->
<action android:name="android.appwidget.action.APPWIDGET_UPDATE" />
</intent-filter>
<intent-filter>
<!-- 自定義的action-->
<action android:name="yuexin.AppWidget.UPDATE_APPWIDGET" />
</intent-filter>
<meta-data android:name="android.appwidget.provider"
android:resource="@xml/example_appwidget_info"
/><!--這裏指定xml文件這個文件指定了桌面顯示的樣式-->
</receiver>
</application>
</manifest>
再在res下建立xml文件夾新建example_appwidget_info.xml文件
<appwidget-provider xmlns:android="http://schemas.android.com/apk/res/android"
android:minWidth="294dp"
android:minHeight="72dp"
android:updatePeriodMillis="86400000"
android:initialLayout="@layout/example_appwidget"
></appwidget-provider>
<!-- android:initialLayout="@layout/example_appwidget" 此句爲指定桌面組件的佈局文件 -->
example_appwidget.xml文件 指定了佈局(自己隨便佈局)
<?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"
android:orientation="vertical" >
<TextView
android:id="@+id/widgetTextId"
android:layout_width="fill_parent"
android:layout_height="wrap_content"
android:text="firstWidgetText"
android:textColor="#000000"
/>
<Button
android:id="@+id/widgetButtonId"
android:layout_width="fill_parent"
android:layout_height="wrap_content"
android:text="測試按鈕"
/>
</LinearLayout>
下來就是最主要的了ExampleAppWidgetProvider.java文件
package com.yx.appwidget;
import android.app.PendingIntent;
import android.appwidget.AppWidgetManager;
import android.appwidget.AppWidgetProvider;
import android.content.ComponentName;
import android.content.Context;
import android.content.Intent;
import android.widget.RemoteViews;
public class ExampleAppWidgetProvider extends AppWidgetProvider{
//定義一個常量字符串,該常量用於命名action,與AndroidManifest.xml文件中的 自定義的action一致,廣播是從onUpdate方法中發出,而用onReceive方法接收的。
private static final String UPDATE_ACTION = "yuexin.AppWidget.UPDATE_APPWIDGET";
@Override
public void onDeleted(Context context, int[] appWidgetIds) {
//當appWidget刪除時調用
System.out.println("onDeleted");
super.onDeleted(context, appWidgetIds);
}
@Override
public void onDisabled(Context context) {
//當appWidget全部刪除時調用
System.out.println("onDisabled");
super.onDisabled(context);
}
@Override
public void onEnabled(Context context) {
//當appwidget第一次創建時調用
System.out.println("onEnabled");
super.onEnabled(context);
}
@Override
public void onReceive(Context context, Intent intent) {
//接收程序中的廣播
System.out.println("onReceive");
String action = intent.getAction();
if(UPDATE_ACTION.equals(action)){
System.out.println("onReceive--->"+action);
RemoteViews remoteViews = new RemoteViews(context.getPackageName(),R.layout.example_appwidget);
remoteViews.setTextViewText(R.id.widgetTextId, "阿哥阿斯頓個");//修改TextView中的東西,RemoteViews中有很多方法可以調用,用來修改AppWidget中的控件內容
AppWidgetManager appWidgetManager = AppWidgetManager.getInstance(context);
ComponentName componentName = new ComponentName(context, ExampleAppWidgetProvider.class);
appWidgetManager.updateAppWidget(componentName, remoteViews);
}else{
//保證運行系統的廣播
super.onReceive(context, intent);
}
}
@Override
public void onUpdate(Context context, AppWidgetManager appWidgetManager,
int[] appWidgetIds) {
/*
//打開一個新的activity
for(int i=0;i<appWidgetIds.length;i++){
//創建一個intent對象,目的是跳轉到TargetActivity
Intent intent = new Intent(context,TargetActivity.class);
//創建一個PendingIntent
PendingIntent pendingIntent = PendingIntent.getActivity(context, 0, intent, 0);
RemoteViews remoteViews = new RemoteViews(context.getPackageName(),R.layout.example_appwidget);
//爲按鈕綁定事件處理器。第一個參數爲控件id,第二個參數指定當控件點擊時那個pendingIntent會被執行
remoteViews.setOnClickPendingIntent(R.id.widgetButtonId, pendingIntent);
//更新appWidget。第一個參數用於指定Appwidget的id
appWidgetManager.updateAppWidget(appWidgetIds[i], remoteViews);
}
*/
//廣播
//創建一個intent對象,並設置action
Intent intent = new Intent();
intent.setAction(UPDATE_ACTION);
//創建一個PendingIntent,當該對象執行時會發送一個廣播
PendingIntent pendingIntent = PendingIntent.getBroadcast(context, 0, intent, 0);
RemoteViews remoteViews = new RemoteViews(context.getPackageName(),R.layout.example_appwidget);
//爲按鈕綁定事件處理器。第一個參數爲控件id,第二個參數指定當控件點擊時那個pendingIntent會被執行
remoteViews.setOnClickPendingIntent(R.id.widgetButtonId, pendingIntent);
//更新appWidget。第一個參數用於指定Appwidget的id
appWidgetManager.updateAppWidget(appWidgetIds, remoteViews);
super.onUpdate(context, appWidgetManager, appWidgetIds);
}
}
最後貼上其他一些沒有太大關係的代碼,使項目完整
MainActivity。java
package com.yx.appwidget;
import android.os.Bundle;
import android.app.Activity;
import android.view.Menu;
public class MainActivity extends Activity {
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
}
@Override
public boolean onCreateOptionsMenu(Menu menu) {
// Inflate the menu; this adds items to the action bar if it is present.
getMenuInflater().inflate(R.menu.main, menu);
return true;
}
}
TargetActivity.java
package com.yx.appwidget;
import android.app.Activity;
import android.os.Bundle;
public class TargetActivity extends Activity {
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
}
}
activity_main.xml
<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:tools="http://schemas.android.com/tools"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:paddingBottom="@dimen/activity_vertical_margin"
android:paddingLeft="@dimen/activity_horizontal_margin"
android:paddingRight="@dimen/activity_horizontal_margin"
android:paddingTop="@dimen/activity_vertical_margin"
tools:context=".MainActivity" >
<TextView
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:text="@string/hello_world" />
</RelativeLayout>