Google Maps Android API v2 APP 開發步驟

網路上很多 Google Maps Android API v2 相關文章，但有各種不同講法，自己試了 1-2 個禮拜都沒有成功，最後結合網路找的資料跟 android sdk 內附的 maps 範例程式，總算成功試出來了，因此作下記錄。

準備工作…
一、建立 keystore 並取出 SHA1 碼。
　到 jre bin 目錄下 C:\Program Files\Java\jre6\bin\
　建立 keysor…
　　keytool -genkey -v -keystore yourkeyname.keystore -alias yourkeyname -keyalg RSA -keysize 2048 -validity 10000
　取出 sha1 碼…
　　keytool -list -v -keystore yourkeyname.keystore > save_sha1.txt
　　打開 save_sha1.txt 找到 sha1 碼
    　　SHA1：xx:xx:xx…

二、到 Google apis 申請 API key
　到 https://code.google.com/apis/console/
　Create project
　Services 中 google Maps Android API v2 點一下 off 改成 on
　API Access 中「Create new Android key」
　　輸入「sha1碼」+「;」+「your_package_name」
　　產生出 API key…
　　　Key for Android apps (with certificates)
　　　API key:AIzaSyB1yoElxxxxxxxx...

三、打開 Android SDK Manager 安裝  Google Play services，在 extra 底下。
　
四、將  google-play-services_lib import 進 Workspace。
　在 SDK 安裝目錄下 \extras\google\google_play_services\libproject\google-play-services_lib

開發專案…
一、建立新專案。

二、將 google-play-services_lib 函式庫加入專案中。
　project > properties >Android Library ， Add。

三、順便將 Android Lint Preferences > Correctness:Messages 中 Missing Translation 改為 Ignore。(忽略多國語言未翻譯的錯誤)

四、修改 AndroidManifest.xml，加入權限及 API key。
　application 內加入 api key…

        <meta-data
            android:name="com.google.android.maps.v2.API_KEY"
                    android:value="AIzaSyB1yoElxxxxxxxx..."/>

　接著 application 底下加入權限設定…

    <permission
        android:name="your_package_name.permission.MAPS_RECEIVE"
        android:protectionLevel="signature"/>
    <uses-permission android:name="your_package_name.permission.MAPS_RECEIVE"/>
    <uses-permission android:name="android.permission.INTERNET"/>
    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>
    <uses-permission android:name="com.google.android.providers.gsf.permission.READ_GSERVICES"/>
    <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION"/>
    <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"/>
    <uses-feature android:glEsVersion="0x00020000" android:required="true"/>

五、修改 activIty_main.xml，內容改成底下，最簡易 layout，只用 fragment …

<?xml version="1.0" encoding="utf-8"?>
<fragment xmlns:android="http://schemas.android.com/apk/res/android"
  android:id="@+id/map"
  android:layout_width="match_parent"
  android:layout_height="match_parent"
  class="com.google.android.gms.maps.SupportMapFragment"/>

 六、MainActivity.java 範例…

public class MainActivity  extends FragmentActivity {

    private GoogleMap mMap;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        setUpMapIfNeeded();
    }

    @Override
    protected void onResume() {
        super.onResume();
        setUpMapIfNeeded();
    }

    private void setUpMapIfNeeded() {
        // Do a null check to confirm that we have not already instantiated the map.
        if (mMap == null) {
            // Try to obtain the map from the SupportMapFragment.
            mMap = ((SupportMapFragment) getSupportFragmentManager().findFragmentById(R.id.map))
                    .getMap();
            // Check if we were successful in obtaining the map.
            if (mMap != null) {
                setUpMap();
            }
        }
    }
    private void setUpMap() {
        mMap.setMyLocationEnabled(true);
    }

} 

註：API LEVEL 8 以上 Android 2.2 以上才能支援 Google Play services。
註：keystore 可以用自己產生的(release用)，也可以用 debug 的。(在 C:\Documents and Settings\USER\.android\debug.keystore)