ArcGIS Developers 開発リソース集 > 技術 Tips 集 > ArcGIS Maps SDK for Kotlin > インストールガイド

インストールガイド

出典：ArcGIS Maps SDK for Kotlin - Guide - Install and set up

このインストールガイドでは、ArcGIS Maps SDK for Kotlin (バージョン 200.x) のインストールとセットアップ手順を紹介します。マップを表示する方法については「アプリの作成」のチュートリアルをご覧ください。

ArcGIS Developers のダッシュボードから各インストーラーやデータをダウンロードするには、ArcGIS 開発者アカウントでログインする必要があります。アカウントをお持ちでない場合は、サインアップ (無料) してください。アカウントの作成方法は「開発者アカウントの作成」をご覧ください。

ArcGIS Maps SDK for Kotlin をインストールする前に、開発マシンが動作環境を満たしていることを確認してください。アプリを実行するすべてのターゲットデバイスには、Android API レベルの最小バージョンが必要です。詳細については、システム要件を参照してください。

Gradle を使用してインストールすることをお勧めします。これにより、Esri の Maven リポジトリから必要な依存関係と SDK バイナリがインストールされます。

Gradle で API を取得する

既存の Android Studio プロジェクトか新しいプロジェクトを作成して、次のセットアップ手順を実行します。

settings.gradle ファイルの repositories ブロック内で、Esri の Maven リポジトリ URL を追加します。Esri のリポジトリはオープンソースではないため、google() や mavenCentral() からは使用できないため、この URL を指定する必要があります。

settings.gradle

dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        google()
        mavenCentral()

        // Esri の Maven リポジトリを追加
        maven {
            url 'https://esri.jfrog.io/artifactory/arcgis'
        }
    }
}

module レベルの build.gradle ファイルの dependencies ブロック内で、ArcGIS Maps SDK for Kotlin の依存関係をアプリに追加します。

注：この依存関係を、ArcGIS Maps SDK for Kotlin を使用する各モジュールに追加する必要があります。

