• Android Hacks —プロが教えるテクニック & ツール
  

今回は、「HACK#8 インテント入門」 (p.63～71) の内容について触れていきます。

インテントってなんぞや?

インテントとはアクティビティやアプリケーション間でのやり取りを行うための仕組みです。インテントを利用することで自アプリケーション内の画面遷移だけでなく、他アプリケーションと連携を取ることができます。

前回までの学習においても、画面遷移の際に (つまり、他のアクティビティを呼び出す際に)、インテントを利用していました。 startActivity() メソッドに渡していたアレですね。

        button_to_branch.setOnClickListener(new View.OnClickListener() {
            public void onClick(View v) {
                startActivity(
                        new Intent(RootActivity.this, BranchActivity.class) // <- これ。
                        );
            }
        });

「HACK#6 アクティビティ入門」においてこのようなコードが紹介された際には、この Intent クラスについては特に説明はありませんでした。

本書で「明示的 INTENT」と呼んでいる方法では、 setClassName() メソッドを用いて、呼び出そうとするアクティビティのパッケージ名とクラス名を指定しますが、同名のメソッドにはパッケージ名の代わりに Context オブジェクトを引数に取るものがオーバーロードされており (Activity クラスはこの Context クラスを継承している)、上記のコンストラクタはまさにこの「明示的 INTENT」を実現する 1つの方法と言えるものなのでしょう。

実際、setClassName() メソッドは this を返すので、上記のコードは以下のように書いても同様に動作することが確認できます。

            public void onClick(View v) {
                startActivity((new Intent()).setClassName(RootActivity.this,
                        "jp.co.harapeko.testsome.BranchActivity")); // <- クラス名は省略できないっぽい…。
            }

次に「暗黙的 INTENT」ですが、

21:            Intent intent=new Intent();
22:            intent.setAction(Intent.ACTION_VIEW);
23:            intent.setData(uri)
24:            startActivity(intent);

Intent クラスにはアクションと URI を指定するコンストラクタもあるので、この部分は以下のように書くこともできます。

            Intent intent=new Intent(Intent.ACTION_VIEW, uri);
            startActivity(intent);

インテントフィルタ

今度はインテントフィルタを用いて、暗黙的 INTENT を利用して起動するアクティビティを作る方法が解説されています。

前回までの学習において、マニフェスト XML に、書くなと言われたり書けと言われたりしていた <intent-filter> 要素がここにきて登場します。

            <intent-filter>
                <action android:name="android.intent.action.VIEW" />
                <category android:name="android.intent.category.DEFAULT" />
                <category android:name="android.intent.category.BROWSABLE" />
                <data android:scheme="http" />
            </intent-filter>

