! appwidget-hello

アプリケーションウィジェットの最小サンプル。
固定レイアウトとして layout/main.xml を表示するアプリケーションウィジェット。
更新は一切しない。

!! アプリケーションウィジェットの実装手順

* アプリケーションウィジェットのレイアウトを作成
* アプリケーションウィジェットの情報を記述したXMLファイルを作成
* AppWidgetProvider を継承したクラスを作成
* AndroidManifest.xml に必要事項を登録


!! AppWidgetProvider

アプリケーションウィジェットの実装者は AppWidgetProvider を継承して
以下のメソッドを実装する。(BroadcastReciever を継承しても実装は可能。)

* AppWidgetProvider#onEnabled(Context context) : void
  このウィジェットが最初に追加されたときに呼ばれる
* AppWidgetProvider#onDisabled(Context context) : void
  このウィジェットの最後のインスタンスが削除されたときに呼ばれる
* AppWidgetProvider#onUpdate(Context context, AppWidgetManager manager, int[] appWidgetIds) : void
  このウィジェットが追加されたとき、または更新されたときに呼ばれる
* AppWidgetProvider#onDelete(Context context,  int[] appWidgetIds) : void
  このウィジェットのインスタンスが削除されたときに呼ばれる

アプリケーションウィジェットのインスタンスの初期化と更新は onUpdate() で行う
ことになる。


!! 利用可能なレイアウトとビュー

アプリケーションウィジェットではアクティビティと異なり利用可能な
レイアウトとビューが制限されている。


利用可能なレイアウト
* FrameLayout
* LinearLayout
* RelativeLayout

利用可能なビュー
* AnalogClock
* Button
* Chronometer
* ImageButton
* ImageView
* ProgressBar
* TextView
* ViewFlipper

Android 3.0 以降利用可能なビュー
* GridView
* ListView
* StackView
* AdapterViewFlipper


!! ビルドターゲット

http://maven-android-plugin-m2site.googlecode.com/svn/plugin-info.html

* mvn compile - アプリケーションのコンパイル
* mvn package - apk の作成
* mvn clean - ビルドファイルの削除
* mvn install - maven の local リポジトリにインストール

* mvn android:deploy - エミュレータやデバイスにインストール
* mvn android:generate-sources

* mvn install - アプリケーションのインストール
* mvn uninstall - アプリケーションのアンインストール

