ProGuide Installation and Upgrade - kataya/arcgis-pro-sdk GitHub Wiki

Language:      C#
Subject:       Framework
Contributor:   ArcGIS Pro SDK Team <[email protected]>
Organization:  Esri, http://www.esri.com
Date:          11/24/2020
ArcGIS Pro:    2.7
Visual Studio: 2017, 2019

この ProGuide では、ArcGIS Pro SDK for .NET のインストール、アップグレード、およびアンインストール方法について説明します。

In this topic

ArcGIS Pro SDK for .NET のインストール

ArcGIS Pro SDK for .NET のテンプレートおよびユーティリティは、Visual Studio 拡張機能 (.vsix ファイル) として提供されています。ArcGIS Pro SDK for .NET のインストールには、管理者アクセスや高度なユーザ権限は必要ありません。

ArcGIS Pro SDK for .NET をインストールするには、以下の手順を実行します。

  1. Visual Studio を起動します。
    • Visual Studio 2017: [ツール] メニュー, [拡張機能と更新プログラム] を選択します。. これにより、[拡張機能と更新プログラム]ダイアログが表示されます。
    • Visual Studio 2019: [拡張機能] メニュー, [拡張機能の管理] を選択します。 これにより、[拡張機能の管理]ダイアログが表示されます。
  1. 左側の Online フォルダを展開し、Visual Studio Marketplace を選択します。
    Online_Option1.png
  1. 右上の検索ボックスに ArcGIS Pro SDK と入力します。 検索結果の中で必要なアイテムは、以下のスクリーン ショットのように、ArcGIS Pro SDK for .NET と ArcGIS Pro SDK for .NET (Utilities) です。
    Search1.png
  1. ArcGIS Pro SDK for .NET パッケージを選択し、ダウンロード ボタンをクリックします。
  1. Visual Studio のウィンドウを閉じると、ArcGIS Pro SDK for .NET のインストールがスケジュールされます。[Close（日本語UI：閉じる）] をクリックしてダイアログを閉じ、Visual Studio を終了します。
    SDK_Install.png
  1. VSIX インストーラ ダイアログが表示されます。[Modify] をクリックして ArcGIS Pro SDK for .NET をインストールします。VSIX インストール ウィザードを進めて、インストールを完了させます。
    SDK_Install.png
  1. Visual Studio Marketplace から ArcGIS Pro SDK for .NET (Utilities) をインストールするには、拡張機能と更新プログラム (Visual Studio 2017) もしくは 拡張機能の管理 (Visual Studio 2019) ダイアログで、ArcGIS Pro SDK for .NET (Utilities) パッケージを選択し、ダウンロード ボタンをクリックします。上記と同様の方法で ArcGIS Pro SDK for .NET (Utilities) パッケージをインストールします。

  1. ArcGIS Pro SDK for .NET テンプレート および ユーティリティが Visual Studio にインストールされていることを確認します。

    • Visual Studio 2017: Visual C# および Visual Basic の新規プロジェクト テンプレートのセットの中に、ArcGIS フォルダが表示されているはずです。 ArcGIS_Pro_Addins_CS1.png
    • Visual Studio 2019: Visual Studio のスタート画面から Create New Project（日本語UI：新しいプロジェクトの作成） オプションにアクセスします。 CreateNewProject_VS2019.png
      利用可能な全てのプロジェクト テンプレートから、ArcGIS Pro SDK プロジェクトタイプ フィルターを利用して、テンプレートをフィルタリングします。そうすると、ArcGIS Pro SDK テンプレートが表示されるはずです。 ArcGIS_Pro_Addins_VS2019.png

注: インストール後、[拡張機能の管理 (Visual Studio 2019)] または [拡張機能と更新 (Visual Studio 2017)] ダイアログ ボックスを使用して、ArcGIS Pro SDK for .NET パッケージの有効化、無効化、更新、またはアンインストールを行うことができます。

ArcGIS Pro をカスタマイズして拡張するためのアドインの作成方法については ProGuide: Build your first add-in を参照してください。

ArcGIS Pro SDK for .NET のアップグレード

注意: Visual Studio で Automatically update extensions（日本語UI：この拡張機能を自動的に更新する） オプションがチェックされている場合、ご使用のマシンにはすでに新しいバージョンの ArcGIS Pro SDK for .NET がインストールされています。

auto-update.png

