Y.A.M の雑記帳: 6月 2015

2015年6月23日火曜日

AppCompat を継承したテーマで EditText のデフォルトスタイルを上書きするときは android:editTextStyle ではなく editTextStyle を使う

注意: appcompat-v7:22.2.0 での話です。将来 fix される可能性もあります。

AppCompat を継承したテーマで EditText のデフォルトスタイルを上書きしようとして android:editTextStyle を使うと、5系以降しか適用されないという落とし穴があります。

結論

android: をつけずに editTextStyle で指定すると4系にも適用されます。ただし、parent が Widget.AppCompat.EditText の場合、5系でカーソルが白になります（解説参照のこと）。

view plain print ?

<resources>
<style name="AppTheme" parent="Theme.AppCompat.Light.DarkActionBar">
<item name="editTextStyle">@style/EditTextStyle</item>
</style>
<style name="EditTextStyle" parent="Widget.AppCompat.EditText">
<item name="android:background">#ccccff</item>
</style>
</resources>

背景を変えたいだけなら android:editTextBackground と editTextBackground 両方を指定するほうが、カーソルの色を維持できます。

view plain print ?

<resources>
<style name="AppTheme" parent="Theme.AppCompat.Light.DarkActionBar">
<item name="android:editTextBackground">@drawable/blue</item>
<item name="editTextBackground">@drawable/blue</item>
</style>
<drawable name="blue">#ccccff</drawable>
</resources>

解説

1. デフォルトの状態

view plain print ?

<resources>
<style name="AppTheme" parent="Theme.AppCompat.Light.DarkActionBar">
</style>
</resources>

2. android:editTextStyle を指定した状態

view plain print ?

<resources>
<style name="AppTheme" parent="Theme.AppCompat.Light.DarkActionBar">
<item name="android:editTextStyle">@style/EditTextStyle</item>
</style>
<style name="EditTextStyle" parent="android:Widget.EditText">
<item name="android:background">#ffffff</item>
</style>
</resources>

3. editTextStyle を指定した状態

view plain print ?

<resources>
<style name="AppTheme" parent="Theme.AppCompat.Light.DarkActionBar">
<item name="editTextStyle">@style/EditTextStyle</item>
</style>
<style name="EditTextStyle" parent="android:Widget.EditText">
<item name="android:background">#ffcccc</item>
</style>
</resources>

EditTextStyle の parent が android:Widget.EditText なので、4.4.2 のカーソルの色が黒になってしまっています。

4. parent が Widget.AppCompat.EditText なスタイルを editTextStyle を指定した状態

view plain print ?

<resources>
<style name="AppTheme" parent="Theme.AppCompat.Light.DarkActionBar">
<item name="editTextStyle">@style/EditTextStyle</item>
</style>
<style name="EditTextStyle" parent="Widget.AppCompat.EditText">
<item name="android:background">#ccccff</item>
</style>
</resources>

今度は 5.0.0 のカーソルの色が白になった...

この白が何かというと、v12/values-v12.xml で android:textCursorDrawable に指定されている @drawable/abc_text_cursor_mtrl_alpha です。これに accentColor で tint するのが適用されず白くなっているようです。たぶん。

view plain print ?

<style name="Base.V12.Widget.AppCompat.EditText" parent="Base.V7.Widget.AppCompat.EditText">
<item name="android:textCursorDrawable">@drawable/abc_text_cursor_mtrl_alpha</item>
</style>

そこで、android:editTextBackground です。

android:editTextBackground

背景を変えるだけなら android:editTextBackground を指定するという方法もあります。ただ、こちらも落とし穴があり、
- android:editTextBackground // 5系にしか適用されない
- editTextBackground // 4系にしか適用されない
という状態なので、両方指定する必要があります。

5. android:editTextBackground を指定した状態

view plain print ?

<resources>
<style name="AppTheme" parent="Theme.AppCompat.Light.DarkActionBar">
<item name="android:editTextBackground">@drawable/yellow</item>
</style>
<drawable name="yellow">#ffff00</drawable>
</resources>

6. editTextBackground を指定した状態

view plain print ?

