您的位置: 首页  >  IT文章  >  arcgis for android 第一个例子（翻译） 原文地址：https://developers.arcgis.com/android/latest/guide/develop-your-first-map-app.htm 用Java开发你的第一个地图应用程序

arcgis for android 第一个例子（翻译） 原文地址：https://developers.arcgis.com/android/latest/guide/develop-your-first-map-app.htm 用Java开发你的第一个地图应用程序

分类: IT文章 • 2024-04-03 11:43:30

用Java开发你的第一个地图应用程序

ArcGIS Runtime SDK for Android创建基本地图应用程序的过程，该应用程序使用Android Studio集成开发环境（IDE）使用特定的初始地图范围显示地图。

本教程是为Android Studio 3.1.2版编写的 - 不同的Android Studio版本在用户界面标题或选项的名称上可能略有不同。Esri建议使用最新的Android Studio稳定版。

相同的教程。

样本。

先决条件

在开始之前，请确保您已完成以下操作：

在Android Studio中创建一个新项目

欢迎”屏幕。从这里，您可以创建一个新的Android应用程序项目。

 

  • 单击“ 启动新的Android Studio项目”。

    文件”>“新建”>“新建项目”。

  • 在应用程序名称文本框中，键入显示地图。

    开发第一个地图应用。）

    下一步”。

    arcgis for android 第一个例子（翻译） 原文地址：https://developers.arcgis.com/android/latest/guide/develop-your-first-map-app.htm 用Java开发你的第一个地图应用程序
  • Next。
  • 下一步”。
  • 保留向导其余部分中的默认选项，然后单击“ 完成”。

    将打开一个新的Android应用程序项目，显示默认布局。

    • ArcGIS Runtime SDK for Android依赖项。

    添加ArcGIS Runtime SDK for Android AAR依赖项

    ArcGIS Runtime SDK for Android依赖项添加到您的app模块。这将在您构建应用程序时自动从Esri公共Bintray Maven存储库下载Android Archive（AAR）包。

    Android是一种权限分离的操作系统。您还将添加应用所需功能的权限。

     

  • 在Android项目视图窗口中的Gradle Scripts下，双击build.gradle（项目：<项目名称>）。

    构建系统概述。

  • 在脚本的allprojects / repositories块中，添加一个新的maven块，如图所示，其值为url'https：//esri.bintray.com/arcgis '。完整部分现在看起来像下面的代码：
     
    allprojects {
  repositories {
    google()
    jcenter()
    
    // Add the Esri public Bintray Maven repository
    maven {
        url 'https://esri.bintray.com/arcgis'
    }
  }
}

    该指令通过指定Maven存储库URL告知Gradle在哪里查找适用于Android依赖项的ArcGIS Runtime SDK。

  • 在Android项目视图窗口的Gradle Scripts下，双击build.gradle（Module：<module name>）。

    构建系统概述。

  • 在脚本的依赖项块中，添加一个新行“ implementation'com.esri.arcgisruntime：arcgis-android：100.4.0'”。依赖块现在看起来应该像下面的代码 - 存在的依赖项的确切列表将取决于Android Studio的版本和所选的项目设置：
     
    dependencies { 
  implementation 'com.esri.arcgisruntime:arcgis-android:100.4.0' 
  implementation fileTree(dir: 'libs', include: ['*.jar'])
  [more dependencies...]
}

    实现。）

  • 在Android Studio工具栏中，单击“使用Gradle文件同步项目”。或者，当您在Gradle脚本窗口顶部看到自上次项目同步消息后Gradle文件已更改时，请单击立即同步。
    arcgis for android 第一个例子（翻译） 原文地址：https://developers.arcgis.com/android/latest/guide/develop-your-first-map-app.htm 用Java开发你的第一个地图应用程序
  • 在Android项目视图窗口的app> manifests下，双击AndroidManifest.xml。

    这将打开您的应用程序的清单文件。

  • 添加以下XML元素作为现有清单的子元素：
     
    <uses-permission android:name="android.permission.INTERNET" /> 
