インストール ガイド

1. 以下の最低要件を更新します。

   • Android の最低 SDK バージョン: 28
   android/app/build.gradle.kts

   defaultConfig {
       // TODO: Specify your own unique Application ID (https://developer.android.com/studio/build/application-id.html).
       applicationId = "com.esri.flutter_project_template"
       // You can update the following values to match your application needs.
       // For more information, see: https://flutter.dev/to/review-gradle-config.
   	minSdk = 28 // 変更
       targetSdk = flutter.targetSdkVersion
       versionCode = flutter.versionCode
       versionName = flutter.versionName
   }

パーミッションを必要とする機能

ArcGIS Maps SDK for Flutter に依存するアプリケーションをデプロイするには、以下の権限が必要です。オンライン リソースにアクセスする権限とデバイスの GPS にアクセスする権限を追加します。なお、アプリが位置情報へのアクセスを必要とする API を実際に使用している場合にのみ、ユーザーに位置情報のアクセス許可を求めるプロンプトが表示されます。

	<manifest xmlns:android="http://schemas.android.com/apk/res/android">
		<!-- 追加開始 -->
	    <uses-permission android:name="android.permission.INTERNET" />
	    <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
	    <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
		<!-- 追加終了 -->
	    <application
	        android:label="flutter_project_template"
	        android:name="${applicationName}"
	        android:icon="@mipmap/ic_launcher">

ユーザー認証の有効化

ユーザー認証にシステム ブラウザーの使用が必要な場合は、以下を追加する必要があります。

	</activity> <!-- application タグ内の activity タグ-->

	<!-- 追加開始 -->
    <activity
        android:name="com.linusu.flutter_web_auth_2.CallbackActivity"
        android:exported="true">
        <intent-filter android:label="flutter_web_auth_2">
            <action android:name="android.intent.action.VIEW" />
            <category android:name="android.intent.category.DEFAULT" />
            <category android:name="android.intent.category.BROWSABLE" />
            <data android:scheme="YOUR_CALLBACK_URL_SCHEME_HERE" />
        </intent-filter>
    </activity>
	<!-- 追加終了 -->

YOUR_CALLBACK_URL_SCHEME_HERE を、ポータルで OAuth 認証情報を設定したときに使用したリダイレクト URL のスキームに置き換えてください。 これは、ログイン ワークフローが完了した後、ブラウザーがアプリに通信して戻るために必要です。

Flutter 3.44 以降、iOS アプリケーションのデフォルトの依存関係管理ツールとして、CocoaPods に代わって Swift Package Manager が採用されました。この変更に対応するため、Flutter Maps SDK パッケージである arcgis_maps では、CocoaPods から Swift Package Manager への移行が行われました。Swift Package Manager を使用して ArcGIS Maps SDK for Flutter パッケージを利用するように iOS プロジェクトを設定する方法については、新しい iOS アプリケーションまたは既存の iOS アプリケーションの移行を参照してください。

新しい iOS アプリケーション

arcgis_maps パッケージを依存関係として使用する新しい iOS アプリケーションの場合、iOS Deployment Target をバージョン 18 に更新し、アプリケーションで Swift Package Manager を有効にする必要があります。プロジェクトに必要な変更を加えるには、以下の手順に従ってください。

1. ターミナルを開き、Flutter プロジェクトのディレクトリーに移動します。

2. 以下のコマンドを実行して、プロジェクトのデフォルトの Xcode ワークスペースを開きます。

   open ios/Runner.xcworkspace

3. Xcode で、Runner プロジェクトを選択します。Build Settings タブに移動し、Deployment セクションを見つけます。iOS Deployment Target をバージョン 18 に設定し、Xcode を閉じます。

4. Flutter 3.44 以降、Swift Package Manager はデフォルトで有効になっています。Swift Package Manager が有効になっていることを確認するには、2 つの方法があります。1 つ目の方法は、単一のプロジェクトに対して Swift Package Manager を有効にするものです。これにより、グローバルな設定に関係なく、ローカル開発環境でそのプロジェクトを読み込むすべてのユーザーが Swift Package Manager を使用するようになります。

   pubspec.yaml

   # ...
   
   flutter:
     	uses-material-design: true
   
       #追加開始
     	config:
   			enable-swift-package-manager: true
   #追加終了

   2 つ目のアプローチは、すべてのプロジェクトに対して Swift Package Manager をグローバルに有効にするもので、Flutter 3.44 以降ではデフォルトで有効になっています。以下のコマンドを実行することで、この機能を有効にし、確認することができます。

   flutter config --enable-swift-package-manager

   詳細については、Flutter のドキュメント「アプリ開発者向け Swift Package Manager（英語）」を参照し、プロジェクトに最適なアプローチを選択してください。

