入门指南
获取AK
创建项目
按以下步骤新建一个 Empty Activity 的应用项目。
启动 Android Studio。如果您看到 Welcome to Android Studio 对话框,请选择 Start a new Android Studio project,否则,请点击 Android Studio 菜单栏中的 File,然后点击 New->New Project,按提示输入您的应用名称、公司域和项目位置。 然后点击 Next。
选择您的应用所需的机型。 如果您不能确定自己的需要,只需选择 Phone and Tablet。然后点击 Next。
在“Add an activity to Mobile”对话框中选择 Empty Activity。 然后点击 Next。
按提示输入 Activity 名称、布局名称和标题。 使用默认值即可。 然后点击 Finish。
下载并安装地图开发包
操作步骤具体参考开发指南中的工程配置与说明中添加SDK相关JAR包和SO步骤。
工程配置
1.配置权限
为确保程序正常运行,需要在配置文件AndroidManifest.xml中添加相应的使用权限,如网络定位服务、手机连接状态、存储状态等,代码如下:
<!-- 允许程序打开网络套接字 --> <uses-permission android:name="android.permission.INTERNET" /> <!-- 允许程序访问网络状态 --> <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" /> <!-- 允许用户改变网络连接状态 --> <uses-permission android:name="android.permission.CHANGE_NETWORK_STATE" /> <!-- 允许用户访问WiFi网络信息状态 --> <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" /> <!-- 允许用户改变WiFi连接状态 --> <uses-permission android:name="android.permission.CHANGE_WIFI_STATE" /> <!-- 程序访问粗略位置 --> <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" /> <!-- 允许用户访问精确位置 --> <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" /> <!-- 允许程序读取手机状态 --> <uses-permission android:name="android.permission.READ_PHONE_STATE"/> <!-- 允许程序写入外部存储设备 --> <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>
2.在AndroidManifest中添加Android版本支持
基于SDK开发,要求Android2.3及以上版本,需要在AndroidManifest.xml中进行如下设置,例如
<user-sdk android:minSdkVersion="9"/>
连接 Android 设备
了解您的应用实际运行情况的最简单方法是将 Android 设备与计算机相连。 按照说明在您的 Android 设备上启用开发者选项,并配置您的应用和系统以检测设备。
此外,您也可以使用 Android 模拟器来运行您的应用。 使用 Android Virtual Device (AVD) Manager 来配置一台或多台虚拟设备,您可以将设备与 Android 模拟器联用来构建和运行您的应用。
构建和运行您的应用
在 Android Studio 中,点击 Run 菜单选项(或 play 按钮图标)运行您的应用。
提示您选择设备时,选择下列选项之一:
选择与您的计算机相连的 Android 设备,此外,还可以选择 Launch emulator 单选按钮,然后选择您之前配置过的虚拟设备 点击 OK。 Android Studio 将调用 Gradle 构建您的应用,然后在设备或模拟器上显示结果。应用打开可能需要几分钟的时间。
您可以看到在您的项目里有地图展示。如果您未看到地图,那请检查您是否联网,如果您看到了地图,但是不能使用POI搜索和路径规划等相关功能,请确认是否在AndroidManifest.xml中添加了您的AK。