戌印-INUJIRUSHI- (Androidあれこれ)

Androidのプログラミングをメインにしてます。記事に貼られたソースコードはダブルクリックすることで行番号をはずしてコピーすることができます。

 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
08

スポンサーサイト

上記の広告は1ヶ月以上更新のないブログに表示されています。
新しい記事を書く事で広告が消せます。

Android 2.x 向け ActionBar : ActionBarSherlock

2013/07/24 二リリースされた Android Support Library r18 より ActionBar が Support Library に含まれるようになりました。 (この記事書いた2日後…)
これから ActionBar の実装を考えられている方は公式である Support Library を使うようにしましょう。
Android 2.1 ~ 向け ActionBar : Android Support Library r18


Android 3.0 (API 11) から追加された ActionBar
Android Design でも重要視されているユーザインターフェースで、従来のタイトルバーの代わりにアプリのアイコン、タイトル名、オプションメニューを配置できるウィジェットです。

従来のタイトル
android_titlebar.png

ActionBar
android_actionbar.png

ActionBar は Android 3.0 から追加されたため、それ以前の Andoroid 2.x では使うことができません。
API Level 間の違いを解消するためのサポートライブラリである SupportPackage (*1) にも含まれていません。
そこで SupportPackage を拡張して作られた ActionBarSherlock ライブラリを使います。

ActionBarSherlock を使うことで、Android 2.x でも ActionBar を使うことができるようになりますが、apk のサイズが 300~400k 程大きくなる欠点があります。

*1 ADT r20 以降、プロジェクト作成時に自動で libs に作成される android-support-v4.jar


■ ダウンロード
ActionBarSherlock のトップページにある Download から zip ファイルを落とします。
2013/07/22 時点の最新版は v4.3.1


■ ライブラリプロジェクトのインポート
ActionBarSherlock はリソースファイルを扱うため jar ではなく、ライブラリプロジェクトになっています。
このライブラリプロジェクトのターゲットは Android 4.0 (API 14) になっているので、Android SDK Manager で Android 4.0 のパッケージをダウンロードしている必要があります

準備ができたらダウンロードしたファイルを解凍し、ハイフンの付いていない無印の actionbarsherlock をインポートします。
[ファイル] - [新規] - [プロジェクト] から [Android - 既存コードからの Andorid プロジェクト]
android_actionbar_project.png


■ ライブラリプロジェクトの参照
Android プロジェクトを作成しますが前述にも書いたように ActionBarSherlock のターゲットは Android 4.0 (API 14) になっているため、ライブラリを使用するプロジェクトの Target SDK は API 14 : Android 4.0 以上にする必要があります

プロジェクトが作成し終わったら、ActionBarSherlock を参照します。
作成したプロジェクトを右クリックし [プロパティー] を選択。
ライブラリーに ActionBarSherlock を追加します。
android_actionbar_libraryadd.png

Found 2 versions of android-support-v4.jar in the dependency list, but not all the versions are identical (check is based on SHA-1 only at this time)
とエラーが出た場合、プロジェクトと ActionBarSherlock の android-support-v4.jar のバージョンが異なっています。android-support-v4.jar を最新にしてクリーンするか、作成したプロジェクトから android-support-v4.jar を削除してください (ActionBarSherlock に含まれているため削除してもOK)


■ 実装
ライブラリプロジェクトを参照したことで後は実装するだけですが、ActionBarSherlock を使うには以下のルールを守る必要があります。
・SherlockActivity を継承する
・Sherlock のテーマを設定する


SherlockActivity を継承しているのにテーマが設定されない場合、コンパイルは通りますが実行時に以下のエラーが発生します。
java.lang.IllegalStateException: You must use Theme.Sherlock, Theme.Sherlock.Light, Theme.Sherlock.Light.DarkActionBar, or a derivative.


最初に表示した(↑にある) ActionBar は以下のソースコードによって形成されています。
package jp.inujirushi.android.sample;

import android.os.Bundle;
import android.view.Window;

import com.actionbarsherlock.app.SherlockActivity;
import com.actionbarsherlock.view.Menu;
import com.actionbarsherlock.view.MenuItem;

public class TestActivity extends SherlockActivity {

@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);

// テーマを設定する (必須)
setTheme(R.style.Theme_Sherlock);

// タイトルバーを非表示
requestWindowFeature(Window.FEATURE_NO_TITLE);

// レイアウトを設定する
setContentView(R.layout.activity_layout);
}

@Override
public boolean onCreateOptionsMenu(Menu menu) {
menu.add("HELP").setIcon(android.R.drawable.ic_menu_help)
.setShowAsAction(MenuItem.SHOW_AS_ACTION_IF_ROOM);
return true;
}
}
ActionBarSherlock ではテーマの設定は必須になりますが設定できるテーマは以下のとおり。
・Theme_Sherlock
・Theme_Sherlock_NoActionBar
・Theme_Sherlock_Light
・Theme_Sherlock_Light_DarkActionBar
・Theme_Sherlock_Light_NoActionBar

Theme_Sherlock は元のアクティビティ(ここでは黒色)。
Theme_Sherlock_Light は白色を基調としたテーマになります。
Theme_Sherlock なのに白いよー。という人は res/styles.xml を確認してください。
AppBaseTheme (または AppTheme) の parent が Theme.Light になっているので Theme または Theme.Black にすれば黒になります。
<!-- <style name="AppBaseTheme" parent="android:Theme.Light"> -->
<style name="AppBaseTheme" parent="android:Theme">
アクションバーを表示させても通常のタイトルバーは消えないので、requestWindowFeature(int featureId)
を呼んでタイトルバーを非表示にしています。
ここで import している Window クラスは android.view.Window。
com.actionbarsherlock.view.Window だと ActionBar が表示されませんでした。値一緒のはずなのに…。

ActionBar 右に表示されているオプションメニューを追加するには onCreateOptionsMenu(Menu menu) をオーバーライドします。
オプションメニュー選択時の操作は onOptionsItemSelected(MenuItem item)。
詳しい実装は ActionBar (Android3.0~) を書くときにでも(書けたらいいな)。


■ ダウンロードサイト
ActionBarSherlock

■ 参考サイト
ソフトウェア技術ドキュメントを勝手に翻訳 - 6.3 アクションバーの使用
gabuchanの日記 - Android 2.xでAction Barが使えるActionBarSherlockの使い方
TechBooster - ActionBarSherlockライブラリを使って、2.xでもActionBarを使用する
スポンサーサイト

Comments

Leave a Comment


Body
プロフィール

とむ・やむくん

Author:とむ・やむくん
管理人について

Windows 7 / 64bit
Eclipse 4.2 Juno (日本語パッチ済)

スポンサーサイト
最新トラックバック
検索フォーム
ブロとも申請フォーム
QRコード
QR
Twitter
2013/01/04 19:00 カウント開始

上記広告は1ヶ月以上更新のないブログに表示されています。新しい記事を書くことで広告を消せます。