DEFAULT カテゴリは要らんのかなと思ったのですが、消した状態でやってみたら暗黙的 INTENT で呼び出されなくなっちゃいました。ドキュメントを見てもよくわからなかったのですが (^_^;、これがないとデフォルトでは暗黙的 INTENT における起動の対象にはならない、ということなのでしょうか。

対応するスキーマを増やしたい場合は、 <data> 要素を単に増やせばよいようです。

                <data android:scheme="http" />
                <data android:scheme="https" />
                <data android:scheme="ftp" />
                <data android:scheme="ftps" />

なお、起動される側のアクティビティにおける実装ですが、

6:        if(!getIntent().getAction().equals(Intent.ACTION_MAIN)){
7:            //暗黙的に起動された場合

ここは以下のように書いた方が良さそうです。

        if (Intent.ACTION_VIEW.equals(getIntent().getAction())) {
            // 暗黙的に起動された場合

if ブロック内の処理内容が VIEW アクションの時にのみ行われるべきものであるから、というのもあるのですが、なによりこのアクティビティが明示的 INTENT から起動した場合、 getIntent().getAction() が null を返すために、サンプルコードのままだと java.lang.NullPointerException 例外が送出されてしまうからです。

シェルの am コマンドでインテントをテスト

まとめると、

• am start -n (パッケージ名)/(クラス名) …明示的 INTENT
• am start -a (アクション名) -d (URI) [ -t (MIME タイプ)] …暗黙的 INTENT
• am broadcast -a (アクション名) …BroadcastIntent

といった感じです。

BroadcastIntent

アクティビティ以外のクラスを作るのは何気に初めてなんじゃないでしょうか。 Eclipse にもまだあんまり慣れていないので、ここらで新規にクラスを追加する方法をおさらいしてみます。

1. Package Explorer にて、プロジェクトツリーの「src/(パッケージ名)」を右クリックし、コンテキストメニューから「New > Class」を選択する。
   
   

   Eclipse でクラスの新規追加 - コンテキストメニュー

   • プロジェクト名を右クリックして、でも良いのですが、パッケージ名を右クリックしていた場合、次の「New Java Class」ダイアログでパッケージ名を入力する手間が省けます。
2. 「New Java Class」ダイアログにて、「Name」にクラス名、「Superclass」に継承する基底クラスの完全名称を入力する。
   
   

   Eclipse でクラスの新規追加 - New Java Class ダイアログ

   • 今回の場合、基底クラスの名称は「android.content.BroadcastReceiver」ですね。
   • 基底クラスの完全名称がわからない場合はその横にある「Browse…」ボタンをクリックして表示される検索ダイアログを利用すると便利ですよ。
3. クラスのソースファイルが作成されます。オーバーライドが必要なメソッドが始めから用意され、必要な import 文もすべてあらかじめ書かれた状態で作られるので、便利です。
   
   

   Eclipse でクラスの新規追加 - 追加されたソースファイル

FLAG_ACTIVITY_NEW_TASK フラグ

基本的には今までと同じように intent を生成しますが、アクティビティ以外からアクティビティを起動する場合には 5 行目のように :

intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);

を記述する必要があります。

ここ、さらっと書かれていますが、何気に重要なんじゃないでしょうか。要チェックです。実際、この行無しでビルドして、 BroadcastIntent を発行してみると、以下のログメッセージを伴うような例外が送出されます。

09-29 01:15:28.376: ERROR/AndroidRuntime(694): java.lang.RuntimeException: Unable to start receiver jp.co.harapekoinc.testintent.BootReceiver: android.util.AndroidRuntimeException: Calling startActivity() from outside of an Activity context requires the FLAG_ACTIVITY_NEW_TASK flag. Is this really what you want?

リファレンスにおける android.content.Context クラスの startActivity() メソッドの項にも以下のような記述があります。

Note that if this method is being called from outside of an Activity Context, then the Intent must include the FLAG_ACTIVITY_NEW_TASK launch flag. This is because, without being started from an existing Activity, there is no existing task in which to place the new activity and thus it needs to be placed in its own separate task.

Intent.FLAG_ACTIVITY_NEW_TASK フラグの説明も見ておきましょう。 Back Stack というのがあって、このフラグを指定すると Back Stack に新しいタスクを積むよ、というようなことが書いてあります。 Back Stack についてのドキュメントも目を通しておくと良さそうです。

実際のシチュエーション

BOOT_COMPLETED アクションはその名の通り、システム起動時に bloadcast されるアクションです。せっかくなので、システムを再起動して、ここで作ったアプリが自動的に起動するか試してみるといいと思います。エミュレータでやる場合、単にエミュレータを終了して起動し直してもシステムを再起動したことにはなりません。エミュレータの電源ボタンを長押しして、システムのシャットダウンを実行し、シャットダウン中の画面になるのを待ってから終了 (ここで待ち続けても多分終了しません…) し、再開する必要があります。

まとめ

そんなわけで今回は Android 公式のリファレンスも合わせて参照しながら進めてみました。学習の中で疑問点を見つけて公式情報に当たるというのはとても大切なことだと思います。

暗黙的 INTENT や BloadcastIntent については若干気になる仕様だなと思いました。開発者サイドとしてはプログラムの実装の中で完全にコントロールできるのでやりやすいっちゃやりやすいのですが、ユーザーに自分で設定できる余地が与えられていないのが気になります。特に BloadcastIntent に関しては、それによって実行される処理がユーザーにとって鬱陶しいと思われるようなものでは恐らく敬遠されるでしょうから、慎重に実装する必要があるでしょうね。

• Android Hacks —プロが教えるテクニック & ツール
  

今回は、「HACK#7 アクティビティ Hacks」 (p.58～63) の内容について触れていきます。

adb コマンドからアクティビティを起動

adb コマンドですが、SDK をインストールした際にパスを通した tools ディレクトリにはもはや存在しません。代わりに adb_has_moved.txt というふざけた名前のファイルが置いてあって、開くと次のように書かれています。

The adb tool has moved to platform-tools/

If you don't see this directory in your SDK,
launch the SDK and AVD Manager (execute the android tool)
and install "Android SDK Platform-tools"

Please also update your PATH environment variable to
include the platform-tools/ directory, so you can
execute adb from any location.

そんな訳なので、先ずはあらかじめ (SDK インストールディレクトリ)/platform-tools ディレクトリにもパスを通しておきましょう。

adb コマンドを単に実行すると、 shell 以外のサブコマンドの説明も含むヘルプが表示されます。それを読むとわかるのですが、 shell サブコマンドからアクセスできるシェルというのは、エミュレータを弄る回で扱ったエミュレータコンソールとは別物です。ちなみに、エミュレータコンソールのコマンドも adb コマンドの emu サブコマンドから実行できるようです。

アクティビティの有効・無効を動的に切り替える

このトピックは致命的なことに、アクティビティが有効になる/無効になると言うことがどういう事なのかがいまいちわかりづらくなっています。現象から言えることは、マニフェストに登録したアクティビティが <intent-filter> 要素を伴ってランチャーにアイコンを表示させるようにしていた場合、アクティビティが有効ならばそのアイコンが表示され、無効ならば表示されなくなる、ということだけでした。

もう一つのアクティビティが有効なときのランチャー画面

    @Override
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.main);
        
        button_enable_branch = (Button)findViewById(R.id.bt_enable_branch);
        button_to_branch = (Button)findViewById(R.id.bt_to_branch);
        pack_man = getPackageManager();
        com_name = new ComponentName(this, BranchActivity.class);
        is_enable_branch_activity = !(pack_man.getComponentEnabledSetting(com_name) ==
            PackageManager.COMPONENT_ENABLED_STATE_DISABLED);
        setButtonText();
        button_enable_branch.setOnClickListener(new View.OnClickListener() {
            public void onClick(View v) {
                if (is_enable_branch_activity){
                    pack_man.setComponentEnabledSetting(com_name, PackageManager.COMPONENT_ENABLED_STATE_DISABLED,
                        PackageManager.DONT_KILL_APP);
                }
                else {
                    pack_man.setComponentEnabledSetting(com_name, PackageManager.COMPONENT_ENABLED_STATE_ENABLED,
                        PackageManager.DONT_KILL_APP);
                }
                is_enable_branch_activity = !is_enable_branch_activity;
                setButtonText();
            }
        });
        button_to_branch.setOnClickListener(new View.OnClickListener() {
            public void onClick(View v) {
                startActivity(new Intent(RootActivity.this, BranchActivity.class));
            }
        });
    }

