インストール ガイド

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

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

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

インストールとセットアップ

ArcGIS Maps の機能を .NET アプリケーションに組み込むには、1 つ以上の ArcGIS Maps SDK for .NET NuGet パッケージ への参照を Visual Studio プロジェクト内に追加します。ArcGIS Maps SDK for .NET がサポートするアプリケーション プラットフォームおよび UI フレームワークのそれぞれに対応するプロジェクト テンプレート セットは、Visual Studio 拡張機能 として提供されています。

プロジェクトでの ArcGIS Maps SDK for .NET の参照

ArcGIS Maps SDK for .NET NuGet パッケージは、NuGet.org でホストされています。NuGet を使用して Visual Studio でパッケージを使用するには、Microsoft のドキュメントにある Visual Studio にパッケージをインストールして使用する (Windows) または Visual Studio にパッケージをインストールして使用する (Mac) を参照してください。

1. [Visual Studio Solution Explorer] ウィンドウで、[Project] を右クリックし、[Manage NuGet Packages] を選択します。

2. [Browse] タブを選択し、パッケージソースとして [nuget.org] を選択します。

3. 検索テキスト ボックスに「Esri」と入力します。ArcGIS Maps SDK for .NET がサポートするさまざまなフレームワークが表示されます。

   

4. インストールする NuGet パッケージを選択し、[インストール] ボタンをクリックします。NuGet パッケージ マネージャーの詳細については、Microsoft ドキュメントの NuGet パッケージ マネージャーを使用して Visual Studio にパッケージをインストールして管理する を参照してください。

5. [変更のプレビュー] ダイアログで内容を確認し、[OK] を選択してインストールを進めてください。

6. インストールが完了すると、NuGet パッケージ マネージャーの [インストール済み] タブに追加したパッケージが表示され、ArcGIS Maps SDK for .NET を使用して開発できるようになります。

Toolkit

ArcGIS Maps SDK for .NET Toolkit には、ユーザー インターフェイス（UI）コントロールとコンポーネントが含まれており、すぐに使用したり、アプリ用にカスタマイズしたりできます。Toolkit は、NuGet パッケージとしてプロジェクトに含めることも、GitHub リポジトリからソース コードを入手して自分でビルドすることもできます。

Visual Studio プロジェクト テンプレートのインストール（オプション）

拡張機能のインストール

Visual Studio（Windows）用の ArcGIS Maps SDK for .NET プロジェクト テンプレート 拡張機能は、Android、iOS、および Windows 用のアプリケーション プロジェクト テンプレートを提供します。プロジェクト テンプレートは、各プラットフォームに適した NuGet パッケージを参照し、Model-View-ViewModel（MVVM）デザイン パターンを使用します。拡張機能の使用方法の詳細については、Microsoft のドキュメントの Visual Studio の機能拡張を管理する のトピックを参照してください。

1. Visual Studio で、[拡張機能] メニュー > [拡張機能の管理] を選択して、[拡張機能の管理] ダイアログを表示します。

2. [検索] テキスト ボックスに、「ArcGIS」と入力します。

3. [ArcGIS Maps SDK for .NET Project Templates] 拡張機能を選択し、[ダウンロード] を選択します。この拡張機能のインストールがスケジュールされて、Visual Studio のすべてのインスタンスが終了した後にインストールされます。

   

4. [拡張機能の管理] ダイアログを閉じます。

5. Visual Studio を閉じ、拡張機能をインストールします。

6. Visual Studio を閉じた時に表示される [VSIX インストーラー] ダイアログで [変更] をクリックします。

7. インストールが完了したら、インストーラー ダイアログで [閉じる] をクリックします。

8. 次回、Visual Studio で [新しいプロジェクトの作成] を選択すると、使用可能なすべてのプラットフォームの ArcGIS のプロジェクト テンプレートが表示されます。

   

Nuget パッケージからインストールする

nuget.org で公開されている Esri.ArcGISRuntime.ProjectTemplates NuGet パッケージは .NET MAUI（iOS、Android、WinUI）、WPF、WinUI、および UWP 用のアプリケーション プロジェクト テンプレートを提供します。

以下の手順に従って、コマンドライン インターフェイスを使用してプロジェクト テンプレートをインストールします：

1. コマンドプロンプトを開きます。

2. 以下のコマンドを使用して、新しいテンプレートをインストールします：

   dotnet new --install Esri.ArcGISRuntime.ProjectTemplates
   