build.gradle
```
dependencies {
    ...
    implementation 'com.esri:arcgis-maps-kotlin:200.2.0'
}
```
`
module レベルの build.gradle ファイルの android ブロック内に、ビューバインディングまたはデータバインディングを有効にするブロックがあることを確認します。ビューバインディングの詳細については、ビューバインディングを参照してください。データバインディングの詳細については、データバインディングを参照してください。

build.gradle
```
android {
    . . .
    buildFeatures {
        viewBinding true
    }

    // buildFeatures {
    // dataBinding true
    // }
}
```
module レベルの build.gradle ファイルの android ブロック内に、META-INFDEPENDENCIES ファイルの複製を除外する packagingOptions ブロックがあることを確認します。この設定により、META-INF ディレクトリにある同じファイルを出力に複数回含めようとした場合に発生するコンパイラーエラーを防ぐことができます。パッケージングオプションの詳細については、PackagingOptions を参照してください。

build.gradle
```
android {
    . . .
    packagingOptions {
        exclude 'META-INF/DEPENDENCIES'
    }
}
```

必要な権限と機能

Android は、権限が分離されたオペレーティングシステムです。アプリで使用する ArcGIS の機能によっては、マニフェストに権限を追加する必要がある場合があります。アプリに含まれていない機能の権限を含めないようにしてください。

アプリが Android API バージョン 22 以前で実行されている場合、インストール時にすべての権限が要求されます（許可または拒否）。アプリが Android API バージョン 23 以降で実行されている場合、アクセス許可が要求され、インストール時に自動的に付与されます。ただし、潜在的に危険な権限は実行時にリクエストする必要があり、そのためにはアプリにコードを追加する必要があります。まだ許可されていない場合は、Android フレームワークまたは Android サポートライブラリが、権限を確認して要求するために使用されます。詳細については、アプリの権限を宣言するとアプリの権限をリクエストするをご覧ください。

アクセス許可が必要な ArcGIS Maps SDK for Kotlin の機能

インターネットへのアクセス（ほとんどのアプリはこれを必要とします）：Android API 23 以降の標準の権限
デバイスの GPS にアクセスするための FINE_LOCATION の権限：Android API 23 以降での危険な権限

次のコード例（AndroidManifest.xml ファイルの場合）には、これらの権限が含まれています。

AndroidManifest.xml

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />

Android のストレージと権限

Android API Level 30 では、すべてのアプリは Android デバイスのファイルシステムにアクセスするために対象範囲別ストレージを使用します。対象範囲別ストレージを使用すると、アプリは (1)自身のファイル、および (2)メディアストア内の共有ファイルにアクセスすることができます。下記のパーミッションの宣言は、サポートされていません。

<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />

Android のストレージは、API レベル 29 以降、劇的に変化しています。Android のストレージとパーミッションの詳細については、次のリンクを参照してください。

OpenGL ES バージョンの宣言

Android マニフェストに uses-feature 要素を追加すると、Play ストアでアプリを正しいタイプのデバイスで利用できるようになります。

MapView（2D）を使用するアプリには、最小でも OpenGL ES 2.x が必要です。

<uses-feature android:glEsVersion="0x00020000" android:required="true" />

SceneView（3D）を使用するアプリには、OpenGL ES 3.x が必要です。

<uses-feature android:glEsVersion="0x00030000" android:required="true" />

追加のダウンロード

開発プロジェクトを強化するために、サンプルコードとデータの追加リソースを利用できます。このガイドを、スタンドアロンの開発者ドキュメントとしてダウンロードすることもできます。

サンプルコード

ドキュメントでサンプルの包括的なリストを参照するか、GitHub リポジトリからサンプルコードをダウンロードしてください。

ArcGIS Maps SDK for Kotlin Toolkit

ArcGIS Maps SDK for Kotlin Toolkit には、アプリ開発を簡素化するためのコントロールとユーティリティが含まれています。

スタンドアロンの開発者向けドキュメント

ダウンロードページから、開発者向けドキュメントをアーカイブとしてダウンロードできます。アーカイブには、ローカル Web サーバからドキュメントを提供する手順が含まれているため、インターネットに接続しなくてもドキュメントにアクセスできます。スタンドアロンドキュメントには、開発者ガイド、API リファレンス、チュートリアル、およびサンプルドキュメントが含まれています。このドキュメントは、ローカルのスタンドアロンコンピューターまたは内部ネットワーク上で実行するように設計されており、パブリックなインターネット上では実行できません。

ローカルでドキュメントを公開する方法：

使用する ArcGIS Runtime SDK のドキュメントをダウンロードします。ダウンロードしたファイルは、.zip アーカイブ形式になっています。
アーカイブをローカルフォルダに解凍します。解凍されたアーカイブには、public と install という 2 つのサブフォルダがあります。
install フォルダ内の README.md ファイルを開き、選択した Web サーバーの指示に従います。

注：ライブドキュメントサイトはリリース時及びリリースの間に定期的に更新されますが、スタンドアロンドキュメントは静的で、最初のリリース後は更新されません。

追加のデータ

Projection Engine データ

測地系変換は、ある空間基準から別の空間基準へジオメトリを投影する際に、2つの空間基準の基礎となる測地系に違いがある場合に使用されます。測地系変換は、数学的に定義する（方程式ベースの変換）ことも、外部のサポートファイルに依存する（グリッドベースの変換）ことも可能です。アプリでグリッドベースの変換を使用する場合、Projection Engine ファイルが存在する必要があります。API は、必要なファイルがローカルのファイルシステムで利用可能かどうかを検出することができます。Projection Engine ファイルが無い状態で変換をしようとすると、エラーが発生します。API は、必要なファイルがローカルファイルシステムで利用可能かどうかを検出できます。

グリッドベースの変換を使用している場合は、ダウンロードページからサポートする Projection Engine ファイルをダウンロードしてください。座標系、投影法、測地系変換の操作の詳細については、Spatial references のトピックを参照してください。

Electronic Navigational Charts (ENC)

航海用電子海図（ENC）は、水路や海上の情報を可視化し、分析するためのジオリファレンスされたベクターデータセットです。SDK は、国際水路機関（IHO）の S-57 規格に準拠した ENC をサポートしています。

航海用電子海図 (ENC) を使用する場合は、ダウンロードページから hydrography データをダウンロードします。ENC データの操作の詳細については、Display electronic navigational charts のトピックを参照してください。

インストール ガイド