<resources>
<style name="AppTheme" parent="Theme.AppCompat.Light.DarkActionBar">
<item name="editTextBackground">@drawable/cyan</item>
</style>
<drawable name="cyan">#00ffff</drawable>
</resources>

7. android:editTextBackground と editTextBackground を両方指定した状態

view plain print ?

<resources>
<style name="AppTheme" parent="Theme.AppCompat.Light.DarkActionBar">
<item name="android:editTextBackground">@drawable/blue</item>
<item name="editTextBackground">@drawable/blue</item>
</style>
<drawable name="blue">#ccccff</drawable>
</resources>

2015年6月14日日曜日

android.support.annotation を活用する

利用するには dependencies に追加します。

view plain print ?

dependencies {
compile "com.android.support:support-annotations:22.0.2"
}

参考

上記のドキュメントに書いてありますが、例えば

@Nullable を指定している変数に対して NPE になるようなコードを書くと警告してくれます。

alt + enter で修正候補がでます。

2番目の Replace with 'd != null ?:' を選択するとこんな感じになります。

@NonNull が指定された変数に null を渡そうとすると警告してくれます。

リソースIDはどれも int なので、Drawable のリソースIDを意図しているところに別のリソースIDを渡すことができてしまいます。

そこで Drawable のリソースIDを意図しているところに @DrawableRes を付けると、別のリソースIDを渡そうとしたところがエラーになります。

@StringRes や @LayoutRes など主要なものはそろっています。なにがあるかは package summary で確認してください。

@IntDef や @StringDef では、int や String に対して取りうる値のセットが定義されたアノテーションを作ることができます。

view plain print ?

public static final int SIZE_L = 0;
public static final int SIZE_M = 1;
public static final int SIZE_S = 2;
@Retention(RetentionPolicy.SOURCE)
@IntDef({SIZE_L, SIZE_M, SIZE_S})
public @interface Size {
}
@Size
public abstract int getSize();
public abstract void setSize(@Size int size);

view plain print ?

public static final String FORMAT_XML = "xml";
public static final String FORMAT_JSON = "json";
@Retention(RetentionPolicy.SOURCE)
@StringDef({FORMAT_XML, FORMAT_JSON})
public @interface FORMAT {
}
public abstract void fetchData(@FORMAT String format);

@IntDef は enum だけでなく flag としても使うことができます。

view plain print ?

public static final int SHOW_TITLE = 0x1;
public static final int SHOW_SUB_TITLE = 0x2;
public static final int SHOW_ICON = 0x4;
@Retention(RetentionPolicy.SOURCE)
@IntDef(flag = true,
value = {
SHOW_TITLE,
SHOW_SUB_TITLE,
SHOW_ICON,
})
public @interface TitleOptions {
}

詳しくは Creating Enumerated Annotations を見るとよいです。

22.2.0で追加されたアノテーション

22.2.0 で新しく 13個のアノテーションが追加されました。上記のドキュメント及び android.support.annotation のパッケージサマリーにはまだないですが、そのうち更新されるでしょう。
Android Studio を 1.3 にしないと警告やエラーがでてくれないので注意です。

BinderThread
CallSuper
CheckResult
ColorInt
FloatRange
IntRange
Keep
MainThread
RequiresPermission
Size
TransitionRes
UiThread
WorkerThread

MainThread, WorkerThread, (BinderThread, UiThread), FloatRange, IntRange, Size, CallSuper, CheckResult, ColorInt, RequiresPermission は Google I/O 2015 のセッション「What's New in Android Development Tools」で紹介されていました。

実行スレッド系
- BinderThread
- MainThread
- UiThread
- WorkerThread

メソッドやクラスの実行スレッドを明記する。クラスにつけた場合はそのクラスのメソッド全てが対象になります。
MainThread と UiThread の違いがわからない...

↓バックグラウンドで @MainThread のメソッドを呼ぶと怒られます。

↓@MainThread がついてるメソッドで @WorkerThread のメソッドを呼ぶと怒られます。

値指定系
- FloatRange
- IntRange
- Size

@FloatRange

↓@FloatRangeの範囲外の値を指定すると怒られます。

Float とついているが double にも使えます。

@IntRange

↓@IntRangeの範囲外の値を指定すると怒られます。

Int とついているが long にも使えます。

@Size