例によって変数名とかは結構変えてありますｗ。 RootActivity がこのアクティビティで、 BranchActivity が (有効/無効を切り替えられる) サブの方のアクティビティですね。 button_enable_branch がこの有効/無効を切り替える方のボタン (本書のサンプルにあった mButton に相当する方ですね)、そして button_to_branch が BranchActivity クラスとして定義されたサブのアクティビティに遷移するボタン、ということになります。

さて、このプログラムを実際に実行してみると、サブの方のアクティビティが有効な状態であれば (デフォルトではそうなっているはず)、以下のような画面が表示されます (ちなみに画像はちょうど「次の画面へ」ボタンを押しているところです)。

もう一つのアクティビティが有効な状態の時に、そのアクティビティを開こうとしているところ。

もう一つのアクティビティは問題なく開く。

もう一つのアクティビティが無効な状態の時に、そのアクティビティを開こうとしているところ。

アクティビティは無効なので開くことができず、エラーを表示してアプリは終了する。

実際、 Debug パースペクティブを開いてデバッグ実行してみると、この画面が表示されるまで進めた段階で、 LogCat に以下のようなログメッセージが出力されます。

09-25 08:48:58.955: ERROR/AndroidRuntime(468): android.content.ActivityNotFoundException: Unable to find explicit activity class {jp.co.harapeko.testsome/jp.co.harapeko.testsome.BranchActivity}; have you declared this activity in your AndroidManifest.xml?

これはまさしく、マニフェストに登録し忘れたアクティビティを開こうとしたときに出力されたのとまったく同じログメッセージです。すなわち、「アクティビティを無効にする」とは、「アクティビティがマニフェストに登録されていないような状態にする」ということなのでした。

そんな訳なので、

この Hack を利用して、特定の条件を満たした時しか表示されないようなアイコンがある隠し機能があるアプリを作ると面白いかもしれませんね。

といったような使い方をするのであれば、アプリケーションの画面遷移図において隔離されている (その画面に遷移する画面が存在しない) 状態に設計されている必要がある、という注意事項をわきまえなければならないことになります。

例えば、ゲームソフトのコンフィグでゲームのオープニングをスキップできるようにする場合、単純にオープニング用のアクティビティとゲーム本編用のアクティビティとでアイコンを差し替えるように作ろうとすると、ゲーム本編用のアクティビティを無効にした場合にゲーム本編が実行できなくなるという残念な障害にぶち当たるので、ゲーム本編に即座に飛ぶスキップ用のアクティビティを間に挟む必要があるよ、ということになるでしょう。

今回は以上です。

• Android Hacks —プロが教えるテクニック & ツール
  

今回は、「HACK#6 アクティビティ入門」 (p.41～58) の内容について触れていきます。

いよいよプログラミングです! 張り切っていってみましょう。

アクティビティって何だ?

アクティビティとは、画面を持った機能の単位を指します。 Android では、アクティビティ毎に状態を管理する仕組みがあり、特殊な場合を除いて画面の遷移もアクティビティ単位で行います。

なるほど。モバイル機器向けの OS と割り切ってか、アプリが画面を占有することが前提の世界観になっているわけですね。 Windows でのアプリ開発がウィンドウ主体で行われたり、 Web アプリのクライアントスクリプト部分の開発が DOM 主体で行われたりするのとはまた対照的です。

また、この Hack では本書のサンプルコードが利用できます。サンプルコードは trunk/Hack6/HelloActivity にあります。

こんな事が書いてありますが、この本、別に CD とかは付いてきません。いきなりこんなこと書かれちゃうと何の事やらさっぱりで混乱しちゃう読者とか結構いそうな気がするんですが… (^_^;)

で、その問題のサンプルコードですが、こちらのサイトから入手可能なようです。 Subversion で checkout できるのはいいですね。 git でコピーして改造コードを独自に管理したりするとなお幸せかもしれません。

