インストール ガイド

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

   • Android コンパイル SDK: 36
   • Android NDK バージョン: 27.0.12077973
   • Android の最低 SDK バージョン: 28
   android/app/build.gradle.kts

   android {
   	namespace = "com.esri.flutter_project_template"
   	compileSdk = 36  // 変更
   	ndkVersion = "27.0.12077973"  // 変更
   	compileOptions {
       	sourceCompatibility = JavaVersion.VERSION_11
       	targetCompatibility = JavaVersion.VERSION_11
   	}
   	kotlinOptions {
       	jvmTarget = JavaVersion.VERSION_11.toString()
   	}
   	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">

デバイスのストレージへのアクセスを許可

添付ファイルの追加やエクスポートなど、デバイスのストレージに対する読み取り/書き込み操作が必要な場合は、以下の追加権限を追加する必要があります。

<manifest xmlns:android="http://schemas.android.com/apk/res/android">
	<!-- 追加開始 -->
    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>
    <uses-permission android:name="android.permission.READ_INTERNAL_STORAGE"/>
    <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"/>
	<!-- 追加終了 -->
    <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 のスキームに置き換えてください。 これは、ログイン ワークフローが完了した後、ブラウザーがアプリに通信して戻るために必要です。

1. iOS 17.0 以上を設定します。 行のコメントを解除し、バージョン番号を更新します。

   ios/Podfile

   # Uncomment this line to define a global platform for your project
   platform :ios, '17.0' #変更

2. Runtimecore ポッドと arcgis_maps_ffi ポッドを Runner ターゲット セクションに追加します。

   ios/Podfile

   target 'Runner' do
   	use_frameworks!
   	use_modular_headers!
   
   	#変更開始
   	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

3. pod update を使用して Pods を設定します。

   cd ios && pod update && cd ..

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

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

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

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

<dict>
	<!-- 追加開始 -->
	<key>NSLocationUsageDescription</key>
	<string>Location permission is required to view your position.</string>
	<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>