既存の iOS アプリケーションの移行

バージョン 300.0 以前の arcgis_maps パッケージを使用している既存の iOS アプリケーションについては、以下の手順に従って、プロジェクトを Swift Package Manager に対応するように移行してください。

1. 開発用マシンがシステム要件を満たしていることを確認してください。

2. Flutter 3.44 以降、Swift Package Manager はデフォルトで有効になっています。Swift Package Manager が有効になっていることを確認するには、2 つの方法があります。1 つ目の方法は、単一のプロジェクトに対して Swift Package Manager を有効にするものです。これにより、グローバルな設定に関係なく、ローカル開発環境でそのプロジェクトを読み込むすべてのユーザーが Swift Package Manager を使用するようになります。

   pubspec.yaml

   # ...
   
   flutter:
     	uses-material-design: true
   
       #追加開始
     	config:
   			enable-swift-package-manager: true
   #追加終了

   2 つ目のアプローチは、すべてのプロジェクトに対して Swift Package Manager をグローバルに有効にするもので、Flutter 3.44 以降ではデフォルトで有効になっています。以下のコマンドを実行することで、この機能を有効にし、確認することができます。

   flutter config --enable-swift-package-manager

   詳細については、Flutter のドキュメント「アプリ開発者向け Swift Package Manager（英語）」を参照し、プロジェクトに最適なアプローチを選択してください。

3. ターミナルを開き、Flutter プロジェクト ディレクトリー内の ios フォルダーに移動してください。

4. Podfile、Podfile.lock、および Pods ディレクトリーを削除してください。

5. 以下のコマンドを実行してください。

   pod deintegrate

6. 以下のコマンドを実行して、プロジェクトのデフォルトの Xcode ワークスペースを開きます。

   open Runner.xcworkspace

7. ワークスペースから Pods プロジェクトを削除してください。

8. deintegrate で検出されなかった場合は、Runner プロジェクトから Pods の参照を削除してください。

9. Runner ターゲットの 全般 タブで、iOS の Minimum Deployment を手動で 18.0 以上に更新してください。

target 'Runner' do
	use_frameworks!

	pod 'Runtimecore', :podspec => '../arcgis_maps_core/ios/Runtimecore.podspec'
	pod 'arcgis_maps_ffi', :podspec => '../arcgis_maps_core/ios/arcgis_maps_ffi.podspec'

	flutter_install_all_ios_pods File.dirname(File.realpath(__FILE__))
	target 'RunnerTests' do
		inherit! :search_paths
	end
end

パーミッションを必要とする機能

ArcGIS Maps SDK for Flutter の一部の機能には、追加の権限が必要です。 ArcGIS Maps SDK for Flutter に依存する iOS アプリを App Store にデプロイするには、以下の記述が必要です。 位置情報へのアクセス許可を必要とする API をアプリがアクティブに使用している場合のみ、ユーザーに位置情報へのアクセス許可を求めるプロンプトが表示されます。

• 常にユーザーの位置情報へのアクセスを要求する（NSLocationAlwaysAndWhenInUseUsageDescription）
• アプリがフォアグラウンドで実行されている間、ユーザーの位置情報へのアクセスを要求する（NSLocationWhenInUseUsageDescription）

次のコード例では、情報プロパティ リストにこれらを含めています。

<dict>
	<!-- 追加開始 -->
	<key>NSLocationAlwaysAndWhenInUseUsageDescription</key>
	<string>Location permission is required to view your position.</string>
	<key>NSLocationWhenInUseUsageDescription</key>
	<string>Location permission is required to view your position.</string>
	<!-- 追加終了 -->
	<key>CFBundleDevelopmentRegion</key>
	<string>$(DEVELOPMENT_LANGUAGE)</string>