…ですが、私はここは敢えてこのサンプルコードには手を出さず、本書に書かれたソースコードを手で入力しながら学習してみることにしました。写経は学習の基本です…多分。

さて、それでは本書に習って Eclipse 上で新規プロジェクトを作ってみましょう… おっと、そうだった。新規プロジェクトは、すでに開発環境の設定の際にお試しで作っちゃっていました。今回はこいつをそのまま利用することにします。

アプリケーションを実行するには図 6-3 のようにプロジェクトツリーでプロジェクトのルートを選択した状態で、再生ボタンの形をしたアイコンをクリックします (Run メニューの Run を選択しても可)。

これ、プロジェクトツリー上での選択は必ずしも必須ではないみたいです…。もしかしたら複数のプロジェクトが存在するようなケースではここでの選択が意味のあるものになるのかもしれませんが、とりあえず何も選択しないままツールバーの再生アイコンをクリックしても全く問題なく起動します。

むしろ、ここでエミュレータが初めて起動する際には、起動直後はエミュレータがロック状態になっていて、そのままではアプリが実行されないので、エミュレータ側でロックを解除してあげる必要があります。ロックを解除してしばらくすると、アプリが実行されるようです。

新規プロジェクト作成直後の実行画面

static な文字列管理は strings.xml で

ところでこの画面に表示されている文字列、いったいどこに書かれているんでしょう? メインアクティビティクラス (私の場合、今回は TestSomethingActivity.java) のソース中にはこんな文字列は存在しませんでした。

    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.main);
    }

setContentView メソッドで指定している R.layout.main は、自動的に生成される XML の画面レイアウトリソースです。

なるほど。それでは main.xml の内容を覗いてみましょう…。

<TextView  
    android:layout_width="fill_parent" 
    android:layout_height="wrap_content" 
    android:text="@string/hello"
    />

android:text という属性名があからさまにアヤシイですね! @ で始まるのは何かの識別子でしょうか? なんとなく、これは別のリソースを参照しているのではないかという気がします。

@string で始まっているので、 string.xml なんてファイルでもあるのかな? と Package Explorer の中を探ってみると… res/values の位置に、まさにそのものずばりのファイル strings.xml を見つけました!

新規プロジェクト作成直後の strings.xml

strings.xml を弄ってみた

ちなみに画面の雰囲気が大分変わってますが、実はここを弄っていた当初、スクリーンショットを撮るのに失敗していたようで、その後、さんざん弄った (Eclipse のフォント設定含めて^_^;) 後になって慌てて撮り直したためです… m(_ _)m

実行すると、以下のように表示されました。日本語も化けていませんね。大成功です v(^-^) 。

strings.xml 変更後の実行画面

アクティビティのライフサイクル

p.45～48 に渡って、アクティビティの生成、起動、中断、破棄などのライフサイクルと、それに応じて呼ばれるメッセージハンドラメソッドの説明、それらが呼ばれるタイミングを示した図が示されています。

「図6-12 画面が回転した時」とあって、ここの意味がよく分からなかったので調べてみました。実は私は Android 端末はまだ入手していないのでピンと来なかったのですが… (社費で中古の白ロムでも買おうかなぁ…)、どうやら画面を縦横に傾けるとアプリの画面もそれに応じて向きが変わるようになっていて、そのことを言っているようです。画面回転時の再描画を実現するために、一旦アクティビティを破棄して生成し直す、ということをやっていて、その辺の一連のメッセージが全部飛んでくるから適切に対処しなきゃいけない、という話なのでした。

アクティビティの遷移

画面遷移をするために他のアクティビティを起動させます。まずは起動するアクティビティを用意するために、 MainActivity.java をコピーして SubActivity.java を作成します。

これ、もうちょっと上手い方法は無いのでしょうか…? いろいろと実装してコード量が大きくなってしまったファイルをコピーして、不要なコードを削除して書き直す、というのはちょっと面倒です。かといって、単純にクラスを新規作成だと、 extends と、それに必要な import 行ぐらいは出力してくれるものの、それ以外のよく使うライブラリの import 行や onCreate() メソッドなどの冗長なコードを手作業で書き加える必要があるし、この後にまたコピペして作っているレイアウトリソースの XML ファイルも手作業で作らなきゃなりません。 XML ファイルのみを作成するウィザードは一応あるようですが、どうせならアクティビティ作成用のウィザードも ADT にて用意しておいていただきたいものです…。

10:    android:text="Sub activity"

もちろんここは、任意のテキストを指定できます。日本語でも問題ないようです。こんな感じで…ｗ

    android:text="飯でも食うか   ((( ´ω｀)=3"