<uses-feature android:glEsVersion="0x00020000" android:required="true" />

    使用功能元素。

    • ArcGIS Runtime SDK for Android AAR 的依赖项添加到您的应用程序模块。接下来，您将向应用添加一个显示地图服务的地图，并为该地图设置初始范围。

    使用Java 8语言功能

    ArcGIS Runtime SDK for Android文档和示例中使用，因此，为确保在应用程序中使用这些代码示例进行编译，您将设置模块的兼容性以使用Java 8语言功能。

     

  • build.gradle（Module：<module name>）以再次打开app module gradle构建脚本。
  • 将以下指令添加到现有的android块。
     
    android {
  [...]
  // Add below lines to set compatibility with Java 8 language features for an Android app module.
  compileOptions {
    sourceCompatibility JavaVersion.VERSION_1_8
    targetCompatibility JavaVersion.VERSION_1_8
  }
}

    您现在可能需要再次同步gradle脚本。

    • 小费：

    项目结构”）。

    com.android.tools.build.gradle依赖项中指定的。

    将MapView添加到布局中

    MapView添加到活动布局中。

     

  • 在Android项目视图窗口的应用程序下，单击res> layout，然后双击activity_main.xml。

    content_main.xml布局。

  • 在窗口的左下角，单击“ 文本”以显示布局的XML视图（如果尚未显示）。

    默认情况下，布局XML文件中有两个标记。

    • 第一个是Android ConstraintLayout。这是一个可以显示其他视图的视图。它安排孩子们相对于彼此的观点。有关更多信息，请参阅Google 的约束布局和 用户界面文档。
    • 第二个是TextView，它是约束布局的子项，显示文本“Hello world！”。
  • 选择整个TextView XML元素并将其替换为MapView元素，如下所示：
     
    <com.esri.arcgisruntime.mapping.view.MapView
  android:id="@+id/mapView"
  android:layout_width="match_parent"
  android:layout_height="match_parent" >
</com.esri.arcgisruntime.mapping.view.MapView>

    • Constraint Layout文档。

    在MapView上设置地图

    MapView不显示任何内容，因此下一步是定义要显示的地图。您将指定地图显示ArcGIS Online中的全球地形底图。由于应用程序最初显示特定区域而不是整个范围通常更有用，您还可以将地图设置为放大到特定中心点 - 显示加利福尼亚州雷德兰兹的Esri校园。

     

  • 在Android项目视图窗口的app下，单击java> [package name]，然后双击MainActivity。

    这将打开定义应用程序默认活动的Java代码。

  • 将以下类变量声明添加到MainActivity类的顶部：
     
    private MapView mMapView;
  • Android Studio将以红色突出显示必须导入到类中的MapView类。将指针放在文本突出显示为红色的行上，然后按Alt + Enter解析符号。选择导入com.esri.arcgisruntime.mapping.view.MapView。
     
    import com.esri.arcgisruntime.mapping.view.MapView;
  • 在对setContentView的现有调用之后，将以下代码添加到onCreate方法：
     
    mMapView = findViewById(R.id.mapView);
ArcGISMap map = new ArcGISMap(Basemap.Type.TOPOGRAPHIC, 34.056295, -117.195800, 16); 
mMapView.setMap(map);
    注意：

    com.esri.arcgisruntime.mapping.Basemap。

    MapView中。

  • 将以下方法添加到MainActivity类，以覆盖从父活动类继承的onPause，onResume和onDestroy方法，这些方法在调用这些方法时暂停，恢复和释放MapView：
     
    @Override 
protected void onPause(){
  mMapView.pause();
  super.onPause();
}

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

@Override
protected void onDestroy() {
  super.onDestroy();
  mMapView.dispose();
}

    • 您现在已经完成了将ArcGIS Runtime SDK for Android地图添加到新Android应用程序的步骤。您现在已准备好构建和测试您的应用程序。

    构建并运行应用程序

    使用硬件设备。

     

  • “运行”。
  • 连接的设备”对话框中，选择要使用的设备或模拟器，然后单击“确定”。
  • 当应用程序在您的设备上打开时，它会显示以加利福尼亚州雷德兰兹为中心的街道地图。您可以双击地图进行放大。

    • 创建新项目时，Android Studio会自动创建运行配置以在您的设备上启动应用程序。您将看到类似于以下屏幕截图的内容。

    小费：

    android.permission.INTERNET权限是否已正确添加到Android清单中。

    arcgis for android 第一个例子（翻译） 原文地址：https://developers.arcgis.com/android/latest/guide/develop-your-first-map-app.htm 用Java开发你的第一个地图应用程序

    ArcGIS Runtime SDK。

    Display a Map示例中查看已完成的代码 

    相关推荐