概要
Android で MapView v2 を扱う。
とにかくいろいろハマったので手順をメモ。ウザいほど詳細にメモ。
巷には MapView の多彩なサンプルが煌びやかに並んでいますが
その裏には環境構築という苦行に苦しむ人々が数多くいます。
この記事により、どこかの誰かが少しでも救われれば幸いです。
とりあえず Windows 環境が前提です。他の環境でも流れが同じかどうかは知らない。
クイック備忘録
以下の情報を参照することが多いです。
- (※A) パッケージ名
- AndroidManifest.xml - package
- (※B) SHA1 fingerprint
- [Window] - [Preferences] - [Android] - [Build] - [Default debug keystore] - [SHA1 fingerprint]
- (※C) API Key
- Google Developers Console
- [Project] - [APIs & auth] - [Credentials] - [Public API access] - [API Key] - Google Play services プロジェクト
- {ADT 付き Eclipse のフォルダ}/sdk/extras/google/google_play_services/libproject/google-play-services_lib
- Google Play services サンプル
- {ADT 付き Eclipse のフォルダ}/sdk/extras/google/google_play_services/samples
- android-support-v4.jar
- {ADT 付き Eclipse のフォルダ}/sdk/extras/android/support/v4/android-support-v4.jar
欲張らずに行こう
とにかくハマりどころが多い。
欲張らずに最小の一歩をまず進めよう。今回踏み出す一歩が成功したなら、その後の道はたぶん楽。
まずはサンプルの実行を目指す
ゼロから作ろうとしない。
まずは Google Play services に付属のサンプル「maps」を正常に動かすことを第一目標としよう。
MapView のバージョンは v2 を使う
古い v1 や新しすぎる v3 を使わない。
まずは無難に v2 を動かすことを第一目標としよう。
一般的なネットワーク環境で実行する
プロキシとか挟まるとめんどくさい。
一般家庭のルータ経由や直接の3G回線など、ごくごく「普通の」ネットワーク環境で実行しよう。
手順概略
SDK とサンプルの入手
Eclipse の [メニュー] - [Window] - [Android SDK Manager] を開く。
Android SDK 4.4 (API 19) の中身ぜんぶチェック入れちゃう。
Extras の中にある Google Play services もチェック。ここに MapView のサンプルが入ってる。
ついでに、エミュレータを高速化するために「HAXM」も入れておくと良い。（※ただしここでインストールしただけでは機能しません。今回は解説しません。詳細はググりましょう。）
Installボタンを押すとLicense確認画面に進みます。
ライセンス読んで Accept しましょう。（意外とここでの Accept で漏れがあって一部インストールが行われない例が多い）
インストールはけっこう長いです。気長に待ちます。ネットワーク帯域使うのでテザリングとかではやらないほうが良いと思います。
Step2. サンプルのインポートとビルド
Google Play services のインポート
まずサンプルが依存するライブラリとして Google Play services が必要なので、インポートします。(上記手順で Google Play services がインストールされている必要があります)
{ADT 付き Eclipse のフォルダ}/sdk/extras/google/google_play_services/libproject/google-play-services_lib
- Root Directory を入力。上記 google-play-services_lib のフルパスを入れます。
- Refresh を押さないと一覧が出ないことがあります。押しましょう。
- インポートしたいプロジェクトにチェックを入れます。
- Copy projects into workspace にチェック入れておくのが無難です。（分からない場合）
- 問題なければ Finish を押してインポート実行。
インポートされました。
「Unable to resolve target 'android-9'」というエラーが出てますが気にしなくてOKです。
自動でSDKバージョンが変更され、ビルドは通ります。
サンプルプロジェクトのインポート
MapView のサンプルをインポートします。(上記手順で Google Play services がインストールされている必要があります)
{ADT 付き Eclipse のフォルダ}/sdk/extras/google/google_play_services/samples/maps
- Root Directory を入力。上記 maps のフルパスを入れます。
- Refresh を押さないと一覧が出ないことがあります。押しましょう。
- インポートしたいプロジェクトにチェックを入れます。（プロジェクト名が MainActivity となっているのはご愛嬌）
- Copy projects into workspace にチェック入れておいたほうが良いです。（分からない場合）
- 問題なければ Finish を押してインポート実行。
インポートされました。
「Unable to resolve target 'android-16'」というエラーが出てます。
このエラーは上述に同じく自動で修正されるので問題が無いのですが、別のエラーが発生しているためビルドに失敗しています。
まぁいろいろ出てます。
抜粋するとこのへんが目立つ。
error: No resource identifier found for attribute 'cameraBearing' in package 'com.example.mapdemo'
error: No resource identifier found for attribute 'cameraTargetLat' in package 'com.example.mapdemo'
error: No resource identifier found for attribute 'cameraTargetLng' in package 'com.example.mapdemo'
error: No resource identifier found for attribute 'cameraTilt' in package 'com.example.mapdemo'
error: No resource identifier found for attribute 'cameraZoom' in package 'com.example.mapdemo'
サンプルプロジェクトのライブラリ設定
プロジェクトを右クリック - [Properties] で Properties を開く。
Properties ウィンドウで [Android] を選択し、[Library] の [Add] を押す。
google-play-services_lib を選択。
追加された。「×」印が付いてるやつは無視して良いですが、気持ち悪ければRemoveすると良いです。
エラーが2個に減りました。
The project was not built since its build path is incomplete. Cannot find the class file for android.support.v4.app.Fragment. Fix the build path then try building this project
The type android.support.v4.app.Fragment cannot be resolved. It is indirectly referenced from required .class files
v4系のエラーが出ているので v4 のライブラリを追加します。
{ADT 付き Eclipse のフォルダ}/sdk/extras/android/support/v4/android-support-v4.jar
を見つけておきます。
プロジェクト内に libs フォルダを作成し、上記 android-support-v4.jar を libs にコピーします。
エラーが消えました。
ビルドは通りましたがまだ実行はできません。これから API Key を取得し、設定を行う必要があります。
Step3. キー登録
アプリケーションのパッケージ名を確認
アプリケーションのパッケージ名を確認しておきます。
ソース内フォルダ構成や、AndroidManifest.xml を見るとパッケージ名が分かります。
今回は「com.example.mapdemo」です。(※A)
API Key を取得
まずは Google Developers Console にアクセス。
Google にログインしていない場合はログインしましょう。
初めての場合は
「You don't have any projects!
Create a new project to get started.」
って言われるので、「CREATE PROJECT」ボタンでプロジェクトを作ります。
Project name、Project ID は適当に付ければ良いです。
できた。
必要な API を ON にする
Google Developers Console のプロジェクトページの左側のメニューから [APIs & auth] - [APIs] を開きます。
いろんなAPIのON/OFFができるので、とりあえずMap系全部ONにしちゃいましょう。
細かい切り分けは詳しくなってからで良い。
Geocoding API も ON にしておく。
それっぽいものを全部ONにした状態。
Step4. 実行
AVD 準備
AVD (Android Virtual Device) を用意します。エミュレータのことです。
Eclipse の [メニュー] - [Window] - [Android Virtual Device Manager] を開く。
Android Virtual Device Manager の [Device Definitions] タブで、
ベースとなる端末を選択し、[Create AVD] を押します。解像度は小さいほうがたぶん軽くて良い。
AVD の詳細を入力します。
- Target は Google APIs ではなく Android 4.4.2 を選ぶこと。
- CPU は Intel が良い。HAXM が導入されていればとても高速に動く。
- メモリは 512 程度が適切。大きすぎると AVD が起動しなかったりする。
[Android Virtual Devices] タブを開き、
作成された AVD を選択し、[Start] を押してみよう。
起動した。
こうなるまで待つ。
HAXM が有効なら30秒くらいでここまで来る。
HAXM がうまく動いていない場合、ここまで来るのにだいたい10分くらいかかる。
AVD に Google Play services を入れる
今回作成した AVD には Google Play services が入っていないので、adb コマンドを使って手動でインストールを行う。
情報元：
android - This app won't run unless you update Google Play Services. (via Bazaar) - Stack Overflow
まず、以下2つのapkをダウンロードする。
入手したapkを
{ADT 付き Eclipse のフォルダ}/sdk/platform-tools
に配置する。
コマンドプロンプトにて、以下を実行。
> cd {ADT 付き Eclipse のフォルダ}/sdk/platform-tools
> adb install com.android.vending-20140218.apk
926 KB/s (6951714 bytes in 7.323s)
WARNING: linker: libdvm.so has text relocations. This is wasting memory and is a security risk. Please fix.
pkg: /data/local/tmp/com.android.vending-20140218.apk
Success
> adb install com.google.android.gms-20140218.apk
916 KB/s (11267154 bytes in 12.003s)
WARNING: linker: libdvm.so has text relocations. This is wasting memory and is a security risk. Please fix.
pkg: /data/local/tmp/com.google.android.gms-20140218.apk
SuccessWARNINGはとりあえず気にしないでおく。
それぞれ「Success」という表示が確認できればOK。
これでやっとアプリケーションを実行する準備ができた。
Step5. 追加情報
困ったとき
以下を確認しましょう。
- Android SDK Manager で Google Play services はインストールしましたか？
- maps プロジェクトの依存ライブラリとして Google Play services は追加しましたか？
- maps プロジェクトの libs フォルダに android-support-v4.jar はコピーしましたか？
- Google Developers Console で API Key は取得しましたか？
- Google Developers Console で Map 系 API の STATUS を ON にしましたか？
- AndroidManifest.xml に API Key は記載しましたか？
- AVD の Target は Android 4.4.2 になっていますか？
- AVD に com.google.android.gms-20140218.apk, com.android.vending-20140218.apk をインストールしましたか？
- ネットワークは繋がっていますか？
最後のおまじない
参考サイト
- Google Maps APIの基本 （1/5）：CodeZine
- Maps API Keyの取得 - Android Wiki*
- android - This app won't run unless you update Google Play Services. (via Bazaar) - Stack Overflow
- eclipse - Security warning on libdvm.so noticed while deploying Android apps - Stack Overflow
- The sample of Google Maps Android API v2 com.example.mapdemo can not find file "R.java" - Stack Overflow
- Google Maps Android API v2のサンプルを動かしてみる 電脳羊（Android Dream）/ウェブリブログ
- crash - Google Maps Android API v2 - Sample Code crashes - Stack Overflow
- Android Maps V2 Quick Start
- Google Maps Android V2 APIキーでハマった点 - Qiita
- android - Google Maps API v2 grey screen - Stack Overflow
さいごに
ここまでたどり着くのに様々なサイトの情報を渡り歩き、優に30時間は費やしました。ただ、今回まとめた情報も1年後2年後には役に立たなくなるでしょう。
情報の代謝が加速していることを実感します。
常に新しい道しるべを残しましょう。