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

インストールガイド

このインストールガイドでは、ArcGIS Runtime SDK for iOS (バージョン 100.x) のインストールとセットアップ手順を紹介します。インストールを進める前に、ご使用のマシン（macOS）に Xcode をインストールしてください。

ArcGIS Runtime SDK for iOS がサポートする最新の動作環境につきましては動作環境をご覧ください。

マップを表示する方法については「アプリの作成」のチュートリアルをご覧ください。

インストールとセットアップ

Xcode プロジェクトに API をインストールして使用するには、いくつかの方法があります。Swift Package Manager か CocoaPods を使用するか、手動でダウンロードしてインストールできます。

Swift Package Manager を使用する
CocoaPods を使用する
手動でダウンロードする

Swift Package Manager を使用する

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

CocoaPods を使用する

公開済みの 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 プロジェクトを構成します。

プロジェクトに ArcGIS フレームワークを追加する

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 Toolkit は ArcGIS Runtime SDK for iOS 開発チームによって管理されているオープンソースプロジェクトで、アプリ開発を簡素化するためのコントロールとユーティリティが含まれています。これらのコンポーネントの動作を確認するには、サンプルやドキュメントを参照してください。

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

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

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

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

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

追加のデータ

グリッドベースの地理座標変換を使用している場合は、ダウンロードページからサポートする Projection Engine ファイルをダウンロードしてください。

航海用電子海図 (ENC) を使用する場合は、ダウンロードページから hydrography directory をダウンロードします。

インストール ガイド