Y.A.M の雑記帳

ColorPicker の Action Provider を作った

2012-01-02T18:13:00.000+09:00

色選択するための Action Provider を作りました。

HSV の領域をタッチして色を変えます。SとVはそれぞれの現在値に応じて領域の色が変わるようになっています。

いつものように github にもおきましたー。
yanzm/ColorPickerActionProvider - GitHub -

public class MainActivity extends Activity {    private int mSelectedColor = Color.BLACK;    @Override    public boolean onCreateOptionsMenu(Menu menu) {        super.onCreateOptionsMenu(menu);        getMenuInflater().inflate(R.menu.menu, menu);        MenuItem item = menu.findItem(R.id.menu_color_picker);        HsvColorActionProvider actionProvider = (HsvColorActionProvider) item.getActionProvider();        actionProvider.setOnColorChangedListener(new HsvColorActionProvider.OnColorChangedListener() {            @Override            public void onColorChanged(int color) {                View v = findViewById(android.R.id.content);                v.setBackgroundColor(color);            }            @Override            public void onColorSelected(int color) {                mSelectedColor = color;                View v = findViewById(android.R.id.content);                v.setBackgroundColor(color);            }            @Override            public void onCanceled() {                View v = findViewById(android.R.id.content);                v.setBackgroundColor(mSelectedColor);            }        });        return true;    }}

public class HsvColorActionProvider extends ActionProvider {    public interface OnColorChangedListener {        public void onColorChanged(int color);        public void onColorSelected(int color);        public void onCanceled();    }    private OnColorChangedListener mListener;    private Context mContext;    private LayoutInflater mLayoutInflater;    private PopupWindow mPopupWindow;    private HsvColorPickerView mColorPicker;    private int mInitialColor;    public HsvColorActionProvider(Context context) {        super(context);        mContext = context;        mInitialColor = Color.HSVToColor(new float[] { 180, 0.7f, 0.8f });        mLayoutInflater = LayoutInflater.from(context);        View v = mLayoutInflater.inflate(R.layout.color_popup, null, false);        mColorPicker = (HsvColorPickerView) v.findViewById(R.id.color_picker);        mColorPicker.showPreview(true);        mColorPicker.setIniticalColor(mInitialColor);        mColorPicker.setOnColorChangedListener(new HsvColorPickerView.OnColorChangedListener() {            @Override            public void onColorChanged(int color, float[] hsv) {                if (mListener != null) {                    mListener.onColorChanged(color);                }            }        });        v.findViewById(R.id.cancel_btn).setOnClickListener(new View.OnClickListener() {            @Override            public void onClick(View v) {                mPopupWindow.dismiss();                if (mListener != null) {                    mListener.onCanceled();                }            }        });        v.findViewById(R.id.ok_btn).setOnClickListener(new View.OnClickListener() {            @Override            public void onClick(View v) {                mInitialColor = mColorPicker.getCurrentColor();                if (mListener != null) {                    mListener.onColorSelected(mInitialColor);                }                mPopupWindow.dismiss();            }        });        mPopupWindow = new PopupWindow(v);        mPopupWindow.setBackgroundDrawable(mContext.getResources().getDrawable(R.drawable.panel_bg));        mPopupWindow.setWidth(WindowManager.LayoutParams.WRAP_CONTENT);        mPopupWindow.setHeight(WindowManager.LayoutParams.WRAP_CONTENT);    }    public void setOnColorChangedListener(OnColorChangedListener l) {        mListener = l;    }    @Override    public View onCreateActionView() {        LayoutInflater layoutInflater = LayoutInflater.from(mContext);        final View actionItem = layoutInflater.inflate(R.layout.color_action_provider, null);        ImageButton button = (ImageButton) actionItem.findViewById(R.id.button);        button.setOnClickListener(new View.OnClickListener() {            @Override            public void onClick(View v) {                if (!mPopupWindow.isShowing()) {                    mColorPicker.setIniticalColor(mInitialColor);                    mPopupWindow.showAsDropDown(actionItem);                } else {                    mPopupWindow.dismiss();                }            }        });        return actionItem;    }}

public class HsvColorPickerView extends View {    public interface OnColorChangedListener {        void onColorChanged(int color, float[] hsv);    }    public void setOnColorChangedListener(OnColorChangedListener l) {        mListener = l;    }    /**     * 初期カラーをセットする     *      * @param color     */    public void setIniticalColor(int color) {        mCurrentColor = color;        Color.colorToHSV(mCurrentColor, mCurrentHSV);        invalidate();    }    /**     * 現在の色を返す     *      * @return     */    public int getCurrentColor() {        return mCurrentColor;    }    /**     * プレビューを表示するかどうか     *      * @param show     */    public void showPreview(boolean show) {        mIsShowPreview = show;        updateRectArea();    }    /**     * 色領域の幅をセットする     *      * @param width     */    public void setRectWidth(int width) {        mRectWidth = width;        updateRectArea();    }    /**     * 色領域の高さをセットする     *      * @param height     */    public void setRectHeight(int height) {        mRectHeight = height;        updateRectArea();    }    /**     * 色領域間のギャップをセットする     *      * @param gap     */    public void setRectGap(int gap) {        mRectGap = gap;        updateRectArea();    }    private static final int RECT_WIDTH = 400;    private static final int RECT_HEIGHT = 80;    private static final int RECT_GAP = 20;    private boolean mIsShowPreview = true;    private int mRectWidth = RECT_WIDTH;    private int mRectHeight = RECT_HEIGHT;    private int mRectGap = RECT_GAP;    private OnColorChangedListener mListener;    private int mCurrentColor = Color.RED;    private float[] mCurrentHSV = new float[3];    private Shader mHueShader;    private Shader mSaturationShader;    private Shader mValueShader;    private Paint mHuePaint;    private Paint mValuePaint;    private Paint mSaturationPaint;    private Paint mPreviewPaint;    private Paint mLinePaint;    private Rect mHueRect;    private Rect mSaturationRect;    private Rect mValueRect;    private Rect mPreviewRect;    int[] mHueList;    public HsvColorPickerView(Context c) {        super(c);        init();    }    public HsvColorPickerView(Context context, AttributeSet attrs) {        super(context, attrs);        init();    }    private void init() {        Color.colorToHSV(mCurrentColor, mCurrentHSV);        mHueList = new int[10];        float hue = 0;        for (int i = 0; i < 10; i++) {            mHueList[i] = setHSVColor(hue, 255, 255);            hue += 36;        }        mHuePaint = new Paint(Paint.ANTI_ALIAS_FLAG);        mHuePaint.setStyle(Paint.Style.FILL);        mHuePaint.setStrokeWidth(2);        mValuePaint = new Paint(Paint.ANTI_ALIAS_FLAG);        mValuePaint.setStyle(Paint.Style.FILL);        mValuePaint.setStrokeWidth(2);        mSaturationPaint = new Paint(Paint.ANTI_ALIAS_FLAG);        mSaturationPaint.setStyle(Paint.Style.FILL);        mSaturationPaint.setStrokeWidth(2);        mPreviewPaint = new Paint(Paint.ANTI_ALIAS_FLAG);        mPreviewPaint.setStyle(Paint.Style.FILL);        mPreviewPaint.setStrokeWidth(5);        mLinePaint = new Paint(Paint.ANTI_ALIAS_FLAG);        mLinePaint.setStyle(Paint.Style.FILL);        mLinePaint.setStrokeWidth(5);        mLinePaint.setColor(Color.BLACK);        updateRectArea();    }    private void updateRectArea() {        mHueShader = new LinearGradient(0, 0, mRectWidth, 0, mHueList, null, Shader.TileMode.CLAMP);        mHuePaint.setShader(mHueShader);        if (mIsShowPreview) {            mPreviewRect = new Rect(0, 0, mRectWidth, mRectHeight);            mHueRect = new Rect(0, mRectHeight + mRectGap, mRectWidth, mRectHeight * 2 + mRectGap);            mSaturationRect = new Rect(0, mRectHeight * 2 + mRectGap * 2, mRectWidth, mRectHeight * 3 + mRectGap * 2);            mValueRect = new Rect(0, mRectHeight * 3 + mRectGap * 3, mRectWidth, mRectHeight * 4 + mRectGap * 3);        } else {            mHueRect = new Rect(0, 0, mRectWidth, mRectHeight);            mSaturationRect = new Rect(0, mRectHeight + mRectGap, mRectWidth, mRectHeight * 2 + mRectGap);            mValueRect = new Rect(0, mRectHeight * 2 + mRectGap * 2, mRectWidth, mRectHeight * 3 + mRectGap * 2);        }    }    @Override    protected void onDraw(Canvas canvas) {        // Hue        canvas.drawRect(mHueRect, mHuePaint);        canvas.drawLine(mCurrentHSV[0] * mRectWidth / 360, mHueRect.top, mCurrentHSV[0] * mRectWidth / 360,                mHueRect.bottom, mLinePaint);        // Saturation        int[] mSaturationList = new int[10];        float saturation = 0;        for (int i = 0; i < 10; i++) {            mSaturationList[i] = setHSVColor(mCurrentHSV[0], saturation, mCurrentHSV[2]);            saturation += 0.1;        }        mSaturationShader = new LinearGradient(0, 0, mRectWidth, 0, mSaturationList, null, Shader.TileMode.CLAMP);        mSaturationPaint.setShader(mSaturationShader);        canvas.drawRect(mSaturationRect, mSaturationPaint);        canvas.drawLine(mCurrentHSV[1] * mRectWidth, mSaturationRect.top, mCurrentHSV[1] * mRectWidth,                mSaturationRect.bottom, mLinePaint);        // Value        int[] mValueList = new int[10];        float value = 0;        for (int i = 0; i < 10; i++) {            mValueList[i] = setHSVColor(mCurrentHSV[0], mCurrentHSV[1], value);            value += 0.1;        }        mValueShader = new LinearGradient(0, 0, mRectWidth, 0, mValueList, null, Shader.TileMode.CLAMP);        mValuePaint.setShader(mValueShader);        canvas.drawRect(mValueRect, mValuePaint);        canvas.drawLine(mCurrentHSV[2] * mRectWidth, mValueRect.top, mCurrentHSV[2] * mRectWidth, mValueRect.bottom,                mLinePaint);        if (mIsShowPreview) {            // Preview            mPreviewPaint.setColor(mCurrentColor);            canvas.drawRect(mPreviewRect, mPreviewPaint);        }    }    @Override    protected void onMeasure(int widthMeasureSpec, int heightMeasureSpec) {        if (mIsShowPreview) {            setMeasuredDimension(mRectWidth, mRectHeight * 4 + mRectGap * 3);        } else {            setMeasuredDimension(mRectWidth, mRectHeight * 3 + mRectGap * 2);        }    }    private int setHSVColor(float hue, float saturation, float value) {        float[] hsv = new float[3];        hsv[0] = Math.max(0, Math.min(359, hue));        hsv[1] = Math.max(0, Math.min(1, saturation));        hsv[2] = Math.max(0, Math.min(1, value));        return Color.HSVToColor(hsv);    }    @Override    public boolean onTouchEvent(MotionEvent event) {        float x = event.getX();        float y = event.getY();        boolean inHue = mHueRect.contains((int) x, (int) y);        boolean inSaturation = mSaturationRect.contains((int) x, (int) y);        boolean inValue = mValueRect.contains((int) x, (int) y);        switch (event.getAction()) {            case MotionEvent.ACTION_DOWN:            case MotionEvent.ACTION_MOVE:                if (inHue) {                    float unit = x / mRectWidth;                    mCurrentHSV[0] = Math.max(0, Math.min(unit * 360, 359));                    updateCurrentColor();                } else if (inSaturation) {                    mCurrentHSV[1] = Math.max(0, Math.min(x / mRectWidth, 1));                    updateCurrentColor();                } else if (inValue) {                    mCurrentHSV[2] = Math.max(0, Math.min(x / mRectWidth, 1));                    updateCurrentColor();                }                break;        }        return true;    }    private void updateCurrentColor() {        mCurrentColor = Color.HSVToColor(mCurrentHSV);        if (mListener != null) {            mListener.onColorChanged(mCurrentColor, mCurrentHSV);        }        invalidate();    }}

Android 4.0.3 Platform

2011-12-17T15:03:00.000+09:00

Android 4.0.3 Platformを意訳しました。訳が正しくない可能性もあります。正確な内容を理解するには原文を参照してください。

---
API Level: 15

Android 4.0.3 は Android .4x (Ice Cream Sandwich) プラットフォームファミリーのインクリメンタルリリースです。このリリースには、ユーザーと開発者むけの新しい機能、API の変更、いくつかのバグフィックスが含まれています。

開発者は Android SDK のコンポーネントとして Android 4.0.3 platform をダウンロードできるようになりました。Android emulator を使って Android 4.0 でのアプリケーションの開発やテストを行うことができます。このプラットフォームには Android library と system image, emulator skin などが含まれていますが、外部のライブラリは含まれていません。

Android 4.0.3 向けの開発とテストを始めるには、Android SDK Manager を使って自分の SDK にプラットフォームをダウンロードします。より詳しい情報は Adding SDK Components を見てください。Android が初めての人は、まず download the SDK Starter Package から始めてください。

ユーザーと開発者向けの新しい機能の概要は Platform Highlights を見てください。

---

API Overview

Social stream API in Contacts Provider

ステータスアップデートやチェックインなどのソーシャルストリームデータを使うアプリケーションは各ユーザーのコンタクトにデータを同期したり、各写真といっしょにストリームのアイテムを提供することができるようになりました。

個々のコンタクトのソーシャルストリームを含むデータベーステーブルは ContactsContract.StreamItems によって定義されています。それぞれの Uri はストリームアイテムが所属する ContactsContract.RawContacts ディレクトリ内に格納されています。各ソーシャルストリームテーブルは、ストリームアイテムのメタデータ用のいくつかのカラムを含みます。例えば情報元（アバター）を表すアイコンやアイテムのラベル、主なテキストコンテンツ、アイテムについてのコメント（他の人からのレスポンスとか）などです。ストリームに関連する写真は ContactsContract.StreamItemPhotos で定義されるテーブルに格納されます。これあh ContactsContract.StreamItems Uri のサブディレクトリとして利用できます。

より詳しい情報は ContactsContract.StreamItems と ContactsContract.StreamItemPhotos を見てください。

コンタクトに対してソーシャルストリームアイテムを読み書きするには、アプリケーションはパーミッションをリクエストする必要があります。リクエストするには、マニフェストファイルに <uses-permission android:name="android.permission.READ_SOCIAL_STREAM"> かつ／または <uses-permission android:name="android.permission.WRITE_SOCIAL_STREAM"> を宣言します。

Calendar Provider

Calendar Provider でのカラーテーブルを表す新しいクラス CalendarContract.Colors が追加されました。このクラスは与えられたアカウントで利用出来る色にアクセスするためのフィールドを提供します。色は COLOR_KEY によってリファレンスされ、与えられたアカウント名／タイプに対してユニークでなければなりません。これらの値は sync adapter によってのみアップデートできます。
exchange/sync サポートのための ALLOWED_AVAILABILITY と ALLOWED_ATTENDEE_TYPES が追加されました。
参加者用の TYPE_RESOURCE (会議室など)、AVAILABILITY_TENTATIVE、イベント用の EVENT_COLOR_KEY が追加されました。

Home screen widgets

Android 4.0 からホームスクリーンウィジェットはもはや自身のパディングを含みません。代わりに現在の画面の特徴に基づいて、現在のシステムが自動的に各ウィジェットにパディングを追加します。これにより、グリッド上のウィジェットにより均一で統一な表現を与えます。ホームスクリーンウィジェットをホストするアプリケーションをアシストするために、プラットフォームは新しいメソッド getDefaultPaddingForWidget() を提供します。アプリケーションはこのメソッドを呼んでシステムが定義したパディングを取得することができ、ウィジェットに割り当てるセルの数を計算するときにそれを考慮できます。

Spell-checking

spell-checker サービスにアクセスできるアプリでは、新しい cancel() メソッドを使ってセッション中で保留されていたり実行されている spell-checker タスクをキャンセルすることができます。
spell-checker サービスでは、新しい候補フラグ RESULT_ATTR_HAS_RECOMMENDED_SUGGESTIONS によってサービスは低信頼度の候補から高信頼度の候補を区別することができます。例えば、spell-checker はユーザーの辞書にはないが、よく候補が現れる入力ワードにフラグをセットしたり、ユーザーの辞書にないがあまり役立たない候補がでる入力ワードのフラグを外したりできます。
spell-checker に接続したアプリは getSuggestionsAttributes() や getSuggestionsCount() などの他の候補属性との組み合わせで RESULT_ATTR_HAS_RECOMMENDED_SUGGESTIONS フラグを使うことができます。これにより入力ワードをタイポとしてマークし他の候補を出すかどうか決めることができます。
text span 用の新しい FLAG_AUTO_CORRECTION スタイルは、ユーザーがタイピング／編集した文字／テキストに自動修正が適用されたことを表します。このタイプの候補は異なったレンダリングがされ、自動修正が起こったことを示します。

Bluetooth

新しい public メソッド fetchUuidsWithSdp() と getUuids() によってリモートデバイスによってサポートされている機能 (UUIDs) を決めることができます。fetchUuidsWithSdp() の場合、システムはサポートされている UUIDs を取得するためにリモートデバイス上でサービスディスカバリを実行し、結果を ACTION_UUID intent として発行します。

UI toolkit

新しいメソッド setUserVisibleHint() と getUserVisibleHint() によってフラグメントは現在ユーザーに見えているかどうかのヒントをセットすることができます。システムは見えているフラグメントの Loader が実行されるまで見えていないフラグメントの開始を遅らせます。見えているかどうかのヒントはデフォルトでは "true" です。

Graphics

SurfaceTexture の新しいメソッド setDefaultBufferSize(int, int) でイメージバッファのデフォルトサイズをセットできます。このメソッドは Canvas (lockCanvas(Rect) を介して) や OpenGL ES (EGLSurface を介して) で画像を処理するときに画像サイズをセットするのに使われるでしょう。
OpenGL ES 拡張の GL_OES_EGL_image_external の enum の定義が追加されました。 - GL_REQUIRED_TEXTURE_IMAGE_UNITS_OES、GL_SAMPLER_EXTERNAL_OES、GL_TEXTURE_BINDING_EXTERNAL_OES、 GL_TEXTURE_EXTERNAL_OES。

Accessibility

RemoteViews のクライアントは setContentDescription() を使えるようになりました。これにより、インフレートされたレイアウト上の View に content description をセットすることができます。
新しいメソッド getMaxScrollX()、getMaxScrollY()、setMaxScrollX()、setMaxScrollY()を使って、AccessobilityRecord オブジェクトに対する最大のスクロールオフセットを設定したり取得したりできます。
touch-exploration モードが有効のとき、新しいセキュア設定 ACCESSIBILITY_SPEAK_PASSWORD は、ハンドセットが使われていなくてもパスワードフィールドに入力されたテキストを IME が読み上げることをユーザーがリクエストしているかどうかを示しています。デフォルトでは、ハンドセットが使われていない場合パスワードテキストは読まれません。

Text-to-speech

ネットワークの TTS サポートを調べたり有効にしたりするための新しいメソッド getFeatures() が追加されました。
音声合成エラーの通知を受取るためにエンジンが登録する新しいリスナークラス UtteranceProgressListener が追加されました。

Database

Content Provider が cross-process なクエリの結果をより効果的に返せるようにする新しいクラス CrossProcessCursorWrapper が追加されました。この新しいクラスはリモートでプロセスに送られる cursor をラップしたブロックを作成するときに便利です。また通常の Cursor オブジェクトを CrossProcessCursor オブジェクトに透過的に変換することもできます。
CrossProcessCursorWrappter クラスは Content Provider を実装するときにアプリケーションがよく遭遇する一般的なパフォーマンス問題とバグを解決します。
入力として名前文字列を受取るコンストラクタ CursorWindow(String) が追加されました。システムはもはやローカルとリモートの cursor window を区別しません。そのため CursorWindow(boolean) は無効になりました。

Intents

デバイス上のアプリケーションのタイプを指定するための新しいカテゴリ（CATEGORY_APP_BROWSER や CATEGORY_APP_CALENDAR や CATEGORY_APP_MAPS など）が追加されました。

Camera

アプリのアクセスが、画像やビデオの位置情報を取得できるように、MediaMetadataRetriever に新しい定数 METADATA_KEY_LOCATION が追加されました。
ComcorderProfile に QVGA (320x240) 解像度プロファイルが追加されました。このクオリティレベルは QUALITY_QVGA および QUALITY_TIME_LAPSE_QVGA 定数が表しています。
Camera で、ビデオの安定度をチェックしたり管理したりするための新しいメソッド setVideoStabilization()、getVideoStabilization()、isVideoStabilizationSupported() が追加されました。

Permissions新しいパーミッションが追加されました。

READ_SOCIAL_STREAM と WRITE_SOCIAL_STREAM : 共有されている Contacts Provider 内の連絡先にソーシャルストリームデータを読み書きするための sync adapter を許可します。

Android　ADKを使ってバルスって言ったら青色LEDが光るようにしてみた。

2011-12-09T18:08:00.001+09:00

今日の21時から「天空の城ラピュタ」が放送されるので、TLがバルスで盛り上がって楽しかったので作ってみましたw

RecognizerIntent を使って認識した文字がバルスだったら ADK で LED をつけてるだけです。
RecognizerIntent については adakoda 先生のサイト音声認識(RecognizerIntent)を使用するには - 逆引きAndroid入門 -を参考にしました。
いつもありがとうございます。

Android アプリから LED の ON/OFF を切り替える方法は前回のエントリ（Android　Hello ADK をつくった！）をみてください。

やってみたい人は GitHub においたのでどうぞ。
yanzm/SayBalus - GitHub -

Android　Hello ADK つくった！

2011-12-08T18:02:00.001+09:00

DemoKit を動かしてみたよエントリや、Arduino で ADK 自作したよエントリはあるのに、Android ADK 用の Android アプリのプログラミングについて初心者向けに書かれたエントリがぜーんぜんなかったので書くことにしました。

ちなみにわたくし、電子工作ブランク10年くらいです。10年前にブレッドボード上にケーブルが空中回廊みたいになった電卓を作って以来です。

今回は USB Accessory モードの方についてです。
公式ドキュメントはこちら
http://developer.android.com/guide/topics/usb/accessory.html
私のブログでの和訳はこちら
http://y-anz-m.blogspot.com/2011/05/usb-accessory.html

さて、とりあえず開発環境の準備。
DemoKit 動かしてみたよエントリがたくさんあるのでその辺りみればだいたい書いてると思う。
ちなみに公式ドキュメントはこちら。
Android Open Accessory Development Kit | Android Developers

これの Getting Started with the ADK を見ながら（私のブログでの和訳はこちら http://y-anz-m.blogspot.com/2011/05/android-open-accessory-development-kit.html

Arduino Software : ADK は Arduino がベースになっているので、ADK で動かすプログラムは Arduino で書く。そのための IDE。コーディングは持ちろん、デバッグやファームインストールもこれで行う。
CapSence library : 人間の静電容量を感知するためのライブラリ。DemoKit の Android シールドにあるタッチセンサーの為に必要。これいれないとタッチセンサーを触っても DemoKit アプリ側で反応しない。
The ADK package : ADK board 用のファームウェアおよび ADK board とシールド用の hardware design files。

をまずはとってきて、ドキュメントの手順通りにセットアップする。

で、DemoKit を動かす。

さて、ここまではできるよ。手順通りにやればいいだけだからね。
でもさ、DemoKit 取り外して、アクセサリに LED 1個つなげて光らせるだけでも自分だけでやれって言われると、
はて、どうしたら、、、？ってなるのですよ。

とりあえず DemoKit のコード見るよねー。
アクセサリ側はまだいいんだけど、Android アプリ側がすごく複雑。。。
とりあえず LED を on/off するだけの最小構成が知りたいのに操作できる項目が多い（DemoKit では入力としてリレー、3色LEDx3。出力としてジョイスティック、ボタン、タッチセンサー、温度、湿度がある）のでレイアウトも複雑だし、クラスも多い。。。。

やはりここは HelloWorld ならぬ HelloADK が必要なのでは。

ということでつくりましたよっと。

1. Android app

まずは Android アプリ側から。

注意点: Build Target は 2.3.3 (API Level 10) の Google APIs にする。

USB Accessory モードはもともと USB Host と同じく Android 3.0 からサポートされたものなのですが、Android 2.3.4 にバックポートされています。このバックポートを使うには 2.3.3 の Google APIs を指定する必要があります！

LED を on / off するだけなんでレイアウトはトグルボタン1個でいいよね。
ADK に接続してるかどうかのステータスも出すようにしよう。

<?xml version="1.0" encoding="utf-8"?><LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"    android:layout_width="fill_parent"    android:layout_height="fill_parent"    android:gravity="center"    android:orientation="vertical" >    <TextView        android:id="@+id/status"        android:layout_width="wrap_content"        android:layout_height="wrap_content"        android:layout_margin="10dip" />    <ToggleButton        android:id="@+id/toggleBtn"        android:layout_width="wrap_content"        android:layout_height="wrap_content"        android:layout_margin="10dip" />    <TextView        android:id="@+id/ledState"        android:layout_width="wrap_content"        android:layout_height="wrap_content"        android:layout_margin="10dip" /></LinearLayout>

では肝心の Activity 側。まずは　UsbManager のインスタンスを取得します。
Add-on library （つまり 2.3.4 にバックポートされたライブラリ）を使っている場合は
UsbManager manager = UsbManager.getInstance(this);
3.0 以降のプラットフォーム標準の API を使う場合は
UsbManager manager = (UsbManager) getSystemService(Context.USB_SERVICE);

流れ的には

onCreate()
　・UsbManager の取得
　・オレオレIntent action でパーミッション依頼用の
　　PendingIntent 作成
　・オレオレIntent action とアクセサリが外されたときの
　　BroadcastReceiver 登録
　・画面のセットアップ

onResume()
　・USBAccessory の一覧を取得して、権限チェック。
　　あればアクセサリとの接続を開く
　　（UsbAccessory からファイルデスクリプタを取得し
　　　ファイルデスクリプタから入出力用の Stream を取得。
　　　入力を受け取るためのスレッドを開始）
　　、なければパーミッションを依頼

onPause()
　・アクセサリとの接続閉じる

onDestroy()
　・onCreate() で登録した BroadcastReceiver 解除

・View が操作されたら出力用ストリームにバイト列書き込む。
・入力受け取り用スレッドでバイト列受け取ったらUIスレッドに渡してViewに反映

こんな感じかな。あとは、コメントみてくれ。

public class MainActivity extends Activity implements Runnable {    private static final String TAG = "HelloLED";    private static final String ACTION_USB_PERMISSION = "com.uphyca.android.app.helloled.action.USB_PERMISSION";    private PendingIntent mPermissionIntent;    private boolean mPermissionRequestPending;    private UsbManager mUsbManager;    private UsbAccessory mAccessory;    ParcelFileDescriptor mFileDescriptor;    FileInputStream mInputStream;    FileOutputStream mOutputStream;        private ToggleButton mToggleButton;    private TextView mLedStatusView;    private TextView mStatusView;    private final BroadcastReceiver mUsbReceiver = new BroadcastReceiver() {        @Override        public void onReceive(Context context, Intent intent) {            String action = intent.getAction();            if (ACTION_USB_PERMISSION.equals(action)) {                synchronized (this) {                    // Intent からアクセサリを取得                    UsbAccessory accessory = UsbManager.getAccessory(intent);                    // パーミッションがあるかチェック                    if (intent.getBooleanExtra(UsbManager.EXTRA_PERMISSION_GRANTED, false)) {                        // 接続を開く                        openAccessory(accessory);                    } else {                        Log.d(TAG, "permission denied for accessory " + accessory);                    }                    mPermissionRequestPending = false;                }            } else if (UsbManager.ACTION_USB_ACCESSORY_DETACHED.equals(action)) {                // Intent からアクセサリを取得                UsbAccessory accessory = UsbManager.getAccessory(intent);                if (accessory != null && accessory.equals(mAccessory)) {                    // 接続を閉じる                    closeAccessory();                }            }        }    };    @Override    public void onCreate(Bundle savedInstanceState) {        super.onCreate(savedInstanceState);        // UsbManager のインスタンスを取得        mUsbManager = UsbManager.getInstance(this);        // オレオレパーミッション用 Broadcast Intent        mPermissionIntent = PendingIntent.getBroadcast(this, 0, new Intent(ACTION_USB_PERMISSION), 0);        // オレオレパーミッション Intent とアクセサリが取り外されたときの Intent を登録        IntentFilter filter = new IntentFilter();        filter.addAction(ACTION_USB_PERMISSION);        filter.addAction(UsbManager.ACTION_USB_ACCESSORY_DETACHED);        registerReceiver(mUsbReceiver, filter);        setContentView(R.layout.main);                mToggleButton = (ToggleButton) findViewById(R.id.toggleBtn);        mLedStatusView = (TextView) findViewById(R.id.ledState);        mStatusView = (TextView) findViewById(R.id.status);                mToggleButton.setOnCheckedChangeListener(new OnCheckedChangeListener() {                        @Override            public void onCheckedChanged(CompoundButton buttonView, boolean isChecked) {                byte command = 0x1;                byte value = (byte) (isChecked ? 0x1 : 0x0);                sendCommand(command, value);            }        });        enableControls(false);    }    @Override    public void onResume() {        super.onResume();        if (mInputStream != null && mOutputStream != null) {            return;        }        // USB Accessory の一覧を取得        UsbAccessory[] accessories = mUsbManager.getAccessoryList();        UsbAccessory accessory = (accessories == null ? null : accessories[0]);        if (accessory != null) {            // Accessory にアクセスする権限があるかチェック            if (mUsbManager.hasPermission(accessory)) {                // 接続を開く                openAccessory(accessory);            } else {                synchronized (mUsbReceiver) {                    if (!mPermissionRequestPending) {                        // パーミッションを依頼                        mUsbManager.requestPermission(accessory, mPermissionIntent);                        mPermissionRequestPending = true;                    }                }            }        } else {            Log.d(TAG, "mAccessory is null");        }    }    @Override    public void onPause() {        super.onPause();        closeAccessory();    }    @Override    public void onDestroy() {        unregisterReceiver(mUsbReceiver);        super.onDestroy();    }    private void openAccessory(UsbAccessory accessory) {        // アクセサリにアクセスするためのファイルディスクリプタを取得        mFileDescriptor = mUsbManager.openAccessory(accessory);        if (mFileDescriptor != null) {            mAccessory = accessory;            FileDescriptor fd = mFileDescriptor.getFileDescriptor();            // 入出力用のストリームを確保            mInputStream = new FileInputStream(fd);            mOutputStream = new FileOutputStream(fd);            // この中でアクセサリとやりとりする            Thread thread = new Thread(null, this, "DemoKit");            thread.start();            Log.d(TAG, "accessory opened");            enableControls(true);        } else {            Log.d(TAG, "accessory open fail");        }    }    private void closeAccessory() {        enableControls(false);        try {            if (mFileDescriptor != null) {                mFileDescriptor.close();            }        } catch (IOException e) {        } finally {            mFileDescriptor = null;            mAccessory = null;        }    }    private void enableControls(boolean enable) {        if (enable) {            mStatusView.setText("connected");        } else {            mStatusView.setText("not connected");        }        mToggleButton.setEnabled(enable);    }    private static final int MESSAGE_LED = 1;    private class LedMsg {        private byte on;        public LedMsg(byte on) {            this.on = on;        }        public boolean isOn() {            if(on == 0x1)                return true;            else                return false;        }    }    // ここでアクセサリと通信する    @Override    public void run() {        int ret = 0;        byte[] buffer = new byte[16384];        int i;        // アクセサリ -> アプリ        while (ret >= 0) {            try {                ret = mInputStream.read(buffer);            } catch (IOException e) {                break;            }            i = 0;            while (i < ret) {                int len = ret - i;                switch (buffer[i]) {                    case 0x1:                        // 2byte のオレオレプロトコル                        // 0x1 0x0 や 0x1 0x1 など                        if (len >= 2) {                            Message m = Message.obtain(mHandler, MESSAGE_LED);                            m.obj = new LedMsg(buffer[i + 1]);                            mHandler.sendMessage(m);                        }                        i += 2;                        break;                    default:                        Log.d(TAG, "unknown msg: " + buffer[i]);                        i = len;                        break;                }            }        }    }    // UI スレッドで画面上の表示を変更    private Handler mHandler = new Handler() {        @Override        public void handleMessage(Message msg) {            switch (msg.what) {                case MESSAGE_LED:                    LedMsg o = (LedMsg) msg.obj;                    handleLedMessage(o);                    break;            }        }    };    private void handleLedMessage(LedMsg l) {        if(l.isOn()) {            mLedStatusView.setText("ON");        }        else {            mLedStatusView.setText("OFF");        }    }    // アプリ -> アクセサリ    public void sendCommand(byte command, byte value) {        byte[] buffer = new byte[2];                if(value != 0x1 && value != 0x0)            value = 0x0;        // 2byte のオレオレプロトコル        // 0x1 0x0 や 0x1 0x1        buffer[0] = command;        buffer[1] = value;        if (mOutputStream != null) {            try {                mOutputStream.write(buffer);            } catch (IOException e) {                Log.e(TAG, "write failed", e);            }        }    }}

つぎにアクセサリをフィルターするための XML ファイルを作成
manufacturer と model と version はアクセサリ側のコードの aac() の引数をあわせる。

res/xml/accessory_filter.xml

最後の AndroidManifest.xml にいろいろ宣言
・<uses-library android:name="com.android.future.usb.accessory" />
・android.hardware.usb.action.USB_ACCESSORY_ATTACHED の intentfilter
・android.hardware.usb.action.USB_ACCESSORY_ATTACHED の meta-data

AndroidManifest.xml

<?xml version="1.0" encoding="utf-8"?><manifest xmlns:android="http://schemas.android.com/apk/res/android"    package="com.uphyca.android.helloadk"    android:versionCode="1"    android:versionName="1.0" >    <uses-sdk android:minSdkVersion="10" />    <application        android:icon="@drawable/ic_launcher"        android:label="@string/app_name" >                <uses-library android:name="com.android.future.usb.accessory" />        <activity            android:label="@string/app_name"            android:launchMode="singleInstance"            android:name=".MainActivity"            android:taskAffinity="" >            <intent-filter >                <action android:name="android.intent.action.MAIN" />                <category android:name="android.intent.category.LAUNCHER" />            </intent-filter>            <intent-filter >                <action android:name="android.hardware.usb.action.USB_ACCESSORY_ATTACHED" />            </intent-filter>            <meta-data                android:name="android.hardware.usb.action.USB_ACCESSORY_ATTACHED"                android:resource="@xml/accessory_filter" />        </activity>    </application></manifest>

これでアプリ側は完了。

2. アクセサリ側

アプリ側で定義したオレオレプロトコルに沿って LED 用のデジタル出力ピンのレベルの HIGH/LOW を切り替えるだけ。

#include <Wire.h>#include <Max3421e.h>#include <Usb.h>#include <AndroidAccessory.h>#define  LED       24AndroidAccessory acc("uPhyca",       "HelloADK",       "DemoKit Arduino Board",       "1.0",       "http://www.android.com",       "0000000012345678");void setup();void loop();void init_leds(){    // 24 の DIGITAL を LED 用の出力にする    pinMode(LED, OUTPUT);}void setup(){    Serial.begin(115200);    Serial.print("\r\nStart");    init_leds();    acc.powerOn();}void loop(){    byte msg[2];    byte led;    if (acc.isConnected()) {        int len = acc.read(msg, sizeof(msg), 1);        if (len > 0) {            if (msg[0] == 0x1) {                if(msg[1] == 0x1) {                    digitalWrite(LED, HIGH);                    msg[0] = 0x1;                    msg[1] = 0x1;                    acc.write(msg, 2);                }                else {                    digitalWrite(LED, LOW);                    msg[0] = 0x1;                    msg[1] = 0x2;                    acc.write(msg, 2);                }            }        }    }     else {        digitalWrite(LED, LOW);    }    delay(10);}

DIGITAL の 24 を LED のアノードにつないで、カソードを抵抗につないで、抵抗を GND につないでと。

最初に接続を許可するか聞かれるので OK する。

トグルボタンで LED の ON /OFF できたー。

GitHub にもおいといたよ！
yanzm/HelloADK - GitHub - http://goo.gl/bhG1t

Android　DialogFragmentを使うときの注意点。

2011-12-04T22:43:00.001+09:00

4日目〜。

---

DialogFragment で表示される Dialog を指定するための主なメソッドは次の2つ。 onCreateView() と onCreateDialog()。

Dialog のテーマと ContentView の中身だけ指定すればいい場合は onCreateView() の方だけを Override すればいいのですが、例えば OK と Cancel のある AlertDialog を作ろうとしたときは onCreateDialog() を Override して、表示したい AlertDialog のインスタンスを返すようにします。

このときに、onCreateView() で null 以外を返していると落ちます。

public class MainActivity extends Activity {    @Override    public void onCreate(Bundle savedInstanceState) {        super.onCreate(savedInstanceState);        FragmentManager manager = getFragmentManager();        MainFragmentDialog dialog = new MainFragmentDialog();        dialog.show(manager, "dialog");    }    public class MainFragmentDialog extends DialogFragment {        @Override        public View onCreateView(LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState) {            return inflater.inflate(R.layout.main, null, false);        }                @Override        public Dialog onCreateDialog(Bundle savedInstanceState) {            AlertDialog.Builder builder = new AlertDialog.Builder(getActivity());            builder.setTitle("タイトル");            builder.setPositiveButton("OK", null);            builder.setNegativeButton("Cancel", null);            return builder.create();        }    }}

12-04 22:51:37.099: E/AndroidRuntime(586): Caused by: android.util.AndroidRuntimeException: requestFeature() must be called before adding content

onCreateView() を Override せずに、onCreateDialog() で返す AlertDialog に対して setView() するのはOK

public class MainActivity extends Activity {    @Override    public void onCreate(Bundle savedInstanceState) {        super.onCreate(savedInstanceState);        FragmentManager manager = getFragmentManager();        MainFragmentDialog dialog = new MainFragmentDialog();        dialog.show(manager, "dialog");    }    public class MainFragmentDialog extends DialogFragment {        @Override        public Dialog onCreateDialog(Bundle savedInstanceState) {            LayoutInflater inflater = getActivity().getLayoutInflater();            View view = inflater.inflate(R.layout.main, null, false);            AlertDialog.Builder builder = new AlertDialog.Builder(getActivity());            builder.setTitle("タイトル");            builder.setPositiveButton("OK", null);            builder.setNegativeButton("Cancel", null);            builder.setView(view);            return builder.create();        }    }}

これは落ちない。

onCreateDialog() を Override しないとほんとに単純なダイアログしかだせないよねー。。。

Android　4.0 で TextView のレイアウトが変わる？

2011-12-03T22:05:00.001+09:00

3日目〜

---

TextView を継承したオリジナル CheckedTextView を作って使っているのですが、
コードは全く変えてないのにプレビューレベルで 3.2 以前と 4.0 で
それのレイアウトが変わってしまうのです。。。

これは注意ポイントかも。

うーん。。。
まだ解決法わかってないので、調査結果はあしたにでも！

第3回名古屋android勉強会 Fragment基礎講座/ハンズオンを行ったよ。

2011-12-02T18:28:00.001+09:00

さぁ、２日目です。
いつまで続けられるかな。

---

11月19日に名古屋で行った Fragment のハンズオンの資料を載せました。
タイポとかなおってる。。。はず！

Android　AlertDialog の背景を変更する for 4.x

2011-12-01T18:34:00.001+09:00

どうも、お久しぶりです。
あんざいゆきです。
世の中の Advent Calendar 祭りに乗り遅れたので、一人 Advent Calendar やることにしました。

---

前に Android　AlertDialog の背景を変更するというエントリを書いたのですが、どうも 3.0 以降だとこのハックがうまくいかないという報告があり確かめてみました。

このエントリの通りにやると

や

のようなダイアログになるはずなのですが、悲しいかな、Android 4.0 のエミュレータで実行したら、こんな感じになってしまいました。

orz

外枠はでてるけど、AlertDialog の内部の色が変わってないので、android:alertDialogStyle が効かなくなってるっぽいです。

AlertDialog の内側の属性値の android:topBright などを参照しているのは AlertController です。
この AlertController に android:topBright などが設定されたテーマを渡さなければいけないのですが、このテーマを渡すためのメソッドである AlertController#AlertParams() が呼ばれているのが AlertDialog.Builder 内の以下の部分だけなのです。

Android 4.0

