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

インストールガイド

出典：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) を参照してください。

Visual Studio で NuGet パッケージマネージャーを開きます (例えば、[プロジェクト] メニュー > [NuGet パッケージの管理])。
[NuGet パッケージマネージャー] ウィンドウで、[パッケージソース] に「nuget.org」が選択されていることを確認します。
[参照] タブを選択して、[検索] テキストボックスに「Esri」と入力します。ArcGIS Maps SDK for .NET でサポートされているフレームワークに一致するものがいくつか表示されます。
インストールする NuGet パッケージを選択し、[インストール] ボタンをクリックします。NuGet パッケージマネージャの詳細については、Microsoft ドキュメントの NuGet パッケージマネージャーを使用して Visual Studio にパッケージをインストールして管理するを参照してください。
[変更のプレビュー] ダイアログで内容を確認し、「OK」を選択してインストールを進めてください。
インストールが完了すると、NuGet パッケージマネージャーの [インストール済み] タブに追加したパッケージが表示され、ArcGIS Maps SDK for .NET を使用して開発できるようになります。

Toolkit

ArcGIS Maps SDK for .NET Toolkit は、ArcGIS Maps SDK for .NET 開発チームによって管理されているオープンソースプロジェクトで、アプリ開発を簡素化するためのコントロールとユーティリティが含まれています。ツールキットは NuGet パッケージとしてプロジェクトに含めるか、GitHub リポジトリからソースコードをダウンロードしてローカルでビルドできます。

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

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

注: .NET Framework プロジェクトテンプレートなど、すぐに使用できる Visual Studio テンプレートの一部は PackageReference をサポートしていますが、現在、プロジェクトによって参照されるパッケージのリストを維持するために packages.config が既定になっています packages.config このような状況を軽減するには、Microsoft の推奨に従って、packages.config から PackageReference に移行することを検討してください。

Visual Studio で、[拡張機能] メニュー > [拡張機能の管理] を選択して、[拡張機能の管理] ダイアログを表示します。
[検索] テキストボックスに、「ArcGIS」と入力します。
「ArcGIS Maps SDK for .NET Project Templates」拡張機能を選択し、[ダウンロード] を選択します。すぐにダウンロードされ、再起動時に拡張機能がインストールされることを示すメッセージが表示されます。
[拡張機能の管理] ダイアログを閉じます。
Visual Studio を閉じ、拡張機能をインストールします。
Visual Studio を閉じた時に表示される [VSIX インストーラー] ダイアログで [変更] をクリックします。
インストールが完了したら、インストーラーダイアログで [閉じる] をクリックします。
次回、Visual Studio で [新しいプロジェクトの作成] を選択すると、使用可能なすべてのプラットフォームの ArcGIS のプロジェクトテンプレートが表示されます。

注: ArcGIS Maps SDK App, Packaged (WinUI 3 in Desktop) テンプレートでは、Single-project MSIX Packaging Tools for VS 2022 もインストールされている必要があります。

Nuget パッケージを使用した、Mac および Windows への Visual Studio プロジェクトテンプレートのインストール

また、nuget.org で公開されている Esri.ArcGISRuntime.ProjectTemplates NuGet パッケージを使用して、Mac と Windows にプロジェクトテンプレートをインストールすることができます。前述の Visual Studio の拡張機能は Windows 用のみであるため、この方法を使用して Mac 用 Visual Studio でテンプレートを利用できるようにすることができます。

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

Windows を使用している場合、コマンドプロンプトを開きます。Mac の場合は、新しいターミナルを開きます。
以下のコマンドを使用して、新しいテンプレートをインストールします：
```
dotnet new install Esri.ArcGISRuntime.ProjectTemplates
```
テンプレートがインストールされたら、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 拡張機能をダウンロードしてインストールする

プロジェクトテンプレート拡張機能（ArcGIS_Maps_SDK_DotNet_Templates_200_0_0.vsix）と NuGet パッケージ拡張機能（ArcGIS_Maps_SDK_DotNet_200_0_0.vsix）の両方を、ArcGIS Developers ダッシュボードからダウンロードできます。

開発マシンからアクセスできる場所にファイルを保存します。
ダウンロードした Visual Studio 拡張機能をインストールするには、.vsix ファイルをダブルクリックします (またはファイルを選択して Enter キーを押します)。
複数のバージョンの Visual Studio がインストールされている場合、VSIX インストーラーダイアログには、拡張機能をインストールするために使用できる Visual Studio 製品 (Visual Studio Enterprise 2022 など) のリストが表示されます。ターゲットの Visual Studio インスタンスを選択し、ライセンス条項を確認して [インストール] を選択します。
インストールが完了すると、選択した製品の確認が表示されます。 [閉じる] を選択して、インストールを終了します。インストールしたら、Visual Studio の [拡張機能の管理] ダイアログを使用して、拡張機能を有効化、無効化、またはアンインストールします。詳細については、Microsoft ドキュメントのトピック [拡張機能の管理] ダイアログボックスを使用しないインストールを参照してください。

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

Visual Studio ソリューションエクスプローラーウィンドウで、[プロジェクト] を右クリックし、[NuGet パッケージの管理] を選択します。
[参照] タブを選択し、パッケージソースとして Esri を選択します。
ArcGIS Maps SDK for .NET でサポートされているさまざまなフレームワーク用の NuGet パッケージがいくつか表示されます。
インストールする NuGet パッケージを選択し、[インストール] ボタンをクリックします。 NuGet パッケージマネージャーの詳細については、Microsoft ドキュメントの NuGet パッケージマネージャーを使用して Visual Studio にパッケージをインストールして管理するを参照してください。
[変更のプレビュー] ダイアログの内容を確認し、[OK] を選択してインストールを続行します。
インストールが完了すると、追加されたパッケージが NuGet パッケージマネージャーの [インストール済み] タブに表示され、ArcGIS Maps SDK for .NET を使用して開発できるようになります。

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

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

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

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

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

インストール ガイド