main.xml を以下のように修正します。 (ボタンの使い方は「Hack #9 ボタンを使う」で詳しく紹介しています。ここではおまじないだと思ってそのまま入力してください。)

私自身がそうなのですが、未知の技術を習得しようとする人が、講義の中で本論ではない未知の記述が出てきた時によく使われる「おまじない」という言葉に戸惑ってしまう、ということは少なくないようです。よく分からないものをよく分からないまま、ブラックボックスのままの状態で後回しにされるのが苦手なんですね。そんなわけで、 HACK#9 の該当部分を先回りして読んでみました。内容を要約すると概ね以下の通りです。

• android:id 属性にボタン要素の ID を指定する。 @+id/(ID 名) のように書くことによって、 Java コード中から R.id.(ID 名) として参照することが出来るようになる。
• android:layout_width 属性に wrap_content と指定すると、ボタンの表示幅かボタン内のラベル文字列にフィットするようになる。
• android:text 属性にボタンのラベル文字列を設定する。

ここでは特に ID の指定と利用の方法が重要ですね。この予備知識を元に、その後に出てくる Java のサンプルコードを読んでみると、より理解がスムーズに行くのではないかと思います。

5～8行目の View、Button、OnClickListener、Intent クラスを使うために、 import 文を追加しています。

import 行の行数がやたらと多くなってしまう辺りは如何にも Java という感じですね。クラス内クラスはグロブ ((パッケージ).* みたいな書き方) じゃ拾えないですしね。ていうか、クラス内クラスはむしろ名前空間に展開しないでコード中で new View.OnClickListener() みたいに書かせちゃった方が、むしろセマンティクス的にも閲覧性は上がるような気もします…。

DDMS って何? LogCat って何?

さらにアクティビティを追加したことを AndroidManifest.xml に追記してやる必要があります。追記せずに SubActivity を起動させるとエラーが出てしまいます (図 6-16)。

ほぅほぅ、それは是非とも試しておかなきゃですね! というわけで、AndroidManifest.xml を弄る前にとりあえず実行して、ボタンを押すとエラー画面がでてアプリが終了してしまうのを確認しました。

で、ここまではよかったのですが、その直後。

DDMS のパースペクティブで LogCat のログを確認すると以下のようなエラーが赤い文字で出ているのがわかります。

さっぱりわかりません。 DDMS って何? LogCat ってどこで見れるの??

Web の時代に生きていることをこれほど感謝することはありませんね…。ぐぐればその答えはすぐに見つけることが出来ました。

DDMS は Dalvik Debug Monitor Server の略で、 Android には標準で装備されているものらしいです。 ADT プラグインを入れた Eclipse 上では Android SDK アプリのデバッグの際に Android 端末やエミュレータ上の DDMS と通信してデバッグを実現しています。上記の引用では恐らくデバッガそのもののことを DDMS と呼んでいらっさるのでしょう。

デバッガの話なのでデバッグ実行してあげる必要があるのですが、 Eclipse 上でツールバーの虫アイコンをクリックしてデバッグを開始しても、 LogCat とやらは表示されません。デバッグの状況をモニタするには、パースペクティブも Debug のものに切り替えてあげる必要があります。 Eclipse の画面右上の所にある「Debug」ボタンをクリックするか、または [Window] → [Open Perspective] → [Debug] メニューを選択すると、 Debug のパースペクティブに切り替えることができ、めでたく LogCat を拝むことができるようになります。

DDMS のパースペクティブで LogCat を確認

LogCat のログをテキストエディタにコピペしたところ

マニフェストの追記

クラスだけを追加して AndroidManifest.xml への追記を忘れることはよくある (筆者だけ?) ので、

いえいえ、多分私もしょっちゅう忘れそうです。しかしリソース XML 然り、クラスの冗長な部分然り、アクティビティの作成に際してはあまりにも多くの部分が冗長な手作業になっていて悩ましいところですね。なんかその辺自動化できるようなプラグインって無いのかなぁ… 自作するか?

状態の保存、復元

本書ではここからサンプルコードが変わるのですが、やってる内容的に言ってもこれだけのためにまた一からプロジェクト作り直すのも面倒だったので、これまで使ってきたプロジェクトに、そのままここからの内容を付け足していくことにしてしまいました。

で、思ったのですが、恐らくサンプルコードでは最初から用意してあるものの、本書では触れられていないためにひっそりとおまじない扱いにされている要素がいくつかあることに気づきました。やっぱり学習の基本は写経ですね! というわけでその辺について触れていきましょう。

追加すべき import 行

このサンプルプログラムではボタンの他にイメージビューと呼ばれるコントロールを利用しています。その為、以下の import 行を追加してあげる必要があります。

import android.widget.ImageView;

とはいえ、ボタンも同時に利用しているのですから、このように書くと、実際には以下のような記述になってしまうでしょう。

import android.widget.Button;
import android.widget.ImageView;

実際の開発ではこの 2つに限らず、 android.widget パッケージに含まれるたくさんのコントロールを同時に使うことになるのではないでしょうか。といったことを考えても、この 2行を、グロブを用いて以下のように 1行にまとめて書くように習慣づけた方が何かと捗るような気がします。

import android.widget.*;

それからもう一つ、このサンプルプログラムでは、乱数を生成するオブジェクトのクラス Random も利用していますので、以下の 1行も加えてあげる必要があります。これもまぁ、このパッケージの配下のクラスはいろいろと利用頻度高いんじゃないの? という配慮の元、グロブで書いちゃってますが、ここではふつーに完全修飾クラス名で書いちゃってもいいのかなとは思います。

import java.util.*;

画像リソースを用意する

05:    int[] images = new int[]{
06:        R.drawable.android, R.drawable.stamp
07:        , R.drawable.stamp2, R.drawable.mail};

Java なんだからカンマの手前で改行とかするなよみたいな野暮なことを言うつもりはないのですがｗ、この R.drawable.～ で始まる識別子、当然最初から用意されているわけもなく、この識別子によって参照されるリソースを自分で用意してあげる必要があります。

そのリソースとはつまり画像のことです。適当な画像ファイルを 4つばっかし作成し、それぞれ然るべき名前で特定の場所に保存しておいてあげる必要があります。その手順を以下に示します。

1. 適当な画像を用意します。画像の形式は JPEG か PNG 辺りが確実でしょう。
2. 画像のファイル名を、先ほどの識別子 R.drawable.～ の ～ の部分と同じになるように変更します。例えば、 R.drawable.android に対応するファイル名は android.jpg とか android.png とかになります。
3. 画像ファイルを、 (プロジェクトルート)/res/drawable-hdpi ディレクトリ下にコピーします。
4. Eclipse 上で [F5] キーを押し、 Package Explorer の表示を更新します。このとき、自動生成される R.java も更新され、先ほどの識別子が有効になります。

変数名を変えて入力してみよう

正直なところ、mButton とか mImageView とかみたいなハンガリアン記法的な名前規則がなんだか馬鹿みたいで私の性に合わないというのもあったので、メンバフィールドなどの変数名はもうちょっと意味のある名前に変えて入力していました。こうすることで、テキストに書かれているコードをただ書き写すのではなく、どの部分にどの変数を使うべきなのかと言うことをきっちり考えながら入力していくことになるので、理解も早くなるのではないかと思います。

状態保存のサンプルプログラム実行画面

まとめ

まだ初歩の初歩だというのにやたらと内容がゴージャスになってしまいました… orz この辺は慣れてきた中盤以降の方がメモも簡潔になっていきそうな予感もありますね。

ここまで文句ばかり書いていましたがｗ、実際にはかなり丁寧に説明が書かれていて、順を追って読みながら試していけば、すんなりと理解できるようになっているのではないかと思います。今後もこんな感じで学習を進めていきたいと思います。

しかし新規アクティビティ作成用のプラグイン欲しいなぁ… あれだけは本当にいただけないよなぁ… 後でまた少し探してみよう…。

今回は以上です。

• Android Hacks —プロが教えるテクニック & ツール
  

今回は、「HACK#4 エミュレータ入門」および「HACK#5 エミュレータ Hacks」(p.23~41) の内容について触れていきます。

AVD の作成

当面はコマンドラインからの作成が役に立ちそうなケースが思い浮かばなかったので、とりあえず AVD Manager にて作成する方法のみ押さえました。

作成の際に操作するダイアログの内容は、あとで AVD を編集するときに用いるダイアログとほとんど変わらないようです。つまり、ここで指定する内容は後で変更が可能である、かのように見えるのですが、実際に後で OS のバージョンや skin の大きさを変えたりすると、起動できなくなっちゃって、設定を戻しても起動できなくなっちゃって、結局 AVD イメージを捨てる羽目になった、ということがあったので、注意が必要そうです…。

もっとも、 AVD を捨てて作り直すのにそれほど時間は掛からないので、その辺は気軽に割り切ってやっちゃっても良さそうですが…。

SD Card は指定した容量とモロに同じ大きさのイメージファイルを作ってしまうので、テストに応じた最小限の容量に抑えるべきですね。ていうか圧縮ぐらいしてくれ…。

作成の際に設定項目「Snapshot」というのがあります。本書には説明がありませんでした。これはエミュレータの状態をスナップショットとして保存し、次回起動時に利用するという機能のようです (こちらのサイトが参考になりました…)。ただ、実際使ってみたのですが、私の環境では終了に時間がかかる割には起動が速くなるイメージがなかったので、それほどありがたみを感じていません…。

エミュレータを起動

これも AVD Manager からの起動のみ押さえました。 Eclipse からの起動は、とりあえず何か作ってみてからでいいかなぁと…。

エミュレータを操作

…また、キーボードショートカットの詳細については「Android デベロッパーズガイド」を参照してください。

何という丸投げ… (-_-;

とりあえずこの辺を眺めておけばよさげです…。

SD カード

AVD 作成時か起動時の話なので、 AVD Manager で設定できる以上、特に知ることもないかなと…。この後のエミュレータコンソールから SD カードの着脱が出来ると面白いんですが、そもそも Android の仕様的に電源が入った状態で SD カードを着脱するっていうことはあり得ないのかな…。

ネットワーク構成

ここは何かしらのアプリを作ったときでないと役に立たない情報なので、出来るよ、ということを知っておくにとどめて読み飛ばしました。

DNS 設定、プロキシ設定

この辺も予備知識程度ですね。

エミュレータコンソール

勢い勇んで Tera Term とか入れてみたんですが、何故か繋がらなかった… 結局いつも使ってる PuTTY ごった煮版で接続。何故か最初のコマンドは必ず失敗するんですが、それ以外は特に問題なく使えます。

Cygwin の telnet でも ok でした。そもそも日本語は通じないっぽいので、横幅 80桁固定が嫌じゃなければ Cygwin でも全く問題無さそうです。

ポートリダイレクト

これも予備知識ですね。読んでて一瞬 GDB って何だっけとか思ってしまった辺りに自分の経験値の低さを実感せざるを得ません… orz

位置情報の設定

これ、試してみたかったのですが、 geo コマンド発行後に、エミュレータ上の Web ブラウザで Google プレースに接続し、現在位置を認識しようとすると、何故かエミュレータ内で core dump してしまうようです…。自作アプリとかならうまく値が取れるようになるんでしょうか…?

ハードウェアイベント

テキストエディタで大量に event send コマンドを書きまくって、それをコンソール上で一気にコピペしてあげたりすると、オートパイロット的に動かせてなかなか便利です。タッチパネル操作もこれでできるんであれば、こいつで結合テストの自動テスト化は概ね完結できそうですね。

但し、私の環境では重い処理になる上に Windows 自体がブルーバックを起こしやすいため、非常にリスキーな処理になってしまいますが… orz

テキストを一気に…

event text コマンドでテキストを一気に入力できる、とあるのですが、私の環境だと (PuTTY でも Cygwin telnet でも) 確実にエミュレータがアプリケーションエラーを起こして強制終了してしまいます (エミュレータ内で core dump ではなくて、エミュレータ自体がこける) …。

ちなみに、ヘルプを見ると「メッセージは UTF-8 じゃないと駄目だよ」みたいなことが書いてあったので、 UTF-8 であれば日本語もいけるのかと PuTTY 経由で試してみたのですが、この場合今度は強制終了すらせずにハングアップして (応答がないままうんともすんとも言わない状態になって) しまいます…。はっきり言って使い物になりません orz

電源状態を制御

power status コマンドは、 not-charging の他に、 unknown, charging, discharging, full が指定できます。それぞれ、不明 (電池アイコンが「?」になる)、充電中、充電してない、充電完了、と動作します (discharging と not-charging の違いがよく分かりませんが…)。

充電されている量は power capacity (百分率) で指定できるようですね。残り電池容量に応じて動作を切り替えるようなアプリを作った際には役に立ちそうです。

ネットワーク状態、遅延・スピード設定

network speed full したときの network status の結果が 0 bits/s って表示されるのはいかがなものかと…

遅いスピードや遅延を設定すると、その分ちゃんと Web アクセスが重くなる辺りは、よくできてるなぁと思います。

電話の状態

gsm コマンドで、架空の電話番号から電話が掛かってきたり切られたり保留されたりするのをシミュレートできます。アプリ実行中に電話が掛かってきた、みたいなテストをしたいときに有効ですね。

コンソールから SMS

日本語は入力できるんですが、おもいっきり文字化けします…。

エミュレータの大きさ

エミュレータを実行中に大きさを変えられるのは有意義ではあるんですが、それを出来るようにするんだったらそもそもエミュレータウィンドウ自体のリサイズをマウス操作でできるようにしておいてよと突っ込みたくなるのは私だけでしょうか…。

スキン変更

そんなおしゃれ必要なの? とか思ってたらどうやら画面サイズのことだったようでなんとも… AVD Manager で AVD イメージ作成時に指定するものなのでここもスルーですね。

エミュレータ間通信

ポートリダイレクトを利用してエミュレータ間で通信できるよ、というお話でした。そもそも独自の通信機能を持ったアプリを作った時じゃないと役に立たないお話です。予備知識として押さえておくにとどめましょう。

エミュレータ間で電話やSMS

電話は特に問題ないのですが…

エミュレータ間で SMS

この辺、ロケールを日本語に設定しても改善されないので、エミュレータの仕様だと思って諦めるしか無さそうです… ていうか実機では実際ちゃんと動いてるのかなぁ…。

今回は以上です。

• Android Hacks —プロが教えるテクニック & ツール
  

当ブログではシリーズとして、上記書籍を参考に学習しながら、気づいた点などについてメモを残していくことにします。

今回は、開発環境の導入と設定までです。

「1章 Android 入門 Hacks」について

Android に関する簡単な紹介として、過去の歩み、 Android マーケット、 OESF について触れています。それから日本語アプリをいくつか紹介。次に SDK のバージョンについて触れ、バージョン毎のシェアの推移がグラフでまとめられています。

日本の会社が書いた書籍だけあって、日本の事情が加味された紹介になっていますが、予備知識としてもさらっと流しておけばよさげです…。お急ぎの方は読み飛ばしちゃってもいいかもしれません。

OESF の認定資格とか、取りたがる人いるのかなぁ…。

開発環境の設定

というわけで、「2章 初級アプリケーション Hacks」からがいよいよ実践になります。先ずは開発環境の導入です。

まず予備知識ですが、 Android SDK を用いて普通に開発するのであれば、開発言語は基本的には Java になります (フレームワークを使って JavaScript+HTML5 で開発とかも出来るらしいですが本書では多分触れられていません)。また、 IDE に Eclipse を (Google が配布している ADT プラグインとセットで) 使用することが推奨されているようです。

つまり、導入すべき基本構成は以下の通りとなります (導入順)。

1. Android SDK
2. JDK
3. Eclipse
4. Android SDK の各種コンポーネント
5. ADT (Android Development Tools) プラグイン

以下、導入順にメモを残します。

1. Android SDK

ここにある書庫ファイルをダウンロードして、ローカルディスク上に展開します。場所はどこでもいいみたいですが、当面 Windows XP を使用する私はとりあえず C:\ の直下に展開しました。

2. JDK

Windows で JDK 5、もしくは JDK 6 が入っていない場合はインストールしてください。これは Eclipse の動作に必要です。どちらも入っていない場合は JDK 6 をインストールしてください。

本書発行時には存在していなかった JDK 7 がリリースされていたので、それをインストールしちゃいました。後で動かしてみて駄目だったら入れ直します…。多分大丈夫だと思うんですけどね。

3. Eclipse

用途別なのか何なのか、とてつもなくいろんな種類のバージョンが存在していて激しく戸惑うのですが、本書にはその中からどれを選べと言うことは特に書かれていません。多分ここはあんまり考えても仕方ないところだと思うので、素直に「Eclipse Classic 3.7」というのを選んでダウンロードし、インストールしました。 Eclipse 自体は優れた IDE なのだと思うので、他の用途でも試してみたいところなのですが (C++ とか C++ とか C++ とか)、その為のプラグインは後からでも必要に応じて入れてあげればいいでしょう。

ちなみに、本書では以下のように書かれていますが、

Android SDK 2.2 リリース時点で Eclipse 3.4 か 3.5 を使うことができます。この章では Eclipse 3.5 で解説を進めます。

stable なバージョンを入れた方が後々いろいろとありがたいと思うので、あまり考えずに新しいのを入れればいいと思います。

# Linux ではまだ試してないのですが、まともなディストリビューションを使っていてパッケージ管理ツールから導入が出来るんであればその方がいいかもしれません。

こちらも単に書庫ファイルを展開してあげればいいだけです。 Windows の場合は %ProgramFiles% の配下に入れてあげたくなるところですが、 Vista や 7 をお使いの方は十分注意してください。私は持って無いので試せません、あしからず… m(_ _)m

4. Android SDK の各種コンポーネント

1. コマンドラインから <SDK ルートディレクトリ>/tools にある android を起動、もしくは Eclipse で [Window] → [Android SDK and ADV Manager] を選択します。

この「Eclipse で～」という説明は嘘です。なぜなら、この後にインストールする ADT プラグインが入っていなければこのメニューは出現しませんし、先に ADT プラグインだけをインストールしても、 Android SDK が見つからない、というようなエラーが出てきて何も出来ないからです。

1. <SDK ルートディレクトリ>/SDK Setup.exe を実行します。

このプログラムのファイル名は、現在では SDK Manager.exe に変更されています。

すべてのコンポーネントを選択してダウンロードすると非常に時間がかかります。

私はこの大切な 1行を見落としたまま、勢いすべてのコンポーネントをダウンロードしに行ってしまいました。他に用事があったのでその間に済めばと思ったのですが、半日潰れてしまう上に、途中で通信上の問題が発生したりするとハングアップ (動きが止まったまま先に進まない) してしまったりするので、お勧めしません…。

開発ターゲットとなるプラットフォームのバージョンを選んで、それ用の Android コンポーネントと Google APIs コンポーネントを入れれば、とりあえずは十分っぽいです。サードパーティのコンポーネントについては、特に贔屓にするような事情があるわけでもないならば、後回しでよさげです。

# ちなみに、巷で出回っている Android 2.3 というのは、 2.3.1 と 2.3.3 のどちらなのでしょう…??

5. ADT プラグイン

概ね本書の説明通りでインストールできました。「Finish」ボタンを押した後、なにやら警告ダイアログが表示されましたが、「Continue」を押しておけば良さそうです。

プロジェクトを試しに作ってみる

3. 図 3-2 のように各項目を設定します。

馬鹿みたいにコンポーネントを全部入れてしまったおかげで、やたらと縦に長いダイアログになってしまいました (^_^; 。

新規プロジェクト作成時のダイアログ

ここで「Finish」を押すと、どうやらプロジェクトは作られるようなのですが、特に画面の表示は変化しません。 Eclipse は使い慣れていないので微妙に戸惑いましたが、 [Window] → [Open Perspective] → [Java Browsing] を選んであげれば、プロジェクトのソースファイルにアクセスできるようです。

本日はここまで。