この機能をオフにすることを推奨します。 この Visual Studio の拡張機能の自動更新を使用すると、古いバージョンの ArcGIS Pro を新しいバージョンの ArcGIS Pro SDK (Visual Studio で自動的にアップグレードされたもの) で使用している状態になってしまう場合があります。このような場合、SDK を使用して ArcGIS Pro アドインを作成しようとするとエラーが発生します。拡張機能ごとの自動更新の有効 / 無効の切り替えは、 [ツール] -> [拡張機能と更新] (Visual Studio 2017) もしくは [拡張機能] -> [拡張機能の管理] (Visual Studio 2019) で行います。グローバル レベルでの自動更新の有効 / 無効の切り替えは、[ツール] -> [オプション] で行います。

注: Auto-update of selected extensions（日本語UI：この拡張機能を自動的に更新する）はオフにすることが可能です。ArcGIS Pro SDK for .NET と ArcGIS Pro SDK for .NET (Utilities) エクステンションパッケージのアップグレードは、この自動的に更新するオプションはオフにして行うことを推奨しています。

turn-off-auto-update.png

Visual Studio で Automatically update extensions（日本語UI：この拡張機能を自動的に更新する） オプションがチェックされていない場合、以下の手順にしたがって ArcGIS Pro SDK for .NET を新しいバージョンにアップグレードしてください。

  1. Visual Studio を起動します。
    • Visual Studio 2017: [ツール] メニュー, [拡張機能と更新プログラム] を選択します。. これにより、[拡張機能と更新プログラム] ダイアログが表示されます。
    • Visual Studio 2019: [拡張機能] メニュー, [拡張機能の管理] を選択します。 これにより、[拡張機能の管理] ダイアログが表示されます。
  2. 左の Updates（日本語UI：更新プログラム） フォルダを展開し、 Visual Studio Marketplace を選択します。
  3. これらの製品のアップデートが利用可能になると、ArcGIS Pro SDK for .NET および ArcGIS Pro SDK for .NET (Utilities) がアップデート対象のパッケージとしてリストされます。
  4. ArcGIS Pro SDK for .NET を選択して、 Update（日本語UI：更新） ボタンをクリックします。
  5. ArcGIS Pro SDK for .NET の更新は、Visual Studio のウィンドウが閉じられたときにスケジュールされます。[閉じる] をクリックしてダイアログを閉じ、Visual Studio を終了します。VSIX インストーラ ダイアログが表示されます。[Modify] をクリックして ArcGIS Pro SDK for .NET を更新します。VSIX インストール ウィザードを続行して、更新のインストールを完了します。
  6. Visual Studio Marketplace から ArcGIS Pro SDK for .NET (Utilities) パッケージを選択します。 Update（日本語UI：更新） ボタンをクリックします。ArcGIS Pro SDK for .NET (Utilities) パッケージが同様にアップデートされます。
  7. Visual Studio の [拡張機能と更新] (Visual Studio 2017) または [拡張機能の管理] (Visual Studio 2019) ダイアログ ボックスでパッケージのバージョンを確認し、新しい ArcGIS Pro SDK for .NET templates および utilities が Visual Studio で更新されていることを確認します。
    new-version-vsix.png

注意: Visual Studio 2019 Community Edition の拡張機能を自動的に更新する機能は既知の制限があります。詳細は、 Visual Studio 2019 Automatic Update not working を参照してください。

この問題が発生した場合は、以下の手順を実行してください。

ArcGIS Pro SDK for .NET のアンインストール

  1. Visual Studio を起動します。
    • Visual Studio 2017: [ツール] メニュー, [拡張機能と更新プログラム] を選択します。これにより、[拡張機能と更新プログラム] ダイアログが表示されます。
    • Visual Studio 2019: [拡張機能] メニュー, [拡張機能の管理] を選択します。これにより[拡張機能の管理] ダイアログが表示されます。
  2. 左側の Installed（日本語UI：インストール済み） フォルダを展開して、すべて を選択します。
  3. ArcGIS Pro SDK for .NET と ArcGIS Pro SDK for .NET (Utilities) パッケージを探索して、Uninstall（日本語UI：アンインストール） ボタンをクリックします。
    vsix-uninstall.png

プライベートギャラリーを使用したArcGIS Pro SDK for .NET の配布

private-gallery.png

組織のイントラネット上のプライベートギャラリーに 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 からダウンロード可能です。

      ArcGIS Pro SDK for Microsoft .NET Framework              Home | API Reference | Requirements | Download | Samples

⚠️ **GitHub.com Fallback** ⚠️