Taehoon Koo's Blog

<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/example_appwidget_info" />



</receiver>

<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"



    android:configure="com.example.android.ExampleAppWidgetConfigure" >



</appwidget-provider>

• minWidth/minHeight 설정
• 사실상 width값대로 표기되는게 아니라, 현재의 Cell Size에 따라 자동 계산된다.
• Cell Size는 Device별로 다르고, 같은 Device일때도, Vertical이냐 Horizontal에 따라서 또 다르다.
• ( Number of Cells ) * 74 -2 의 계산식으로 계산하여 설정하도록 한다.
• updatePeriodMillis 설정
• layout 명시
• AppWidget Layout XML
• configure(optional)
• 유저가 AppWidget 설정시 사용될 Activity

AppWidget Layout

AppWidget의 Layout은 기본적으로 Activity용 Layout과 다를 바가 없다.
다만, AppWidget은 RemoteView를 기반으로 하고 있기 때문에, 사용할 수 있는 종류에 제약이 있다.

사용가능한 Layout Classes

• FrameLayout
• LinearLayout
• RelativeLayout

사용가능한 Widget Classes

• AnalogClock
• Button
• Chronometer
• ImageButton
• ImageView
• ProgressBar
• TextView

AppWidgetProviderClass 구현하기

아래 소스는 appWidget을 Click했을 때, 특정 Activity를 띄우는 AppWidget의 예이다.

public class ExampleAppWidgetProvider extends AppWidgetProvider {




    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);


        }


    }


}