# Create a New Project You begin by creating an initial application. Throughout this tutorial, you will modify and extend that starter application to create a simple application which covers the basic features of this guide. [If you need help to create a new project use this official Flutter guide](https://docs.flutter.dev/get-started/test-drive?tab=terminal) ### Set Up Your Environment[​](https://docs.mapsindoors.com/getting-started/flutter/new-project#set-up-your-environment) This guide explains how to start using a MapsIndoors map in your Flutter application using the MapsIndoors Flutter SDK. You will need to [download and install](https://docs.flutter.dev/get-started/install) the flutter toolchain. We recommend using Android Studio and Xcode for using this tutorial. Read how to set Android Studio up here: [Installing Android Studio](https://developer.android.com/studio/install) If you do not have any devices, you can [set up an emulator through Android Studio](https://developer.android.com/studio/run/emulator), or in Xcode. If you already have an Android device, make sure to [enable developer mode and USB debugging](https://developer.android.com/studio/debug/dev-options#enable) To benefit from the guides, you will need basic knowledge about: * Flutter Development * Mobile Development ### Set Up Your Project[​](https://docs.mapsindoors.com/getting-started/flutter/new-project#set-up-your-project) To get your project started follow these steps: 1. Create a new project by writing the following command in your terminal `flutter create --platforms ios,android getting_started_mapsindoors_flutter` This will create a new project targeting Android and iOS platforms. 2. Go to `lib/main.dart` and delete its contents, we will fill it up again during this guide. If you want to see an example of how this guide will look when completed, you can [find it on Github here](https://github.com/MapsPeople/getting_started_flutter). ### Set Up MapsIndoors[​](https://docs.mapsindoors.com/getting-started/flutter/new-project#set-up-mapsindoors) #### Google Maps[​](https://docs.mapsindoors.com/getting-started/flutter/new-project#google-maps) To get started with your project add the latest MapsIndoors version to your `pubspec.yaml`, it can be found [here](https://pub.dev/documentation/mapsindoors_googlemaps/latest/). ```yaml mapsindoors_googlemaps: ^4.1.6 # replace with the latest version ``` {% tabs %} {% tab title="Android" %} First you need to extend the allowed gradle repositories to allow the SDK to resolve correctly: 1. Navigate to the app's project level `build.gradle`. 2. add `maven { url 'https://maven.mapsindoors.com/' }` to `allprojects`/`repositories` after `mavenCentral()` ```gradle allprojects { repositories { google() mavenCentral() maven { url 'https://maven.mapsindoors.com/' } } } ``` To get the underlying Google Map to work, you need to perform the following steps: 1. Navigate to `android/app/src/main/res/value`. 2. Create a file in this folder called `google_maps_api_key.xml`. 3. Copy and paste the below code snippet and replace `YOUR_KEY_HERE` with your Google Maps API key. ``` YOUR_KEY_HERE ``` To ensure that the app is able to build properly after obfuscation, we need to add some proguard rules: 1. Navigate to `android/app/proguard-rules.pro`, create it if neccesary 2. Copy and paste the below code snippet ``` ##---------------Begin: proguard configuration for MapsIndoors ---------- -keep interface com.mapsindoors.core.** { *; } -keep class com.mapsindoors.core.errors.** { *; } -keepclassmembers class com.mapsindoors.core.models.** { ; } -keep class com.mapsindoors.core.MPDebugLog ##---------------End: proguard configuration for MapsIndoors ---------- ##---------------Begin: proguard configuration for Gson ---------- # Gson uses generic type information stored in a class file when working with fields. Proguard # removes such information by default, so configure it to keep all of it. -keep class com.google.gson.* {*;} -keepclassmembers class com.google.gson.* {*;} -keepattributes Signature # For using GSON @Expose annotation -keepattributes *Annotation* # Gson specific classes -dontwarn sun.misc.** #-keep class com.google.gson.stream.** { *; } # Application classes that will be serialized/deserialized over Gson -keep class com.google.gson.examples.android.model.** { ; } # Prevent proguard from stripping interface information from TypeAdapter, TypeAdapterFactory, # JsonSerializer, JsonDeserializer instances (so they can be used in @JsonAdapter) -keep class * extends com.google.gson.TypeAdapter -keep class * implements com.google.gson.TypeAdapterFactory -keep class * implements com.google.gson.JsonSerializer -keep class * implements com.google.gson.JsonDeserializer # Prevent R8 from leaving Data object members always null -keepclassmembers,allowobfuscation class * { @com.google.gson.annotations.SerializedName ; } -keep class com.google.gson.reflect.TypeToken { *; } # Retain generic signatures of TypeToken and its subclasses with R8 version 3.0 and higher. -keep,allowobfuscation,allowshrinking class com.google.gson.reflect.TypeToken -keep,allowobfuscation,allowshrinking class * extends com.google.gson.reflect.TypeToken ##---------------End: proguard configuration for Gson ---------- ``` {% endtab %} {% tab title="iOS" %} To get the underlying Google Map to function, you need to perform the following steps: **Providing API key**[**​**](https://docs.mapsindoors.com/getting-started/flutter/new-project#providing-api-key) **Swift**[**​**](https://docs.mapsindoors.com/getting-started/flutter/new-project#swift) 1. Navigate to `iOS/Runner/AppDelegate.swift`. 2. Import GoogleMaps on the class 3. Add this code as the first line inside the application function: `GMSServices.provideAPIKey("YOUR GOOGLE MAPS API KEY HERE")` **Objective-C**[**​**](https://docs.mapsindoors.com/getting-started/flutter/new-project#objective-c) 1. Navigate to `iOS/Runner/AppDelegate.h`. 2. Import `#import "GoogleMaps/GoogleMaps.h"` on the class. 3. Add this code as the first line inside the application function: `[GMSServices provideAPIKey:@"YOUR GOOGLE MAPS API KEY HERE"];` {% endtab %} {% endtabs %} #### Mapbox[​](https://docs.mapsindoors.com/getting-started/flutter/new-project#mapbox) To get started with your project add the latest MapsIndoors version to your `pubspec.yaml`, it can be found [here](https://pub.dev/documentation/mapsindoors_mapbox/latest/). ```yaml mapsindoors_mapbox: ^4.1.6 # replace with the latest version ``` {% tabs %} {% tab title="Android" %} First you need to extend the allowed gradle repositories to allow the SDK to resolve correctly: 1. Navigate to the app's project level `build.gradle`. 2. Add `maven { url 'https://maven.mapsindoors.com/' }` to `allprojects`/`repositories` after `mavenCentral()` 3. Add mapbox to repositories like in the example below: ```gradle allprojects { repositories { google() mavenCentral() maven { url 'https://maven.mapsindoors.com/' } } maven { url 'https://api.mapbox.com/downloads/v2/releases/maven' authentication { basic(BasicAuthentication) } credentials { // Do not change the username below. // This should always be `mapbox` (not your username). username = "mapbox" // Use the secret token you stored in gradle.properties as the password password = project.properties['MAPBOX_DOWNLOADS_TOKEN'] ?: "" } } } ``` 4. Add your mapbox download token to gradle.properties ```properties MAPBOX_DOWNLOADS_TOKEN=YOUR_DOWNLOAD_TOKEN ``` To get the underlying Mapbox Map to work, you need to perform the following steps: 1. Navigate to `android/app/src/main/res/value`. 2. Create a file in this folder called `mapbox_api_key.xml`. 3. Copy and paste the below code snippet and replace `YOUR_KEY_HERE` with your Mapbox keys. ```xml YOUR_KEY_HERE YOUR_KEY_HERE ``` To ensure that the app is able to build properly after obfuscation, we need to add some proguard rules: 1. Navigate to `android/app/proguard-rules.pro`, create it if neccesary 2. Copy and paste the below code snippet ``` ##---------------Begin: proguard configuration for MapsIndoors ---------- -keep interface com.mapsindoors.core.** { *; } -keep class com.mapsindoors.core.errors.** { *; } -keepclassmembers class com.mapsindoors.core.models.** { ; } -keep class com.mapsindoors.core.MPDebugLog ##---------------End: proguard configuration for MapsIndoors ---------- ##---------------Begin: proguard configuration for Gson ---------- # Gson uses generic type information stored in a class file when working with fields. Proguard # removes such information by default, so configure it to keep all of it. -keep class com.google.gson.* {*;} -keepclassmembers class com.google.gson.* {*;} -keepattributes Signature # For using GSON @Expose annotation -keepattributes *Annotation* # Gson specific classes -dontwarn sun.misc.** #-keep class com.google.gson.stream.** { *; } # Application classes that will be serialized/deserialized over Gson -keep class com.google.gson.examples.android.model.** { ; } # Prevent proguard from stripping interface information from TypeAdapter, TypeAdapterFactory, # JsonSerializer, JsonDeserializer instances (so they can be used in @JsonAdapter) -keep class * extends com.google.gson.TypeAdapter -keep class * implements com.google.gson.TypeAdapterFactory -keep class * implements com.google.gson.JsonSerializer -keep class * implements com.google.gson.JsonDeserializer # Prevent R8 from leaving Data object members always null -keepclassmembers,allowobfuscation class * { @com.google.gson.annotations.SerializedName ; } -keep class com.google.gson.reflect.TypeToken { *; } # Retain generic signatures of TypeToken and its subclasses with R8 version 3.0 and higher. -keep,allowobfuscation,allowshrinking class com.google.gson.reflect.TypeToken -keep,allowobfuscation,allowshrinking class * extends com.google.gson.reflect.TypeToken ##---------------End: proguard configuration for Gson ---------- ``` {% endtab %} {% tab title="iOS" %} The MapsIndoors SDK requires iOS 15, so make sure that your Podfile is configured for iOS 15. Add `use_frameworks!` inside your app target as well. ``` platform :ios, '15.0' target 'MyApp' do use_frameworks! post_install do |installer| installer.pods_project.targets.each do |target| target.build_configurations.each do |config| config.build_settings['BUILD_LIBRARY_FOR_DISTRIBUTION'] = 'YES' end ... end ... ``` **Providing** [**​**](https://docs.mapsindoors.com/getting-started/flutter/new-project#providing-api-key-1) Navigate to your application settings in Xode and add your Mapbox public access token to info with the key `MBXAccessTokenSetup` your secret access token for downloading the . Read how to do this here: [Configure credentials](https://docs.mapbox.com/ios/maps/guides/install/#configure-credentials) {% endtab %} {% endtabs %} --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.mapsindoors.com/sdks-and-frameworks/flutter/getting-started/create-a-new-project.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.