3. テンプレートがインストールされたら、Visual Studio を開き、ArcGIS Maps SDK .NET MAUI App の新しくインストールした .NET MAUI テンプレートを選択します。または、次のコマンドを使用して、新しい ArcGIS Maps SDK .NET MAUI App を作成します。

   dotnet new mauimap
   

追加のダウンロード

サンプルコード、データ、コンポーネント の追加のリソースを利用できます。また、ガイドを ダウンロード して、オフラインで利用することも可能です。

サンプル コード

アプリケーションに追加できるさまざまな ArcGIS Maps の強力な機能を説明するサンプル コードを入手できます。サンプルを検索し、サンプル ドキュメント で関連するコードを参照するか、サンプル リポジトリ からソース コードをダウンロードして、サンプルをローカルに構築および実行できます。

コンパイル済みのサンプル ビューアー アプリ (WPF 版) は、Microsoft ストア から入手できます。 アプリを実行する前に、システム要件を参照して、正常に実行できることを確認してください。

Local Server

ArcGIS Maps SDK for Local Server では、オフラインでジオプロセシング タスクを実行して、アプリケーションで高度な空間解析とデータ操作を行うことができます。これらのタスクは、ArcGIS Enterprise で実行されるジオプロセシング タスクと同じように動作します。 アプリケーションでオフラインでジオプロセシング タスクを実行する場合は、Local Server のトピックの手順に従って Local Server をインストールします。

追加のデータ

Projection Engine データ

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

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

Electronic Navigational Charts (ENC)

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

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

ArcGIS Maps SDK for .NET を使用したオフライン環境での開発

NuGet パッケージとプロジェクト テンプレート

オンライン アクセスが制限された環境でアプリを開発している場合は、ローカルの NuGet パッケージ フィードから ArcGIS Maps SDK for .NET を参照することができます。 NuGet.org で公開されている NuGet パッケージのサブセットを含む、追加の Visual Studio (Windows) 拡張機能を利用できます。 この拡張機能をインストールすると、ユーザー プロファイルの %localappdata%\Esri\NuGet の下にローカル NuGet パッケージ ソースが構成されます。 詳細については、Microsoft のドキュメントの ローカル NuGet パッケージ フィード を参照してください。

Visual Studio 拡張機能をダウンロードしてインストールする

プロジェクト テンプレート拡張機能と NuGet パッケージ拡張機能の両方を、ダウンロードページ からダウンロードできます。

1. 開発マシンからアクセスできる場所にファイルを保存します。

2. ダウンロードした Visual Studio 拡張機能をインストールするには、.vsix ファイルをダブルクリックします (またはファイルを選択して Enter キーを押します)。

3. 複数のバージョンの Visual Studio がインストールされている場合、VSIX インストーラー ダイアログには、拡張機能をインストールするために使用できる Visual Studio 製品 (Visual Studio Enterprise 2022 など) のリストが表示されます。 ターゲットの Visual Studio インスタンスを選択し、ライセンス条項を確認して [インストール] を選択します。

   

4. インストールが完了すると、選択した製品の確認が表示されます。 [閉じる] を選択して、インストールを終了します。 インストールしたら、Visual Studio の [拡張機能の管理] ダイアログを使用して、拡張機能を有効化、無効化、またはアンインストールします。 詳細については、Microsoft ドキュメントのトピック [拡張機能の管理] ダイアログ ボックスを使用しないインストール を参照してください。

ローカルの Esri パッケージ ソースから NuGet パッケージをインストールする

ローカルの Esri パッケージ ソースから NuGet パッケージをインストールするには、次の手順に従います。

1. Visual Studio ソリューション エクスプローラー ウィンドウで、[プロジェクト] を右クリックし、[NuGet パッケージの管理] を選択します。

2. [参照] タブを選択し、パッケージ ソースとして [Esri] を選択します。

3. ArcGIS Maps SDK for .NET でサポートされているさまざまなフレームワーク用の NuGet パッケージがいくつか表示されます。

   

4. インストールする NuGet パッケージを選択し、[インストール] ボタンをクリックします。 NuGet パッケージ マネージャーの詳細については、Microsoft ドキュメントの NuGet パッケージ マネージャーを使用して Visual Studio にパッケージをインストールして管理する を参照してください。

5. [変更のプレビュー] ダイアログの内容を確認し、[OK] を選択してインストールを続行します。

6. インストールが完了すると、追加されたパッケージが NuGet パッケージ マネージャーの [インストール済み] タブに表示され、ArcGIS Maps SDK for .NET を使用して開発できるようになります。

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

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

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

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