このインストール ガイドでは、ArcGIS Runtime SDK for iOS (バージョン 100.x) のインストールとセットアップ手順を紹介します。インストールを進める前に、ご使用のマシン(macOS)に Xcode をインストールしてください。
ArcGIS Runtime SDK for iOS がサポートする最新の動作環境につきましては動作環境をご覧ください。
マップを表示する方法については「アプリの作成」のチュートリアルをご覧ください。
Xcode プロジェクトに API をインストールして使用するには、いくつかの方法があります。Swift Package Manager か CocoaPods を使用するか、手動でダウンロードしてインストールできます。
Swift Package Manager を使用して Xcode プロジェクトに簡単に統合できます。
Xcode プロジェクトを開きます。メニューバーで、[File] > [Add Package…] を選択します。
パッケージ リポジトリの URL として https://github.com/esri/arcgis-runtime-ios を入力します。
オプションとして、正確なバージョンまたは使用するバージョンの範囲を指定したい場合は、Dependency Rule オプションを選択します。
[Add Package] をクリックします。
ArcGIS の API を使用するには、次のインポートステートメントを任意の Swift コード(.swift)ファイルに追加します。
import ArcGIS
公開済みの CocoaPod を利用できます。CocoaPods を初めて使用する場合は、CocoaPods の使用方法を確認してから、次の手順に従って iOS プロジェクト内でこの Pod を使用してください。
プロジェクトの Podfile に下記を追加します。
pod 'ArcGIS-Runtime-SDK-iOS'
オプションとして、正確なバージョンまたは使用するバージョンの範囲を指定することができます。pod syntax を参照してください。
ターミナル アプリケーションを使用して、Podfile 上で pod install コマンドを実行します。これにより、ArcGIS フレームワークがマシンにダウンロードされ、プロジェクトの Pod ディレクトリ内に配置されます。また、ArcGIS フレームワークを正しく参照するために、プロジェクトのビルド設定に必要な変更が加えられて、新しい Xcode ワークスペース(.xcworkspace ファイル)を作成されます。
ArcGIS の API を使用するには、新しく作成した Xcode ワークスペースを開き、次のインポートステートメントを任意の Swift コード(.swift)ファイルに追加します。
import ArcGIS
手動ダウンロードは、すべての iOS プロジェクト用に一度だけ API をインストールします。
SDK パッケージ インストーラーをダウンロードします。
ダウンロードには ArcGIS 開発者アカウントが必要です。アカウントをお持ちでない場合は、サインアップ(無料)してください。アカウントの作成方法は「開発者アカウントの作成」をご覧ください。
${HOME}/Library フォルダへの書き込み権限があることを確認してください。
マシンに以前のバージョンの ArcGIS Runtime SK for iOS がインストールされている場合は、それをアンインストールします。アンインストールしないと、以前のインストールが上書きされます。アンインストールするには、ターミナル アプリケーションで ${HOME}/Library/Application Support/AGSiOSRuntimeSDK/uninstallAGSiOSSDK スクリプトを実行します。
SDK をダウンロードしたら、ダウンロードした .pkg ファイルをダブルクリックします。インストール ウィザードの指示に従って、インストール手順を完了します。
プロジェクトを構成するための追加の手順を実施します。
デフォルトでは、SDK は ${HOME}/Library/SDKs/ArcGIS にインストールされます。このフォルダーには、Frameworks、Legal、Samples のサブフォルダーが含まれています。
Samples フォルダーに移動し、Objective-C または Swift サンプルのいずれかを実行して、すべてがマシンに正しくインストールされていることを確認できます。
注:${HOME}/Library フォルダは、デフォルトでは非表示になっています。ターミナル アプリケーションで chflags nohidden ~/Library/ コマンドを実行することで表示できます。
インストールエラーが発生した場合は、/var/log/install.log の install.log ファイルで詳細を確認してください。失敗の一般的な理由は、ダウンロード中にインストール パッケージが破損することです。パッケージをもう一度ダウンロードしてみてください。まれに、インストーラーがインストール中にユーザー名/パスワードを要求する場合があります。これが発生すると、インストーラーは正常に終了しますが、SDK はホームディレクトリではなくルートディレクトリにインストールされます。この問題を解決するには、SDKs フォルダをルート /Library ディレクトリからユーザープロファイルの $HOME/Library ディレクトリに手動でコピーします。
この手順は、SDK を手動でインストールした場合のみ必要です。Swift Package Manager または CocoaPods を使用してインストールしている場合は、この手順は不要です。 SDK を手動でインストールした後に、API を使用するために各 Xcode プロジェクトを構成します。
Xcode プロジェクトを開くか、新しいプロジェクトを作成します。
左側の Navigator ペインでプロジェクト名を選択して、[TARGETS (プロジェクト名)] > [General] タブを選択します。
[Frameworks, Libraries, and Embedded Content] セクションに $(HOME)/Library/SDKs/ArcGIS/Frameworks ディレクトリにある ArcGIS.xcframework と Runtimecore.xcframework ファイルをドラッグアンドドロップします。
注:${HOME}/Library フォルダは、デフォルトでは非表示になっています。ターミナル アプリケーションで chflags nohidden ~/Library/ コマンドを実行して表示するか、Finder メニューの [移動] > [フォルダへ移動] を使用して移動することもできます。
以上でプロジェクトの構成は完了です。ArcGIS の API を使用するには、次のインポートステートメントを任意の Swift コード(.swift)ファイルに追加します。
import ArcGIS
ArcGIS Runtime アプリで実行できる、機能についてはサンプル コードを参照してください。
サンプル ビューアー アプリは、App Store からも入手できます。
ArcGIS Runtime SDK for iOS Toolkit は ArcGIS Runtime SDK for iOS 開発チームによって管理されているオープンソース プロジェクトで、アプリ開発を簡素化するためのコントロールとユーティリティが含まれています。これらのコンポーネントの動作を確認するには、サンプルやドキュメントを参照してください。
ダウンロード ページ から、開発者向けドキュメント(任意の ArcGIS Runtime SDK 用)をアーカイブとしてダウンロードできます。アーカイブには、ローカル Web サーバからドキュメントを提供する手順が含まれているため、インターネットに接続しなくてもドキュメントにアクセスできます。スタンドアロン ドキュメントには、開発者ガイド、API リファレンス、チュートリアル、およびサンプル ドキュメントが含まれています。このドキュメントは、ローカルのスタンドアロン コンピューターまたは内部ネットワーク上で実行するように設計されており、パブリックなインターネット上では実行できません。
ローカルでドキュメントを公開する方法:
注:ライブ ドキュメント サイトはリリース時及びリリースの間に定期的に更新されますが、スタンドアロン ドキュメントは静的で、最初のリリース後は更新されません。
グリッド ベースの地理座標変換を使用している場合は、ダウンロード ページからサポートする Projection Engine ファイルをダウンロードしてください。
航海用電子海図 (ENC) を使用する場合は、ダウンロード ページから hydrography directory をダウンロードします。