ProGuide Installation and Upgrade - EsriJapan/arcgis-pro-sdk GitHub Wiki
Language: C#
Subject: Framework
Contributor: ArcGIS Pro SDK Team <[email protected]>
Organization: Esri, http://www.esri.com
Date: 10/06/2024
ArcGIS Pro: 3.4
Visual Studio: 2022
この ProGuide では、ArcGIS Pro SDK for .NET のインストールおよびアンインストール方法について説明します。
- 概要
- ArcGIS Pro SDK for .NET のインストール
- ArcGIS Pro SDK for .NET のアップグレード
- ArcGIS Pro SDK for .NET のアンインストール
- プライベートギャラリーを使用したArcGIS Pro SDK for .NET の配布
ArcGIS Pro SDK for .NET は、以下の 3 つの Visual Studio 拡張機能（.vsix ファイル）を提供します。
- ArcGIS Pro SDK for .NET： ArcGIS Pro アドインを作成するためのプロジェクト テンプレートとアイテム テンプレートのコレクションです。
- ArcGIS Pro SDK for .NET (Utilities): ArcGIS Pro アドインの作成を支援するユーティリティのコレクションです。
- ArcGIS Pro SDK for .NET (Migration): ArcGIS Pro SDK 2.x エクステンションを ArcGIS Pro SDK 3.0 for .Net に移行します。
ArcGIS Pro SDK for .NET をインストールするには、管理者アクセス権限または昇格されたユーザ権限は必要ありません。
Pro SDK for .NET エクステンションは Visual Studio 2022 にのみ統合可能です。バージョン 17.8 以上を推奨します。ArcGIS Pro 3.3 SDK は ArcGIS Pro 3.3 と .NET 8 または それ以上 が必要です。本 SDK を使用するための要件の詳細については、Wiki の 開発要件 のセクションを参照してください。
ArcGIS Pro SDK for .NET をインストールするには、以下の手順を実行します。
- Visual Studio を起動します。
- [拡張機能] メニュー、[拡張機能の管理] を選択します。これにより、[拡張機能の管理] ダイアログが表示されます。
- "閲覧場所" が Visual Studio Marketplace に設定されていることを確認します。
- 検索ボックスに ArcGIS Pro SDK と入力します。 検索結果の中で必要なアイテムは、以下のスクリーン ショットのように、ArcGIS Pro SDK for .NET、ArcGIS Pro SDK for .NET (Utilities)、ArcGIS Pro SDK for .NET (Migration) です。
- ArcGIS Pro SDK for .NET パッケージを選択し、インストール ボタンをクリックします。オプションで、ArcGIS Pro SDK for .NET (Utilities) と ArcGIS Pro SDK for .NET (Migration) を選択し、それぞれのエクステンションの [インストール] ボタンをクリックします。これにより、3 つのエクステンションを 1 つのステップでダウンロードおよびインストールすることができます。
- Visual Studio のウィンドウを閉じると、ArcGIS Pro SDK for .NET のインストールがスケジュールされます。
- VSIX インストーラ ダイアログが表示されます。[Modify] をクリックして ArcGIS Pro SDK for .NET をインストールします。VSIX インストール ウィザードを進めて、インストールを完了させます。
-
ArcGIS Pro SDK for .NET テンプレート および ユーティリティが Visual Studio にインストールされていることを確認します。
- Visual Studio のスタート ウィンドウから、新しいプロジェクトの作成 にアクセスします。
利用可能な全てのプロジェクト テンプレートから、**ArcGIS Pro SDK** _プロジェクトタイプ_ フィルターを利用して、テンプレートをフィルタリングします。そうすると、ArcGIS Pro SDK テンプレートが表示されるはずです。
注: インストール後、[拡張機能の管理] ダイアログ ボックスを使用して、ArcGIS Pro SDK for .NET パッケージの有効化、無効化、更新、またはアンインストールを行うことができます。
ArcGIS Pro をカスタマイズして拡張するためのアドインの作成方法については ProGuide: Build your first add-in を参照してください。
3.3 のリリースから、ArcGIS Pro は .NET 8、Microsoft の .NET の最新バージョン（以前は「.NET Core」として知られていた）、Long Term Support（LTS）に移行しました。これは 破壊的変更では**ない**ですが、Visual Studio 2022 をバージョン 17.8+ に、.NET 6 を .NET 8 に更新する必要があります。詳細については、ProGuide .NET 8 Upgrade を参照してください。
バージョン2.xと.NET Frameworkを使用して作成したアドインがある場合は、ProConcepts 3.0 Migration Guide の手順に従って、プロジェクトをPro 3.0+と.NET 6+ (.NET Frameworkから) に変換**してから**、必要に応じてProGuide .NET 8 Upgrade の手順に従って、Pro 3.3+と.NET 8で再コンパイルしてください。
注： Visual Studio で この拡張機能を自動的に更新する オプションをチェックしている場合、新しいバージョンの ArcGIS Pro SDK for .NET がすでにマシンにインストールされていることになります。
この機能はオフにしておくことをお勧めします。Visual Studio のこの拡張機能の自動更新では、古いバージョンの ArcGIS Pro を新しいバージョンの ArcGIS Pro SDK（Visual Studio で自動的に更新されたもの）で使用している状態になることがあります。この場合、SDK を使用して ArcGIS Pro アドインを作成しようとすると、エラーが発生します。 拡張機能 -> 拡張機能の管理 でエクステンションごとに自動更新を有効化/無効化できます。 ツール -> オプション でグローバル レベルで自動更新を有効化/無効化できます。
Visual Studio で この拡張機能を自動的に更新する オプションをチェックしていない場合は、以下の手順で ArcGIS Pro SDK for .NET を新しいバージョンに更新してください：
- Visual Studio を起動します。
- メニューの 拡張機能 で 拡張機能の管理 を選択します。 これにより、[拡張機能の管理] ダイアログが表示されます。
- 上部の 更新プログラム タブをクリックします。
- これらの製品の更新がある場合、ArcGIS Pro SDK for .NET と ArcGIS Pro SDK for .NET（Utilities）は更新可能なパッケージとして表示されます。
- ArcGIS Pro SDK for .NET を選択し、更新 ボタンをクリックします。
- ArcGIS Pro SDK for .NET は、Visual Studio のウィンドウが閉じられたときに更新がスケジュールされます。[閉じる] をクリックしてダイアログを閉じ、Visual Studio を終了します。 VSIX Installer ダイアログが表示されます。[Modify] をクリックして ArcGIS Pro SDK for .NET を更新します。VSIX インストール ウィザードを進めて、更新のインストールを完了します。
- ArcGIS Pro SDK for .NET (Utilities) パッケージを Visual Studio Marketplace から選択します。更新プログラム タブをクリックします。ArcGIS Pro SDK for .NET（Utilities）パッケージも同様にアップデートします。
- Visual Studio の 拡張機能の管理 ダイアログ ボックスでパッケージのバージョンを確認し、新しい ArcGIS Pro SDK for .NET テンプレートとユーティリティが Visual Studio で更新されていることを確認します。
- Visual Studio を起動します。[拡張機能] メニューで [拡張機能の管理] を選択します。これにより[拡張機能の管理] ダイアログが表示されます。
- 上部の インストール済み タブをクリックします。
- ArcGIS Pro SDK for .NET、ArcGIS Pro SDK for .NET (Migration)、ArcGIS Pro SDK for .NET (Utilities) パッケージを探索して [・・・] をクリックし、アンインストール を選択します。
組織のイントラネット上のプライベートギャラリーに VSIX パッケージを追加することで、ArcGIS Pro SDK for .NET を共有することができます。Visual Studio からユーザーが ArcGIS Pro SDK for .NET をインストールできるように独自のポータルを設定するには、プライベートギャラリー のドキュメントの説明を参照してください。
ArcGIS Pro SDK for .NET は、"My Esri" (http://my.esri.com) もしくは Visual Studio Marketplace からダウンロード可能です。