@Size は size や length の指定ができます。文字列の長さや array, collection のサイズに使います。

multiple で約数を指定することもできます。

その他
- CallSuper
- CheckResult
- ColorInt
- Keep
- RequiresPermission

@CallSuper

↓@CallSuper を指定したメソッドをOverrideしてsuperを呼ばないと怒られます。

@CheckResult

↓@CheckResult を指定したメソッドを呼び出して戻り値を利用しないと怒られます。

@ColorInt

↓@ColorInt に color リソースID を渡すと怒られます。

@Keep

@Keep はビルド時に minified されたコードから外さないでほしいことを明示するためのアノテーションです。

@RequiresPermission

@RequiresPermission は必要なパーミッションを明示するためのアノテーションです。

view plain print ?

@RequiresPermission(Manifest.permission.NFC)
public abstract void scanNfc();

↓パーミッションが無い状態で、それを必要とするAPIを呼ぶと怒ってくれるようになりました。

2015年6月13日土曜日

ScrimInsetsFrameLayout を使うときは android:background を指定する

Android Design Support Library で NavigationView が用意されましたね。
ただ、すぐには移行できなかったり、NavigationView では今のものを置き換えられれない場合などもあるでしょう。

そうは言っても StatusBar 部分の処理だけでも取り込みたい、という場合 ScrimInsetsFrameLayout で包むという方法が使えます。

参考: http://stackoverflow.com/questions/26745300/navigation-drawer-semi-transparent-over-status-bar-not-working

ScrimInsetsFrameLayout はもともと Google I/O アプリで使われていたクラスで、android:fitsSystemWindows="true" で計算される領域と View の領域との差分領域を app:insetForeground で指定された色で塗るという処理をしています。

ScrimInsetsFrameLayout は FrameLayout を継承しているので ViewGroup です。ViewGroup は常に draw() が呼ばれるわけではなく、描画の必要があるときしか呼ばれません。そのため、ScrimInsetsFrameLayout に直接背景を指定しないと draw() が呼ばれず StatusBar 部分に app:insetForeground で指定した色が塗られません。

ScrimInsetsFrameLayout を継承している NavigationView ではコンストラクタで setBackgroundDrawable() を呼んでいます。

Design Support Library の ScrimInsetsFrameLayout は @hi de ですが、こんな感じでXMLで指定して使えます。

view plain print ?

<android.support.v4.widget.DrawerLayout xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:app="http://schemas.android.com/apk/res-auto"
xmlns:tools="http://schemas.android.com/tools"
android:id="@+id/drawer_layout"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:fitsSystemWindows="true">
<LinearLayout
android:layout_width="match_parent"
android:layout_height="match_parent"
android:orientation="vertical">
<android.support.v7.widget.Toolbar
android:id="@+id/action_bar"
android:layout_width="match_parent"
android:layout_height="?attr/actionBarSize"
android:background="?attr/colorPrimary"
android:theme="@style/ThemeOverlay.AppCompat.Dark.ActionBar"
app:popupTheme="@style/ThemeOverlay.AppCompat.Light" />
<FrameLayout
android:id="@+id/container"
android:layout_width="match_parent"
android:layout_height="match_parent" />
</LinearLayout>
<android.support.design.internal.ScrimInsetsFrameLayout
android:id="@+id/navigation_container"
android:layout_width="wrap_content"
android:layout_height="match_parent"
android:layout_gravity="start"
android:background="#ccc"
android:fitsSystemWindows="true"
app:insetForeground="#4000">
<fragment
android:id="@+id/navigation_drawer"
android:name="net.yanzm.navigationdrawersample.NavigationDrawerFragment"
android:layout_width="@dimen/navigation_drawer_width"
android:layout_height="match_parent"
tools:layout="@layout/fragment_navigation_drawer" />
</android.support.design.internal.ScrimInsetsFrameLayout>
</android.support.v4.widget.DrawerLayout>

values-v21/styles.xml

view plain print ?

<?xml version="1.0" encoding="utf-8"?>
<resources>
<style name="AppTheme" parent="BaseTheme">
<item name="android:windowDrawsSystemBarBackgrounds">true</item>
<item name="android:statusBarColor">@android:color/transparent</item>
</style>
</resources>

