原文 Xamarin.android google map v2
- 从你计算机里的keystore里面查询个人的指纹凭证(SHA1)。
- 用SHA1指纹凭证到Google APIs网站申请key。
- 在Xamarin里的Android SDK Manager去安装Google Play services。
- 在Xamarin.Android项目中加入Google Play Services component。
(原生的Android项目必须在这一步骤加入google-play-services_lib的Library。) - 新建一个项目并且在AndroidManifest加入相关的权限设定。
- 在layout 画面的Main.axml 中加入地图控件
总结上述的步骤,在Android里面要使用Map这样的功能时,并不像IOS一样,只要拖拉一个MapView到你的Layout View就可以.所需要的步骤比较繁琐.这些步骤又可以被我们分为两大部份.要使用Google Map在你的装置上
- 首先你要先上Google APIs网站上去开启与Google Map相关的服务.
- 接着才到Xamarin.Android项目中进行所有需要的设定修改.
接下来我们就开始如何在Xamarin.Android项目里使用Google map的相关设定:
1.1在Xamarin环境中,当我们装好Xamarin.android后,我们要在底下的路径去取得你的SHA1指纹凭证。
指纹凭证被放置在debug.keystore里面,在Windows与OSX的存放路径不一样,请参考下列路径:
Windows - C:\Users\[USERNAME]\AppData\Local\Xamarin\Mono for Android\debug.keystore OSX - /Users/[USERNAME]/.local/share/Xamarin/Mono for Android/debug.keystore
1.2 开启终端机窗口,你可以直接输入底下指令来取得你的SHA1指纹凭证. 在[USERNAME]的部分必须要改成你的使用者名称。
keytool -list -v -keystore /Users/[USERNAME]/.local/share/
Xamarin/Mono\ for\ Android/
debug.keystore -alias androiddebugkey -storepass android -keypass android
指令执行成功后可以看到如下图的信息,其中SHA1算法后面有一串16进位的数值。这就你个人的指纹凭证,这部分是我们稍后在Google APIs网站上建立API Key会需要用到。
2.1前往Google APIS网站去建立你的Google API( https://code.google.com/apis/console/ )
按下画面中的Create Project 按钮来建立一个Google API Project
3.1 按下左边API Access的标签.
3.3 在建立钥匙的时候会需要刚刚在debug.keystore 里面的SHA1算法指纹凭证.
3.4 从计算机中复制你的SHA1算法,贴到Configure Android Key for Xamarin Google Map API Android v2 窗口里面。在你的SHA1指纹凭证后打上一个分号「;」接着输入你应用程序的package name. 新增完成后按下确定。
注:你的应用程序package name 是来自你在建立Android时,在AndroidManifest.xml档案里面所输入的 package name.这部分两边的设定若是不一样,或导致你的地图无法显示.
4.3 Binding Google Play Services
安装好Google Play Services后,接下来要在Xamarin.Android项目里面Binding Java binding library. 这边有两个方式来绑定:
- 使用 Google Play Services component
- 手动bind the Google Play Services client library,这个方法比较类似在eclipse中开发使用Google Map的方式
Google Play Services component是Xamarin帮我们简化的Binding Java binding library所需要做的步骤,只要引用这个组件,就可以很轻松的Binding Java binding library.所以在这部分我们选择使用Google Play Services component.
4.4 新增Google Play Services 组件
展开你的Android Map项目,在Components文件夹按下鼠标右键,在弹出的窗口上点选 Get More Components…
开启专案中的AndroidManifest.xml档案,新增下方的Xaml档案权限。
在 package="com.xamarin.docs.android.mapsandlocationdemo2"与 <permission android:name="<PACKAGE NAME>.permission.MAPS_RECEIVE" android:protectionLevel="signature" />
这两个地方要将package name修改成你的Package name.
标签里面Key值.这个Key是刚刚在Google APIs里面建立的API Key。完整的修改请参照下方Xml档案:
<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android" android:versionName="4.5"package="com.xamarin.docs.android.mapsandlocationdemo2" android:versionCode="6">
<uses-sdk android:minSdkVersion="14" android:targetSdkVersion="17" />
<!-- Google Maps for Android v2 requires OpenGL ES v2 -->
<uses-feature android:glEsVersion="0x00020000" android:required="true" />
<!-- We need to be able to download map tiles and access Google Play Services-->
<uses-permission android:name="android.permission.INTERNET" />
<!-- Allow the application to access Google web-based services. -->
<uses-permission android:name="com.google.android.providers.gsf.permission.READ_GSERVICES" />
<!-- Google Maps for Android v2 will cache map tiles on external storage -->
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<!-- Google Maps for Android v2 needs this permission so that it may check the connection
state as it must download data -->
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<!-- Permission to receive remote notifications from Google Play Services -->
<!-- Notice here that we have the package name of our application as a prefix on the permissions. -->
<uses-permission android:name="<PACKAGE NAME>.permission.MAPS_RECEIVE" />
<permission android:name="<PACKAGE NAME>.permission.MAPS_RECEIVE" android:protectionLevel="signature" />
<!-- These are optional, but recommended. They will allow Maps to use the My Location provider. -->
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
<uses-permission >android:name="android.permission.ACCESS_FINE_LOCATION" />
<application android:label="@string/app_name">
<!-- Put your Google Maps V2 API Key here. -->
<meta-data android:name="com.google.android.maps.v2.API_KEY" android:value="YOUR_API_KEY" />
</application>
</manifest>
<?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.MapFragment" />
注:要看到地图被加载,你的Android仿真器必须是要有支持Google Play service的版本。若是仿真器本身如果没有 支持Google Play service,那你的地图会无法显示.
- Obtaining a Google Maps API Key
http://docs.xamarin.com/guides/android/platform_features/maps_and_location/obtaining_a_google_maps_api_key - Maps API
http://docs.xamarin.com/guides/android/platform_features/maps_and_location/part_2_-_maps_api - Google Maps Android API v2
https://developers.google.com/maps/documentation/android/