ArcGIS Pro 3.0 がリリースされ、ArcGIS Pro SDK for .NET には重要なアップデートと新機能が含まれています。
本ブログでは、米国 Esri 社のブログ記事 「What’s New in the ArcGIS Pro SDK 3.0」を翻訳して紹介します。
3.0 の新機能には、新しくデザインされたスタートページ、マップとレイアウトのエクスポートプリセット、レポート内のマップ、新しいジオプロセシングツール、および多くの性能と生産性の向上が含まれます。ArcGIS Pro の開発者は、SDK を使用して構築されたカスタム ツールを使用して組織のワークフローをサポートし、合理化する新しい機会を数多く得ることができます。
ここでは、このリリースの SDK のハイライトと、新しいドキュメントやリソースへのリンクをご紹介します。
目次
Pro 3.0 と .NET 6 の変更点
ArcGIS Pro 3.0 は、Microsoft の長期サポートの最新版である .NET 6 をベースに構築されています。今回は Pro のメジャー アップデートであり、3.0 のバージョン変更は重大な変更を伴うリリースとなります。この API には、重要な機能、パフォーマンス、および品質の改善を伴う重大な変更が含まれています。
.NET 6 へのアップグレードと API の大幅変更により、Pro SDK の開発者は 2.x アドインを Pro 3.0 と Visual Studio 2022 で再コンパイルし、3.0 で動作させる必要があります。重要な更新情報と 2.x のコードを 3.0 に移行するための手順と考慮事項に関する広範な情報については、ProConcepts 3.0 移行ガイドのドキュメントを参照してください。Visual Studio 2022 については、さらに以下のポイントがあります。
移行ガイドの Migrating section では、変換プロセスに関する包括的な説明をし、手動でプロジェクトをアップグレードする方法や、コード移行のオプションや、「Pro Migrate Project」ツールを使用するオプションについて説明します。
移行ガイドの「アセンブリ別の変更点」では、アセンブリごとの主な重大な変更について、変更前 (2.x) と変更後 (3.0) のコード スニペットで説明します。ユーザーは、Pro API リファレンスの新機能ページの API の変更セクションで、すべての変更一覧を確認することができます。
Pro 3.0 バージョンへの移行を行う、Pro Migrate Project ツールのデモ
Visual Studio 2022 サポート
ArcGIS Pro 3.0 では、Pro SDK が Microsoft の IDE の最新版である Visual Studio 2022 をサポートするようになりました。ArcGIS Pro 3.0 のアドインを開発する場合、Visual Studio 2022 v17.2 以降を推奨します。
Visual Studio 2022の推奨最小バージョン
開発者は、Visual Studio 2022 の 17.2 以上のバージョンをインストールしてください。このバージョンでは、 .NET 6.0.5 (with .NET SDK 6.0.3) が含まれています。以前のバージョンの Visual Studio 2022 をインストールする場合、 .NET Desktop Runtime 6.0.5 および/または .NET SDK 6.0.3 を別途インストールする必要がある場合があります。詳細については、Microsoftの .NET 6.0のダウンロードサイトを参照してください。
また、以前のバージョンの Visual Studio では、3.0 用の Pro SDK prosdk_utilitiesPackage.vsix をインストールする際に、次のようなメッセージが表示される場合があります。「いいえ」をクリックすることで、Visual Studio 2022 のバージョンアップを検討できます。
Visual Studio のエラーメッセージが表示されるため、17.2 以降へのバージョンアップを推奨します。
CopyLocal 問題
Visual Studio 2022 バージョン 17.1.6 以前を使用してアドインをコンパイルしている場合、アドイン (または構成やプラグイン) の CopyLocal 動作が正常に処理されないことがあります。Pro アセンブリ (または任意のアセンブリ) がプロパティ UI で CopyLocal = No 属性に設定されていても、アセンブリはローカルにコピーされます (そしてアドインアーカイブに追加されます)。この問題を解決するには、Visual Studio 2022 を 17.2 以降にアップグレードすることをお勧めします。Visual Studio 2022 をアップグレードした後、アドイン プロジェクトを「クリーン」して、プロジェクト内の「obj」フォルダが削除されていることを確認してください。 .csproj または .vbproj のすべての Pro アセンブリ参照プロパティとコピーローカルが 「No」 に設定されていることを確認し、プロジェクトを再ビルドします。
新規アイテム テンプレート
新しいレイアウト トレイ ボタンとマップ トレイ ボタンのアイテム テンプレートにより、開発者はレイアウト ビューとマップ ビューのトレイにそれぞれボタンを作成することができます。よく使うコマンドを実行したり、ツールの起動を切り替えたりするために使用します。
新しいトレイ ボタンの操作方法については、ProConcepts レイアウト ドキュメントの新しいレイアウト トレイ ボタン セクションと、新しい ProGuide トレイ ボタンドキュメントを参照してください。また、新しいトレイ ボタンを使用したサンプル アプリケーションを提供するトレイボタン サンプルもお試しください。
レイアウト トレイ ボタンのサンプル画像
API の強化
また、各リリースと同様に、既存の多くの Pro API にもアップデートが行われました。3.0 での主な API アップデートは以下の通りです。
編集
編集 API については、編集操作とマップ トポロジが新たに強化されました。
編集操作の更新
3.0 では、EditOperation クラスにいくつかの更新が行われました。例として、EditOperation.Create メソッドのオーバーロードでは、RowToken インスタンスを返すようになり、これを使用して新しく作成された機能の ObjectID と GlobalID を取得することができるようになりました。また、Create メソッドと AddAttachment メソッドのオーバーロードも拡張されています。また、EditOperation メソッドの実行を管理する機能を提供する ExecuteMode プロパティが新たに追加されました。
編集操作の概要については、ProConcepts の編集ドキュメントを参照してください。
マップ トポロジの更新
3.0 では、マップ トポロジ セクションが新設され、Pro API を使用してマップ トポロジのノードとエッジを構築およびナビゲートするための新機能の説明があります。マップ トポロジとジオデータベース トポロジは、マップ トポロジがマップ内の編集可能なレイヤーのすべてのフィーチャに対して操作するのに対し、ジオデータベース トポロジはトポロジの編集をトポロジのルールに従っているフィーチャに限定するという点で異なっています。
マップ トポロジ グラフに関連するサンプルはこちらでご覧いただけます。
ジオデータベース
3.0 では、ワークフローのバージョン管理に関する機能が強化されました。
バージョンのリコンサイルとポストは、2 つの異なるメソッドで Version クラスから Reconcile と Post の 2 つのメソッドを実現できます。Post メソッドは、引数として PostOptions オブジェクトを受け取ります。Post オプション オブジェクトは、部分ポストのために選択されたフィーチャのリスト、サービス同期タイプ (Post を同期して実行するかどうか)、ターゲット バージョン （デフォルト バージョンを指定するには NULL を使用) を指定します。また、新しい VersionBase クラスは、Geodatabase のバージョンと履歴バージョンのいずれかを表します。
詳細については、ProConcepts ジオデータベース ドキュメントのバージョン管理セクションを参照してください。
レイアウト
3.0 では、新しいグラフィック要素の更新や LayoutFactory クラスの強化など、レイアウト API にいくつかの更新が行われました。ProConcepts レイアウト ドキュメントが更新され、レイアウト要素の作成と要素コンテンツに関する新しいセクションが追加されました。要素の作成のセクションでは、新しい ElementInfo クラスに関するアップデートについて説明されています。3.0 以降では、要素生成時に ElementInfo を使用して追加の要素プロパティを指定することができます。
最後に、新しいテンプレートのセクションで前述したように、新しいレイアウト トレイ ボタン テンプレートをご覧ください。
マップ作成
マップ作成 API の更新には、ProConcepts マップ作成ドキュメントの新しいディスプレイとフィーチャ キャッシュ セクションの強化が含まれています。開発者は、 SetCacheOptions メソッドを使用して、レイヤーのキャッシュ オプションを更新することができます。レイヤーのフィーチャクラスがフィーチャ キャッシュをサポートしている場合、ディスプレイ キャッシュとフィーチャ キャッシュの両方が設定され、そうでない場合はディスプレイ キャッシュのみが設定されます。
LayerFactory の使用について説明した新しい「レイヤーの操作」のセクションが追加されました。また、地図の作成と表示のセクションで説明した MapFactory のアップデートもあります。
また、標高サーフェスレイヤーを使用するという新しいセクションもあります。3.0 以降、標高サーフェスとソースは ElevationSurfaceLayer クラスで表現されます。このセクションでは、このレイヤー タイプの一般的な操作方法について説明します。
最後に、新しい SelectionSet クラスについて説明する新しいセクションがあります。SelectionSet クラスは、以前の 2.x 汎用 LINQ コレクションである MapMember と objectID を置き換えるものです。
3.0 API のすべての変更点
3.0 で強化されたすべての API の完全なリストについては、API リファレンスの「3.0 での開発者向け新機能」ページの「API の変更点」セクションを参照してください。
インストールとドキュメンテーション
Pro SDK は、My Esri または Visual Studio Marketplace から、『ProGuide インストールとアップグレード』の手順に従ってダウンロードできます。
SDK のドキュメントサイトでは、すべてのコンセプトやガイド ドキュメント、多くのコミュニティ サンプルへのリンクなど、すべての情報リソースを確認することができます。
ArcGIS Pro 3.0 の主な更新点の詳細については、「ArcGIS Pro 3.0 の新機能」ページを参照してください。
関連リンク
- 米国 Esri 社 ArcGIS Blog
- ESRI ジャパン ArcGIS ブログ
- ArcGIS 開発者コミュニティ