2015年6月12日金曜日

SharedPrefenreces の値変更 + RxAndroid で状態の変更を
バックグラウンドのActivityに伝える

前回のエントリ「状態の変更をバックグラウンドのActivityに伝える方法はどれがいいんだろう？」の 3) を RxAndroid を使って実装してみました。

onStart() で値をチェックするのではなく、SharedPreferences の値が true になったイベントと起動時の処理を同じストリームになるようにしてみました。

view plain print ?

public class MainActivity extends Activity {
@InjectView(R.id.list)
ListView listView;
private Subscription subscription = Subscriptions.empty();
private static final String FAVORITE_PREF_KEY = "favorite_changed";
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
ButterKnife.inject(this);
final SharedPreferences pref = getSharedPreferences("reload_flag", MODE_PRIVATE);
final Observable<List<String>> observable = ContentObservable.fromSharedPreferencesChanges(pref)
.filter(new Func1<String, Boolean>() {
@Override
public Boolean call(String prefKey) {
return FAVORITE_PREF_KEY.equals(prefKey) && pref.getBoolean(prefKey, false);
}
})
.startWith(FAVORITE_PREF_KEY)
.flatMap(new Func1<String, Observable<List<String>>>() {
@Override
public Observable<List<String>> call(String s) {
return Observable.create(new Observable.OnSubscribe<List<String>>() {
@Override
public void call(Subscriber<? super List<String>> subscriber) {
try {
subscriber.onNext(getDataFromServer());
} catch (Exception e) {
subscriber.onError(e);
}
}
}).subscribeOn(Schedulers.newThread());
}
});
subscription = AppObservable.bindActivity(this, observable)
.subscribe(new Subscriber<List<String>>() {
@Override
public void onCompleted() {
}
@Override
public void onError(Throwable e) {
e.printStackTrace();
pref.edit().putBoolean(FAVORITE_PREF_KEY, false).apply();
}
@Override
public void onNext(List<String> data) {
listView.setAdapter(new ArrayAdapter<>(MainActivity.this,
android.R.layout.simple_list_item_1, data));
pref.edit().putBoolean(FAVORITE_PREF_KEY, false).apply();
}
});
}
private List<String> getDataFromServer() throws Exception {
// mock
Thread.sleep(1000);
final Calendar c = Calendar.getInstance();
List<String> data = new ArrayList<>();
for (int i = 0; i < 20; i++) {
data.add(i + " : " + DateFormat.format("hh時mm分ss秒", c));
}
return data;
}
@Override
protected void onDestroy() {
subscription.unsubscribe();
super.onDestroy();
}
@OnItemClick(R.id.list)
void onItemClick(int position) {
Intent intent = new Intent(this, SubActivity.class);
startActivity(intent);
}
}


public class MainActivity extends Activity {

    @InjectView(R.id.list)
    ListView listView;

    private Subscription subscription = Subscriptions.empty();

    private static final String FAVORITE_PREF_KEY = "favorite_changed";

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        ButterKnife.inject(this);

        final SharedPreferences pref = getSharedPreferences("reload_flag", MODE_PRIVATE);

        final Observable<List<String>> observable = ContentObservable.fromSharedPreferencesChanges(pref)
                .filter(new Func1<String, Boolean>() {
                    @Override
                    public Boolean call(String prefKey) {
                        return FAVORITE_PREF_KEY.equals(prefKey) && pref.getBoolean(prefKey, false);
                    }
                })
                .startWith(FAVORITE_PREF_KEY)
                .flatMap(new Func1<String, Observable<List<String>>>() {
                    @Override
                    public Observable<List<String>> call(String s) {
                        return Observable.create(new Observable.OnSubscribe<List<String>>() {
                            @Override
                            public void call(Subscriber<? super List<String>> subscriber) {
                                try {
                                    subscriber.onNext(getDataFromServer());
                                } catch (Exception e) {
                                    subscriber.onError(e);
                                }
                            }
                        }).subscribeOn(Schedulers.newThread());
                    }
                });

