Android Studio projesi oluşturma

Bu sayfada, Hızlı Başlangıç bölümünde ayrıntılı olarak açıklanan Google Haritalar şablonunu kullanmadan Android için Haritalar SDK'sını kullanmak üzere bir Android Studio projesinin nasıl yapılandırılacağı açıklanmaktadır.

Google Haritalar şablonu, yeni bir Android Studio projesine temel bir haritayı otomatik olarak yapılandırır ve ekler. Ancak farklı Android Studio şablonu kullanan bir Android projesine de harita ekleyebilirsiniz. Bunu yapmak için projenizi manuel olarak yapılandırmanız ve haritayı eklemeniz gerekir.

1. Adım: Android Studio'yu kurun

  1. Android Studio Arctic Fox veya sonraki sürümler gerekir. Henüz yapmadıysanız uygulamayı indirin ve yükleyin.
  2. Android Gradle eklentisini Android Studio'da 7.0 veya daha yeni bir sürüm kullandığınızdan emin olun.

2. adım: SDK'yı ayarlayın

Android için Haritalar SDK'sı kitaplığına Google'ın Maven deposu üzerinden erişebilirsiniz. SDK'yı uygulamanıza eklemek için aşağıdakileri yapın:

  1. Üst düzey settings.gradle dosyanıza pluginManagement blokunun altındaki Gradle eklenti portalı, Google Maven deposu ve Maven merkezi deposu'nu ekleyin. pluginManagement bloku, komut dosyasındaki diğer ifadelerden önce görünmelidir.
    pluginManagement {
        repositories {
            gradlePluginPortal()
            google()
            mavenCentral()
        }
    } 
  2. Üst düzey settings.gradle dosyanıza, dependencyResolutionManagement blokunun altına Google'ın Maven deposu ve Maven merkezi deposunu ekleyin:
    dependencyResolutionManagement {
        repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
        repositories {
            google()
            mavenCentral()
        }
    } 
  3. Modül düzeyindeki build.gradle dosyanıza, Android için Haritalar SDK'sına yönelik Google Play Hizmetleri bağımlılığını ekleyin.
    dependencies {
    
        // Maps SDK for Android
        implementation 'com.google.android.gms:play-services-maps:18.2.0'
    } 
  4. Modül düzeyindeki build.gradle dosyanızda, compileSdk ve minSdk değerlerini aşağıdaki değerlere ayarlayın:
    android {
        compileSdk 31
    
        defaultConfig {
            minSdk 19
            // ...
        }

3. Adım: API anahtarınızı projeye ekleyin

Bu bölümde, uygulamanızın güvenli bir şekilde başvuruda bulunabilmesi için API anahtarınızı nasıl depolayacağınız açıklanmaktadır. API anahtarınızı sürüm kontrol sisteminize kontrol etmemelisiniz. Bu nedenle, projenizin kök dizininde bulunan secrets.properties dosyasında saklamanızı öneririz. secrets.properties dosyası hakkında daha fazla bilgi için Gradle özellik dosyaları bölümüne bakın.

Bu görevi kolaylaştırmak için Android için Secrets Gradle Plugin'i kullanmanızı öneririz.

Android için Secrets Gradle Eklentisi'ni Google Haritalar projenize yüklemek için:

  1. Android Studio'da, proje düzeyindeki build.gradle dosyanızı açın ve aşağıdaki kodu buildscript altındaki dependencies öğesine ekleyin.

    Modern

    buildscript {
        dependencies {
            classpath "com.google.android.libraries.mapsplatform.secrets-gradle-plugin:secrets-gradle-plugin:2.0.1"
        }
    }

    Kotlin

    buildscript {
        dependencies {
            classpath("com.google.android.libraries.mapsplatform.secrets-gradle-plugin:secrets-gradle-plugin:2.0.1")
        }
    }
    
  2. Open your module-level build.gradle file and add the following code to the plugins element.

    Groovy

    plugins {
        // ...
        id 'com.google.android.libraries.mapsplatform.secrets-gradle-plugin'
    }

    Kotlin

    plugins {
        id("com.google.android.libraries.mapsplatform.secrets-gradle-plugin")
    }
  3. Save the file and sync your project with Gradle.
  4. Open the secrets.properties in your project level directory, and then add the following code. Replace YOUR_API_KEY with your API key.
    MAPS_API_KEY=YOUR_API_KEY