    358         public Builder(Context context) {    359             this(context, resolveDialogTheme(context, 0));    360         }    373         public Builder(Context context, int theme) {    374             P = new AlertController.AlertParams(new ContextThemeWrapper(    375                     context, resolveDialogTheme(context, theme)));    376             mTheme = theme;    377         }

つまり、AlertDialog.Builder(context)　ではなく、AlertDialog.Builder(context, theme) で android:alertDialogStyle が定義されているテーマを渡さなければなりません。なぜなら、Builder(context) の方では、resolveDialogTheme() という内部メソッドに対して第２引数に 0、つまり android:alertDialogStyle が定義されていないものを渡しているからです。

一方、Android 2.3 では第２引数にテーマを渡せるコンストラクタが AlertDialog.Builder にありません。

Android 2.3

    272         public Builder(Context context) {    273             P = new AlertController.AlertParams(context);    274         }

しかし、AlertParams() には Builder の引数の Context をそのまま渡しているため、アプリのテーマとして設定されているものが AlertController にわたり、アプリのテーマとして android:alertDialogStyle を指定しておけば反映されるという状態でした。

で、結論としては、こうすればOKです。

    // 独自ダイアログをつかってテーマを指定    public void showMyDialog(View v) {        MyAlertDialog myDialog = new MyAlertDialog(this, R.style.MyDialog);        myDialog.setTitle("dialog");        myDialog.setMessage("test!");        myDialog.setButton("OK", (OnClickListener) null);        myDialog.show();    }

↑これは上記のエントリと同じ

<?xml version="1.0" encoding="utf-8"?><resources>    ...    <style name="MyDialog" parent="@android:style/Theme.Dialog">        <item name="android:windowBackground">@drawable/rect</item>        <item name="android:buttonStyle">@style/CustomButton</item>        <item name="android:alertDialogStyle">@style/AlertDialog</item>    </style>    ...</resources>

この MyDialog の方にも @style/AlertDialog をいれます！
前はアプリケーション、もしくはアクティビティのテーマに設定していましたが、ダイアログのテーマとして指定する方にも入れると Android 4.0 でも適用されます！

ちなみに、Android 4.0 から Theme の style item の android:alertDialogTheme が追加されていました。
なので、上記のエントリで AlertDialog を継承した独自 Dialog クラスを作成していますが、これをせずに

<?xml version="1.0" encoding="utf-8"?><resources>    <style name="MyTheme" parent="@android:style/Theme.Black">        <item name="android:alertDialogStyle">@style/AlertDialog</item>        <item name="android:alertDialogTheme">@style/MyDialog</item>    </style>    ...    <style name="MyDialog" parent="@android:style/Theme.Dialog">        <item name="android:windowBackground">@drawable/rect</item>        <item name="android:buttonStyle">@style/CustomButton</item>    </style>    ...</resources>

のようにすれば外枠やボタンを反映できるようになりました。

Bootcamp 2011 に行ってきました。

2011-10-31T16:26:00.000+09:00

Bootcamp 2011 Japan

今年は去年と違って、土曜日開催（去年は平日） & Google Japan の六本木オフィスで行えたこともあって、たくさんの参加者に来ていただけました。よかった、よかった。

ハッシュタグは #bc2011jp です。

@Fumi さんが Togetter にまとめてくれました。
GTUG Bootcamp 2011 #bc2011jp - Togetter -

Barエリアで松尾さんに App Engine について熱く語ると App Engine Tシャツがもらえましたー。

セッションの資料、後でチェックしなきゃ。

■ セッション：「Fragment を使ってみよう」（あんざいゆき）
資料

■セッション：「Google SketchUp　モデリングの初歩」 = 初めてでも簡単、3次元の世界 =
（田中雅子、株式会社アルファコックス　CTO）

■セッション：「はじめての Chrome Extension」（吉川徹）
資料

■セッション：「App Engine 倹約のすゝめ」（小川信一）

■ハンズオン：「新聞風の1ページを作ってみよう！」（一條美和子）
資料

■ハンズオン：Google Apps Script （中村敦）
資料1 資料2 資料3

■ハンズオン：「Spike WebView & Tough ICS」（江川　崇）
資料

■ハンズオン：Google+ API の体験と Hangouts の紹介（田中洋一郎、伊藤千光、中嶋信博）
資料参考ブログ

Android 4.0 Platform

2011-10-22T16:29:00.000+09:00

Android 4.0 Platformを意訳しました。訳が正しくない可能性もあります。正確な内容を理解するには原文を参照してください。

---
API Level: 14

Android 4.0 へようこそ！

Android 4.0 はユーザーと開発者むけの新しい機能を追加したメジャープラットフォームリリースです。以下で議論される新しい機能と API に加え、Android 3.x からの API セットと Holographic テーマを小さい画面向けにも拡張した Android 4.0 は重要なプラットフォームリリースです。つまり、アプリ開発者として、Android 4.0 (API Level 14) 以上で動作するハンドセット、タブレット、その他デバイスにおいて、それぞれに最適化されたユーザー体験を提供する単一の APK を開発し公開するための、1つのプラットフォームと単一の API フレームワークを手に入れたということです。

開発者は Android SDK のコンポーネントとして Android 4.0 platform をダウンロードできるようになりました。Android emulator を使って Android 4.0 でのアプリケーションの開発やテストを行うことができます。このプラットフォームには Android library と system image, emulator skin などが含まれていますが、外部のライブラリは含まれていません。

Android 4.0 向けの開発とテストを始めるには、Android SDK Manager を使って自分の SDK にプラットフォームをダウンロードします。より詳しい情報は Adding SDK Components を見てください。Android が初めての人は、まず download the SDK Starter Package から始めてください。

リマインダー: すでに Android application を公開している場合、できるだけ早く Android 4.0 上であなたのアプリケーションのテストと最適化をしてください。最新の Android-powered デバイスでベストな体験を提供していることを確認するべきです。

---

API Overview

■ Social APIs in Contacts Provider

ContactsContract provider によって定義されるコンタクトAPI が新しいソーシャル向け機能をサポートするように拡張されました。例えば、デバイス所有者のパーソナルプロフィールや、デバイスにインストールされているソーシャルネットワークへ個々のコンタクトを招待する機能などです。

User Profile

ContactsContract.Profile table で定義される、デバイス所有者を表すパーソナルプロフィールを持つようになりました。ユーザーのアイデンティティを管理するソーシャルアプリは ContactsContract.Profile 内に新しい ContactsContract.RawContacts エントリを作成することでユーザーのプロフィールデータを提供することができます。つまり、デバイスユーザーを表す raw contacts は、ContactsContract.RawContacts Uri によって定義されていたこれまでの raw contacts table には属さないということです。代わりに CONTENT_RAW_CONTACTS_URI にあるテーブルにプロフィール用の raw contact を追加しなければなりません。このテーブルの raw contact は、"Me" というラベルの1ユーザーのプロフィールとして集約されます。

プロフィール用の raw contact を追加するには WRITE_PROFILE パーミッションが必要です。同様に、プロフィールテーブルを読むには READ_PROFILE パーミッションが必要です。プロフィールへデータを提供するときであっても、ほとんどのアプリはプロフィールを読むべきではありません。ユーザーのプロフィールを読むことはセンシティブなパーミッションです。ユーザーがこのパーミッションを要求するアプリに対して懐疑的になると予想すべきでしょう。

Invite Intent

INVITE_CONTACT intent のアクションは、あるアプリに対して、ユーザーがソーシャルネットワークにコンタクトを追加したいことを示すアクションの呼び出しを許可します。このアクションを行うアプリとして選ばれたアプリは、ソーシャルネットワークに指定されたコンタクトを招待します。ほとんどのアプリはこの操作の受け手側になるでしょう。例えば、ビルトインの People アプリは、コンタクト詳細にリストされた特定のソーシャルアプリに対して、ユーザーが "Add connection" を選択したときにこのインテントを呼び出します。

あなたのアプリを "Add connection" リスト内に表示されるようにするには、ソーシャルネットワークからのコンタクト情報をシンクさせるための sync adapter を、あなたのアプリで提供しなければなりません。さらに、システムに対してあなたのアプリが INVITE_CONTACT intent に応答することを示さなければなりません。そのためには、あなたのアプリの sync configuration file に inviteContactActivity 属性を追加する必要があります。inviteContactActivity 属性には、システムが invite intent を送ったときに起動するための完全修飾の Activity 名も記述します。起動された Activity は intent のデータから指定された contact の URI を取得することができるので、ネットワークにコンタクトを招待したり、ユーザーのコネクションに人を追加するなど必要な処理を行えます。

例として Sample Sync Adapter アプリを見てください（特に、contacts.xml ファイルを見てください）。

Large photos

コンタクト用の高解像度写真をサポートするようになりました。contact record に写真を入れたとき、システムは 96x96 のサムネイル（これまでと同じ）と、新しいファイルベースの写真ストアに保存される 256x256 の "display photo" を生成します（システムが選択する実際のサイズは将来変わる可能性があります）。大きい写真を通常の PHOTO カラムに入れると、システムが適切なサムネイルを生成し、photo record に表示するので、コンタクトに大きい写真を追加できます。

Contact Usage Feedback

新しい ContactsContract.DataUsageFeedback API によって、人にコンタクトするための特定の方法がどの程度使用されたかをトラックすることができます。例えば、ユーザーがどのくらい頻繁に各電話番号やメールアドレスを使用したかなど。この情報は、各人に関連するコンタクトメソッドのランキング付けを改善し、コンタクトのより良い提案を行う助けになります。

■Calendar Provider

新しい Calendar API によって、カレンダー、イベント、参加者、リマインダー、アラートなどの Calendar Provider に保存されるデータを読み込み、追加、編集、削除することができます。

さまざまなアプリやウィジェットがこれらの API をつかってカレンダーのイベントを読んだり編集したりできます。しかし、最も魅力的なユースケースは sync adapter です。これにより、Calendar Provider を使って他のカレンダーサービスのユーザーカレンダーを同期することができ、ユーザーの全てのイベントを表示できる1つの場所を提供できます。Google Calendar のイベントは、Google Calendar Sync Adapter による Calendar Provider で同期され、 Android のビルトインカレンダーアプリに各イベントが表示されることを許可します。

カレンダーのデータモデルと、Calendar Provider 内のイベントに関連した情報は CalendarContract によって定義されます。ユーザーの全てのカレンダーデータは CalendarContract のいくつかのサブクラスで定義される複数のテーブルに保存されます。

CalendarContract.Calendars テーブルはカレンダー特有の情報を保持します。テーブルの各ローは1つのカレンダーの名前、色、同期情報などの詳細を含みます。
CalendarContract.Events テーブルはイベント特有の情報を保持します。テーブルの各ローは1つのイベントのタイトル、場所、開始時刻、終了時刻などの情報を含みます。イベントは1度だけ発生させることも、複数回繰り返し発生させることもできます。参加者、リマインダー、その他拡張可能なプロパティは別のテーブルに保存され、イベントの _ID がそれらとイベントのリンクに利用されます。
CalendarContract.Instances テーブルは1つのイベントの発生ごとの開始時刻と終了時刻を保持します。テーブルの各ローは1つの発生イベントを表します。１度だけのイベントではインスタンスとイベントは1対1でマッピングされます。繰り返し起こるイベントでは、そのイベントの複数の発生イベントに対する複数のローが自動的に生成されます。
CalendarContract.Attendees テーブルはイベントの参加者やゲストの情報を保持します。各ローは1つのイベントの1人のゲストを表します。その人のゲストタイプとイベントでの役割を指定します。
CalendarContract.Reminders テーブルはアラート／通知のデータを保持します。各ローはイベントに対する1つのアラートを表します。1つのイベントは複数のリマインダーを持つことができます。1イベントあたりのリマインダー数は与えられたカレンダーの sync adapter によってセットされる MAX_REMINDERS によって指定されます。リマインダーには、イベントのスケジュールされている時刻から何分前かと、ユーザーに通知するための方法（アラーム、メール、SMSなど）が指定されています。
CalendarContract.ExtendedProperties テーブルは sync adapter によって利用される不透明なデータフィールドを保持します。provider はこのテーブルのアイテムに対して、関連するイベントが削除されたときにアイテムを削除する以外はアクションを起こしません。

Calendar Provider を使ってユーザーのカレンダーデータにアクセスするには READ_CALENDAR パーミッション（読み出しアクセス用）や WRITE_CALENDAR（書き込みアクセス用）が必要です。

Event intent

行いたいことがユーザーのカレンダーにイベントを追加することだけなら、"vnd.android.cursor.item/event" MIME type の ACTION_INSERT intent を使って実現することができます。この intent を呼び出すと、カレンダーアプリの新しいイベントを作成する Activity が起動します。この intent を使う場合はパーミッションは必要ありません。intent の以下の extras でイベントの詳細を指定することができます。

Events.TITLE : イベントの名前
CalendarContract.EXTRA_EVENT_BEGIN_TIME : イベントの開始時刻（epoch からのミリ秒単位）
CalendarContract.EXTRA_EVENT_END_TIME : イベントの終了時刻（epoch からのミリ秒単位）
Events.EVENT_LOCATION : イベントの場所
Events.DESCRIPTION : イベント内容
Intents.EXTRA_EMAIL : 招待するメールアドレス
Events.RRULE : イベントの繰り返し設定
Events.ACCESS_LEVEL : イベントがプライベートかパブリックか
Events.AVAILABILITY : このイベントの期間中に他のイベントが同じ時間にスケジュールされるのを許可するかどうか

■ Voicemail Provider

新しい Voicemail Provider によって、ユーザーの全ての voicemail を1カ所で表示するために、デバイスに voicemail を追加することができるようになりました。例えば、電話のサービスプロバイダーからの voicemail, VoIP からの voicemail, その他代わりの音声サービスからの voicemail など、ユーザーが複数の voicemail ソースを持つことができます。これらのアプリは Voicemail Provider API を使って彼らの voicemail をデバイスに追加することができます。そして、ビルトインの Phone アプリではユーザーに全ての voicemail を一カ所にまとめて表示します。システムの Phone アプリだけが全ての voicemail を読むことができますが、voicemail を提供している各アプリは、システムに追加された彼らの voicemail を読むことはできます（ただし、他のサービスが追加した voicemail を読むことはできません）。

現状では、API でサードパーティのアプリがシステムから全ての voicemail を読むことを許可していないので、サードパーティアプリが voicemail API を使ってすべきことはユーザーに届ける voicemail を持つことです。

VoicemailContract クラスは Voicemail Provider の content provider を定義します。サブクラスの VoicemailContract.Voicemails と VoicemailContract.Status は、デバイスのストレージに voicemail データを追加できるアプリを表すテーブルを提供します。voicemail provider アプリの例として Voicemail Provider Demo を見てください。

■ Multimedia

Android 4.0 では写真、ビデオ、音楽などのメディアとやりとりするアプリ向けの新しい API が追加されました。

Media Effects

新しい media effect フレームワークによって、様々なビジュアルエフェクトを画像やビデオにつけることができるようになりました。例えば、画像エフェクトでは簡単に赤目を直したり、画像をグレイスケール（モノクロ）に変換したり、明るさを調整したり、彩度を調整したり、画像を回転させたり、魚眼効果をつけたり、などができます。システムは全てのエフェクト処理を最大のパフォーマンスを得るために GPU 上で行います。

パフォーマンスの最大化のために、エフェクトは OpenGL テクスチャへ直接適用されます。そのため、あなたのアプリケーションではエフェクト API を使用する前に、適切な OpenGL コンテキストを持つ必要があります。エフェクトが適用されるテクスチャはビットマップやビデオやカメラからのものだと思いますが、これらのテクスチャには一定の制約があります。

1. GL_TEXTURE_2D テクスチャ画像にバウンドされていなければならない
2. 少なくとも1つの mipmap レベルを含んでいなければならない

1つの Effect オブジェクトは、画像フレームに適用できる 1つの media effect を定義します。
1つの Effect を作成するワークフローは

1. EffectContext.createWithCurrentGlContext() をあなたの OpenGL ES 2.0 コンテキストから呼び出す
2. 返ってきた EffectContext を使って EffectContext.getFactory() を呼び出し、返ってくる EffectFactory のインスタンスを取得する
3. createEffect() を呼び出し、EFFECT_FISHEYE や EFFECT_VIGNETTE など EffectFactory で定義されているエフェクト名を渡す

パラメータ名とパラメータ値を指定して setParameter() を呼ぶことでエフェクトのパラメータを調整することができます。各エフェクトタイプによって設定できるパラメータは異なります。どのパラメータを指定できるかはエフェクト名と一緒にドキュメントに記述されています。例えば EFFECT_FISHEYE は歪みの scale を設定するパラメータを持っています。

テクスチャにエフェクトを適用するには Effect 上で apply() を呼び、入力テクスチャ、それの横幅と縦幅、出力テクスチャを渡します。入力テクスチャは GL_TEXTURE_2D テクスチャにバウンドされていなければなりません（通常は glTexImage2D() 関数を呼ぶことで行えます）。複数の mipmap レベルを提供することができます。出力テクスチャがテクスチャイメージにまだバウンドされていない場合は、自動的にエフェクトによって mipmap レベルが1つ (0) の GL_TEXTURE_2D としてバウンドされ、入力と同じサイズになります。

EffectFactory にリストされた全てのエフェクトはサポートが保証されています。しかし、外部ライブラリから利用可能な付加的エフェクトは全てのデバイスがサポートしているとは限りません。そのため、使いたいエフェクトが外部ライブラリからのものの場合、最初に isEffectSupported() を呼んでデバイスがサポートしているかチェックしなければなりません。

Remote control client

新しい RemoteControlClient によって、デバイスロックスクリーンなどのリモートコントロールクライアントからメディアプレイヤーの再生をコントロールすることができるようになります。また、メディアプレイヤーは現在再生中の曲のトラック情報やアルバムアートなどをリモートコントロール上に表示することもできるようになります。

あなたのメディアプレイヤーでリモートコントロールクライアントを有効にするには、RemoteControlClient のコンストラクタに ACTION_MEDIA_BUTTON をブロードキャストする PendingIntent を渡してインスタンスを生成します。さらに、インテントは ACTION_MEDIA_BUTTON イベントを処理するあなたのアプリ内の BroadcastReceiver コンポーネントを明示的に宣言しなければなりません。

どのメディアコントロール入力がプレイヤーで処理できるかを宣言するには setTransportControlFlags() を RemoteControlClient 上で呼びます。そのさい、FLAG_KEY_MEDIA_PREVIOUS や FLAG_KEY_MEDIA_NEXT などの FLAG_KEY_MEDIA_* 形式のフラグを渡します。

そうしたら、RemoteControlClient を MediaManager.registerRemoteControlClient() に渡して登録する必要があります。一度登録したら、RemoteControlClient のインスタンスを生成するときに渡した BroadcastReceiver がリモートコントロール上のボタンが押されたときに ACTION_MEDIA_BUTTON イベントを受け取ります。受け取る intent には KeyEvent が含まれており、getParcelableExtra(Intent.EXTRA_KEY_EVENT) でどのメディアキーが押されたかを取得することができます。

再生中のメディアの情報をリモートコントロール上に表示するには、editMetaData() を呼び出して、返ってきた RemoteControlClient.MetadataEditor にメタデータを追加します。メディアのアートワーク用のビットマップや、経過時間などの数値情報、トラックタイトル等のテキスト情報を提供することができます。利用可能なキーの情報は MediaMetadataRetriever 内の METADATA_KEY_* 形式のフラグを見てください。

サンプル実装として、Random Music Player をみてください。このサンプルでは、Android 4.0 でリモートコントロールクライアントを有効にする互換性ロジックを提供しており、Android 2.1 以上のデバイスで引き続きサポートするようになっています。

Media player

MediaPlayer からオンラインメディアストリーミングでは INTERNET パーミッションが必要になりました。MediaPlayer をインターネット上のコンテンツを再生するのに使う場合は、INTERNET パーミッションがマニフェストに追加されていることを確認してください。そうしないと Android 4.0 からメディアの再生処理が動かなくなります。
setSurface() で video sink として振る舞う Surface を定義できます。
setDataSource() で HTTP(S) live streaming を便利にする付加的な HTTP ヘッダをリクエストに追加できます。
HTTP(S) live streaming はリクエスト全体に渡って HTTP cookies に関連します。

Media tyes

Android 4.0 で以下のサポートが追加されました。

HTTP/HTTPS live streaming protocol version 3
ADTS raw AAC audio encoding
WEBP images
Matroska video

より詳しい情報は Supported Media Formats を見てください。

■ Camera

Camera クラスに顔検出と、フォーカスと測定エリアのコントロールをする新しい API が追加されました。

Face detection

Camera アプリは Android の顔検出 API を使った機能をより高くすることができます。これまでは単に顔の位置を検出するだけでしたが、目や口の位置など顔の特徴も検出できるようになりました。

カメラアプリで顔を検出するには、まず setFaceDetectionListener() を呼んで Camera.FaceDetectionListener を登録する必要があります。そうしたら、camera surface を開始して、 startFaceDetection() を呼ぶことで顔検出をスタートさせることができます。

カメラがカメラシーン内に1つ以上の顔を検出すると、Camera.FaceDetectionListener 内の onFaceDetection() コールバックが呼ばれます。このとき、Camera.Face オブジェクトの配列が渡されます。

Camera.Face クラスのインスタンスは顔検出についての複数の情報を含みます：

顔の領域を表す Rect 。カメラの現在の view フィールドからの相対値
その物体が人間の顔であるとシステムが認識した信頼度をあらわす 1 - 100 までの整数値
複数の顔をトラックするのに利用できる識別ID
目や口の位置を表すいくつかの Point オブジェクト

注意: 顔検出はいくつかのデバイスでサポートされていない可能性があります。そのため、まず getMaxNumDetectedFaces() を呼んで、戻り値が 0 より大きいことをチェックしてください。また、いくつかのデバイスでは目や口の識別をサポートしていないことがありえます。その場合、Camera.Face オブジェクトには null が入ります。

Focus and metering areas

カメラアプリで、カメラがフォーカスやホワイトバランスや露光の測定に使う領域をコントロールできるようになりました。両方の機能とも新しい Camera.Area クラスを使って、フォーカスや測定される現在のビューの領域を指定します。1つの Camera.Area には領域を表す Rect と、その領域が他の領域と比べてどれだけ重要かを表すレベル（整数値）が含まれます。

フォーカス領域と測定領域を設定する前に、まず getMaxNumFocusAreas() や getMaxNumMeteringAreas() を呼んで、デバイスがそれぞれの昨日をサポートしているかチェックしてください。戻り値が 0 より大きければサポートされています。

使用されるフォーカス領域や測定領域を設定するには、 setFocusArea() や setMeteringArea() を呼びます。そのとき、フォーカスや測定として考慮する情報を含んだ Camera.Area オブジェクトのリストをそれぞれに渡します。例えば、プレビューでユーザーがタッチした領域にフォーカスするような機能を実装する場合、タッチされた領域を Camera.Area オブジェクトに変換して、その領域をフォーカス領域としてセットします。その領域のシーンが変わっても、その領域のフォーカスと露光は継続的にアップデートされます。

Continuous auto focus for photos

写真を撮るときに連続して自動フォーカス (confinuous auto focusing : CAF) させることができるようになりました。あなたのカメラアプリで CAF を有効にするには、setFocusMode() に FOCUS_MODE_CONTINUOUS_PICTURE を渡します。写真をとる準備ができたら、autoFocus() を呼びます。あなたの Camera.AutoFocusCallback はフォースできたかどうかを表すコールバックを直ちに受け取ります。コールバックを受け取ったあとに CAF を再開するには、cancelAutoFocus() を呼ぶ必要があります。

注意: 連続自動フォーカス(CAF) はビデオ撮影時もサポートしています。その場合は API level 9 で追加された FOCUS_MODE_CONTINUOUS_VIDEO を指定します。

Other camera features

ビデオを撮影している間、takePicture() を呼ぶことでビデオセッションを中断せずに写真を撮ることができます。これを行う前に、isVideoSnapshotSupported() を呼んで、ハードウェアがサポートしているかどうか確かめるべきです。
自動的に露光とホワイトバランスのプロパティが変化するのを防ぐために、setAutoExposureLock() や setAutoWhiteBalanceLock() を呼んでこれらの値をロックすることができるようになりました。
setDisplayOrientation() をプレビューが走っている間も呼べるようになりました。これまではプレビューが始まる前しか呼ぶことができなかったのですが、いつでも向きを変えられるようになりました。

Camera broadcast intents

Camera.ACTION_NEW_PICTURE: ユーザーが新しく写真を撮影したことを示すインテントです。ビルトインのカメラアプリは写真が撮られたあとにこのブロードキャストを投げます。サードパーティのカメラアプリも写真を撮ったあとはこのインテントをブロードキャストするべきです。
Camera.ACTION_NEW_VIDEO : ユーザーが新しくビデオを撮影したことを示すインテントです。ビルトインのカメラアプリはビデオが録画されたあとにこのブロードキャストを投げます。サードパーティのカメラアプリもビデオを撮影したあとはこのインテントをブロードキャストするべきです。

■ Android Beam (NDEF Push with NFC)

Android Beam は "NDEF Push" として知られているプロセスを使って、NDEF message をあるデバイスから別のデバイス送る、新しい NFC 機能です。Android Beam をサポートしている2台の Android デバイスがかなり近づく（4cm くらい、通常は背面同士をタッチする）と、データ転送が初期化されます。NDEF message 内にはデバイス間で共有したいさまざまなデータを入れることができます。例えば、Android Beam を使って、People アプリはコンタクトを共有しますし、YouTube アプリは動画を共有し、ブラウザアプリは URL を共有します。

Android Beam を使ってデバイス間でデータを転送するには、Activity が foreground にある間に、共有したい情報を持った NdefMessage を作成する必要があります。それから、以下の2つの内、いずれかの方法を使ってシステムに NdefMessage を渡します。

activity 中に渡すための 1つの NdefMessage を定義する:
setNdefPushMessage() を呼んで、いつでも送りたいメッセージをセットできます。例えば、Activity の onCreate() 中にこのメソッドを呼びだして NdefMessage を渡すとしましょう。そうすると、Activity が foreground にあって Android Beam が別の端末との間で動いているときはいつでもシステムは NdefMessage を他のデバイスに送ります。
Android Beam が初期化されたタイミングで渡すための NdefMessage を定義する:
NfcAdapter.CreateNdefMessageCallback を実装し、その実装内の createNdefMessage() メソッドで送りたい NdefMessage を返すようにします。そして、NdefAdapter.CreateNdefMessageCallback 実装を setNdefPushMessageCallback() に渡します。
この場合、Activity が foreground にあるときに、Android Beam が他のデバイスとの間で動くようになったときに、システムが createNdefMessage() を呼んで送りたい NdefMessage を取得します。これは、Android Beam が初期化されたとき”のみ” NdefMessage を定義することを許可します。そのため、Activity のライフサイクル全体でメッセージの内容が変わることがあります。

システムが他のデバイスへの NDEF message の送信に成功したときに特定のコードを1度だけ実行したこともあるでしょう。そのときは、NdefAdapter.OnNdefPushCompleteCallback を実装し、setNdefPushCompleteCallback() でその実装を渡すことでできます。システムはメッセージが配送されたときに onNdefPushComplete() を呼び出します。

受信側のデバイスでは、システムは NDEF Push メッセージを通常の NFC タグと同じ方法で処理します。システムは Activity を開始するために、NdefMessage 内の最初の NdefRecord の URL もしくは MIME type がセットされた ACTION_NDEF_DISCOVERED のインテントを投げます。応答したい Activity の intent filter にその URL や MIME type を設定して処理したいものにだけ反応することができます。Tag Dispatch のより詳しい情報は NFC developer guide を見てください。

もし、NdefMessage で URI を運びたいなら、そのための便利な createUri メソッドを使って、1つの文字列もしくは1つの Uri オブジェクトから NdefRecound を作成することができます。URI が Android Beam イベント中にあなたのアプリが受信したい特別なフォーマットであるならば、渡された NDEF message を受け取るために、同じ URI scheme を使って Activity に intent filter をセットしてください。

また、別のアプリが同じ intent action の filter を設定していても、渡された NDEF message をあなたのアプリが確実に処理することを保証するために、渡す NdefMessage に "Android application record" も含めてください。アプリのパッケージ名を渡して createApplicationRecord() を呼ぶことで Android application record を作成することができます。他のデバイスが application record の入った NDEF message を受信して、その intent を処理できる activity を含むアプリが複数あった場合、システムは常にそのメッセージを application record との一致によってあなたのアプリの activity に渡します。ターゲットデバイスにあなたのアプリがインストールされていない場合は、Android application record を使ってシステムは Android Market を起動し、そのアプリをインストールできるようユーザーを導きます。

NDEF Push でメッセージ送る NFC API をあなたのアプリが使っていない場合、Android は通常の振る舞いを提供します。あなたのアプリがデバイス foreground にあって、Android Beam が他の Android デバイスから呼ばれたら、一方のデバイスはあなたのアプリを識別する Android application record を含んだ NDEF message を受け取ります。受け取ったデバイスにそのアプリがインストールされていたら、システムはそれを起動し、インストールされていなかったら、Android Market を開いて、アプリをインストールできるようにユーザーを導きます。

NFC Basics developer guide で Android Beam と NFC 機能についてより詳しく読むことができます。Android Beam を使ったサンプルコードは Android Beam Demo を見てください。

■ Wi-Fi Direct

hotspot やインターネット接続なに Android デバイス間や他のタイプのデバイスと peer-to-peer (P2P) 接続するための Wi-Fi Direct をサポートするようになりました。Android フレームワークは Wi-Fi P2P API のセットを提供します。これを使うことで、Wi-Fi Direct をサポートしているデバイスを見つけて接続し、Bluetooth 接続よりも長い距離で速い通信ができます。

新しい android.net.wifi.p2p パッケージには Wi-Fi で peer-to-peer 接続を行うための全ての API が含まれています。もっとも重要なクラスは WifiP2pManager です。 getSystemService(WIFI_P2P_SERVICE) を呼ぶことで取得することができます。WifiP2pManager に含まれる API では以下のことができます:

initialize() を呼んで P2P 接続のための初期化を行う
descoverPeers() を呼んで近くのデバイスを見つける
connect() を呼んで P2P 接続を開始する
その他いろいろ

その他いくつかのインタフェースとクラスも同じく必要です:

WifiP2pManager.ActionListener インタフェースによって、デバイスの探索や接続の処理が成功または失敗したときにコールバックを受信できます。
WifiP2pManager.PeerListListener インタフェースによって、見つけた peers の情報を受け取ることができます。コールバックが提供する WifiP2pDeviceList から範囲内の各デバイスの WifiP2pDevice オブジェクトが取得でき、これにはデバイス名、アドレス、デバイスタイプ、デバイスがサポートするWPS設定などの情報が入っています。
WifiP2pManager.GroupInfoListener インタフェースによって、P2P グループの情報を受け取ることができます。コールバックが提供する WifiP2pGroup オブジェクトには、オーナー、ネットワーク名、パスフレーズなどのグループ情報がふくまれています。
WifiP2pManager.ConnectionInfoListener インタフェースによって、現在の接続についての情報を受け取ることができます。コールバックが提供する WifiP2pInfo オブジェクトには、グループが形成されたかどうかや、誰がグループのオーナーかなどの情報が含まれています。

Wi-Fi P2P API を使うには、次のユーザーパーミッションが必要です。

ACCESS_WIFI_STATE
CHANGE_WIFI_STATE
INTERNET (あなたのアプリが技術的にインターネットに接続しなくても、標準の java socket で Wi-Fi Direct peers を使って通信するにはインタネットのパーミッションが必要です）

Android システムは Wi-Fi P2P の特定のイベントごとに異なるアクションをブロードキャストします。

WIFI_P2P_CONNECTION_CHANGED_ACTION : P2P 接続の状態が変化した。EXTRA_WIFI_P2P_INFO に WifiP2pInfo オブジェクトが、EXTRA_NETWORK_INFO に NetworkInfo オブジェクトが含まれている。
WIFI_P2P_STATE_CHANGED_ACTION : P2P の有効／無効状態が切り替わった。EXTRA_WIFI_STATE には WIFI_P2P_STATE_DISABLED か WIFI_P2P_STATE_ENABLED が含まれている。
WIFI_P2P_PEERS_CHANGED_ACTION : peer デバイスのリストが変化した。
WIFI_P2P_THIS_DEVICE_CHANGED_ACTION : このデバイスの詳細が変化した。

より詳しい情報は WifiP2pManager ドキュメントを見てください。また、サンプルアプリは Wi-Fi Direct Demo です。

■ Bluetooth Health Devices

Bluetooth Health Profile デバイスをサポートするようになりました。これにより、心拍モニターや血液メーター、体温計、測定器などの医療デバイスと Bluetooth を使って通信するアプリを作成できます。

通常のヘッドセットや A2DP profile デバイスと同じように、getProfileProxy() に BluetoothProfile.ServiceListener と HEALTH profile タイプを渡して呼んで、profile proxy オブジェクトとの接続を確立します。

一度 Health Profile proxy (BluetoothHealth オブジェクト) を取得したら、次の新しい Bluetooth クラスを呼び出して、ペアの医療デバイスと接続や通信を行います。

BluetoothHealthCallback : このクラスを継承して、アプリの登録状態と Bluetooth channel 状態の変化のアップデート受け取るためのコールバックメソッドを実装する必要があります。
BluetoothHealthAppConfiguration : あなたの BluetoothHealthCallback へコールバックしている間、このオブジェクトのインスタンスを受け取ります。これには利用可能な Bluetooth 医療デバイスについての設定情報が含まれています。これらの情報は、 BluetoothHealth API で接続の初期化や終了などいくつかの操作を実行するのに必要です。

Bluetooth Health Profile のより詳しい情報は BluetoothHealth ドキュメントを見てください。

■ Accessibility

Android 4.0 では視覚的にハンディのあるユーザーの accessibility を改善しました。新しく explore-by-touch mode が追加され、view コンテンツについてより情報を提供したり、高度な accessibility サービスを開発するために API が拡張されました。

Explore-by-touch mode

画面上をタッチしたりドラックすることでコンテンツの説明する音声を聞くことができ、視覚のない人でも画面上のコンテンツを探すことができます。explore-by-touch mode は仮想的なカーソルとして動作し、d-pad や trackball の操作でスクリーンリーダーが説明文を見つけるのと同じ方法で、画面上での "hover" をシミュレートして音声案内する情報を見つけます。読まれる情報は android:contentDescription と setContentDescription() で提供されます。つまり、アプリの view に対して説明文を提供するよう心がけてください。特に ImageButton, EditText, ImageView など通常状態で説明文を含まないものは気をつけてください。

Accessibility for views

スクリーンリーダーのような accessibility サービスで利用できる情報を拡張するために、カスタム View コンポーネントで accessibility イベントで新しいコールバックメソッドを実装できます。

最初に知っておくべき重要なことは、Android 4.0 で sendAccessibilityEvent() メソッドの動作が変わったということです。以前の Android バージョンでは、ユーザーがデバイスの accessibility サービスを有効にして、クリックやホバーなどの入力イベントがおこると、対応する view の sendAccessibilityEvent() が呼ばれていました。以前は sendAccessibilityEvent() の実装は AccessibilityEvent を初期化し、AccessibilityManager に送っていました。新しい動作では、view や親 view がコンテキスト情報をイベントに追加できるようにするための追加されたコールバックメソッドが含まれます :

呼び出されたとき、sendAccessibilityEvent() と sendAccessibilityEventUnchecked() メソッドは http://developer.android.com/reference/android/view/View.html#onInitializeAccessibilityEvent(android.view.accessibility.AccessibilityEvent) へ持ち越されます。
View のカスタム実装として付加的な accessibility 情報を AccessibilityEvent につけるために onInitializeAccessibilityEvent() を実装したいでしょう。しかし、標準のコンテンツ内容やアイテムのインデックスなどデフォルト情報を提供するために親の実装も呼ぶべきです。このコールバックでは付加的なテキストコンテンツを追加するべきではありません。それは次で行います。
一度初期化され、イベントがテキスト情報を移すべきいくつかのタイプの1つだった場合、view は dispatchPopulateAccessibilityEvent() の呼び出しを受け取り、onPopulateAccessibilityEvent() コールバックに持ち越されます。
View のカスタム実装は、android:contentDescription テキストが見つからないもしくは十分でないなら、通常、 onPopulateAccessibilityEvent() を実装して追加する付加的なテキストコンテンツを AccessibilityEvent に追加してください。AccessibilityEvent にテキスト情報を追加するには getText().add() を呼びます。
この時点で View は requestSendAccessibilityEvent() を親 view 上で呼んで View 階層にイベントを渡します。イベントが最終的に root view に届くまでの間、各親 view は AccessibilityRecord を追加することで accessibility 情報を増やすチャンスがあります。イベントが root view に届くと、sendAccessibilityEvent() を使って AccessibilityManager にイベントを渡します。

View クラスを継承するときに便利な上記の新しいメソッドに加えて、AccessibilityDelegate を継承して view に setAccessibilityDelegate() を設定することで、任意の View のイベントコールバックに介入することもできます。こうした場合、view 内の各 accessibility メソッドは delegate 内の対応するメソッドに呼び出しを持ち越します。例えば、view が onPopulateAccessibilityEvent() の呼び出しを受けたとすると、それは View.AccessibilityDelegate 内の同じメソッドにも渡されます。delegate で処理されないメソッドはすぐにデフォルトの動作に戻ってきます。これにより、View クラスを継承せずに必要なメソッドだけを上書きできます。

新しい accessibility API をサポートしつつ、Android バージョン 4.0 以前との互換性を維持したい場合、後方互換性を持つようにデザインされた accessibility API を提供する最新バージョンの v4 support library (Compatibility Package, r4 に含まれる) のユーティリティクラスセットを使って実現できます。

Accessibility services

accessibility service を開発しているなら、いくつかの accessibility イベントについての情報は、ユーザーにより高度な accessibility フィードバックを可能にするために大幅に拡張されています。特に、イベントは View の物体に基づいて生成され、よりよいコンテキスト情報を提供し、accessibility service は付加的な view 情報の取得と特別なケースを扱うために view 階層をさかのぼることができます。もしあなたがスクリーンリーダーのような accessibility service を開発しているなら、次の手順で付加的なコンテンツ情報の追加と view 階層をさかのぼることができます。

アプリからAccessibilityEvent を受け取ったら、AccessibilityEvent.getRecord() を呼んで特定のAccessibilityRecord（1つのイベントにはいくつかの record が存在する可能性があります）を取得します。
AccessibilityEvent もしくは個々の AccessibilityRecord に対して getSource() を呼んで AccessibilityNodeInfo オブジェクトを取得することができます。
1つの AccessibilityNodeInfo は window コンテンツの1つのノードを表し、ノードの accessibility 情報を取得できます。AccessibilityEvent から返された AccessibilityNodeInfo オブジェクトはイベント元の情報を持ち、AccessibilityRecord から返された AccessibilityNodeInfo はイベント元の前の情報を持ちます。
AccessibilityNodeInfo で getParent() や getChild() を呼ぶことで view 階層をさかのぼるための情報を取得できます。また、ノードに子 view を追加することもできます。

あなたのアプリを accessibility service としてシステムに公開するには、AccessibilityServiceInfo に対応する XML 設定フィアルを宣言する必要があります。accessibility service を作るためのより詳しい情報は AccessibilityService と SERVICE_META_DATA を見てください。

Other accessibility APIs

デバイス accessibility 状態に興味があるなら、AccessibilityManager で以下のようないつくかの新しい API が使えます :

AccessibilityManager.AccessibilityStateChangeListener は accessibility が有効／無効になったときにコールバックを受け取るためのインタフェースです。
getEnabledAccessibilityServiceList() は現在有効になっている accessibility についての情報を提供します。
isTouchExplorationEnabled() は explore-by-touch mode が有効になっているかどうかを返します。

■ Spell Checker Services

新しい spell checker フレームワークによって、input method フレームワーク（IME用）と似た方法でスペルチェッカーをアプリで作ることができるようになりました。新しいスペルチェッカーを作るには、SpellCheckerService を継承したクラスを実装し、インタフェースのコールバックメソッドで提供される文字列に基づいてスペル候補を提供する SpellCheckerService.Session クラスを継承する必要があります。SpellCheckerService.Session コールバックメソッドでは、SuggestionsInfo オブジェクトとしてスペル候補を返します。

spell checker service を持つアプリは、このサービスによって必要とされる BIND_TEXT_SERVICE パーミッションを宣言しなければなりません。また、そのサービスの intent filter として <action android:name="android.service.textservice.SpellCheckerService" />を宣言し、<meta-data> エレメントでスペルチェッカーの設定情報を宣言する必要もあります。

サンプルコードはサンプルアプリの Spell Checker を見てください。

■ Text-to-speech Engines

Android の text-to-speech (TTS) API が大幅に拡張され、アプリがより簡単に custom TTS eingine を実装できるようになりました。TTS エンジンを使いたいアプリはエンジンを選択するためのいくつかの新しい API を使うことができます。

Using text-to-speech engines

Android の以前のバージョンでは、システムが提供する TTS engine や setEngineByPackageName() を使ってセットされた custom engine を利用して text-to-speech(TTS) 操作を行う TextToSpeech クラスを使うことができました。Android 4.0 では、setEngineByPackageName() メソッドは廃止され、TTS engine のパッケージ名を受け取る新しい TextToSpeech コンストラクタを使って engine を指定できるようになりました。

また、getEngines() で利用可能な TTS engines を検索することもできます。このメソッドは TextToSpeech.EngineInfo オブジェクトのリストを返します。このオブジェクトには engine のアイコン、ラベル、パッケージ名などのメタデータが含まれます。

Building text-to-speech engines

以前は、custom engine はドキュメント化されていない native header file を使ってビルドされている必要がありました。Android 4.0 では、TTS engine を作成するためのフレームワーク API のセットがそろっています。

ベースのセットアップとして、INTENT_ACTION_TTS_SERVICE intent に応答する TextToSpeechService の実装が必要です。TTS engine の一番重要な処理は TextToSpeechService を継承したサービス内の onSynthesizeText() 中に行います。システムはこのメソッドに次の2つのオブジェクトを渡します :

SynthesisRequest: 合成するテキスト、ロケール、話す速度、声の高さなどいくつかのデータを含む
SynthesisCallback: 話されたデータの結果を streaming audio として TTS engine が届けるためのインタフェース。最初に engine は start() を呼んで engine が audio を届ける準備ができていることを示す。それから、audioAvailable() を呼んで byte buffer の audio data を渡す。全ての audio を渡し終わったら done() を呼ぶ

フレームワークは TTS engine を作成するための（本当の） API をサポートし、native code をサポートするための実装は削除されました。compatibility layer についてのブログポストを見てください。古い TTS engine を新しいフレームワークに変換する方法がわかります。

新しい API を使った TTS engine の例は Text To Speech Engine サンプルアプリを見てください。

■ Network Usage

Android 4.0 では、アプリケーションが使っているネットワークデータがどのくらいあるのかを、ユーザーが正確なビジュアル（グラフとか）で見れるようになりました。ユーザーは設定アプリで、個々のアプリに対してネットワークデータ使用のリミットを設定できたり、バックグラウンドデータの使用を無効にすることもできます。ユーザーがアプリのデータへのアクセスを無効にするのを避けるために、効果的にデータ接続を使い、接続に依存した使用方法を調整する戦略を立てるべきです。

もしあなたのアプリが多くのネットワーク通信を行っているなら、ユーザーがアプリのデータ習慣（どのくらいの頻度でデータをシンクするのか、Wi-Fi のときだけアップロード／ダウンロードを行うかどうか、ローミング中にデータを使うかどうか、など）をコントロールするための設定を提供するべきです。これらのコントロールが利用可能であれば、データ通信がリミットに達して、ユーザーがあなたのアプリのデータへのアクセスを無効にすることはより少なくなるでしょう。これらの設定に preference activity を提供するのであれば、マニフェストで ACTION_MANAGE_NETWORK_USAGE action の intent filter を定義しておくべきです。例えば :

<activity android:name="DataPreferences" android:label="@string/title_preferences">    <intent-filter>       <action android:name="android.intent.action.MANAGE_NETWORK_USAGE" />       <category android:name="android.intent.category.DEFAULT" />    </intent-filter></activity>

この intent filter はシステムにこの activity はアプリケーションのデータ使用をコントロールするものだということを示します。こうすると、ユーザーが設定アプリからあなたのアプリのデータ使用量をみたときに、"View application settings" ボタンが有効になっていて、ボタンを押すとあなたのアプリの preference activity を開けるので、ユーザーがあなたのアプリのデータ使用量をよりよくすることができます。

さらに、getBackgroundDataSetting() は廃止になり常に true を返すようになりました。代わりに getActiveNetworkInfo() を使ってください。ネットワーク通信を試みる前に、常に getActiveNetworkInfo() を呼んで、現在のネットワークを表す NetworkInfo を取得し、 isConnected() でデバイスが接続しているかどうかチェックしてください。デバイスがローミング中かどうかや Wi-Fi で接続しているかどうかなど、その他の接続プロパティも取得することができます。

■ RenderScript

RenderScript に3つのメジャー機能が追加されました。

framebuffer object への Off-screen レンダリング
view 内部でのレンダリング
RS for each from the framework APIs (←意味がわからなかったので訳せませんでした m(_ _)m）

Allocation クラスが新しく USAGE_GRAPHICS_RENDER_TARGET メモリースペースをサポートし、これにより直接 Allocation にレンダリングしたり、 framebuffer object として扱ったりできるようになりました。

RSTextureView は View の内部に RenderScript グラフィクスを表示する手段を提供します。別の window を作る RSSurfaceView とは異なります。この大きな違いによって、Activity のレイアウト上の、内側に RenderScript グラフィックを描画した View を移動したり、変形したりアニメーションすることができます。

Script.forEach() メソッドで VM レベルから RenderScript 計算スクリプトを呼ぶことができ、自動的にデバイスの利用可能なコアへ割当てられます。このメソッド直接使わないでください。しかし、あなたが書いた計算する RenderScript は、リフレクトされた RenderScript クラスで呼べるように forEach() メソッドを持ってください。プロセスに入力 Allocation を、結果を書くところに出力 Allocation を渡すことで、リフレクトされた forEach() メソッドを呼ぶことができます。そして、 RenderScript の場合の FieldPacker データ構造にはより情報が必要です。Allocation だけが不可欠なもので、データ構造はオプションです。

■ Enterprise

Android 4.0 で企業向けアプリの機能として以下の内容が拡張されました。

VPN service

新しい VpnService によって、アプリが自身の VPN (Virtual Perivate Network) を構成し、Service として走らせることができます。 VPN サービスは自身のアドレスとルーティング規則で virtual network へのインタフェースを作成し、ファイルディスクリプタですべての読み込みと書き込みを実行します。

VPN サービスを作成するには、ネットワークアドレス、DNS サーバー、ネットワークルートなどを指定できる VpnService.Builder を使います。指定が完了したら、ParcelFileDescriptor を返す establish() を呼び出してインタフェースを確立します。

VPN サービスはパケットに介入するため、セキュリティへの影響があります。そのため、VpnService を実装するサービスは、システムだけがこれにバインドできることを確実にするために、 BIND_VPN_SERVICE を要求しなければなりません（システムだけがバインドするパーミッションをもち、アプリはリクエストできません）。そして、あなたの VPN サービスを使うには、ユーザーが手動でシステム設定からこれを有効にする必要があります。

Device policies

デバイスの制限を管理するアプリで setCameraDisabled() と USES_POLICY_DISABLE_CAMERA プロパティ（ポリシー設定ファイルで <disable-camera /> に適用される）を使ってカメラを無効にできるようになりました。

Certificate management

新しい KeyChain クラスは証明書をシステムキーストアにインポートやアクセスする API を提供します。証明書はクライアント証明書（ユーザーの身元を検証する）と認証局の証明書（サーバーの身元を検証する）の両方のインストールを合理化します。Web ブラウザやメールクライアントなどのアプリは、サーバーにユーザーを認証させるためにインストールされた証明書にアクセスできます。より詳しい情報は KeyChain ドキュメントを見てください。

■ Device Sensors

Android 4.0 で新しいセンサータイプが追加されました。

TYPE_AMBIENT_TEMPERATURE : 周り（部屋）の温度をセルシウス度で提供する温度センサー
TYPE_RELATIVE_HUMIDITY: 周り（部屋）の湿度をパーセントで提供する湿度センサー

TYPE_AMBIENT_TEMPERATURE と TYPE_RELATIVE_HUMIDITY センサーの両方をデバイスがサポートしているなら、これらを露点と絶対湿度を計算するのに使えます。

以前の温度センサーである TYPE_TEMPERATURE は廃止になりました。代わりに TYPE_AMBIENT_TEMPERATURE センサーを使ってください。

加えて、Android の 3つの合成センサーがかなり改善され、レイテンシが低くなり、出力がスムーズになりました。これらのセンサーには重力センサー (TYPE_GRAVITY)、回転ベクトルセンサー (TYPE_ROTATION_VECTOR)、線形加速センサー (TYPE_LINEAR_ACCELERATION) が含まれます。改善されたセンサーは、出力を改善するためにジャイロスコープセンサーに頼っています。そのため、これらのセンサーはジャイロスコープが搭載されたデバイスにだけ現れます。

■ Action Bar

いくつかの新しい動作をサポートするために ActionBar がアップデートされました。もっとも重要なのことは、全ての画面サイズでオプショナルなユーザー操作を提供するために、小さい画面サイズのときにシステムが action bar のサイズと設定を優雅に管理することです。例えば、画面が狭いとき（ハンドセットで縦画面のときなど）、action bar のナビゲーションタブはメインの action bar の真下に表れる "stacked bar" 内に表示されます。また、 "split action bar" を opt-in することもできます。これにより画面が狭いときに全ての action item を画面下部の separate bar に配置することができます。

Split action bar

もし action bar に複数の action item が含まれる場合、全ての項目を狭い画面上の action bar に合わせることはありません。システムはそれらのうちのいくつかを overflow menu に置きます。しかし、Android 4.0 から "split action bar" を有効にできるようになりました。これにより、より多くの action item を画面下部のセパレートバー上に表示できるようになりました。split action bar を有効にするには、"splitActionBarWhenNarrow" を指定した android:uiOptions 属性を manifest ファイルの <application> タグもしくは個々の <activity> タグに指定します。有効の場合、画面が狭いときに全ての action item 用にシステムは付加的なバーを画面下部に追加します（優先的な（上部の） action bar には action item が表示されなくなります）。

ActionBar.Tab API によって提供されるナビゲーションタブを使いたいが、上部にメインの action bar は必要ない場合（上部にタブだけを表示したい場合）、上で説明した split action bar を有効にして、さらに setDisplayShowHomeEnabled(false) を呼ぶと action bar のアプリアイコンが無効になります。メインの action bar の左には何も表示されず、画面上部にナビゲーションバー、画面下部に action item が置かれるようになります。

Action bar styles

action bar のカスタマイズしたスタイルを適用したい場合は、新しいスタイルプロパティの backgroundStacked と backgroundSplit で背景の画像や色をスタックするバーと区切りバーにそれぞれ適用することができます。また、ランタイム中に setStackedBackgroundDrawable() と setSplitBackgroundDrawable() でこれらのスタイルをセットすることもできます。

Action provider

新しい ActionProvider クラスによって action item を処理する特別なハンドラを作成できます。1つの action provider は 1つの action view、デフォルトの action 動作、関連した各 action item のサブメニューを定義することができます。動的な動作（可変な action view やデフォルト動作やサブメニュー）を行う action item を作成したい場合は、fragment や activity 内で action item を変換するよりも、再利用可能なコンポーネントを作成するために、ActionProvider を拡張するのがいい解決法です。

例えば、ShareActionProvider は ActionProvider を拡張して簡単にアクションバーから "share" action を行えます。ACTION_SEND intent を呼び出すこれまでの action item を使うかわりに、この action provider を使って ACTION_SEND intent を処理するアプリ一覧のドロップダウンリストの action view を表示できます。ユーザーがリストからアプリを選択すると、ShareActionProvider はその選択を記憶して、そのアプリでシェアするためにより速くサクセスするために action view にそれを提供します。

1つの action item に対して1つの action provider を宣言するには Activity の options menu の <item> エレメントに android:actionProviderClass 属性に action provider のクラス名を指定します。例えば :

<item android:id="@+id/menu_share"      android:title="Share"      android:showAsAction="ifRoom"      android:actionProviderClass="android.widget.ShareActionProvider" />

あなたの Activity の onCreateOptionsMenu() コールバックメソッドでは、menu item から action provider のインスタンスを取得して、intent をセットします。

public boolean onCreateOptionsMenu(Menu menu) {    getMenuInflater().inflate(R.menu.options, menu);    ShareActionProvider shareActionProvider =          (ShareActionProvider) menu.findItem(R.id.menu_share).getActionProvider();    // Set the share intent of the share action provider.    shareActionProvider.setShareIntent(createShareIntent());    ...    return super.onCreateOptionsMenu(menu);}

ShareActionProvider を使った例として、ApiDemos の ActionBarActionProviderActivity を見てください。

Collapsible action views

action view を提供する action item で、 action view 状態とこれまでの action item 状態を切り替えられるようになりました。以前は SearchView だけが action view として使われたときに閉じるようサポートされてしました。しかし、任意の action item を action view として追加し、展開状態（action view が見えている）と閉じている状態（action item が見えている）を切り替えることができるようになりました。

閉じられる action view を含む action item を宣言するには menu の XML ファイルの <item> エレメントの android:showAsAction 属性に "collapseActionView" フラグを入れます。

action view が展開した状態と閉じた状態が切り替わったことをコールバックで受け取るには、MenuItem.OnActionExpandListener のインスタンスを setOnActionExpandListener() を呼んでそれぞれの MenuItem でに登録します。典型的には、onCreateOptionsMenu() コールバックの中で行ってください。

閉じれる action view をコントロールするには、collapseActionView() や expandActionView() を各 MenuItem に対して呼びます。カスタム action view を作る場合は、CollapsibleActionView インタフェースを実装して view が開いたり閉じたりしたときのコールバックを受け取ることができます。

Other APIs for action bar

setHomeButtonEnabled() でアイコン／ロゴがホームもしくは "up" をナビゲートするボタンとして動作するかどうかを指定できる（true を渡すとボタンとして動作する）。
setIcon() と setLogo() でランタイム中に Action Bar のアイコンやロゴを設定できます。
Fragment.setMenuVisibility() によって fragment で定義されたメニューアイテムの可視状態を有効／無効にすることができる。Activity に Fragment が追加されたが、それが不可視状態であるときに menu item を隠すのに使えます。
FragmentManager.invalidateOptionsMenu() によって Activity から同等のメソッドが利用できない可能性がある Fragment ライフサイクルのいくつかの状態の間 activity の options menu を無効にできます。

■ User Interface and Views

Android 4.0 で追加された新しい view とその他 UI コンポーネントについて紹介します。

GridLayout

GridLayout は子 view を格子状に配置する新しい view group です。TableLayout と違い、GridLayout はフラットな階層に依存し、table rows のような構造を作るための中間の view を必要としません。代わりに子 view は配置される行（rows(s)）と列（column(s)）を指定します（セルは複数の行や列をまたぐことができます）。デフォルトでは順番に格子の行と列を占めるように配置されます。子 view の間のスペースは新しい Space view のインスタンスを使ったり、関連するマージンパラメータを子viewに設定したりすることで調整できます。

サンプルは ApiDemos の GridLayout です。

TextureView

TextureView はビデオや OpenGL シーンなどの content stream を表示できる新しい view です。SurfaceView と似ていますが、TextureView は別の window をつくるのではなく、通常の view のように振る舞うという点でユニークです。そのため、他の View object と同じように扱うことができます。例えば、ViewPropertyAnimator を使って変形やアニメーションをさせたり、setAlpha() で透明度を調整できたりします。

TextureView は hardware accelerated window 内でのみ動作するので注意してください。

より詳しい情報は TextureView ドキュメントをみてください。

Switch widget

新しい Switch ウィジェットは一方を反対側にスライドして（もしくは、単にタップして）2つの状態を切り替えるものです。

android:textOn と android:textOff 属性を使ってスイッチ上に表示される文字を指定できます。android:text 属性でスイッチの横に置かれるラベル名を指定できます。

スイッチを使ったサンプルは switches.xml レイアウトファイルと関連する Switches activity を見てください。

Popup menus

Android 3.0 で、小さいコンテキストメニューを指定したアンカーポイント（通常は選択されたアイテムの場所）にポップアップする PopupMenu を紹介しました。Android 4.0 では PopupMenu を拡張して幾つかの便利な機能を追加しました :

menu resource ID で infalte() を呼ぶことで、popup menu のコンテンツを XML menu resource から簡単に作れるようになりました。
メニューが消えたことを受け取るコールバックの PupupMenu.OnDismissListener を作れるようになりました。

Preferences

新しい TwoStatePreference 抽象クラスは2つの状態から選択するオプション用の preference を提供します。この TwoStatePreference を継承した新しいクラスが SwitchPreference です。この preference は Switch ウィジェットを使った preference view を提供し、ユーザーは別のスクリーンやダイアログを開くこと無く設定の on/off を切り替えられます。例えば、設定アプリでは Wi-Fi や Bluetooth の設定に SwitchPreference を使っています。

System themes

Android 4.0 をターゲットとする（targetSdkVersion か minSdkVersion が "14"以上に設定されている）全てのアプリケーションのデフォルトテーマは "device default" テーマの: Theme.DeviceDefault になります。これは dark Holo テーマか、特定のデバイスによって定義された dark theme になるでしょう。

Theme.Holo ファミリーのテーマは同じバージョンの Android が動いている場合は、デバイスによって変わらないことが保証されます。Theme.Holo テーマをあなたの activity に明示的に適用するなら、同じプラットフォームバージョン内のデバイスならテーマによる特徴が変わらないので安心できます。

もしデバイス全体のテーマ（例えば、異なる OEM が提供するシステム用の異なるデフォルトテーマ）にアプリを合わせたいなら、明示的に Theme.DeviceDefault ファミリーを適用してください。

Options menu button

Android 4.0 からハンドセットが Menu ハードボタンを必要としなくなったことに気づいたと思います。あなたのすでにあるアプリケーションで option menu を使っていて Menu ボタンがあることを期待していても心配する必要はありません。既にあるアプリがそれらが期待した動作をちゃんとできるように、システムは Android の古いバージョン用にデザインされたアプリでは、スクリーン上に Menu ボタンを提供します。

ベストなユーザー体験のために、メニューアイテムへのアクセスとして ActionBar を使うようにアプリを新しくするかアップデートしてください。また、targetSdkVersion に "14" をセットして最新のフレームワークのデフォルトの動作を活用してください。

Controls for system UI visibility

以前の Android では、status bar として知られていたシステムが管理する UI コンポーネントがありました。ハンドセットデバイスの上部に常駐してキャリアシグナルな時間、通知などの情報を表示していました。Android 3.0 では、画面の下部に常駐してシステムのナビゲーションコントロール（Home、Back、など) やこれまで status bar で提供してきた項目へのインタフェースを提供する system bar がタブレットデバイス用に追加されました。Android 4.0 では、navigation bar と呼ばれる新しいタイプのシステム UI が提供されます。navigation bar はハンドセット向けにデザインされた system bar の re-tuned バージョンだと思うかもしれません。システムをナビゲーションするためのハードウェア部分（ハードキーとか）を持たないデバイスに対して、ナビゲーションコントロールを提供しますが、 system bar の通知 UI と設定コントロールを残します。このように navigation bar を提供するデバイスでは上部に status bar も持ちます。

これまでは、ハンドセット上で FLAG_FULLSCREEN フラグを使って status bar を隠すことができました。Android 4.0 では、system bar の可視状態をコントロールする API は system bar と navigation bar 両方の動作をよりよく反映するようにアップデートされています。

SYSTEM_UI_FLAG_LOW_PROFILE フラグは STATUS_BAR_HIDDEN フラグを置き換えるものです。セットされた場合、このフラグは system bar もしくは navigation bar の "low profile" モードを有効にします。ナビゲーションボタンは薄暗くなって system bar 内の他の項目は隠れます。システムナビゲーションボタンが邪魔せず、より没入できるゲームを作るときに便利です。
SYSMTE_UI_FLAG_VISIBLE フラグは STATUS_BAR_VISIBLE フラグを置き換えるものです。system bar もしくは navigation bar が可視状態になることを要求します。
SYSTEM_UI_FLAG_HIDE_NAVIGATION は navigation bar を完全に隠すことを要求する新しいフラグです。これは navigation bar を使っているいくつかのハンドセットでのみ動作することに注意してください（タブレット上の system bar は隠せません）。navigation bar はシステムがユーザー入力を受け取るとすぐに view として返ってきます。つまり、ビデオのプレイバックなど、画面全体が必要とするがユーザーの入力が必要ではないときに便利です。

Activity 内のいずれかの view 上で setSystemUiVisibility() を呼ぶことで、 system bar と navigation bar に対してこれらのフラグをセットできます。window manager は window 内の全ての view からの全フラグを組み合わせて（もしくは一緒にして）、window が入力フォーカスを持つのと同じくらい長くシステム UI に適用します。window が入力フォーカスを失うと（ユーザーがあなたのアプリから離れたり、ダイアログが表示されたり）、フラグの効果は中止されます。同様に、view 階層からそれらの view を取り除くと、フラグは適用されなくなります。

システム UI の可視状態の変化に他のイベントを同期させる（例えば、アクションバーを隠したり、他の UI コントロールをシステム UI が隠れたときに隠すなど）には、system bar や navigation bar の可視状態が変わったことを通知する View.OnSystemUiVisibilityChangeListener を登録してください。システム UI オプションの違いのデモは OverscanActivity を見てください。

■ Input Framework

Android 4.0 でカーソルのホバーイベント、新しいスタイラスとマウスボタンのイベントをサポートするようになりました。

Hover events

View クラスで新しく "hover" イベントがサポートされるようになりました。これにより、マウスなど画面上にカーソルを表示するポインタでバイスを使うときによりリッチなインタラクションが可能になります。

View でホバーイベントを受け取るには、View.OnHoverListener を実装し setOnHoverListener() で登録します。View 上でホバーイベントが起こったら、あなたのリスナーの onHover() が呼び出され、イベントを受け取った View と起こったホバーイベントのタイプを持つ MotionEvent を受け取ります。ホバーイエベントは次のうちのいずれかになります :

ホバーイベントを処理する場合は、あなたの View.OnHoverListener の onHover() で true を返してください。false を返すと、通常のように親 view にイベントが送られます。

あなたのアプリでボタンのように現在の状態に応じて見た目が変わる widget を使っているなら、カーソルのホバー状態に応じて背景画像を変えるための android:state_hovered 属性を state list drawable で利用できます。

ホバーイベントのデモとして ApiDemos の Hover クラスを見てください。

Stylus and mouse button events

digitizer tablet やスタイラスが使えるタッチスクリーンなど、スタイラス入力デバイスからの入力を受ける API が提供されるようになりました。

スタイラスによる入力はタッチやマウス入力と同じように動作します。スタイラスが digitizer に接触したとき、アプリは指が画面をタッチしたときと同じようなタッチイベントを受け取ります。スタイラスが digitizer 上に浮いているとき、アプリはマウスポインターがボタンを押さずに画面上を動くのと同じようなホバーイベントを受け取ります。

getToolType() を使って MotionEvent のポインタに対して "tool type" を取得して、入力が指なのか、マウスなのか、スタイラスなのか、イレイサーなのか区別することができます。現在定義されている tool type は : TOOL_TYPE_UNKNOWN, TOOL_TYPE_FINGER, TOOL_TYPE_MOUSE, TOOL_TYPE_STYLUS, TOOL_TYPE_ERASER です。tool type を見ることで指やマウスでの入力と異なる処理をスタイラス入力で行うようにできます。

getButtonState() を使って MotionEvent の "button state" を調べることで、マウスやスタイラスのボタンが押されているかどうかわかります。現在定義されている button state は : BUTTON_PRIMARY, BUTTON_SECONDARY, BUTTON_TERTIARY, BUTTON_BACK, BUTTON_FORWARD です。利便性のために、マウスのバックとフォーワードボタンは自動的に KEYCODE_BACK と KEYCODE_FORWARD キーに割り振られます。マウスボタンのバックとフォーワード操作をサポートするためにこれらのキーを利用できます。

加えて、接触の位置と圧力を正確をはかるために、いくつかのスタイラス入力デバイスはスタイラスチップと digitizer の間の距離、スタイラスの傾き角度、スタイラスの回転角度を報告します。AXIS_DISTANCE, AXIS_TILT, AXIS_ORIENTATION で getAxisValue() を使ってこの情報を取得できます。

tool type, button state, 新しい axis code のデモとして ApiDemos の TouchPaint を見てください。

■ Properties

新しい Property クラスは、一般的にオブジェクトに対して set/get で呼ばれる値であるプロパティを速く、効果的に、簡単に指定する方法を提供します。また、フィールドやメソッド周りのリファレンスを渡すことを可能にし、フィールドやメソッドの詳細を知らなくてもプロパティの値を set/get するコードが可能になります。

例えば、オブジェクト foo のフィールド bar に値をセットする場合、これまではこうしていました : foo.bar = value;private field bar に対する setter を呼ぶときは、これまではこうしていました : foo.setBar(value);しかし、foo インスタンスの周りに渡したり、bar value をセットする他のコードがある場合、Android 4.0 以前では行う方法がまったくありませんでした。

Property クラスを使うと、Foo クラスに Property オブジェクト BAR を宣言して、Foo クラスの foo インスタンスのフィールドをこのようにセットできます : BAR.set(foo, value);View クラスでは、この Property クラスを利用して、Android 3.0 で追加された変形プロパティ (ROTATION, ROTATION_X, TRANSLATION_X など) など、いくつかのフィールドを設定できるようになりました。

ObjectAnimator クラスも Property クラスを使うようになりました。そのため、Property を使ってより速く、効率的に、文字列ベースのアプローチよりもより型安全に ObjectAnimator を作成できます。

■ Hardware Acceleration

Android 4.0 から、targetSdkVersion もしくは minSdkVersion に "14" 以上がセットされているアプリでは、デフォルトで hardware acceleration が全ての window で有効になっています。hardware acceleration の結果として、一般的にはアニメーションがスムーズになったり、スクロールがスムーズになったり、ユーザー操作へのレスポンスとパフォーマンスが全体的によくなったりします。

必要であれば手動で hardware acceleration を無効にすることができます。それには個々の <activity> エレメントもしくは <application> エレメントの hardwareAccelerated 属性に false を設定します。また、個々の view で setLayerType(LAYER_TYPE_SOFTWARE) を呼ぶことでも hardware acceleration を無効にすることができます。

サポートしていない描画操作のリストなどのを含む、hardware acceleration のより詳しい情報は Hardware Acceleration ドキュメントを見てください。

■ JNI Changes

以前の Android バージョンでは、JNI local reference は間接的に扱うことができず、Android は直接ポインタを使っていました。これはガーベージコレクターがオブジェクトを動かさなかった間は問題ありませんでしたが、一見動くように見える状態はバグを含むコードを書いてしまう可能性があります。Android 4.0 では、システムはこれらのバグを検出するために間接的な reference を使うようになりました。

JNI local reference の入力と出力は JNI Tips の "Local and Global References" に記述されています。Android 4.0 では、これらのエラーを検出するために CheckJNI が拡張されています。Android Developer Blog を見て、一般的な JNI references のエラーとそれをどのように直すかのポストがくるのをチェックしてください。

JNI 実装のこの変更は targetSdkVersion か minSdkVersion が "14"以上の Android 4.0 をターゲットとするアプリにのみ影響します。これらの属性にこれより小さい値をセットした場合は、JNI local reference は以前のバージョンと同じように動作します。

■ WebKit

WebKit が version 534.30 にアップデートされました。
Indic fonts (Devanagari, Bengali, and Tamil, including the complex character support needed for combining glyphs) を WebView とビルトインのブラウザでサポート
Ethiopic, Georgian, and Armenian fonts を WebView とビルトインのブラウザでサポート
WebView を使うアプリのテストを楽にする WebDriver をサポート

Android Browser

ブラウザアプリに web アプリをサポートするための以下の機能が追加されました。

V8 JavaScript コンパイラがアップデートされパフォーマンスがよくなりました
加えて、Android 3.0 から引き継がれた注目すべき機能がハンドセットでも利用可能になりました :
- 全てのページでのエレメントの固定位置をサポート
- HTML media capture
- Device orientation events
- CSS 3D transformations

■ Permissions

以下は新しいパーミッションです。

ADD_VOICEMAIL : voicemail service がデバイスに voicemail メッセージを追加することを許可する
BIND_TEXT_SERVICE : SpellCheckerService を実装するサービスはこのパーミッションが必要
BIND_VPN_SERVICE : VpnService を実装するサービスはこのパーミッションが必要
READ_PROFILE : ContactsContract.Profile provider への読み込みアクセスを提供する
WRITE_PROFILE : ContactsContract.Profile provider への書き込みアクセスを提供する

■ Device Features

以下はデバイスの新しい機能です。

FEATURE_WIFI_DIRECT : アプリが Wi-Fi の peer-to-peer 通信を使うことを宣言します。

Android　SimpleCursorTreeAdapter を使う

2011-10-06T11:37:00.000+09:00

1段のリストを作る ListView 用の Adapter として、 Object配列やリストをひもづける SimpleAdapter やデータベースを検索して得られる Cursor をひもづける SimpleCursorAdapter などがあります。

同じように、2段のリストを作る ExpandableListView 用の Adapter として、Object の配列やリストをひもづける SimpleExpandableListAdapter というのがあります。実は、Cursor データを ExpandableListView にひもづけるための実装クラスの Adapter はありません。変わりに抽象クラスの SimpleCursorTreeAdapter というものがあります。

# SimpleExpandableListAdapter の使い方は API Demos の ExpandableList3.java がわかりやすいです。

このクラスを継承した実装クラスを作って利用します。

public class SimpleCursorTreeAdapterSampleActivity extends ExpandableListActivity {    private static final String[] CONTACTS_PROJECTION = new String[] {        Contacts._ID,        Contacts.DISPLAY_NAME    };        private static final int GROUP_ID_COLUMN_INDEX = 0;        private static final String[] PHONE_PROJECTION = new String[] {        Phone._ID,        Phone.TYPE,        Phone.NUMBER    };    public class ExpandableListAdapter extends SimpleCursorTreeAdapter {        public ExpandableListAdapter(Context context, Cursor c,                int groupLayout, String[] groupFrom, int[] groupTo,                 int childLayout, String[] childrenFrom,int[] childrenTo) {            super(context, c, groupLayout, groupFrom, groupTo,                     childLayout, childrenFrom, childrenTo);        }        @Override        protected Cursor getChildrenCursor(Cursor groupCursor) {            Uri.Builder builder = Contacts.CONTENT_URI.buildUpon();            ContentUris.appendId(builder, groupCursor.getLong(GROUP_ID_COLUMN_INDEX));            builder.appendEncodedPath(Contacts.Data.CONTENT_DIRECTORY);            Uri phoneNumbersUri = builder.build();                        Cursor c = getContentResolver().query(phoneNumbersUri, PHONE_PROJECTION, Phone.MIMETYPE + "=?", new String[] { Phone.CONTENT_ITEM_TYPE}, null);            startManagingCursor(c);            return c;        }    }        private SimpleCursorTreeAdapter mAdapter;        @Override    public void onCreate(Bundle savedInstanceState) {        super.onCreate(savedInstanceState);        Cursor c = getContentResolver().query(Contacts.CONTENT_URI, CONTACTS_PROJECTION,                 Contacts.HAS_PHONE_NUMBER + "=1", null, null);        mAdapter = new ExpandableListAdapter(                this, c,                android.R.layout.simple_expandable_list_item_1,                new String[] { Contacts.DISPLAY_NAME },                 new int[] { android.R.id.text1 },                android.R.layout.simple_expandable_list_item_1,                new String[] { Phone.NUMBER },                new int[] { android.R.id.text1 });                startManagingCursor(c);                setListAdapter(mAdapter);    }}

SimpleCursorTreeAdapter にも SimpleCursorAdapter 同様 ViewBinder を設定して表示方法を変更することができます。

public class SimpleCursorTreeAdapterSampleActivity extends ExpandableListActivity {    private static final String[] CONTACTS_PROJECTION = new String[] {        Contacts._ID,        Contacts.DISPLAY_NAME    };        private static final int GROUP_ID_COLUMN_INDEX = 0;        private static final String[] PHONE_PROJECTION = new String[] {        Phone._ID,        Phone.TYPE,        Phone.NUMBER    };    private static final int[] COLOR_LIST = new int[] {        Color.parseColor("#002A42"),        Color.parseColor("#3DC3EA"),        Color.parseColor("#99417B"),        Color.parseColor("#F2AE30"),        Color.parseColor("#F2D338"),    };    public class ExpandableListAdapter extends SimpleCursorTreeAdapter {        public ExpandableListAdapter(Context context, Cursor c,                int groupLayout, String[] groupFrom, int[] groupTo,                 int childLayout, String[] childrenFrom,int[] childrenTo) {            super(context, c, groupLayout, groupFrom, groupTo,                     childLayout, childrenFrom, childrenTo);        }        @Override        protected Cursor getChildrenCursor(Cursor groupCursor) {            Uri.Builder builder = Contacts.CONTENT_URI.buildUpon();            ContentUris.appendId(builder, groupCursor.getLong(GROUP_ID_COLUMN_INDEX));            builder.appendEncodedPath(Contacts.Data.CONTENT_DIRECTORY);            Uri phoneNumbersUri = builder.build();                        Cursor c = getContentResolver().query(phoneNumbersUri, PHONE_PROJECTION, Phone.MIMETYPE + "=?", new String[] { Phone.CONTENT_ITEM_TYPE}, null);            startManagingCursor(c);            return c;        }    }        private SimpleCursorTreeAdapter mAdapter;        @Override    public void onCreate(Bundle savedInstanceState) {        super.onCreate(savedInstanceState);        Cursor c = getContentResolver().query(Contacts.CONTENT_URI, CONTACTS_PROJECTION,                 Contacts.HAS_PHONE_NUMBER + "=1", null, null);        mAdapter = new ExpandableListAdapter(                this, c,                android.R.layout.simple_expandable_list_item_1,                new String[] { Contacts.DISPLAY_NAME },                new int[] { android.R.id.text1 },                android.R.layout.simple_expandable_list_item_2,                new String[] { Phone.TYPE, Phone.NUMBER },                new int[] { android.R.id.text1, android.R.id.text2 });                mAdapter.setViewBinder(new SimpleCursorTreeAdapter.ViewBinder() {                        public boolean setViewValue(View view, Cursor cursor, int columnIndex) {                if (cursor.getColumnName(columnIndex).equals(Phone.TYPE)) {                    int type = cursor.getInt(columnIndex);                    String text = (String) Phone.getTypeLabel(getResources(), type, null);                                        ((TextView) view).setText(text);                    ((TextView) view).setTextColor(COLOR_LIST[type % 5]);                    return true;                }                return false;            }        });                startManagingCursor(c);                setListAdapter(mAdapter);    }}

Y.A.M の雑記帳: Android　AsyncQueryHandler を使う - でも触れたように、UI スレッドで Cursor を取得するためのクエリを走らせると UI スレッドをブロックしていまいます。それを避けるために SimpleCursorTreeAdapter に対しても AsyncQueryHandler を使うようにすることができます。

public class AsyncQuerySimpleCursorTreeAdapterSampleActivity extends ExpandableListActivity {    private static final String[] CONTACTS_PROJECTION = new String[] {        Contacts._ID,        Contacts.DISPLAY_NAME    };        private static final int GROUP_ID_COLUMN_INDEX = 0;        private static final String[] PHONE_PROJECTION = new String[] {        Phone._ID,        Phone.TYPE,        Phone.NUMBER    };    private static final int[] COLOR_LIST = new int[] {        Color.parseColor("#002A42"),        Color.parseColor("#3DC3EA"),        Color.parseColor("#99417B"),        Color.parseColor("#F2AE30"),        Color.parseColor("#F2D338"),    };        private static final int TOKEN_GROUP = 0;    private static final int TOKEN_CHILD = 1;        private static final class QueryHandler extends AsyncQueryHandler {        private CursorTreeAdapter mAdapter;        public QueryHandler(Context context, CursorTreeAdapter adapter) {            super(context.getContentResolver());            this.mAdapter = adapter;        }        @Override        protected void onQueryComplete(int token, Object cookie, Cursor cursor) {            switch (token) {            case TOKEN_GROUP:                mAdapter.setGroupCursor(cursor);                break;            case TOKEN_CHILD:                int groupPosition = (Integer) cookie;                mAdapter.setChildrenCursor(groupPosition, cursor);                break;            }        }    }        public class ExpandableListAdapter extends SimpleCursorTreeAdapter {        public ExpandableListAdapter(Context context,                 int groupLayout, int childLayout,                 String[] groupFrom, int[] groupTo,                 String[] childrenFrom,int[] childrenTo) {            super(context, null, groupLayout, groupFrom, groupTo,                     childLayout, childrenFrom, childrenTo);        }        @Override        protected Cursor getChildrenCursor(Cursor groupCursor) {            Uri.Builder builder = Contacts.CONTENT_URI.buildUpon();            ContentUris.appendId(builder, groupCursor.getLong(GROUP_ID_COLUMN_INDEX));            builder.appendEncodedPath(Contacts.Data.CONTENT_DIRECTORY);            Uri phoneNumbersUri = builder.build();            mQueryHandler.startQuery(TOKEN_CHILD, groupCursor.getPosition(), phoneNumbersUri,                     PHONE_PROJECTION, Phone.MIMETYPE + "=?",                     new String[] { Phone.CONTENT_ITEM_TYPE }, null);            return null;        }    }        private QueryHandler mQueryHandler;    private SimpleCursorTreeAdapter mAdapter;        @Override    public void onCreate(Bundle savedInstanceState) {        super.onCreate(savedInstanceState);        mAdapter = new ExpandableListAdapter(                this,                 android.R.layout.simple_expandable_list_item_1,                android.R.layout.simple_expandable_list_item_2,                new String[] { Contacts.DISPLAY_NAME },                new int[] { android.R.id.text1 },                new String[] { Phone.TYPE, Phone.NUMBER },                new int[] { android.R.id.text1, android.R.id.text2 });                mAdapter.setViewBinder(new SimpleCursorTreeAdapter.ViewBinder() {                        public boolean setViewValue(View view, Cursor cursor, int columnIndex) {                if (cursor.getColumnName(columnIndex).equals(Phone.TYPE)) {                    int type = cursor.getInt(columnIndex);                    String text = (String) Phone.getTypeLabel(getResources(), type, null);                                        ((TextView) view).setText(text);                    ((TextView) view).setTextColor(COLOR_LIST[type % 5]);                    return true;                }                return false;            }        });                setListAdapter(mAdapter);        mQueryHandler = new QueryHandler(this, mAdapter);        mQueryHandler.startQuery(TOKEN_GROUP, null, Contacts.CONTENT_URI,                 CONTACTS_PROJECTION, Contacts.HAS_PHONE_NUMBER + "=1", null, null);    }    @Override    protected void onDestroy() {        super.onDestroy();        mAdapter.changeCursor(null);        mAdapter = null;    }}

Android　Localeに対応した曜日や月の表記一覧を取得する

2011-10-05T12:11:00.000+09:00

特定の Locale に対応した、曜日や月などの表記の一覧配列を DateFormatSymbols を使って取得できるので、Android で設定言語を変えた場合を取得してみた。

public class DateFormatSymbolSampleActivity extends Activity {    @Override    public void onCreate(Bundle savedInstanceState) {        super.onCreate(savedInstanceState);        setContentView(R.layout.main);                LayoutInflater inflater = (LayoutInflater)getSystemService(Context.LAYOUT_INFLATER_SERVICE);                DateFormatSymbols symbols = new DateFormatSymbols();                TableLayout table = (TableLayout) findViewById(R.id.symbols);                addTableRow(inflater, table, "getAmPmString", Arrays.toString(symbols.getAmPmStrings()));        addTableRow(inflater, table, "getEras", Arrays.toString(symbols.getEras()));        addTableRow(inflater, table, "getMonths", Arrays.toString(symbols.getMonths()));        addTableRow(inflater, table, "getShortMonths", Arrays.toString(symbols.getShortMonths()));        addTableRow(inflater, table, "getWeekdays", Arrays.toString(symbols.getWeekdays()));    }        private void addTableRow(LayoutInflater inflater, TableLayout table, String text1, String text2) {        TableRow row = (TableRow)inflater.inflate(R.layout.row, table, false);        ((TextView)row.findViewById(R.id.text1)).setText(text1);        ((TextView)row.findViewById(R.id.text2)).setText(text2);        table.addView(row);    }}

<?xml version="1.0" encoding="utf-8"?><LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"    android:orientation="vertical"    android:layout_width="fill_parent"    android:layout_height="fill_parent"    >    <TableLayout        android:id="@+id/symbols"        android:layout_width="fill_parent"         android:layout_height="wrap_content"         /></LinearLayout>

<?xml version="1.0" encoding="utf-8"?><TableRow xmlns:android="http://schemas.android.com/apk/res/android"    android:layout_width="fill_parent"    android:layout_height="wrap_content"    android:padding="5dip"    >    <TextView        android:id="@+id/text1"        android:layout_width="wrap_content"         android:layout_height="wrap_content"         android:padding="5dip"        />    <TextView        android:id="@+id/text2"        android:layout_width="0dip"        android:layout_weight="1"         android:layout_height="wrap_content"         android:padding="5dip"        /></TableRow>

英語ロケール

日本語ロケール

ドイツ語ロケール

フランス語ロケール

韓国語ロケール

ちなみに、1.6 だと、曜日名と月名がとれないバグがあるそうです。
Issue 3985 - android - DateFormatSymbols bugs in Japanese locale sdk1.6 - Project Hosting on Google Code

Android　Apache HTTP Client と HttpURLConnection どっちを使うべき？

2011-10-04T14:48:00.001+09:00

Android Developer's Blog にちょっと面白い記事があったのでまとめてみた。

Android Developers Blog: Android’s HTTP Clients -

Android のフレームワークは HTTP 通信をするための HTTP client の実装が2つあります。

1つが HttpURLConnection (java.net パッケージ) で、もう1つのが Apache HTTP Client (org.apache.http パッケージ) です。

Apache HTTP Client

　DefaultHttpClient とそれのサブクラスの AndroidHttpClient は Web ブラウザに適応した拡張された HTTP Client です。そのため、大きくてフレキシブルな API を持っています。これらの実装は安定していますが、いくつかのバグも含まれています。

巨大な API は互換性を破らずに改善することがとても難しく、Android チームは Apache HTTP Client に対してアクティブに活動していません。

HttpURLConnection

　HttpURLConnection ほとんどのアプリケーションに適応する汎用的で軽量な HTTP Client です。API が絞られているので、徐々に改善していきやすいです。

Froyo 以前では、HttpURLConnection には幾つかのイライラするバグがありました。とくに、close() を読み込み可能な InputStream で呼ぶことで connection pool を汚染することがありました。connection pooling を無効にすることでこの問題を回避するには

private void disableConnectionReuseIfNecessary() {    // HTTP connection reuse which was buggy pre-froyo    if (Integer.parseInt(Build.VERSION.SDK) < Build.VERSION_CODES.FROYO) {        System.setProperty("http.keepAlive", "false");    }}

のようにします。

Gingerbread では、transparent response compression が追加されました。HttpURLConnection は自動的にリクエストにヘッダを追加し、対応するレスポンスを処理します。

Accept-Encoding: gzip

Web server が圧縮レスポンスを利用できるクライアントに対してそれを返すように設定することで、この利点を生かすことができます。もし圧縮レスポンスで問題がある場合は、クラスのドキュメントに無効にする方法がのっています。

HTTP の Content-Length ヘッダは圧縮されたサイズを返すので、非圧縮データ用のバッファサイズとして getContentLength() で取得した値を使うとエラーになります。InputStream.read() が -1 を返すまで読みようにしてください。

Gingerbread での HTTPS も幾つか改善されています。HttpsURLConnection は IP アドレスを共有する複数の HTTPS host を許可する Servier Name Indication (SNI) に接続を試みます。これは圧縮とセッションチケットを有効にします。コネクションが失敗した場合は、自動でこれらの機能を省いてリトライします。これは HttpsClientConnection が過去のサーバーと互換性を保ちながら最新のサーバーと接続するのに効果的です。

Ice Cream Sandwich では、レスポンスキャッシュが追加されます。インストールされたキャッシュに対して、次の3つのなかのいずれかの方法で HTTP リクエストが完了します。

完全にキャッシュされたレスポンスがローカルストレージから直接提供される。ネットワーク接続がない場合、このようなレスポンスがすぐに返ってくることが必要であるため。
条件付きでキャッシュされたレスポンスはウェブサーバーによって新しさが検証されます。クライアントは "もし機能から変更されていたら /foo.png をください” のようなリクエストを送り、サーバーはアップデートがあるかどうかに応じて 304 Not Modified status かコンテンツを返します。つまり、コンテンツが変わっていなければダウンロードされません！
キャッシュされていないレスポンスは Web から提供されます。これらのレスポンスは後でレスポンスキャッシュに保存されます。

HTTP レスポンスのキャッシュをサポートしている端末で有効にするにはリフレクションを使います。例えば、以前のリリースに影響を与えずに、Ice Create Sandwich の端末でキャッシュ機能を有効にするには次のようにします。

private void enableHttpResponseCache() {    try {        long httpCacheSize = 10 * 1024 * 1024; // 10 MiB        File httpCacheDir = new File(getCacheDir(), "http");        Class.forName("android.net.http.HttpResponseCache")            .getMethod("install", File.class, long.class)            .invoke(null, httpCacheDir, httpCacheSize);    } catch (Exception httpResponseCacheNotAvailable) {    }}

もちろん、HTTP レスポンスにキャッシュヘッダをセットするよう Web server を設定する必要があります。

Which client is best?どっちのクライアントがいい？

Eclair と Froyo では Apache HTTP client のほうがバグがすくないので、こちらがベストです。

Gingerbread 以降では、HttpURLConnection がベストです。API がシンプルでサイズも小さいので Android に適しています。Transparent compression とレスポンスキャッシュはネットワークの利用を減らし、速度やバッテリーのもちを改善します。

---

# さらっと Ice Cream Sandwich のことが書かれてたね。

PreferenceActivity の CheckBox マークを変える

2011-10-04T12:55:00.002+09:00

PreferenceActivity の各UI は Android のフレームワークの theme.xml に定義されています。

/frameworks/base/core/res/res/values/themes.xml

    194         <!-- Preference styles -->    195         <item name="preferenceScreenStyle">@android:style/Preference.PreferenceScreen</item>    196         <item name="preferenceCategoryStyle">@android:style/Preference.Category</item>    197         <item name="preferenceStyle">@android:style/Preference</item>    198         <item name="preferenceInformationStyle">@android:style/Preference.Information</item>    199         <item name="checkBoxPreferenceStyle">@android:style/Preference.CheckBoxPreference</item>    200         <item name="yesNoPreferenceStyle">@android:style/Preference.DialogPreference.YesNoPreference</item>    201         <item name="dialogPreferenceStyle">@android:style/Preference.DialogPreference</item>    202         <item name="editTextPreferenceStyle">@android:style/Preference.DialogPreference.EditTextPreference</item>    203         <item name="ringtonePreferenceStyle">@android:style/Preference.RingtonePreference</item>    204         <item name="preferenceLayoutChild">@android:layout/preference_child</item>

ここをそれぞれオリジナルテーマに置き換えればOK

もともとはこうなってる

/frameworks/base/core/res/res/values/styles.xml

    769     <!-- Preference Styles -->    770     771     <style name="Preference">    772         <item name="android:layout">@android:layout/preference</item>    773     </style>    774         775     <style name="Preference.Information">    776         <item name="android:layout">@android:layout/preference_information</item>    777         <item name="android:enabled">false</item>    778         <item name="android:shouldDisableView">false</item>    779     </style>    780         781     <style name="Preference.Category">    782         <item name="android:layout">@android:layout/preference_category</item>    783         <!-- The title should not dim if the category is disabled, instead only the preference children should dim. -->    784         <item name="android:shouldDisableView">false</item>    785         <item name="android:selectable">false</item>    786     </style>    787         788     <style name="Preference.CheckBoxPreference">    789         <item name="android:widgetLayout">@android:layout/preference_widget_checkbox</item>    790     </style>    791         792     <style name="Preference.PreferenceScreen">    793     </style>    794     795     <style name="Preference.DialogPreference">    796         <item name="android:positiveButtonText">@android:string/ok</item>    797         <item name="android:negativeButtonText">@android:string/cancel</item>    798         <item name="android:widgetLayout">@android:layout/preference_dialog</item>    799     </style>    800         801     <style name="Preference.DialogPreference.YesNoPreference">    802         <item name="android:positiveButtonText">@android:string/yes</item>    803         <item name="android:negativeButtonText">@android:string/no</item>    804     </style>    805         806     <style name="Preference.DialogPreference.EditTextPreference">    807         <item name="android:dialogLayout">@android:layout/preference_dialog_edittext</item>    808     </style>    809         810     <style name="Preference.RingtonePreference">    811         <item name="android:ringtoneType">ringtone</item>    812         <item name="android:showSilent">true</item>    813         <item name="android:showDefault">true</item>    814         <item name="android:widgetLayout">@android:layout/preference_dialog</item>    815     </style>

これを置き換え。

android:widgetLayout というのが左側に配置される部品（チェックボックスとか、○に下三角のやつ）

結論。CheckBoxPreference のチェックボックスと EditTextPreference の下三角は変更できる。
ただし、EditTextPreference のダイアログのレイアウトは変更できたけど、レイアウトファイル内の @+android:id/edittext_container が public ではないため、入力ボックスがでなくなっちゃうのでダメだった。

PreferenceDialog を継承したクラスを作ったほうが早そう。

res/xml/prefs.xml

<?xml version="1.0" encoding="utf-8"?><PreferenceScreen xmlns:android="http://schemas.android.com/apk/res/android">    <PreferenceCategory android:title="Setting">        <CheckBoxPreference             android:key="checkbox_value"            android:title="Setting1"             android:summary="sample of checkbox setting" />        <EditTextPreference             android:key="edittext_value"            android:title="Setting2"             android:summary="sample of edittext setting"            android:dialogTitle="Setting edittext"            android:dialogMessage="please set values" />    </PreferenceCategory></PreferenceScreen>

res/values/styles.xml

<?xml version="1.0" encoding="utf-8"?><resources>    <style name="CustomTheme" parent="@android:style/Theme.Light">        <item name="android:windowBackground">@color/window_bg</item>        <item name="android:colorBackground">@color/window_bg</item>        <item name="android:checkBoxPreferenceStyle">@style/CustomCheckBoxPreference</item>        <item name="android:editTextPreferenceStyle">@style/CustomDialogPreference.CustomEditTextPreference        </item>    </style>    <style name="CustomCheckBoxPreference">        <item name="android:widgetLayout">@layout/preference_widget_checkbox</item>    </style>    <style name="CustomDialogPreference.CustomEditTextPreference">        <item name="android:dialogLayout">@layout/preference_dialog_edittext</item>    </style>    <style name="CustomDialogPreference">        <item name="android:positiveButtonText">@android:string/ok</item>        <item name="android:negativeButtonText">@android:string/cancel</item>        <item name="android:widgetLayout">@layout/preference_dialog</item>    </style>    <style name="CustomDialogPreference.YesNoPreference">        <item name="android:positiveButtonText">@android:string/yes</item>        <item name="android:negativeButtonText">@android:string/no</item>    </style></resources>

res/layout/preference_widget_checkbox.xml

<?xml version="1.0" encoding="utf-8"?><CheckBox xmlns:android="http://schemas.android.com/apk/res/android"    android:id="@+android:id/checkbox"     android:layout_width="wrap_content"    android:layout_height="wrap_content"    android:layout_marginRight="4dip"    android:layout_gravity="center_vertical"    android:button="@drawable/btn_check"    android:focusable="false"    android:clickable="false" />

res/layoutpreference_dialog.xml

<?xml version="1.0" encoding="utf-8"?><ImageView xmlns:android="http://schemas.android.com/apk/res/android"     android:layout_width="wrap_content"     android:layout_height="wrap_content"     android:layout_marginRight="6dip"     android:layout_marginTop="@dimen/margin_check"     android:layout_marginLeft="@dimen/margin_check"     android:layout_marginBottom="@dimen/margin_check"     android:layout_gravity="center_vertical"     android:background="@drawable/btn_circle"     android:src="@drawable/ic_btn_round_more"     android:scaleType="center"      />

res/layoutpreference_dialog_edittext.xml

<?xml version="1.0" encoding="utf-8"?><ScrollView xmlns:android="http://schemas.android.com/apk/res/android"    android:layout_width="fill_parent"    android:layout_height="fill_parent">    <LinearLayout        android:id="@*android:id/edittext_container"        android:layout_width="fill_parent"        android:layout_height="wrap_content"        android:padding="5dip"        android:orientation="vertical">        <TextView             android:id="@android:id/message"            style="?android:attr/textAppearanceMedium"            android:layout_width="fill_parent"            android:layout_height="wrap_content"            android:textColor="@color/color2" />                </LinearLayout></ScrollView>

res/values/dimens.xml

<?xml version="1.0" encoding="utf-8"?><resources>    <dimen name="size_check">32dip</dimen>    <dimen name="size_more">32dip</dimen>    <dimen name="size_radio">32dip</dimen>    <dimen name="margin_check">3dip</dimen>    <dimen name="size_circle">14dip</dimen></resources>

res/values/colors.xml

<?xml version="1.0" encoding="utf-8"?><resources>    <color name="color1">#FDF3DE</color>    <color name="color2">#9C0C0A</color>    <color name="color3">#E88833</color>    <color name="color4">#8F6031</color>    <color name="color5">#3B3013</color>    <color name="color6">#690806</color>    <color name="color7">#dfd3d0</color>    <color name="window_bg">@color/color1</color>    <color name="component_frame_normal">@color/color3</color>    <color name="component_frame_pressed">@color/color2</color>    <color name="component_frame_pressed_top">@color/color2</color>    <color name="component_frame_pressed_bottom">@color/color6</color>    <color name="component_frame_disabled">@color/color7</color>    <color name="component_text_normal">@color/color6</color>    <color name="component_text_pressed">@color/color1</color>    <color name="component_button_top">#fff</color>    <color name="component_button_bottom">@color/color7</color></resources>

res/drawable/btn_check_bg.xml

<?xml version="1.0" encoding="utf-8"?><shape xmlns:android="http://schemas.android.com/apk/res/android">    <padding android:left="38dip" android:right="0dip" />    <solid android:color="#0000" /></shape>

res/drawable/btn_bg.xml

<?xml version="1.0" encoding="utf-8"?><selector xmlns:android="http://schemas.android.com/apk/res/android">    <item android:state_checked="true" android:state_pressed="true"        android:state_enabled="true">        <layer-list>            <item android:top="@dimen/margin_check" android:bottom="@dimen/margin_check"                android:left="@dimen/margin_check" android:right="@dimen/margin_check">                <shape android:shape="rectangle">                    <corners android:radius="5dip" />                    <gradient android:angle="270"                        android:startColor="@color/component_frame_pressed_top"                        android:endColor="@color/component_frame_pressed_bottom" />                    <size android:width="@dimen/size_check"                        android:height="@dimen/size_check" />                    <stroke android:width="2dip"                        android:color="@color/component_frame_pressed" />                </shape>            </item>            <item android:top="10dip" android:bottom="10dip"                android:left="8dip" android:right="8dip"                android:drawable="@drawable/check_on" />        </layer-list>    </item>    <item android:state_checked="false" android:state_pressed="true"        android:state_enabled="true">        <layer-list>            <item android:top="@dimen/margin_check" android:bottom="@dimen/margin_check"                android:left="@dimen/margin_check" android:right="@dimen/margin_check">                <shape android:shape="rectangle">                    <corners android:radius="5dip" />                    <gradient android:angle="270"                        android:startColor="@color/component_frame_pressed_top"                        android:endColor="@color/component_frame_pressed_bottom" />                    <size android:width="@dimen/size_check"                        android:height="@dimen/size_check" />                    <stroke android:width="2dip"                        android:color="@color/component_frame_pressed" />                </shape>            </item>            <item android:top="10dip" android:bottom="10dip"                android:left="8dip" android:right="8dip"                android:drawable="@drawable/check_off" />        </layer-list>    </item>    <item android:state_checked="true" android:state_focused="true"        android:state_enabled="true">        <layer-list>            <item android:top="@dimen/margin_check" android:bottom="@dimen/margin_check"                android:left="@dimen/margin_check" android:right="@dimen/margin_check">                <shape android:shape="rectangle">                    <corners android:radius="5dip" />                    <gradient android:angle="90"                        android:startColor="#ffffff" android:endColor="#fefefe" />                    <size android:width="@dimen/size_check"                        android:height="@dimen/size_check" />                    <stroke android:width="2dip"                        android:color="@color/component_frame_pressed" />                </shape>            </item>            <item android:top="10dip" android:bottom="10dip"                android:left="8dip" android:right="8dip"                android:drawable="@drawable/check_on" />        </layer-list>    </item>    <item android:state_checked="false" android:state_focused="true"        android:state_enabled="true">        <layer-list>            <item android:top="@dimen/margin_check" android:bottom="@dimen/margin_check"                android:left="@dimen/margin_check" android:right="@dimen/margin_check">                <shape android:shape="rectangle">                    <corners android:radius="5dip" />                    <gradient android:angle="90"                        android:startColor="#ffffff" android:endColor="#fefefe" />                    <size android:width="@dimen/size_check"                        android:height="@dimen/size_check" />                    <stroke android:width="2dip"                        android:color="@color/component_frame_pressed" />                </shape>            </item>            <item android:top="10dip" android:bottom="10dip"                android:left="8dip" android:right="8dip"                android:drawable="@drawable/check_off" />        </layer-list>    </item>    <item android:state_checked="false" android:state_enabled="true">        <layer-list>            <item android:top="@dimen/margin_check" android:bottom="@dimen/margin_check"                android:left="@dimen/margin_check" android:right="@dimen/margin_check">                <shape android:shape="rectangle">                    <corners android:radius="5dip" />                    <gradient android:angle="90"                        android:startColor="#ffffff" android:endColor="#fefefe" />                    <size android:width="@dimen/size_check"                        android:height="@dimen/size_check" />                    <stroke android:width="2dip"                        android:color="@color/component_frame_normal" />                </shape>            </item>            <item android:top="10dip" android:bottom="10dip"                android:left="8dip" android:right="8dip"                android:drawable="@drawable/check_off" />        </layer-list>    </item>    <item android:state_checked="true" android:state_enabled="true">        <layer-list>            <item android:top="@dimen/margin_check" android:bottom="@dimen/margin_check"                android:left="@dimen/margin_check" android:right="@dimen/margin_check">                <shape android:shape="rectangle">                    <corners android:radius="5dip" />                    <gradient android:angle="90"                        android:startColor="#ffffff" android:endColor="#fefefe" />                    <size android:width="@dimen/size_check"                        android:height="@dimen/size_check" />                    <stroke android:width="2dip"                        android:color="@color/component_frame_normal" />                </shape>            </item>            <item android:top="10dip" android:bottom="10dip"                android:left="8dip" android:right="8dip"                android:drawable="@drawable/check_on" />        </layer-list>    </item>    <!-- Disabled states -->    <item>        <layer-list>            <item android:top="@dimen/margin_check" android:bottom="@dimen/margin_check"                android:left="@dimen/margin_check" android:right="@dimen/margin_check">                <shape android:shape="rectangle">                    <corners android:radius="5dip" />                    <gradient android:angle="90"                        android:startColor="#ffffff" android:endColor="#fefefe" />                    <size android:width="@dimen/size_check"                        android:height="@dimen/size_check" />                    <stroke android:width="2dip"                        android:color="@color/component_frame_disabled" />                </shape>            </item>            <item android:top="10dip" android:bottom="10dip"                android:left="8dip" android:right="8dip"                android:drawable="@drawable/check_off" />        </layer-list>    </item></selector>

res/drawable/btn_circle.xml

<?xml version="1.0" encoding="utf-8"?><selector xmlns:android="http://schemas.android.com/apk/res/android">    <item android:state_enabled="true">        <shape android:shape="ring" android:useLevel="false"            android:innerRadius="0dip" android:thickness="@dimen/size_circle">            <size android:width="@dimen/size_check" android:height="@dimen/size_check" />            <stroke android:width="2dip"                android:color="@color/component_frame_normal" />            <solid android:color="#fff" />        </shape>    </item>    <item>        <shape android:shape="ring" android:useLevel="false"            android:innerRadius="0dip" android:thickness="@dimen/size_circle">            <size android:width="@dimen/size_check" android:height="@dimen/size_check" />            <stroke android:width="2dip"                android:color="@color/component_frame_disabled" />            <solid android:color="#fff" />        </shape>    </item></selector>

ic_btn_round_more.xml は SDK プラットフォームのリソースのものを利用。

Android　AsyncQueryHandler を使う

2011-10-04T10:56:00.001+09:00

UI スレッド上で getContentResolver().query() とかをすると、処理が重たい場合にスレッドをブロックしてしまって ANR になることもあるので、別スレッドで非同期に query() するための AsyncQueryHandler というクラスがあります。

AsyncQueryHandler は abstract クラスなので、継承したクラスを作って、onQueryComplete() や onQueryInsertComplete() を Override し、ここで Adapter に Cursor をセットします。
こんな感じで使います。

public class AsyncQueryHandlerSampleActivity extends ListActivity {    private static final String[] PHONE_PROJECTION = new String[] {        Phone._ID,        Phone.TYPE,        Phone.NUMBER    };    private static final int COLUMN_TYPE = 1;    private static final int[] COLOR_LIST = new int[] {        Color.parseColor("#002A42"),        Color.parseColor("#3DC3EA"),        Color.parseColor("#99417B"),        Color.parseColor("#F2AE30"),        Color.parseColor("#F2D338"),    };        public class CustomAsyncQueryHandler extends AsyncQueryHandler {        public CustomAsyncQueryHandler(ContentResolver cr) {            super(cr);        }                @Override        protected void onQueryComplete(int token, Object cookie, Cursor cursor) {            super.onQueryComplete(token, cookie, cursor);                        SimpleCursorAdapter adapter = new SimpleCursorAdapter(                    AsyncQueryHandlerSampleActivity.this,                    android.R.layout.simple_list_item_2,                     cursor,                    new String[] { Phone.TYPE, Phone.NUMBER },                    new int[] { android.R.id.text1, android.R.id.text2 });                        adapter.setViewBinder(new SimpleCursorAdapter.ViewBinder() {                                public boolean setViewValue(View view, Cursor cursor, int columnIndex) {                    if (columnIndex == COLUMN_TYPE) {                        int type = cursor.getInt(COLUMN_TYPE);                        String text = (String) Phone.getTypeLabel(getResources(), type, null);                                                ((TextView) view).setText(text);                        ((TextView) view).setTextColor(COLOR_LIST[type % 5]);                        return true;                    }                    return false;                }            });            setListAdapter(adapter);        }            }        @Override    protected void onCreate(Bundle savedInstanceState) {        super.onCreate(savedInstanceState);                CustomAsyncQueryHandler asyncQueryHandler = new CustomAsyncQueryHandler(getContentResolver());        asyncQueryHandler.startQuery(                0, // token                null, // cookie                Phone.CONTENT_URI,                PHONE_PROJECTION,   // projection                null,   // selection                null,   // selectionArgs                null    // orderBy                );    }}

Android　SimpleCursorAdapter で ViewBinder を使う

2011-10-04T09:59:00.000+09:00

SimpleAdapter で ViewBinder を使う方法は Android Layout CookBook に書いたので、SimpleCursorAdapter で ViewBinder を使う方法を紹介します。

SimpleCursorAdapter.ViewBinder の setViewValue() メソッドでは第２引数としてその行の Cursor と、第３引数として列の columnIndex が渡されるので、これを使ってそのカラムに表示したいデータを取得して、色を変えたり文字の大きさを変えたり表示するデータを別のテーブルからとってきたりして、対象の View にセットします。

public class SimpleCursorAdapterSampleActivity extends ListActivity {    private static final String[] PHONE_PROJECTION = new String[] {        Phone._ID,        Phone.TYPE,        Phone.NUMBER    };    private static final int COLUMN_TYPE = 1;    private static final int[] COLOR_LIST = new int[] {        Color.parseColor("#002A42"),        Color.parseColor("#3DC3EA"),        Color.parseColor("#99417B"),        Color.parseColor("#F2AE30"),        Color.parseColor("#F2D338"),    };        @Override    protected void onCreate(Bundle savedInstanceState) {        super.onCreate(savedInstanceState);        Cursor c = getContentResolver().query(                Phone.CONTENT_URI,                PHONE_PROJECTION,   // projection                null,   // selection                null,   // selectionArgs                null    // orderBy                );        startManagingCursor(c);        SimpleCursorAdapter adapter = new SimpleCursorAdapter(this,                android.R.layout.simple_list_item_2,                 c,                new String[] { Phone.TYPE, Phone.NUMBER },                new int[] { android.R.id.text1, android.R.id.text2 });                adapter.setViewBinder(new SimpleCursorAdapter.ViewBinder() {                        public boolean setViewValue(View view, Cursor cursor, int columnIndex) {                if (columnIndex == COLUMN_TYPE) {                    int type = cursor.getInt(COLUMN_TYPE);                    String text = (String) Phone.getTypeLabel(getResources(), type, null);                                        ((TextView) view).setText(text);                    ((TextView) view).setTextColor(COLOR_LIST[type % 5]);                    return true;                }                return false;            }        });        setListAdapter(adapter);    }}

Sharp ハッカソンで作ったアプリを公開しました。

2011-09-30T22:13:00.001+09:00

子供向けのホームアプリ（正確には、自分が普段使っているスマホでときどき子供にゲームとかさせる親向け）です。

Pakaroid - Android Market

「子供にスマートフォンのアプリで遊ばせたいけど、関係ないアプリを勝手に起動させたくない。」
「子供用のアプリに簡単にアクセスしたい。」
「子供でも使えるようなホームアプリに、アプリをまとめておきたい。」

そのためにどういうアプリがいいかな、ということで、

・ホームから子供が自分でアプリを起動できる

　　- Pakaroid（パカロイド）というゆるキャラをタップして
　　　アプリ一覧を表示（しかもキャラがでかいからタップしやすい）
　　- 全体的にポップな感じ
　　- アニメーションをつけて楽しく

・関係ない操作をさせない

　　- メニューキーのロングタップや検索キーのロングタップを無効化
　　- 設定アプリなどへの入口であるダイアログの表示方法を
　　　　メニューキーをタップ
　　　　メニューキーをロングタップ
　　　　メニューキーをタップしながらボリュームアップボタンを押す
　　から選択できる
　　（メニューキーをタップしながらボリュームアップボタンを押す、なら
　　　知らなければ子供が誤って押しちゃうことはまずないだろうと）

　　- もし誤ってダイアログを表示しちゃっても10秒で自動的に
　　　ダイアログを閉じる

・関係ないアプリを起動させない

　　- 選択したアプリだけを一覧に表示

などの機能をいれました。

他にも

　- バッテリーの残量に応じて草の量が変わる
　- 充電ケーブルをつなぐと雨が降るなど

など、ちょっとしたところに凝ってます。

ぜひ使ってみてください！

Team Pakaroid のメンバーです。
- Yuki Anzai (@yanzm)
- Rin Yano (@yanorin)
- Kazuya Matsubara (@Toro_kun)
- Masahide Fukagawa (@PUKa)

---

ここからは広島旅行の思い出ということで。
7月23日

飛行機にのって

空港からバスで白市駅まで行き、

白市駅から電車で八本松駅まで行き、
八本松駅からタクシーで工場まで行きました。
タクシーの運転手さんの話だと、昔、枝が八本あるように見える松があったから八本松駅なんだそうです。（でもちょっと記憶があいまい、、、）

1階に携帯電話の展示コーナーがあって、IS03 の三枚おろしみたいなのとかありました。
面白かった。

ハッカソンシールもらいました。

お弁当が豪華でした。おいしかったです。

ちーむぱかろいどのアイディアまとめとかの残骸

帰りの空港で時間があったので矢野さんと女二人でビール飲んできました。
ごちそうさまでした！

Android　SharedPreference の実体ファイルの場所

2011-09-21T17:04:00.001+09:00

ContextImpl.java をみると場所が書いてる

    333     public File getSharedPrefsFile(String name) {    334         return makeFilename(getPreferencesDir(), name + ".xml");    335     }

    391     private File getPreferencesDir() {    392         synchronized (mSync) {    393             if (mPreferencesDir == null) {    394                 mPreferencesDir = new File(getDataDirFile(), "shared_prefs");    395             }    396             return mPreferencesDir;    397         }    398     }

ということで、

　/data/data/[package_name]/shared_prefs/[name].xml

にあります。
エミュレータなら File Explorer や adb shell から見れます。

Android　Scroll の終端のピカッを消す

2011-09-20T19:26:00.000+09:00

Android 2.3 (Gingergread) からスクロールが終端までいくと、（デフォルトでは）オレンジ色にピカッと光ります。

これはこれでいいんですけど、デザインに合わないときもあります。

このピカッがどこで設定されているか調べると
AbsListView の setOverScrollMode() でした。
ここをみると、OverScrollMode が OVER_SCROLL_NEVER であれば、ピカッがなしになることがわかります。

    650     public void setOverScrollMode(int mode) {    651         if (mode != OVER_SCROLL_NEVER) {    652             if (mEdgeGlowTop == null) {    653                 final Resources res = getContext().getResources();    654                 final Drawable edge = res.getDrawable(R.drawable.overscroll_edge);    655                 final Drawable glow = res.getDrawable(R.drawable.overscroll_glow);    656                 mEdgeGlowTop = new EdgeGlow(edge, glow);    657                 mEdgeGlowBottom = new EdgeGlow(edge, glow);    658             }    659         } else {    660             mEdgeGlowTop = null;    661             mEdgeGlowBottom = null;    662         }    663         super.setOverScrollMode(mode);    664     }

ということで、ピカッとさせたくない場合はmListView.setOverScrollMode(View.OVER_SCROLL_NEVER);とすれば OK。

Android　コードからステータスバーを開く

2011-09-15T22:33:00.000+09:00

Launcher アプリにはステータスバーを開くメニューがある。

該当部分がこれ

public static final String STATUS_BAR_SERVICE = "statusbar";...private void showNotifications() {    final StatusBarManager statusBar = (StatusBarManager) getSystemService(STATUS_BAR_SERVICE);    if (statusBar != null) {        statusBar.expand();   }}

StatusBarManager を使う。が、StatusBarManager は @hide である。

よって、これを使いたい場合の方法は、@hide を含む android.jar を使ってアプリを作る or リフレクションする。

例えばリフレクションするならこんな感じ

private void showNotifications() {            try {         Object service = getSystemService("statusbar");         Class clazz = Class.forName("android.app.StatusBarManager");         Method method = clazz.getMethod("expand");         method.invoke(service);      } catch (Exception e) {          e.printStackTrace();     } }

ちなみに、AndroidManifest.xml で uses-permission に android.permission.EXPAND_STATUS_BAR が必要。

GWT で SimpleDateFormat がつかえない

2011-09-15T16:38:00.000+09:00

java.text.* をサポートしてないらしい。

同じ機能の DateTimeFormat が用意されているので、こっちを使うべし。めもめも。

Android　Menu の背景を変えるその2

2011-09-11T16:04:00.000+09:00

昔は Menu の背景を簡単に変えることができなかったんです。それで Y.A.M の雑記帳 Android　Menu の背景を変えるというエントリを書いたりしていたのですが、今は style から指定できるようになっているので紹介します。

<?xml version="1.0" encoding="utf-8"?><resources>  <style name="CustomTheme.Light" parent="@android:style/Theme.Light">    ...<!-- パネル(Menu) の背景 -->    <item name="android:panelBackground">@color/menu_bg</item>    <item name="android:panelFullBackground">@color/menu_bg</item>  </style>...</resources>

のようにして、このテーマを AndroidManifest.xml の application や activity タグの android:theme 属性で指定すれば OK です。

ちなみに、できる限り style を使ってカスタマイズする勉強会を去年蒲郡でやりました。その資料にいろいろ書きましたので、ここにも貼っておきます。（Menu の背景を変える部分の書いてます）

↑ Google Docs Viewer 使ってみました。

Android アプリのサイズ関係めも

2011-09-11T14:14:00.000+09:00

1. apk ファイルサイズの上限
　・50MB app package *

2. Android Market に archive できるサイズ
　・ Support up to 4 GB *
　・ Up to two 2GB archives *

3. asset フォルダ
　・ 1ファイルの上限は 1M
　・例えば、asset 内のDBファイルを初回起動時にデバイスの
　　 sqlite にコピーする場合など、ファイルが 1M を超えるなら
　　分割する必要がある。

4. Internal Storage の容量 (/data/data/(app_name)/フォルダ以下)
　・端末の内部メモリの空き容量 - α ？

　* Google I/O 2011 の Android Merket for Developers セッションで紹介されている Android Market での制限

Android　NumberPicker を拡張して ItemPicker を作ってみた。

2011-09-11T11:39:00.000+09:00

Android には日時を設定するための DatePicker, 時刻を設定するための TimePicker が用意されています。これらの Picker の元になっているのが NumberPicker です。ちなみに NumberPicker は非公開クラスになっています。

この NumberPicker のレイアウトでは、 + ボタンが上にあるために、+ ボタンを押している間、設定している値が指で見えなくなってしまいます。そこで、この NumberPicker を元にして + ボタンと - ボタンが設定値の左右にある Picker を作ってみました。

ItemPicker at yanzm/yanzm-s-Custom-View-Project - GitHub

ついでに、ボタンと入力部分の画像リソースと、選択範囲および選択アイテムを attribute として指定できるようにしました。

こんな感じで、XML から値の設定などが全部できます。

<LinearLayout     xmlns:android="http://schemas.android.com/apk/res/android"    xmlns:custom="http://schemas.android.com/apk/res/yanzm.products.customview.itempicker"        android:orientation="vertical"    android:layout_width="fill_parent"    android:layout_height="fill_parent"    >    <DatePicker         android:id="@+id/datePicker1"         android:layout_width="wrap_content"         android:layout_height="wrap_content"/>        <TimePicker         android:id="@+id/timePicker1"         android:layout_width="wrap_content"         android:layout_height="wrap_content"/>    <yanzm.products.customview.itempicker.ItemPicker        android:layout_width="180dip"         android:layout_height="wrap_content"        android:focusable="true"        android:focusableInTouchMode="true"        android:text="+"        custom:start="0"        custom:end="10"        custom:current="2"                 />    <yanzm.products.customview.itempicker.ItemPicker        android:layout_width="240dip"         android:layout_height="wrap_content"        android:focusable="true"        android:focusableInTouchMode="true"        android:text="+"        custom:start="1"        custom:end="9"        custom:current="2"           custom:speed="100"        custom:displayedValue="@array/color_names"              />            <yanzm.products.customview.itempicker.ItemPicker        android:layout_width="240dip"         android:layout_height="wrap_content"        android:focusable="true"        android:focusableInTouchMode="true"        android:text="+"        custom:start="1"        custom:end="9"        custom:current="4"        custom:incrementBackground="@drawable/picker_bg"        custom:decrementBackground="@drawable/picker_bg"        custom:editTextBackground="@drawable/input_bg"        custom:displayedValue="@array/color_names"              />                         </LinearLayout>

attribute として用意したのは

incrementSrc : 増加ボタン (ImageButton) の画像リソース
decrementSrc : 減少ボタン (ImageButton) の画像リソース
incrementBackground : 増加ボタン (ImageButton) の背景画像リソース
decrementBackground : 減少ボタン (ImageButton) の背景画像リソース
editTextBackground : 設定値 (EditText) の背景画像リソース
start : 最少値 (int)
end : 最大値 (int)
current : 現在の値 (int)
speed : ボタン長押し時の自動増加／減少の切り替え速度
displayedValue : 数字ではなく文字を設定値にする場合の文字列配列。最小値が index 0 にあたる

Android 3.2 でサポートされた Zoom to fill screen 機能

2011-08-19T10:31:00.009+09:00

Android 3.2 から、Android 3.0 向けではなくかつ xlarge をサポートしていないアプリを起動すると、System bar に画面のストレッチみたいなアイコンがでます。このアイコンをタップすると、Stretch to fill screen と Zoom to fill screen のいずれをか選ぶことができます。

こんなやつ

詳しくは
Android Developers Blog: New Mode for Apps on Large Screens -

とか

Declaring Tablet Layouts for Android 3.2 | Supporting Multiple Screens | Android Developers -

にありますが、まとめると

■ Stretch to fill screen

通常のモード。Android の多解像度対応のルールに従って画面のレイアウトが決まる（リサイズされる）。

画像やレイアウトなどは、その解像度＆画面サイズの識別子がついたものが使われる (= drawable-hdpi, とか layout-xlarge が使われる）

■ Zoom to fill screen

アプリを normal/mdpi スクリーン（だいたい 320dp x 480dp）に描画した場合のものを画面に拡大して表示する。

電話に描画したものを 200 % ズームしたと想像すればよい。

画像やレイアウトなどは、normal /mdpi の場合のものが使われる (= drawable-hdpi があったとしても、drawable-mdpi や layout-normal が使われる）ので、画素化（pixelated）された感じになる。ピクセルが目立つというかがたがたしてる感じかな。

■ Zoom to fill screen が出ない条件

　・ AndroidManifest.xml で android:minSdkVersion に
　　 11 以上を指定している
　・ AndroidManifest.xml で android:targetSdkVersion に
　　 11 以上を指定している
　・ AndroidManifest.xml で以下を指定している



<manifest ... >

    <supports-screens android:xlargeScreens="true" />

    ...

</manifest>

　のどれか1つでも満たしている場合、Zoom to fill screen は出ない
　（＝ System bar に画像のストレッチみたいなアイコンがでない）

■ Zoom to fill screen が出る条件

　Zoom to fill screen が出ない条件を満たしていない場合

左が Stretch to fill screen、右が Zoom to fill screen

# Honeycomb で画面がすっかすかーになってしまった
# アプリにはいいモードですね。
# normal/mdpi の拡大なのでどのくらいピクセル化が
# 目立つのかちょっと気になるなぁ。

Android　FLAG_DISMISS_KEYGUARD と FLAG_SHOW_WHEN_LOCKED を使う

2011-08-18T15:43:00.006+09:00

KeyguardManager の exitKeyguardSecurely() メソッド及び newKeyguardLock() メソッドと、サブクラスの KeyguardManager.KeyguardLock は deprecated になっています。

これらのメソッドの代わりに WindowManager.LayoutParams クラスの FLAG_DISMISS_KEYGUARD と FLAG_SHOW_WHEN_LOCKED を使うことが推奨されています。

■ FLAG_DISMISS_KEYGUARD

　このフラグが設定されると、secure lock keyguard でない場合、ウィンドウによって keyguard が表示されなくなる。security が必要でない keyguard では、ユーザーが他のウィンドウに移動したときに再表示されない（反対に FLAG_SHOW_WHEN_LOCKED では、secure、non-secure 両方の key guard を一時的に隠して、ユーザーがこれらを隠さない設定の他の UI に移動したときに再表示する。

　FLAG_SHOW_WHEN_LOCKED が同時に設定されていないと、keyguard が現在アクティブでユーザーより secure な場合（＝ unlock pattern を要求している場合）、ウィンドウを表示する前に lock pattern を確認する必要がある。

■ FLAG_SHOW_WHEN_LOCKED

　スクリーンがロックされたときに Windows に表示させるための特別なフラグで、このフラグをセットすると、アプリケーションウィンドウが key guard や他のロックスクリーンよりも優先される。
　
　FLAG_KEEP_SCREEN_ON と組み合わせて使うことで、画面をオンした後、 key guard を表示する前に直接ウィンドウを表示できる。
　
　FLAG_DISMISS_KEYGUARD と組み合わせて使うことで、自動で non-secure keyguards を表示させないようにできる。このフラグは一番上の full-screen window にのみ適用される。

関連するフラグ

■ FLAG_ALLOW_LOCK_WHILE_SCREEN_ON

■ FLAG_KEEP_SCREEN_ON



public class KeyguardSampleActivity extends Activity {



    @Override

    public void onCreate(Bundle savedInstanceState) {

        super.onCreate(savedInstanceState);

        setContentView(R.layout.main);

        

        Window window = getWindow();

        

        // lock pattern を設定していても、

        // このアプリ起動中は画面オン時にロックはでない

        // 別のアプリやホームに移動するときにロックがでる

        window.setFlags(WindowManager.LayoutParams.FLAG_SHOW_WHEN_LOCKED, 

                WindowManager.LayoutParams.FLAG_SHOW_WHEN_LOCKED);



        // lock pattern を設定していない場合、

        // このアプリ起動中は画面オン時にロックはでない

        window.setFlags(WindowManager.LayoutParams.FLAG_DISMISS_KEYGUARD, 

                WindowManager.LayoutParams.FLAG_DISMISS_KEYGUARD);

    }

}

■ まとめ

1. lock pattern あり、FLAG_SHOW_WHEN_LOCKED

　このアプリ起動中は画面オン時にロックはでない
　別のアプリやホームに移動するときにロックがでる

2. lock pattern あり、FLAG_DISMISS_KEYGUARD

　普通にロックがでる

3. lock pattern あり、FLAG_SHOW_WHEN_LOCKED, FLAG_DISMISS_KEYGUARD

　このアプリ起動中は画面オン時にロックはでない
　別のアプリやホームに移動するときにロックがでる

4. lock pattern なし、FLAG_SHOW_WHEN_LOCKED

　このアプリ起動中は画面オン時にロックはでない
　別のアプリやホームに移動するときにロックがでる

5. lock pattern なし、FLAG_DISMISS_KEYGUARD

　このアプリ起動中は画面オン時にロックはでない
　別のアプリやホームに移動するときもロックはでない

6. lock pattern なし、FLAG_SHOW_WHEN_LOCKED, FLAG_DISMISS_KEYGUARD

　このアプリ起動中は画面オン時にロックはでない
　別のアプリやホームに移動するときもロックはでない

Android　Keygurad が外されたことを検知する

2011-08-18T15:27:00.004+09:00

ロックを設定している場合、Intent.ACTION_SCREEN_ON だと画面がオンになった状態で通知がくるので、ロックが外れる前に通知がきてしまいます。画面がオンになったあと、ロックが外れた時に通知を受け取るには Intent.ACTION_USER_PRESENT を拾うようにします。



public class UserPresentSampleActivity extends Activity {



    private static final String TAG = "UserPresentSampleActivity";

    

    @Override

    public void onCreate(Bundle savedInstanceState) {

        super.onCreate(savedInstanceState);

        setContentView(R.layout.main);

    }

    

    @Override

    protected void onResume() {

        super.onResume();



        IntentFilter filter = new IntentFilter();

        filter.addAction(Intent.ACTION_USER_PRESENT);

        filter.addAction(Intent.ACTION_SCREEN_ON);

        filter.addAction(Intent.ACTION_SCREEN_OFF);

        registerReceiver(mReceiver, filter);

    };



    @Override

    protected void onPause() {

        super.onPause();

        

        unregisterReceiver(mReceiver);

    };

    

    BroadcastReceiver mReceiver = new BroadcastReceiver() {



        @Override

        public void onReceive(Context context, Intent intent) {

            String action = intent.getAction();



            Log.d(TAG, "mReceiver received : " + action);



            if(action.equals(Intent.ACTION_USER_PRESENT)){

            }

            else if(action.equals(Intent.ACTION_SCREEN_ON)){

            }

            else if(action.equals(Intent.ACTION_SCREEN_OFF)){                

            }

        }

    };    

}



D/UserPresentSampleActivity( 9858): mReceiver received : android.intent.action.SCREEN_ON

D/UserPresentSampleActivity( 9858): mReceiver received : android.intent.action.USER_PRESENT

D/UserPresentSampleActivity( 9858): mReceiver received : android.intent.action.SCREEN_OFF

Android Market　Multiple APK Support

2011-08-17T11:42:00.012+09:00

2011年7月11日から Android Market で Multiple APK がサポートされるようになりました。

詳細は Android Developers のブログ記事
Android Developers Blog: Multiple APK Support in Android Market -

や

Android のドキュメント
Multiple APK Support | Android Developers -

を参照してください。

Android Market の Help Center もあります。

■まとめ

Multiple APK support は Android Market の新しいパブリッシュオプション (つまり、その他の配布プラットフォーム、例えば au one market とか、では使えません）
APK を1つだけ Developer Console からアップしている場合はこれまでと同じ
複数の APK をアップロードしている場合、Android Market は1つのプロダクトの一部として扱う（ = アプリの詳細ページはどのユーザーからも同じ内容になる）
つまり、以下の項目は複数の APK で共通、もしくは合算になる
- アプリの詳細情報（バナーなど、スクリーンショット、ビデオ）
- レーティング
- コメント
- アプリのダウンロード統計
- レビュー
- 購入データ
Multiple APK で分割できる項目
- target API version
  Android Manifest の <uses-sdk> に基づく
  異なる APK レベルのサポートを指定するために、android:minSdkVersion および android:maxSdkVersion 属性の両方を使うことができる
  将来の API バージョンに自動で対応するために、android:maxSdkVersion は指定しないほうがよい
- 画面サイズ（オプションで画面解像度）
  Android Manifest の <supports-screens>; や <compatible-screens> エレメントに基づく
  この2つを同時に使用するべきではない
  可能な限り <supports-screens> だけを使う
- GL texture-compression フォーマット
  Android Manifest の <supports-gl-texture> エレメントに基づく
Multiple APK の利点
- API のバージョンで APK を分割できる (例えば、電話用とタブレット用の APK を分けられる）
- ハードウェア機能のあり・なしで APK を分割できる
- 新しい API がリリースされたときに、それをターゲットにしたバージョンを別 APK で開発できるので、既存のユーザーに影響がない
- 1つの APK で様々な解像度の端末に対応する場合、resource （特に画像）が多くなることで APK サイズが大きくなるが、これを防げる

注意： Multiple APK Support | Android Developers - に
Currently, these are the only device characteristics that Android Market supports for publishing multiple APKs as the same application.
とあるように、
現状では、マルチ APK を同じアプリとして配布するために Android Market がサポートしているのはデバイスの特徴（ハードウェア機能のある・なし）のみのようです。

注意2: 基本的には、1つの APK のサイズが 50M を超えるときだけ Multiple APK をつかって、それ以外はなるべく1つの APK で複数のデバイスコンフィグレーションに対応するべき。そのほうがアップデートがシンプルになるし、開発管理も複雑にならなくてすむ。

　　

Android　TransitionDrawable を使う

2011-08-13T12:38:00.004+09:00

TransitionDrawable は LayerDrawble の拡張で、2つのレイヤーの間をクロスフェードさせることが可能。

主なメソッドは次の3つ

startTransition(int durationMillis)
引数で指定された durationMillis [millisecond] かけて1つ目のレイヤーから2つ目のレイヤーにクロスフェード
reverseTransition(int durationMillis)
引数で指定された durationMillis [millisecond] かけて現在レイヤーからもう一つのレイヤーにクロスフェード
resetTransition()
1つ目のレイヤーを表示

次のコンストラクタで Drawable の配列を渡して生成することもできるし

・TransitionDrawable(Drawable[] layers)

<transition> タグを使って XML で定義することもできる。

例えばこんな感じ



<?xml version="1.0" encoding="utf-8"?>

<transition xmlns:android="http://schemas.android.com/apk/res/android">

    <item android:drawable="@drawable/trash"  />

    <item android:drawable="@drawable/trash2"  />

</transition>



public class TransitionDrawableSampleActivity extends Activity {



    TransitionDrawable mTransitionDrawable;

    

    private static final int TRANSITION_DURATION = 1000;



    @Override

    public void onCreate(Bundle savedInstanceState) {

        super.onCreate(savedInstanceState);

        setContentView(R.layout.main);

        

        ImageView iv = (ImageView)findViewById(R.id.imageview);

        mTransitionDrawable = (TransitionDrawable)iv.getDrawable();

        mTransitionDrawable.setCrossFadeEnabled(false);

    }

    

    public void onResetClick(View v) {

    	mTransitionDrawable.resetTransition();

    }

    

    public void onTransitionClick(View v) {

    	mTransitionDrawable.startTransition(TRANSITION_DURATION);

    }

    

    public void onReverseClick(View v) {

    	mTransitionDrawable.reverseTransition(TRANSITION_DURATION);

    }

}

Android　Spannable を使って文字列の一部を装飾する

2011-08-11T08:24:00.030+09:00

SpannableStringBuilder を使って、文字列の一部を装飾（bold, italic, typeface, color, size) することができます。

こんな感じ。



public class SpannableSampleActivity extends Activity {



 private static StyleSpan sBoldStyleSpan = new StyleSpan(Typeface.BOLD);

 private static TypefaceSpan sSerifTypefaceSpan = new TypefaceSpan("serif");



 @Override

 public void onCreate(Bundle savedInstanceState) {

   super.onCreate(savedInstanceState);

   setContentView(R.layout.main);



   TextAppearanceSpan cyanTextAppearanceSpan =

       new TextAppearanceSpan(this, R.style.MyTextAppearance);



   SpannableStringBuilder sb = new SpannableStringBuilder();

   sb.append(getString(R.string.pretext) + " ");



   int start = sb.length();

   sb.append(getString(R.string.boldtext));

   sb.setSpan(sBoldStyleSpan, start, sb.length(),

       Spannable.SPAN_EXCLUSIVE_EXCLUSIVE);



   sb.append(" " + getString(R.string.posttext) + " ");



   start = sb.length();

   sb.append(getString(R.string.seriftext));

   sb.setSpan(sSerifTypefaceSpan, start, sb.length(),

       Spannable.SPAN_EXCLUSIVE_EXCLUSIVE);



   sb.append(" " + getString(R.string.posttext) + " ");



   start = sb.length();

   sb.append(getString(R.string.cyantext));

   sb.setSpan(cyanTextAppearanceSpan, start, sb.length(),

       Spannable.SPAN_EXCLUSIVE_EXCLUSIVE);



   sb.append(" " + getString(R.string.posttext));



   ((TextView)findViewById(R.id.textview)).setText(sb);

 }

}

res/values/styles.xml

<?xml version="1.0" encoding="utf-8"?>

<resources>

<style name="MyTextAppearance" parent="@android:style/TextAppearance">

 <item name="android:textColor">#00ffff</item>

 <item name="android:textSize">30sp</item>

 <item name="android:textStyle">italic</item>

</style>

</resources>

SpannableStringBuilder には複数の Span が設定可能で、それぞれ setSpan() メソッドで設定できます。

設定されている Span オブジェクトの一覧は getSpans() メソッドで取得でき、特定の Span オブジェクトの設定されている開始位置や終了位置、フラグなどは getSpanStart(), getSpanEnd(), getSpanFlags() で取得できます。 Span を削除する場合は removeSpan() を呼び出します。

SpannalbeStringBuilder の Span 操作

setSpan() の4つ目の引数で、この span の範囲内に文字が挿入されたときにどう振舞うかを指定することができます。指定できるフラグは Spanned に定義されている SPAN_* の定数のうち次の5個です。

SPAN_INCLUSIVE_EXCLUSIVE
SPAN_INCLUSIVE_INCLUSIVE
SPAN_EXCLUSIVE_EXCLUSIVE
SPAN_EXCLUSIVE_INCLUSIVE
SPAN_PARAGRAPH

SpannableStringBuilder の文字列操作

append()
insert()
replace()

など

Span オブジェクトとして指定できるクラスとしていくつかあります。

StyleSpan
bold, italic を指定
TypefaceSpane
"monospace", "serif", "sans-serif" を指定
TextAppearanceSpan
文字の色、サイズ、style、typeface を一致する TextAppearance リソースに設定
AbsoluteSizeSpan
RelativeSizeSpan
ReplacementSpan
ScaleXSpan
SubscriptSpan
SuperscriptSpan

StyleSpan を使うときの注意点として、このスタイルが累積するものなので、例えば bold と italic 両方を別々の span で設定したり、ベースのスタイルが bold で italic の span を呼び出した場合、 bold italic になります。ベーススタイルからのスタイルはオフにすることができません。

コンストラクタの引数でスタイルを設定します。設定できるスタイルは Typeface クラスで定義されている次の4個です。

TypefaceSpane のコンストラクタで指定できる family は次の3個です。

"monospace"
"serif"
"sans-serif"

TextAppearanceSpan には、文字の typeface、大きさ、色を引数で指定する

- public TextAppearanceSpan (String family, int style, int size, ColorStateList color, ColorStateList linkColor)

と、TextAppearance のリソース ID を指定する

- public TextAppearanceSpan (Context context, int appearance)

- public TextAppearanceSpan (Context context, int appearance, int colorList)

があります。

カッコいい時計ウィジェットをリリースしました。

2011-07-31T14:42:00.017+09:00

Band O'clock

複数並べて世界時計のようにしたり

好きなフォントにしてみたり

できます。

ウィジェット本体よりも設定画面にかなりこだわってます。

デフォルトの PreferenceActivity を使って簡単に作ることもできますが、それって使いにくくないですか？

・その設定によってウィジェットがどう変わるのかわからない
・設定をやり直すのに毎回ダイアログを開かないといけない

このあたりを改善したくて、

・設定画面にウィジェットのプレビューをつけて設定によってリアルタイムで変わるように
・複数の選択肢から1つを選ぶのに Spinner を使わない

というポリシーで、こんな感じの画面になってます。
各画面にはフリックで移動できます。

フォントも変えられます。
フォントインポート機能を購入すると、自分の用意した好きなフォントも使うことができます。

色を変えたり

都市名やタイムゾーンを設定できます。

タイムゾーンの設定中もプレビューが隠れないようになってます。

よかったらぜひ使ってみてくださいませ〜。

　　

Android 3.2 Platform

2011-07-31T11:43:00.001+09:00

Android 3.2 Platform

API Level: 13

Android 3.2 へようこそ！

Android 3.2 はユーザーと開発者むけの新しい機能を追加したインクリメンタルプラットフォームリリースです。このセクションでは、新しい機能と developer APIs のオーバービューを紹介します。

開発者は Android SDK のコンポーネントとして Android 3.2 platform をダウンロードできるようになりました。このプラットフォームには Android library と system image, emulator skin などが含まれていますが、外部のライブラリは含まれていません。

Android 3.2 向けの開発とテストを始めるには、Android SDK Manager を使って自分の SDK にプラットフォームをダウンロードします。より詳しい情報は Adding SDK Components を見てください。Android が初めての人は、まず download the SDK Starter Package から始めてください。

リマインダー: すでに Android application を公開している場合、できるだけ早く Android 3.2 上であなたのアプリケーションのテストと最適化をしてください。最新の Android-powered デバイスでベストな体験を提供していることを確認するべきです。そのためにあなたができることについての情報は Optimizing Apps for Android 3.x を見てください。

---
Platform Highlights

New user features

ワイドレンジのタブレット用の最適化
Android 3.2 はワイドレンジのタブレットデバイスでユーザー体験をすばらしいものにするためのシステム全体にわたるさまざまな最適化を含んでいます。
固定サイズのアプリ用ズーム互換性
Android 3.2 は、大画面のデバイス上の固定サイズアプリを見る新しい方法である、compatibility zoom mode (ズーム互換性モード）をサポートします。新しいモードは、タブレットのような大画面サイズ上で動くようにデザインされていない標準の UI ストレッチに代わって pixel-scaled を提供します。ユーザーは、互換性サポートが必要なアプリに対して、システムバーのメニューアイコンから新しいモードにアクセスできます。
SD card からの Media sync
SD card をサポートしているデバイスで、ユーザーはメディアファイルを SD card からそれを使用するアプリへ直接ロードできるようになりました。システムの機能によって、アプリがシステムメディアストアからファイルにアクセスできるようになりました。

New developer features

画面サポートを管理する API の拡張
Android 3.2 は、さまざまな Android-powered device でのアプリケーション UI の管理方法に新しいものを追加した、プラットフォームスクリーンサポート API の拡張を提供します。API は新しいリソース識別子と manifest 属性を含みます。これにより異なるサイズ上でのアプリの表示を、一般的なサイズのカテゴリに頼るよりも正確にコントロールできます。
fixed-sized アプリと、いくつかのスクリーンサイズむけの限定的なサポートをしているアプリに対しては、最も可能性のあるディスプレイを確認してください。プラットフォームは、UI を小さいスクリーン領域に描画して、それをディスプレイの可能な領域に拡大する、新しいズーム互換性モードも提供します。スクリーンサポート API のより詳しい情報とその使い方は以降のセクションをみてください。

---
API Overview

Screens Support APIs

Android 3.2 は新しいスクリーンサポート API を紹介します。これにより異なる画面サイズに渡ってどのようにアプリケーションが表示されるかをより細かくコントロールできます。新しい API は、プラットフォームの一般的なスクリーンサイズモデルを含む既存のスクリーンサポート API 上に作られ、一般的なスクリーンサイズ (large や xlarge) よりも、"dpi" 単位で測定されたサイズ (600dp や 720dp) で指定したスクリーン範囲に正確にターゲットします。

アプリケーションの UI をデザインする際、プラットフォームが提供する抽象化された解像度に頼ることももちろんできます。これはつまり、アプリケーションがさまざまなデバイスの実際のピクセル密度の違いを補う必要がないということです。アプリケーションの UI を横および縦の利用可能な領域によってデザインすることができます。プラットフォームは利用可能な領域の量を新しい3つの特徴で表現します：smallestWidth, width, height

スクリーンの smallestWidth は "dp" 単位での基礎的な最小サイズです。スクリーンの高さおよび幅の短い方です。縦向きのスクリーンでは、smallestWidth は通常横幅に基づき、横向きでは縦幅に基づきます。全ての場合で、smallestWidth は固定の画面特性から導き出され、画面の向きによって値は変化しません。smallestWidth はアプリケーション UI が描画に必要とする最も短い幅（システムによって予約されている領域を含まない）を表すので、アプリケーションにとって重要です。
対照的に、スクリーンの width と height は現在の横および縦のアプリケーションのレイアウトで利用可能な領域（"dp"単位、システムによって予約されている領域を含まない）を表します。width と height はユーザーが画面の向きを縦向きや横向きに変更すると変わります。

新しいスクリーンサポート API は現在の画面の smallestWidth によってアプリケーションの UI を管理するようデザインされています。さらに必要に応じて、現在の横幅と縦幅によっても UI を管理することができます。これらの目的のため API は次のツールを提供します：

最小 smallestWidth, width, height にレイアウトや他のリソースをターゲットするための新しい識別子
アプリの互換性を持つ範囲の最大スクリーンサイズを指定する新しいマニフェスト属性

加えて、アプリケーションはプラットフォームの以前のバージョンの起動時のリソース読み込みや UI の管理やシステムへの問い合わせもそのままできます。

新しい API では smallestWidth, width, height を使ってより直接的に画面サイズをターゲットできます。そのため、典型的なスクリーンタイプの異なる特徴を理解することは訳に立ちます。次の表でいくつかの例を "dp" 単位で載せました。

典型的なデバイスの解像度と画面サイズ

Type	Density(generalized)	Dimensions(dp)	smallestWidth(dp)
Baseline phone	mdpi	320x480	320
Small tablet/large phone	mdpi	480x800	480
7-inch tablet	mdpi	600x1024	600
10-inch tablet	mdpi	800x1280	800

次のセクションでは新しいスクリーン識別子とマニフェスト属性のより詳しい情報を提供します。スクリーンサポート API の完全な情報については Supporting Multiple Screens を見てください。

New resource qualifiers for screens support

Android 3.2 の新しいリソース識別子によってさまざまなスクリーンサイズに対してレイアウトをよりうまくターゲットさせることができます。識別子を使って特定の最小 smallestWidth, 現在の横幅もしくは縦幅、に対してデザインされたリソース設定を作ることができます。

新しい識別子は：

swNNNdp — 最小の smallestWidth を指定する。 smallestWidth はリソースが使用されるべき "dp" 単位でのサイズ。上記で述べたように、スクリーンの smallestWidth は画面の向きによらず定数である。例えば: sw320dp, sw720dp, sw720dp
wNNNdp and hNNNdp — リソースが使用されるべき "dp" 単位での最小の横幅もしくは縦幅を指定する。上記で述べたように、スクリーンの横幅と縦幅は画面の向きに応じて変わる。例えば: w320dp, w720dp, h1024dp

複数にオーバーラップするリソース設定を作成することもできます。例えば、いくつかのリソースを画面が 480dp より広い場合にタグ付し、その他では 600dp より大きいもの、その他で 720dp より大きいもののようにできます。複数のリソース設定がスクリーン対して識別子と付けられている場合、システムは最も一致する設定を選択します。与えられたスクリーンに対してどのリソースが割り当てられるか正確にコントロールするために、リソースを1つの識別子、もしくは複数の識別子の組み合わせにタグ付することができます。

すでに表記した典型的なサイズに基づいた新しい識別子を使った例です：


# For phones
res/layout/main_activity.xml

# For 7” tablets
res/layout-sw600dp/main_activity.xml   

# For 10” tablets
res/layout-sw720dp/main_activity.xml

# Multi-pane when enough width
res/layout-w600dp/main_activity.xml

# For large width
res/layout-sw600dp-w720dp/main_activity.xml

platform の古いバージョンでは新しい識別子は無視されます。そのため、すべてのデバイスに対応するために必要に応じてこれらをミックスすることができます。


# For phones
res/layout/main_activity.xml

# For pre-3.2 tablets
res/layout-xlarge/main_activity.xml

# For 3.2 and up tablets
res/layout-sw600dp/main_activity.xml

どのように新しい識別子を使うかの完全な情報は Using new size qualifiers を見てください。

New manifest attributes for screen-size compatibility

framework は新しい <supports-screens> マニフェスト属性のセットを提供します。これにより異なるスクリーンサイズに対するアプリのサポートを管理することができます。特に、動くようにデザインされた最大と最小のスクリーンサイズを指定することができ、また最大サイズはシステムの新しい screen compatibility mode が必要としないようデザインされたサイズです。上記で説明したリソース識別子のように、新しいマニフェスト属性はアプリケーションがサポートするスクリーンの範囲を指定します。

スクリーンサポートの新しいマニフェスト属性は：

android:compatibleWidthLimitDp="numDp" — 最大の largestWidth を指定します。largestWidth はアプリケーションが compatibility mode を必要としないで動作できるサイズです。現在のスクリーンが指定した値より大きい場合、システムはアプリケーションを通常のモードで表示します。しかし、ユーザーはオプションとしてシステムバーの設定から compatibility mode に切り替えることが可能です。
android:largestWidthLimitDp="numDp" — 最大の largestWidth を指定します。largestWidth はアプリケーションが動作するようデザインされたサイズです。現在のスクリーンが指定した値より大きい場合、現在のスクリーン上でベストな表示を行うために、システムは強制的にアプリケーションを compatibility mode で表示します。
android:smallestWidthLimitDp="numDp" — 最小の smallestWidth を指定します。smallestWidth はアプリケーションが動作するようデザインされたサイズです。現在のスクリーンが指定した値より小さい場合、システムはアプリケーションがこのデバイスと非互換だと考えますが、インストールして実行することを防いだりはしません。

注意: 現状では、Android Market は上記の属性に基づいてフィルターしません。フィルタリングのサポートは後の platform リリースで追加される予定です。スクリーンサイズに基づいたフィルタリングが必要なアプリケーションは既存の <supports-screens> 属性を使うことができます。

新しい属性をどのように使うかの完全な情報は Declaring screen size support を見てください。

Screen compatibility mode

Android 3.2 から新しいスクリーン互換性モードが提供されるようになりました。このモードは、走っているなかでできるだけ大きいスクリーンをサポートしないことを明示的に宣言します。この新しい "zoom" モードはピクセルスケールです。つまり、アプリケーションを小さい画面領域に描画して、それを現在の画面を覆うようにピクセルをスケールします。

デフォルトでは、システムはスクリーン互換性モードを必要としているアプリに対して、このモードをユーザーオプションとして提供します。ユーザーはシステムバーから利用可能なコントロールでズームモードのオンオフを切り替えることができます。

新しいスクリーン互換性モードは全てのアプリケーションに対して適切ではないため、プラットフォームはアプリケーションがマニフェストファイルを使ってそれを無効にすることを許可しています。アプリによって無効にされた場合、システムはアプリが走っている間ユーザーに対して "zoom" 互換性モードをオプションとして提供しません。

注意：どのように互換性モードをアプリケーションでコントロールするかの重要な情報については、Android Developer Blog の New Mode for Apps on Large Screens 記事を参照してください。

New screen density for 720p televisions and similar devices

720p のテレビや、それに似た解像度のデバイス上でアプリケーションを動かすために Android 3.2 から新しい一般的な解像度 tvdpi が追加されました。これはおよそ 213 dpi です。アプリケーションは新しい解像度を densityDpi で問い合わせることができ、また tvdpi 識別子をテレビや似たようなデバイス向けのタグとして使うことができます。
例えば


# Bitmap for tv density
res/drawable-tvdpi/my_icon.png

一般的には、アプリケーションはこの解像度で動くことはありません。720p のスクリーンに出力する必要がある場合、UI エレメントは platform によって自動的にスケールされます。

UI framework

Fragments
- 新しい Fragment.SavedState クラスが saveFragmentInstanceState() を通して Fragment のインスタンスから取得した状態情報を保持します。
- 新しいメソッド saveFragmentInstanceState() が与えられた Fragment の現在のインスタンス状態を保存します。状態は、現在の状態と一致する Fragment の新しいインスタンスが後で生成されたときに使うことができます。
- 新しいメソッド setInitialSavedState() が最初に生成された Fragment に対して初期の保存状態をセットします。
- 新しい onViewCreated() コールバックメソッドでは、onCreateView() が返されたことを Fragment に知らせますが、以前の保存状態はその View に再保存されています。
- isDetached() メソッドは Fragment が明示的に UI から切り離されているかどうかを決定します。
- 新しい attach() と detach() メソッドによってアプリケーションは UI に Fragment を再取り付け、取り離しすることができます。
- 新しい setCustomAnimations() オーバーロードメソッドによって、指定したアニメーションリソースをエンター／イグジット操作およびバックスタックをポップするときの操作で走るよう指定できます。既存の実装はバックスタックをポップするときの Fragment のデフォルトの振る舞いには寄与しません。
Screen size information in ActivityInfo and ApplicationInfo
- configChanges のビットマスクとして新しく CONFIG_SCREEN_SIZE と CONFIG_SMALLEST_SCREEN_SIZE が ActivityInfo に追加されました。ビットは Activity 自身が画面サイズと最小画面サイズをハンドルするかどうかを意味します。
- アプリケーションマニフェストファイルの <supports-screens> 属性に対応する largestWidthLimitDp, compatibleWidthLimitDp, requiresSmallestWidthLimitDp が ApplicationInfo のフィールドとして追加されました。
WindowManager から画面サイズを取得するためのヘルパー
- 新しいメソッド getSize() と getRectSize() によってアプリケーションは画面の生のサイズを取得できるようになりました。
新しい公開 "holographic" スタイル
- text, actionbar widgets, tabs などに対する多くの公開 "holographic" スタイル提供されるようになりました。完全なリストは R.style を見てください。
LocalActivityManager, ActivityGroup, LocalActivityManager が deprecated になりました。
- 新しいアプリケーションはこれらのクラスの代わりに Fragment を使ってください。古いバージョンのプラットフォームでも動くようにするために、Android SDK で利用できる v4 Support Library (compatibility library) を使うことができます。v4 Support Library は Android 1.6 (API level 4) まで互換性のある Fragment API のバージョンを提供します。
- Android 3.0 (API level 11) 以上に対して開発しているアプリでは、タブをアクションバー領域に置くための新しい ActionBar.newTab() や関連する API を使って、典型的にはタブをアクションバー内に表示させます。

Media framework

platform のメディアプロバイダー(MediaStore)を使うアプリケーションはデバイスによってサポートされている取り外しできる SD カードから直接メディアデータを読むことができるようになりました。また、MTP API を使って直接 SD カードのファイルとやりとりすることもできるようになりました。

Graphics

Parcelable utilities in Point and PointF
- Point と PointF クラスが Parcelable インタフェースとユーティリティメソッドの describeContents(), readFromParcel(), writeToParcel() を含むようになりました。

IME framework

修飾キーの現在の状態を取得するための新しいメソッド getModifiers() が追加されました。

USB framework

デバイスの生の USB デスクリプタを取得するために新しく getRawDescriptors() メソッドが追加されました。ハイレベルの API 介したアクセスがサポートされていないデスクリプタにこのメソッドを使ってアクセスできます。

Network

Network type constants
- ConnectivityManager に定数 TYPE_ETHERNET と TYPE_BLUETOOTH が追加されました。

Telephony

新しい NETWORK_TYPE_HSPAP ネットワークタイプ定数が追加されました。

Core utilities

Parcelable utilities
- 新しいインタフェース Parcelable.ClassLoaderCreator によって、アプリケーションは、オブジェクトが生成される ClassLoader を受け取ることができます。
- ParcelFileDescriptor オブジェクトを管理するために新しく adoptFd, dup(), fromFd() が追加されました。
Binder and IBinder
- Binder と IBinder の新しいメソッド dumpAsync() によって、アプリケーションは指定されたファイルへのダンプを非同期に実行することができます。
- 新しい IBinder プロトコルトランザクションコード TWEET_TRANSACTION によってアプリケーションはターゲットオブジェクトにツイートを送ることができます。

New feature constants

Android マニフェストで宣言できるハードウェア機能の定数が追加されました。これを宣言することで Android Market のような外部のエンティティに、必要なハードウェア・ソフトウェアの機能を知らせることができます。これらと他の機能定数は <uses-feature> マニフェストエレメントに宣言します。

Android Market はこれら <uses-feature> 属性に基づいてアプリケーションをフィルターします。これにより、必要条件を満たしたデバイスでのみ利用可能にすることができます。

landspace (横向き), portrait (縦向き) が必要条件の場合の機能定数
Android 3.2 でアプリケーションが横向き、縦向き、もしくは両方の画面向きを必要としているかを指定できる機能定数が増えました。これらの定数を宣言することは、アプリケーションが求める画面向きに対応しないデバイスにはインストールされないことを意味します。逆に、1つもしくは両方の定数が宣言されていないのであれば、宣言されていない向きに対する設定をアプリケーションが持っていないことを意味し、それらを提供しないデバイスにもインストールされます。
- android.hardware.screen.landscape — アプリケーションは横向きの画面を必要とする
- android.hardware.screen.landscape — アプリケーションは縦向きの画面を必要とする
横と縦両方の向きに対して適切に動く典型的なアプリケーションでは通常は画面向きの必要条件を宣言する必要はありません。テレビ向けにデザインされているような1つの向きにだけ主にデザインされているアプリケーションでは、その向きを提供していないデバイスで利用できないようにするために定数のいずれかを宣言することができます。
もしアプリケーションが API Level 12 以下をターゲットとしている場合、プラットフォームは portrait, landscape いずれかを必要と指定していなければ、両方の向きが必要とされていると仮定します。
Other feature constants
- android.hardware.faketouch.multitouch.distinct — アプリケーションは2つ以上のポイントを別々にトラッキングできるエミュレートされたマルチタッチ入力のサポートを必要とする
- android.hardware.faketouch.multitouch.jazzhand — アプリケーションは5つ以上のポイントを別々にトラッキングできるエミュレートされたマルチタッチ入力のサポートを必要とする

API Differences Report

Android 3.2(API Level 13) の全ての API 変更の詳細については、API Differences Report を見てください。

---

API Level

Android 3.2 platform は framework API のアップデートバージョンとして提供されます。Android 3.2 API には整数値の識別子 - 13 - が割り当てられ、システム自身に保存されます。この識別子は "API Level" と呼ばれ、アプリケーションをインストールする前に、そのアプリケーションがシステムと互換性があるかどうかシステムが正しく決定するために利用されます。

Android 3.2 で紹介された API をあなたのアプリケーションで使用するには、Android 3.2 SDK platform で提供されている　Android library に対してアプリケーションをコンパイルする必要があります。あなたの必要に応じて、アプリケーションのマニフェストの <uses-sdk> エレメントに android:minSdkVersion="13" 属性を追加する必要があるかもしれません。

API Level を利用するためのより詳しい情報は、API Levels ドキュメントを見てください。

Android　resource で integer を定義する

2011-07-26T09:34:00.004+09:00

strings.xml で


  <string name="one">1</string>

と定義して


int one = Integer.parseInt(getString(R.string.one));

とかやっちゃダメですよ！
コードみせたら笑われry

ちゃんと integer で定義してくださいまし。
More Resource Types | Android Developers

res/values/hoge.xml の <resources> の中に
こうですよ！


  <integer name="one">1</integer>

と定義して


int one = getResources().getInteger(R.integer.one);

Android　AppWidget の PendingIntent で putExtra するときの注意

2011-07-12T01:09:00.005+09:00

AppWidget 上のボタンをタップしたときに編集画面を開いたりする場合、RemoteViews を使った次のようなコードがよく紹介されています。


RemoteViews remoteView = new RemoteViews(context.getPackageName(), R.layout.appwidget);
Intent intent = new Intent(context, WidgetConfigure.class);

PendingIntent pendingIntent = PendingIntent.getActivity(context, 0, intent, 0);
// or
// PendingIntent pendingIntent = PendingIntent.getService(context, 0, intent, 0);
// or
// PendingIntent pendingIntent = PendingIntent.Broadcast(context, 0, intent, 0);

remoteView.setOnClickPendingIntent(R.id.button, pendingIntent);

画面に同じアプリのウィジェットが複数個ある場合、AppWidgetId を Intent の extras に詰めて渡したくなります。なるでしょう？

そこで


Intent intent = new Intent(context, WidgetConfigure.class);
intent.putExtra(AppWidgetManager.EXTRA_APPWIDGET_ID, appWidgetId);
PendingIntent pendingIntent = PendingIntent.getActivity(context, 0, intent,0);

とやるとうまくいきません。画面にウィジェットが複数ある場合、どれをタップしてもどれか1つのボタンが押された挙動になってしまいます。

正しく動かすには、こう


PendingIntent pendingIntent = PendingIntent.getActivity(context, appWidgetId, intent, 0);

---
注意：


PendingIntent pendingIntent = PendingIntent.getActivity(context, appWidgetId, intent, PendingIntent.FLAG_UPDATE_CURRENT);
// or
PendingIntent pendingIntent = PendingIntent.getActivity(context, appWidgetId, intent, PendingIntent.FLAG_CANCEL_CURRENT);

でも動きますが、今回の目的では第4引数フラグを指定する必要はありません。
詳しくはこの後で説明します。
---

PeindingIntent の getActivity() (getService(), getBroadcast() も同じ) の第2引数に AppWidget の ID （同じアプリの各 AppWidget で一意になるならなんでもよい）を指定します！

ちょっと、ちゃんと PendingIntent の説明を読んでみましょう。

---
A description of an Intent and target action to perform with it. Instances of this class are created with getActivity(Context, int, Intent, int), getBroadcast(Context, int, Intent, int), getService(Context, int, Intent, int); the returned object can be handed to other applications so that they can perform the action you described on your behalf at a later time.

By giving a PendingIntent to another application, you are granting it the right to perform the operation you have specified as if the other application was yourself (with the same permissions and identity). As such, you should be careful about how you build the PendingIntent: often, for example, the base Intent you supply will have the component name explicitly set to one of your own components, to ensure it is ultimately sent there and nowhere else.

A PendingIntent itself is simply a reference to a token maintained by the system describing the original data used to retrieve it. This means that, even if its owning application's process is killed, the PendingIntent itself will remain usable from other processes that have been given it. If the creating application later re-retrieves the same kind of PendingIntent (same operation, same Intent action, data, categories, and components, and same flags), it will receive a PendingIntent representing the same token if that is still valid, and can thus call cancel() to remove it.
---

Intent と、その Intent を実行したい Action の記述。このクラスのインスタンスは getActivity(Context, int, Intent, int), getBroadcast(Context, int, Intent, int), getService(Context, int, Intent, int); で生成されます。後で他のアプリケーションが記述されたアクションを実行できるように、これらのメソッドで返されるオブジェクトは他のアプケーションに受け渡すことができます。

PendingIntent を他のアプリケーションに渡すことで、他のアプリケーションが自分自身であるかのように（同じパーミッションとIDで）指定した操作を実行する権限を付与します。
このようなことから、PendingIntent をどのように作成するのかについて注意するべきです。よく起こることで、例えば、あなたが渡す base Intent が他のところではなく最終的にそこに届けられることを確認するために、あなた自身のコンポーネントの1つとして明示的に設定された component name を持つようにしてください。

PendingIntent 自身は、単にシステムによって管理されるトークンへのリファレンスです。これは、PendingIntent を受信するために使用されるオリジナルデータを記述しています。
これはつまり、自身のアプリケーションプロセスが殺されても、PendingIntent 自身は他のプロセス（すでに受け取っている）から使用可能な状態のまま残ることを意味しています。もし作成したアプリケーションがあとで同じ種類の PendingIntent を再取得した場合（同じ操作、同じアクション、データ、カテゴリ、コンポーネント、フラグ）、同じトークンがまだ有効な場合、その同じトークンを代表する PendingIntent を受信します。したがって、cancel() を呼んでそれを削除することができます。

---

ふむふむ。

---

public static PendingIntent getActivity (Context context, int requestCode, Intent intent, int flags)

Since: API Level 1
Context.startActivity(Intent) を呼ぶように、新しい Activity を開始する PendingIntent を取得する。既存の activity の context の外で新しい activity が開始されるので、Intent に Intent.FLAG_ACTIVITY_NEW_TASK launch flag を使わなければならない。

Parameters

context : この PendingIntent が activity を開始する context
requestCode : sender 用のプライベートな request code
intent : 起動される Activity の Intent
flags : FLAG_ONE_SHOT, FLAG_NO_CREATE, FLAG_CANCEL_CURRENT, FLAG_UPDATE_CURRENT のいずれか。もしくは Intent.fillIn() でサポートされる全てのフラグ。intent の指定されてない部分のコントロール用。実際の送信が起こったときに intent に適用される。

Returns

与えられたパラメータにマッチする既存の、もしくは新しい PendingIntent を返す。FLAG_NO_CREATE が与えられたときのみ null が返る場合がある。

---

ふむふむふむ。
flags に指定する。FLAG_ONE_SHOT, FLAG_NO_CREATE, FLAG_CANCEL_CURRENT, FLAG_UPDATE_CURRENT の説明も見てみるか。

---

Constants

public static final int FLAG_CANCEL_CURRENT

Since: API Level 1
getActivity(Context, int, Intent, int), getBroadcast(Context, int, Intent, int),　getService(Context, int, Intent, int) 用のフラグ : 記述された PendingIntent がすでに存在していた場合、新しいのが生成される前に現在のはキャンセルされる。Intent の extra data だけを変更する場合に新しい PendingIntent を取得するのに使える。以前の pending intent をキャンセルすることによって、新しいデータを与えられた実体だけが起動できることを保証する。この保証が問題はない場合、FLAG_UPDATE_CURRENT を検証する。

public static final int FLAG_NO_CREATE

Since: API Level 1
getActivity(Context, int, Intent, int), getBroadcast(Context, int, Intent, int),　getService(Context, int, Intent, int) 用のフラグ : 記述された PendingIntent がまだ存在していない場合、生成せずに単に null を返す。

public static final int FLAG_ONE_SHOT

Since: API Level 1
getActivity(Context, int, Intent, int), getBroadcast(Context, int, Intent, int),　getService(Context, int, Intent, int) 用のフラグ : この PendingIntent は1度だけ使える。このフラグがセットされた場合、send() が呼ばれた後に試みた send は自動的にキャンセルされる。

public static final int FLAG_UPDATE_CURRENT

Since: API Level 3
getActivity(Context, int, Intent, int), getBroadcast(Context, int, Intent, int),　getService(Context, int, Intent, int) 用のフラグ : 記述された PendingIntent がすでに存在している場合、それをキープして extra data を新しい Intent のものに置き換える。extras だけを変えた intent を作成し、以前の PendingIntent が受け取った実体が、明示的に与えなくても新しい extras で起動できるのを気にしない場合に使える。

---

FLAG_UPDATE_CURRENT で問題ない場合は、こっちを考えてねって FLAG_CANCEL_CURRENT にあるので、FLAG_UPDATE_CURRENT の方がいいのかな？

第2引数についても検証してみた。
リファレンスには

---

requestCode Private request code for the sender (currently not used).

---

(currently not used) = 現在は使っていない

って書いてあるけど、どうもそうではないみたい。

例えば、同じ AppWidget を画面に2個配置して、それぞれに


Intent intent = new Intent(context, WidgetConfigure.class);
intent.putExtra(AppWidgetManager.EXTRA_APPWIDGET_ID, appWidgetId);
PendingIntent pendingIntent = PendingIntent.getActivity(context, 0, intent, PendingIntent.FLAG_CANCEL_CURRENT);  
views.setOnClickPendingIntent(R.id.widgetbase, pendingIntent);

を指定すると、先に追加した方の PendingIntent はキャンセルされるので、先に張り付けた AppWidget のボタンをタップしても反応しなくなります（PedingIntent が実行されなくなる）。

これは、extras 以外が同じ PendingIntent なので、以前のがキャンセルされるからです。
これを


Intent intent = new Intent(context, WidgetConfigure.class);
intent.putExtra(AppWidgetManager.EXTRA_APPWIDGET_ID, appWidgetId);
PendingIntent pendingIntent = PendingIntent.getActivity(context, appWidgetId, intent, PendingIntent.FLAG_CANCEL_CURRENT);  
views.setOnClickPendingIntent(R.id.widgetbase, pendingIntent);

にすると、先に張り付けた AppWidget のボタンもちゃんと反応します。
extras 以外に appWidgetId も違うので、同じ PendingIntent だと判定されないのでキャンセルされないからです。

FLAG_UPDATE_CURRENT も同じことです。


Intent intent = new Intent(context, WidgetConfigure.class);
intent.putExtra(AppWidgetManager.EXTRA_APPWIDGET_ID, appWidgetId);
PendingIntent pendingIntent = PendingIntent.getActivity(context, 0, intent, PendingIntent.FLAG_UPDATE_CURRENT);  
views.setOnClickPendingIntent(R.id.widgetbase, pendingIntent);

を指定すると、先に追加した方の PendingIntent はキャンセルされないので起動できますが、新しい Extras が適用されてしまう（FLAG_UPDATE_CURRENT のところに説明されている通り) ので、どの AppWidget でも同じ Extras の Activity が起動されることになります。

これを


Intent intent = new Intent(context, WidgetConfigure.class);
intent.putExtra(AppWidgetManager.EXTRA_APPWIDGET_ID, appWidgetId);
PendingIntent pendingIntent = PendingIntent.getActivity(context, appWidgetId, intent, PendingIntent.FLAG_UPDATE_CURRENT);  
views.setOnClickPendingIntent(R.id.widgetbase, pendingIntent);

にすれば、同じ PendingIntent と判定されないので、以前の Extras が新しいのに置き換わることはなくなります。

。。。あれれ、結局第2引数で同じ PendingIntent と判定されないようにするなら、第4引数いらなくね？

てことで、


Intent intent = new Intent(context, WidgetConfigure.class);
intent.putExtra(AppWidgetManager.EXTRA_APPWIDGET_ID, appWidgetId);
PendingIntent pendingIntent = PendingIntent.getActivity(context, appWidgetId, intent, 0);  
views.setOnClickPendingIntent(R.id.widgetbase, pendingIntent);

でいいじゃん！ちゃんと意図した通り動きました。

ちなみに、コードをちょっと追ってみました。

PendingIntent.java#189


    189     public static PendingIntent getActivity(Context context, int requestCode,
    190             Intent intent, int flags) {
    191         String packageName = context.getPackageName();
    192         String resolvedType = intent != null ? intent.resolveTypeIfNeeded(
    193                 context.getContentResolver()) : null;
    194         try {
    195             IIntentSender target =
    196                 ActivityManagerNative.getDefault().getIntentSender(
    197                     IActivityManager.INTENT_SENDER_ACTIVITY, packageName,
    198                     null, null, requestCode, intent, resolvedType, flags);
    199             return target != null ? new PendingIntent(target) : null;
    200         } catch (RemoteException e) {
    201         }
    202         return null;
    203     }

ActivityManagerNative.java#2233


   2233     public IIntentSender getIntentSender(int type,
   2234             String packageName, IBinder token, String resultWho,
   2235             int requestCode, Intent intent, String resolvedType, int flags)
   2236             throws RemoteException {
   2237         Parcel data = Parcel.obtain();
   2238         Parcel reply = Parcel.obtain();
   2239         data.writeInterfaceToken(IActivityManager.descriptor);
   2240         data.writeInt(type);
   2241         data.writeString(packageName);
   2242         data.writeStrongBinder(token);
   2243         data.writeString(resultWho);
   2244         data.writeInt(requestCode);
   2245         if (intent != null) {
   2246             data.writeInt(1);
   2247             intent.writeToParcel(data, 0);
   2248         } else {
   2249             data.writeInt(0);
   2250         }
   2251         data.writeString(resolvedType);
   2252         data.writeInt(flags);
   2253         mRemote.transact(GET_INTENT_SENDER_TRANSACTION, data, reply, 0);
   2254         reply.readException();
   2255         IIntentSender res = IIntentSender.Stub.asInterface(
   2256             reply.readStrongBinder());
   2257         data.recycle();
   2258         reply.recycle();
   2259         return res;
   2260     }

requestCode もちゃんと Parcel に入れられてます = 使ってるじゃん！


   2244         data.writeInt(requestCode);

Android　In-app Billing Overview

2011-07-06T09:38:00.011+09:00

In-app Billing Architecture

請求リクエストと請求レスポンスのやりとりを非同期メッセージループを使って、アプリと Android Market サーバ間で行う
実際にはアプリは Android Market サーバと直接やりとりすることはない
アプリは請求リクエストを Android Market application に interprocess communication (IPC) を介して送り、Android Market application から購入レスポンスを非同期の broadcast intent として受け取る
コンテンツを配送したり、トランザクションを検証するためのプライベートなリモートサーバを使うアプリ内課金の実装もあるが、in-app billing の実装にリモートサーバは必須ではない
メディアファイルや写真等をユーザーのデーバイスに配送する必要があるデジタルコンテンツを売る場合、リモートサーバーは役に立つ
ユーザーのトランザクション履歴を保存したり、署名検証などのアプリ内課金用セキュリティタスクを実行するためにリモートサーバを使うこともある
セキュリティに関連した全てのタスクをアプリ内で処理することも可能だが、セキュリティアタックへの脆弱性を減らすためにこれらのタスクをリモートサーバで行うことが推奨される

典型的な in-app billing の実装は3つのコンポーネントに依存している

Service
(サンプルアプリでは BillingService という名前)
アプリからの購入メッセージを処理し、Android Market の in-app billing service に請求リクエストを送る
BroadcastReceiver
(サンプルアプリでは BillingReceiver という名前)
Android Market application からの全ての非同期請求レスポンスを受け取る
セキュリティコンポーネント
(サンプルアプリでは Security という名前)
署名検証やワンタイムトークンの生成などセキュリティに関連したタスクを実行する
in-app billing のセキュリティに関するより詳しい情報は Security controls を参照する

必要に応じて in-app billing をサポートする以下のコンポーネントを組み込む

response Handler
(サンプルアプリでは ResponseHandler という名前)
購入の通知、エラー、その他ステータスメッセージのアプリケーション固有の処理を提供する
observer
(サンプルアプリでは PurchaseObserver という名前)
アプリへのコールバック送信に責任をもち、これによりアプリは購入情報やステータスなどで、ユーザーのインタフェースをアップデートする

これらのコンポーネントに加えて
・ユーザーの購入情報を保存する方法
・ユーザーが購入アイテムを選択できるユーザーインタフェース
を提供しなければならない

アプリは checkout 用のユーザーインタフェースを用意する必要はない（Android Market application が提供する)
ユーザーの checkout プロセスが完了したら、アプリが再開される

from http://developer.android.com/guide/market/billing/billing_overview.html

---

In-app Billing Messages

ユーザーが購入を開始したら、アプリは Android Market の in-app billing service (MarketBillingService という名前) に単一の IPC メソッド呼び出しと使って請求メッセージを送る。
Android Market application は全ての請求リクエストに対して同期にレスポンスを返し、ステータス通知と他の情報をアプリに提供する
Android Market アプリはいくつかの請求リクエストに対して非同期でもレスポンスを返し、エラーメッセージと詳細なトランザクション情報をアプリに提供する

■ In-app billing requests

アプリは MarketBillingService インタフェースで公開されている single IPC method (sendBillingRequest()) を呼び出すことで請求リクエストを送る
このインタフェースは Android Interface Definition Language ファイル (IMarketBillingService.aidl) で定義されている
この AIDL ファイルは in-app billing のサンプルアプリと一緒にダウンロードできる

sendBillingRequest() メソッドは引数として Bundle パラメータを一つ持つ
アプリが渡すこの Bundle には、リクエストのパラメータを指定するための、いくつかの key-value ペアが含まれていなければならない
リクエストで送る Bundle keys の詳細は In-app Billing Service Interface を参照する

一番重要な key は各リクエスト Bundle で必須な BILLING_REQUEST key
この key で作成する請求リクエストのタイプを指定する

Android Market の in-app billing service は次の 5 タイプの請求リクエストをサポートしている：

CHECK_BILLING_SUPPORTED
Android Market application が in-app billing をサポートしているかどうか確かめるリクエスト
アプリケーションの開始時にこのリクエストを送って in-app billing が利用できるときのみ UI を有効にするべき

その他の必須な key-value pairs
・API_VERSION : 1
・PACKAGE_NAME : package name

同期レスポンス Bundle のキー
・RESPONSE_CODE

RESPONSE_CODE の可能な値
・RESULT_OK
・RESULT_BILLING_UNAVAILABLE
・RESULT_ERROR
・RESULT_DEVELOPER_ERROR
REQUEST_PURCHASE
Android Market application に購入メッセージを送るリクエスト
in-app billing の基盤
ユーザーがアプリのアイテムを購入したいことを示したときにこのリクエストを送る
Android Market は checkout のユーザーインタフェースを表示して購入のトランザクションを処理する

その他の必須な key-value pairs
・API_VERSION : 1
・PACKAGE_NAME : package name
・ITEM_ID : 有効な製品（アイテム）の識別子

同期レスポンス Bundle のキー
・RESPONSE_CODE
・PURCHASE_INTENT
・REQUEST_ID

RESPONSE_CODE の可能な値
・RESULT_OK
・RESULT_ERROR
・RESULT_DEVELOPER_ERROR

非同期レスポンス
・IN_APP_NOTIFY（broadcast intent）
　　　・a notification ID（データ）
GET_PURCHASE_INFORMATION
購入状態の変化の詳細を取得するためのリクエスト
リクエストした購入の支払いが成功した場合やユーザーが checkout 中にトランザクションをキャンセルした場合に購入の状態が変わる
事前の購入がリファンドされたときにも購入状態が変わる
購入状態が変更になったとき Android Market はアプリに通知するので、取得したいトランザクション情報がある場合だけこのリクエストを送ればいい

その他の必須な key-value pairs
・API_VERSION : 1
・PACKAGE_NAME : package name
・NONCE : 有効な long 値
・NOTIFY_IDS : 有効な long 値の配列

同期レスポンス Bundle のキー
・RESPONSE_CODE
・REQUEST_ID

RESPONSE_CODE の可能な値
・RESULT_OK
・RESULT_ERROR
・RESULT_DEVELOPER_ERROR

非同期レスポンス
・PURCHASE_STATE_CHANGED（broadcast intent）
CONFIRM_NOTIFICATIONS
購入状態変更の詳細をアプリが取得したこと知らせるためのリクエスト
Android Market はアプリが購入状態変更の通知を受け取ったことを確認するまで通知を送る

その他の必須な key-value pairs
・API_VERSION : 1
・PACKAGE_NAME : package name
・NOTIFY_IDS : 有効な long 値の配列

同期レスポンス Bundle のキー
・RESPONSE_CODE
・REQUEST_ID

RESPONSE_CODE の可能な値
・RESULT_OK
・RESULT_ERROR
・RESULT_DEVELOPER_ERROR
RESTORE_TRANSACTIONS
購入を管理する(managed purchases)ためのユーザーのトランザクションを取得するリクエスト
ユーザーのトランザクション状態を取得する必要があるときだけこのリクエストを送る
通常はアプリケーションがデバイスに最初にインストールされたときか、再インストールされたとき

その他の必須な key-value pairs
・API_VERSION : 1
・PACKAGE_NAME : package name
・NONCE : 有効な long 値

同期レスポンス Bundle のキー
・RESPONSE_CODE
・REQUEST_ID

RESPONSE_CODE の可能な値
・RESULT_OK
・RESULT_ERROR
・RESULT_DEVELOPER_ERROR

非同期レスポンス
・RESPONSE_CODE（broadcast intent）
・PURCHASE_STATE_CHANGED（broadcast intent）

---

■ In-app Billing Responses

Android Market application からの in-app billing リクエストに対するレスポンスには、同期・非同期両方のレスポンスがある
同期的なレスポンスは Bundle で、次の 3 つのキーの値をもつ

RESPONSE_CODE
リクエストのステータス情報とエラー情報を提供するキー
PURCHASE_INTENT
checkout activit を起動するための PendingIntent を提供するキー
REQUEST_ID
リクエストと非同期のレスポンスを一致させるためのリクエスト識別子を提供するキー

いくつかのキーは全てのリクエストで使えるわけではない
より詳しい情報は、Messaging sequence を参照する

非同期レスポンスはそれそれが broadcast intent の形式で送られる

com.android.vending.billing.RESPONSE_CODE
Android Market server の response code を含む
in-app billing リクエストを作成した後に送られる
レスポンスコードによって、Android Market に billing request が正しく送れたか、もしくはエラーがリクエスト中に起こったかを判別できる
このレスポンスは購入状態の変化（リファンドや購入の情報）をレポートするものではない
レスポンスコードの詳細は Server Response Codes for In-app Billing を参照する

Extras
・request_id : long : request ID を表す
・response_code : int : Android Market server のレスポンスコードを表す

response_code extras に含まれるレスポンスコード
- RESULT_OK
  値 : 0
  リクエストが正しくサーバーに送れたことを意味する
  このコードが CHECK_BILLING_SUPPORTED のレスポンスとして返された場合は、billing がサポートされていることを意味する
- RESULT_USER_CANCELED
  値 : 1
  checkout ページでユーザーがアイテムを購入しようとせずに戻るボタンを押したことを意味する
- RESULT_SERVICE_UNAVAILABLE
  値 : 2
  ネットワークコネクションがダウンしていることを意味する
- RESULT_BILLING_UNAVAILABLE
  値 : 3
  指定した API_VERSION が Android Market application に認識されなかった、もしくはユーザーが in-app billing に不適格（例えば、ユーザーが in-app purchase が禁止されている国にいるなど）なことにより in-app billing が使えないことを意味する
- RESULT_ITEM_UNAVAILABLE
  値 : 4
  Android Market がリクエストされたアイテムをアプリケーションの product list に見つけられなかったことを意味する。REQUEST_PURCHASE で product ID をミススペルしている場合、もしくはアイテムがアプリケーションの product list にパブリッシュされていない場合におこる
- RESULT_DEVELOPER_ERROR
  値 : 5
  アプリケーションが in-app billing リクエストをしようとしたが、アプリケーションが com.android.vending.BILLING パーミッションを manifest で宣言していないことを意味する。アプリケーションが適切に署名されていない、もしくは変なリクエスト（例えば、request type を識別するための Bundle keys がないリクエストなど）を送ったことも意味しうる
- RESULT_ERROR
  値 : 6
  予測できないサーバーエラーを意味する。自分で自分のアイテムを購入しようとした場合、このエラーが起こる
com.android.vending.billing.IN_APP_NOTIFY
購入状態（購入に成功した、キャンセルされた、リファンドされた）が変わったことを意味するレスポンス
このレスポンスには 1つ以上の notification ID が含まれる
ID は特定のサーバサイドメッセージとひもづいており、各メッセージは1つ上のトランザクションに関する情報を含む
IN_APP_NOTIFY broadcast intent を受け取った後、アプリケーションは受け取った ID でGET_PURCHASE_INFOMATION リクエストを送ってメッセージの詳細を受け取るべき

Extras
・notification_id : String : notification ID を表す
com.android.vending.billing.PURCHASE_STATE_CHANGED
1つ以上のトランザクションに関する詳細状態を含むレスポンス
トランザクション情報は JSON string に含まれる
JSON string は署名され、JSON string と一緒に signature が送られる (暗号化はされていない）
あなたの in-app billing メッセージのセキュリティを確保するために、この JSON string の signature を使ってアプリケーションを検証する

Extras
・inapp_signed_data : String : signed された JSON string
・inapp_signature : String : signature を表す String

JSON string の例
```
{ "nonce" : 1836535032137741465,
  "orders" :
    { "notificationId" : "android.test.purchased",
      "orderId" : "transactionId.android.test.purchased",
      "packageName" : "com.example.dungeons",
      "productId" : "android.test.purchased",
      "developerPayload" : "bGoa+V7g/yqDXvKRqq+JTFn4uQZbPiQJo4pf9RzJ",
      "purchaseTime" : 1290114783411,
      "purchaseState" : 0 }
}
```
JSON string のフィールドの情報は In-app Billing Broadcast Intents を参照する
- nonce
  1回だけ使われる数字。自分のアプリケーションで nonce を生成して GET_PURCHASE_INFOMATION と一緒に送る。Android Market は JSON string の一部として nonce を送り返す。これによりメッセージを識別できる。
- notificationId
  IN_APP_NOTIFY broadcast intent と一緒に送られるユニークな識別子。各 notificationId は Android Market server に受信されるのを待っている特定のメッセージと対応する。notificationId を GET_PURCHASE_INFORMATION メッセージと一緒に送り返すことで、アプリケーションがメッセージを受信したかどうかを Android Market が判断できる。
- orderId
  トランザクション用のユニークなオーダー識別子。Google Checkout Order ID とひもづいている。
- packageName
  購入が発生したアプリケーションのパッケージ名
- productId
  アイテムの product 識別子。各アイテムは Android Market publisher site でアプリケーションの product list として指定された product ID をもたなければならない。
- purchaseTime
  product が購入された時間。epoch (Jan 1, 1970) からの経過ミリ秒数
- purchaseState
  オーダーの購入状態。可能は値は 0 (purchased), 1 (canceled), 2 (refunded) のいずれか。
- developerPayload
  開発者が指定した文字列。オーダーの付加情報を含む。REQUEST_PURCHASE リクエストを発行するときにこのフィールドを指定することができる。

Android　android:duplicateParentState

2011-07-06T08:02:00.003+09:00

子View の状態（クリックされた、フォーカスがあたった、選択されたなど）を親と共有したい場合、

android:duplicateParentState="true or false"

setDuplicateParentStateEnabled(boolean)

が使えます。

これを設定すると、自身の状態よりも親の状態が優先され、親の状態と同じ状態をとるようになります。

例えば、ダッシュボードで

(ボタン1)
-----------
|画像|画像|
-----------
(ボタン2)
-----------
|画像|画像|
-----------
(ボタン3)
-----------
|画像|画像|
-----------
・・・

があって、どっちの画像を押しても、両方の画像が状態に応じて変わるようにするには、両方の画像の親Viewにクリック処理をさせ、子View に android:duplicateParentState="true" を設定します。


    <LinearLayout
        android:orientation="horizontal"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:clickable="true"
        android:focusable="true"
        >
        <ImageView 
            android:background="@android:drawable/btn_default"
            android:layout_width="50dip" 
            android:layout_height="wrap_content"
            android:duplicateParentState="true"
            />
        <ImageView 
            android:background="@android:drawable/btn_default"
            android:layout_width="100dip" 
            android:layout_height="wrap_content"
            android:duplicateParentState="true"
            />
    </LinearLayout>

    ...

この場合、LinearLayout 部分をクリックすると、2つの ImageView 両方が LinearLayout の状態（押された、フォーカスがあたったなど）に応じて変わります。

ちなみに、これを使ったダッシュボードの例が「Android Layout Cookbook」の 8.4 レイアウトサンプル4 です。
ここから、Android Layout Cookbook デモあぷりを落として実際の動きをみることができます。

Android Layout CookBook デモあぷり - Android マーケット -

本もよろしくね！

実は、親 View の enabled/disabled も伝えることができます。
例えば、


<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:id="@+id/container"
    android:orientation="vertical"
    android:layout_width="fill_parent"
    android:layout_height="fill_parent"
    >
    <Button 
        android:text="Button" 
        android:id="@+id/button1" 
        android:layout_width="wrap_content" 
        android:layout_height="wrap_content"
        android:duplicateParentState="true"
        />
    <Button 
        android:text="Button" 
        android:id="@+id/button2" 
        android:layout_width="wrap_content" 
        android:layout_height="wrap_content"
        android:duplicateParentState="false"
        />
    <Button 
        android:text="Button" 
        android:id="@+id/button3" 
        android:layout_width="wrap_content" 
        android:layout_height="wrap_content"
        android:duplicateParentState="true"
        />
    <Button 
        android:text="Button" 
        android:id="@+id/button4" 
        android:layout_width="wrap_content" 
        android:layout_height="wrap_content"
        android:duplicateParentState="true"
        />
    <Button 
        android:text="Button" 
        android:id="@+id/button5" 
        android:layout_width="wrap_content" 
        android:layout_height="wrap_content"
        android:duplicateParentState="true"
        />
</LinearLayout>


    @Override
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.main);
        
        View container = findViewById(R.id.container); 
        container.setEnabled(false);
        
        View button4 = findViewById(R.id.button4);
        button4.setEnabled(true);

        View button5 = findViewById(R.id.button5);
        button5.setDuplicateParentStateEnabled(false);
        button5.setEnabled(true);
    }

の結果は次のようになります。

setDuplicateParentStateEnabled(false) を指定しないと、子 View だけ setEnabled(true) しないと親 View が disabled の場合は enabled になりません。

このパラメータは一度に有効／無効を切り替えるのに使うにはちょっと向いてないかなー。

Android ListFragment でカスタムレイアウトを使うと setEmptyText() が使えない

2011-07-05T22:30:00.007+09:00

もともとは adakoda さんのブログのエントリ

[Android] ListFragment の View をカスタマイズする方法 - adakoda - http://goo.gl/UBgyu

で、onCreateView() を override してカスタムレイアウトを指定すると setEmptyText() で落ちるという話があって、正しい ID を指定してないからでは〜？的な流れになったのですが、どうもそうではないようなので調べてみました。

まず、setEmptyText(CharSequence text) は API Level 11 (Android 3.0) で追加された API です。

結果をまとめると

・ListActivity
　　・setEmptyView() : 使える
　　・getEmptyView() : 使える
　　・@android:id/list, @android:id/empty を使った
　　　カスタムレイアウト : 使える

・ListFragment
　　・@android:id/list, @android:id/empty を使った
　　　カスタムレイアウト : 使える

　　・カスタムレイアウトを使わない場合
　　　　・getListView().setEmptyView() : なにもおこらない
　　　　・getListView().getEmptyView() : 使える
　　　　・setEmptyText() : 使える

　　・カスタムレイアウトを使った場合
　　　　・getListView().setEmptyView() : なにもおこらない
　　　　　(@android:id/empty がそのまま表示される)
　　　　・getListView().getEmptyView() : 使える
　　　　・setEmptyText() : 落ちる

ListFragment で、カスタムレイアウトで setEmptyText() を使いたい場合は、次のように override しておくこと


 @Override
 public void setEmptyText(CharSequence text) {
  TextView tv = (TextView)getListView().getEmptyView();
  tv.setText(text);
 }

ちなみに、このときのカスタムレイアウトはこんな感じ


<?xml version="1.0" encoding="utf-8"?>
<FrameLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent">
    
    <ListView 
        android:id="@android:id/list"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:drawSelectorOnTop="false" />
        
    <TextView 
        android:id="@android:id/empty"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:text="No data" 
        android:textSize="30sp"/>
</FrameLayout>

さて、結論をいったので、それまでの過程もちょっと紹介。

まずは、ListFragment の onCreateView() で生成される View のなかから empty 用っぽい View を見つけて、それの ID から resourceName とればわかるんじゃね？と思ってやってみました。


@Override
public View onCreateView(LayoutInflater inflater, ViewGroup container,
     Bundle savedInstanceState) {

    View v = super.onCreateView(inflater, container, savedInstanceState);
    Log.d("NoteListFragment", v.getClass().getName() + ", " + v.getId());

    if (v instanceof ViewGroup) {
        ViewGroup vg = (ViewGroup) v;
        for (int i = 0; i < vg.getChildCount(); i++) {
            View child = vg.getChildAt(i);

            String resourcename = getResourceNameByID(android.R.id.class, child.getId());

            Log.d("NoteListFragment", child.getClass().getName() + ", "
                          + child.getId() + ", " + resourcename);
    
            if(child instanceof ViewGroup) {
                ViewGroup vg2 = (ViewGroup) child;
                for (int j = 0; j < vg2.getChildCount(); j++) {
                    View child2 = vg2.getChildAt(j);

                    String resourcename2 = getResourceNameByID(android.R.id.class, child2.getId());

                    Log.d("NoteListFragment", child2.getClass().getName() + ", "
                                 + child2.getId() + ", " + resourcename2);
                }     
            }
        }
    }  
    return v;
}

public String getResourceNameByID(Class<?> clazz, int resourceId)
    throws IllegalArgumentException {

    Field[] fields = clazz.getFields();
    for (Field f : fields) {
        try {
            if (resourceId == f.getInt(null)) {
                return f.getName();
            }
        } catch (Exception e) {
            e.printStackTrace();
            throw new IllegalArgumentException();
       }
    }
    return null;
}

リフレクション。リフレクション。
結果はこんな感じ

07-05 13:46:40.090: DEBUG/NoteListFragment(30597): android.widget.FrameLayout, -1
07-05 13:46:40.090: DEBUG/NoteListFragment(30597): android.widget.LinearLayout, 16908904, null
07-05 13:46:40.090: DEBUG/NoteListFragment(30597): android.widget.ProgressBar, -1, null
07-05 13:46:40.090: DEBUG/NoteListFragment(30597): android.widget.TextView, -1, null
07-05 13:46:40.090: DEBUG/NoteListFragment(30597): android.widget.FrameLayout, 16908905, null
07-05 13:46:40.090: DEBUG/NoteListFragment(30597): android.widget.ListView, 16908298, list
07-05 13:46:40.090: DEBUG/NoteListFragment(30597): android.widget.TextView, 16908906, null

ListView には list (= android.R.id.list) が割当てられているのに、その下の TextView (EmptyView だと思われる) には null が入っている。つまり、android.R.id.** に対象の ID がなかったということです。コードで動的に生成してるのかな？

念のためこの TextView が EmptyView なのかチェック


 @Override
 public void onActivityCreated(Bundle savedInstanceState) {
  super.onActivityCreated(savedInstanceState);
  ...
  
  setEmptyText(getActivity().getString(R.string.no_notes));
  Log.d("NoteListFragment", getListView().getEmptyView().getId() + "");
 }

結果は

07-05 13:56:22.510: DEBUG/NoteListFragment(30953): 16908906

ビンゴ。

ちなみに setEmptyText() する前に getListView().getEmptyView().getId() するとヌルポになります。
EmptyView が生成されてないんですね。このことからも EmptyView が動的に生成されてるのがわかります。

なので、レイアウトをカスタムしないで setEmptyText を override するときは super.setEmpty() を忘れずに最初にしてください。そうしないとその後の getListView().getEmptyView() には null が返ってきてしまいます。


 @Override
 public void setEmptyText(CharSequence text) {
  super.setEmptyText(text);  // don't forget
  TextView tv = (TextView)getListView().getEmptyView();
  tv.setText(text);
 }

カスタムを使っていてもいなくても、カスタムレイアウトに android:empty が入っていてもいなくても動くようにするには、こんな感じかなぁ。。。


 @Override
 public void setEmptyText(CharSequence text) {
  try {
   super.setEmptyText(text);
  }
  catch (IllegalStateException e1){
   e1.printStackTrace();
   Log.d("NoteListFragment", e1.getClass().getName() + " : " + e1.getMessage());

   try {
    TextView tv = (TextView)getListView().getEmptyView();
    tv.setText(text);    
   }
   catch(NullPointerException e2) {    
    e2.printStackTrace();
    Log.d("NoteListFragment", e2.getClass().getName() + " : " + e2.getMessage());

    TextView tv = new TextView(getActivity());
    tv.setText(text);
    tv.setId(android.R.id.empty);
    
    ViewParent v = getListView().getParent();
    if(v instanceof ViewGroup) {
     ((ViewGroup)v).addView(tv);
    }
    getListView().setEmptyView(tv);
   }
  }
 }

Android Developer Lab Tokyo 2011 のノートパッドをカスタマイズしてみた。

2011-07-04T04:58:00.009+09:00

7月2日と3日に「Android デベロッパーラボ東京 2011」が開催されました。

「Android デベロッパーラボ東京 2011」開催のお知らせ - Google Japan Developer Relations Blog -

私は両日ともチューターとして参加してきました。

参加者は80人 x 2 くらい

午前中に Android の Advocate の方のセッションがあって、
午後から実際に手を動かすという内容でした。

ハッシュタグは #adl11jp で

すでに Togetter にまとめがあります。ありがとう @mrshiromi さん。
Togetter - 「#adl11jp Android Developer Lab 2011 7/2-3」 -

午後のコードラボの資料は

Android Developer Lab — Tokyo 2011

にあります。(http://j.mp/adltokyo2011)

Android developers のサイトにある Notepad Tutorial を Honeycomb 用にカスタマイズするというコンテンツです。
もともとは I/O Bootcamp Honeycomb Codelab で行われたものなのですが、これよりも簡単になっています。

最後までいくと、こんな感じになります。

せっかくなので、カスタマイズしてみました。

・全体的に余白をいれる
・背景を変える
・レイアウトを変える
　　・保存ボタンの位置を変える
　　・Body 部分を上揃えにする
　　・Title 部分を１行固定にする
　　・保存ボタンのスタイルを変える
　　・リストの区切り線を変える
　　・Title と Body の文字の大きさを変える
・アクションバーをカスタマイズする
　　・背景を変える
　　・ロゴを使う
　　・メニューボタンの文字色を変える
　　・メニューボタンを押したときの色を変える
・ノートがないときにリスト部分に "No Notes Yet" とでるようにする
・開いているノートがどれかわかるように
　　・リストのアイテムを CheckedTextView にする
　　・チェックマークを変える
・タイトルなしで保存しようとしたとき、日時の入ったタイトルを自動でつける

やったのはこのくらいかなー。

ソースは github で公開しました。
yanzm/CustomizedHoneycombNotepad - GitHub -

できあがりはこんな感じ。

まだノートがない場合

リスト部分にチェックマークでるようにしてみた。

アクションバーのボタンを押したとき。赤くしてみた。

保存ボタンを押したとき。これも赤くしてみた。

個々のカスタマイズ tips もいずれブログに書きたいなー。。。

　

Y.A.M の 雑記帳

ColorPicker の Action Provider を作った

Android 4.0.3 Platform

API Overview

Android ADKを使ってバルスって言ったら青色LEDが光るようにしてみた。

Android Hello ADK つくった！

Android DialogFragmentを使うときの注意点。

Android 4.0 で TextView のレイアウトが変わる？

第3回名古屋android勉強会 Fragment基礎講座/ハンズオン を行ったよ。

Android AlertDialog の背景を変更する for 4.x

Bootcamp 2011 に行ってきました。

Android 4.0 Platform

API Overview

■ Social APIs in Contacts Provider

User Profile

Invite Intent

Large photos

Contact Usage Feedback

■Calendar Provider

Event intent

■ Voicemail Provider

■ Multimedia

Media Effects

Remote control client

Media player

Media tyes

■ Camera

Face detection

Focus and metering areas

Continuous auto focus for photos

Other camera features

Camera broadcast intents

■ Android Beam (NDEF Push with NFC)

■ Wi-Fi Direct

■ Bluetooth Health Devices

■ Accessibility

Explore-by-touch mode

Accessibility for views

Accessibility services

Other accessibility APIs

■ Spell Checker Services

■ Text-to-speech Engines

Using text-to-speech engines

Building text-to-speech engines

■ Network Usage

■ RenderScript

■ Enterprise

VPN service

Device policies

Certificate management

■ Device Sensors

■ Action Bar

Split action bar

Action bar styles

Action provider

Collapsible action views

Other APIs for action bar

■ User Interface and Views

GridLayout

TextureView

Switch widget

Popup menus

Preferences

System themes

Options menu button

Controls for system UI visibility

■ Input Framework

Hover events

Stylus and mouse button events

■ Properties

■ Hardware Acceleration

■ JNI Changes

■ WebKit

Android Browser

■ Permissions

■ Device Features

Android SimpleCursorTreeAdapter を使う

Android Localeに対応した曜日や月の表記一覧を取得する

Android Apache HTTP Client と HttpURLConnection どっちを使うべき？

PreferenceActivity の CheckBox マークを変える

Y.A.M の雑記帳

Android　ADKを使ってバルスって言ったら青色LEDが光るようにしてみた。

Android　Hello ADK つくった！

Android　DialogFragmentを使うときの注意点。

Android　4.0 で TextView のレイアウトが変わる？

第3回名古屋android勉強会 Fragment基礎講座/ハンズオンを行ったよ。

Android　AlertDialog の背景を変更する for 4.x

Android　SimpleCursorTreeAdapter を使う

Android　Localeに対応した曜日や月の表記一覧を取得する

Android　Apache HTTP Client と HttpURLConnection どっちを使うべき？

Android　AsyncQueryHandler を使う

Android　SimpleCursorAdapter で ViewBinder を使う

Android　SharedPreference の実体ファイルの場所

Android　Scroll の終端のピカッを消す

Android　コードからステータスバーを開く

Android　Menu の背景を変えるその2

Android　NumberPicker を拡張して ItemPicker を作ってみた。

Android　FLAG_DISMISS_KEYGUARD と FLAG_SHOW_WHEN_LOCKED を使う

Android　Keygurad が外されたことを検知する

Android Market　Multiple APK Support

Android　TransitionDrawable を使う

Android　Spannable を使って文字列の一部を装飾する

Android　resource で integer を定義する

Android　AppWidget の PendingIntent で putExtra するときの注意

Android　In-app Billing Overview

Android　android:duplicateParentState