ArcGIS Runtime SDK for Android 项目教程

1. 项目目录结构及介绍

arcgis-runtime-samples-android/
├── java/
│   ├── sample1/
│   ├── sample2/
│   └── ...
├── kotlin/
│   ├── sample1/
│   ├── sample2/
│   └── ...
├── gradle/
│   ├── wrapper/
│   └── gradle.properties
├── LICENSE
├── README.md
└── settings.gradle

目录结构说明

• java/: 包含使用 Java 编写的示例代码模块。
• kotlin/: 包含使用 Kotlin 编写的示例代码模块。
• gradle/: 包含 Gradle 构建工具的配置文件，如 gradle.properties 和 wrapper 文件夹。
• LICENSE: 项目许可证文件。
• README.md: 项目说明文件，包含项目的基本信息和使用说明。
• settings.gradle: Gradle 项目设置文件，定义了项目的模块和依赖关系。

2. 项目启动文件介绍

启动文件

每个示例模块中都有一个 MainActivity.java 或 MainActivity.kt 文件，这是示例的启动文件。例如：

• java/sample1/src/main/java/com/example/sample1/MainActivity.java
• kotlin/sample1/src/main/java/com/example/sample1/MainActivity.kt

启动文件说明

• MainActivity.java/MainActivity.kt: 这是每个示例的主活动文件，负责初始化地图视图、加载地图数据和处理用户交互。

3. 项目配置文件介绍

配置文件

• gradle.properties: 包含项目的全局配置，如 API 密钥等。
• build.gradle: 每个模块的构建配置文件，定义了依赖项、插件和其他构建选项。
• settings.gradle: 定义了项目的模块和依赖关系。

配置文件说明

gradle.properties

# 设置 API 密钥
API_KEY = "YOUR_API_KEY"

• API_KEY: 用于访问 Esri 位置服务的 API 密钥。

build.gradle

plugins {
    id 'com.android.application'
}

android {
    compileSdkVersion 31
    defaultConfig {
        applicationId "com.example.sample1"
        minSdkVersion 21
        targetSdkVersion 31
        versionCode 1
        versionName "1.0"
    }
    buildTypes {
        release {
            minifyEnabled false
            proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
        }
    }
}

dependencies {
    implementation 'com.esri.arcgisruntime:arcgis-android:100.15.0'
}

• compileSdkVersion: 指定编译 SDK 版本。
• defaultConfig: 定义应用的基本配置，如应用 ID、最小 SDK 版本等。
• dependencies: 定义项目的依赖项，如 ArcGIS Runtime SDK for Android。

settings.gradle

include ':java:sample1', ':kotlin:sample1'

• include: 定义项目的模块，如 java:sample1 和 kotlin:sample1。

通过以上配置，您可以成功构建和运行 ArcGIS Runtime SDK for Android 的示例项目。