        subscription = AppObservable.bindActivity(this, observable)
                .subscribe(new Subscriber<List<String>>() {
                    @Override
                    public void onCompleted() {
                    }

                    @Override
                    public void onError(Throwable e) {
                        e.printStackTrace();
                        pref.edit().putBoolean(FAVORITE_PREF_KEY, false).apply();
                    }

                    @Override
                    public void onNext(List<String> data) {
                        listView.setAdapter(new ArrayAdapter<>(MainActivity.this,
                                android.R.layout.simple_list_item_1, data));
                        pref.edit().putBoolean(FAVORITE_PREF_KEY, false).apply();
                    }
                });
    }

    private List<String> getDataFromServer() throws Exception {
        // mock
        Thread.sleep(1000);

        final Calendar c = Calendar.getInstance();

        List<String> data = new ArrayList<>();
        for (int i = 0; i < 20; i++) {
            data.add(i + " : " + DateFormat.format("hh時mm分ss秒", c));
        }
        return data;
    }

    @Override
    protected void onDestroy() {
        subscription.unsubscribe();
        super.onDestroy();
    }

    @OnItemClick(R.id.list)
    void onItemClick(int position) {
        Intent intent = new Intent(this, SubActivity.class);
        startActivity(intent);
    }
}

view plain print ?

public class SubActivity extends Activity {
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_sub);
ButterKnife.inject(this);
}
@OnClick(R.id.favorite_button)
void onFavoriteButtonClicked() {
// サーバー通信とかして、状態を変更できたとする
final SharedPreferences pref = getSharedPreferences("reload_flag", MODE_PRIVATE);
pref.edit().putBoolean("favorite_changed", true).apply();
}
}

SubActivity でボタンをクリックすると、MainActivity でリロードが走ります。

状態の変更をバックグラウンドのActivityに伝える方法はどれがいいんだろう？

Activity A
- リストを持つ、リストの項目には favorite ボタンがある
- リストの項目をタップすると Activity B に遷移する

Activity B
- favorite ボタンがある

このとき、Activity B で favorite ボタンの状態が変わったことを Activity A に伝えて Activity A の見た目を変えたい

Activity A に伝える方法は何が最適なんだろう？

1) otto/EventBus 系
2) BroadcastReceiver
3) フラグ（SharedPreferenceとか）を書き換えて、onStartでリロードをかける
4) onActivityResult でリロードをかける
5) Service で Binding（Serviceにキャッシュさせて onStart で毎回 Service から取得）
6) CursorLoader（cursor.registerContentObserver() を使って状態を監視している）
7) その他

悩ましい...

1)

otto/EventBus 系のエントリって、onResume() や onStart() で register して onPause() や onStop() で unregister しているものが多い、この場合 Activity A はバックグラウンドに回ってしまうので、使用例として適切ではないのかもしれない？
ちなみに EventBus の HOWTO では onStart() で register して onStop() で unregister している。
otto のサンプルでは onResume() で register して onStop() で unregister している。

2)

コードが見づらくなりそう？
（バックスタックの Activity を全部消したいときとかに使ってるらしい）
これも onResume() で register して onPause() で unregister するのがセオリーなんだろうなと思うんだけど、https://developer.android.com/training/run-background-service/report-status.html のサンプルは onCreate() で register して onDestroy() で unregister してた。ただわりと前のサンプルなのでなんとも言えない。

3)

わりと素直にかけそうだけど、ルールが見えづらいかも

4)

これのために startActivityForResult にするのもどうなんだろう

5)

これだけのために Service かー

6)

ContentProvider のデータを表示するときはこれが楽。ただし、ローカルデータだけならいいけど、サーバーが絡むと同期問題が...

登録: 投稿 (Atom)

2015年6月23日火曜日

AppCompat を継承したテーマで EditText のデフォルトスタイルを上書きするときは android:editTextStyle ではなく editTextStyle を使う

2015年6月14日日曜日

android.support.annotation を活用する

2015年6月13日土曜日

ScrimInsetsFrameLayout を使うときは android:background を指定する

2015年6月12日金曜日

SharedPrefenreces の値変更 + RxAndroid で状態の変更をバックグラウンドのActivityに伝える

状態の変更をバックグラウンドのActivityに伝える方法はどれがいいんだろう？

SharedPrefenreces の値変更 + RxAndroid で状態の変更を
バックグラウンドのActivityに伝える