Android Studio projesi oluşturma

UYARI: Android için Yerler SDK'sının 2.0.0 ve sonraki sürümleri AndroidX sürümüne bağlıdır. Bu sürümden itibaren eski destek kitaplığı artık desteklenmeyecektir. Uyumluluğu sağlamak için projelerinizi AndroidX kullanacak şekilde taşımanız gerekir.

Uygulamanızı Android için Yerler SDK'sını kullanacak şekilde yapılandırmak için bu adımları izleyin. Bunlar, Android için Yerler SDK'sını kullanan tüm uygulamalarda zorunludur.

1. Adım: Android Studio'yu kurun

Bu dokümanda, Android Studio Hedgehog ve Android Gradle eklentisinin 8.2 sürümünü kullanan bir geliştirme ortamı açıklanmaktadır.

Not: Geliştirme ortamınız farklı bir Android Studio veya Gradle sürümü kullanıyorsa adımları bu sürümlere göre değiştirmeniz gerekebilir. Android Studio ve Gradle sürümleri hakkında daha fazla bilgi için Android Gradle eklentisi ve Android Studio uyumluluğu bölümüne bakın.

2. adım: SDK'yı ayarlama

Android kitaplığı için Yerler SDK'sı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ızda, pluginManagement bloğunun altında Gradle eklenti portalı, Google Maven deposu ve Maven merkezi deposu'nu ekleyin. pluginManagement bloğu, komut dosyasındaki diğer ifadelerden önce görünmelidir.

   pluginManagement {
       repositories {
           gradlePluginPortal()
           google()
           mavenCentral()
       }
   } 

2. Üst düzey settings.gradle dosyanıza dependencyResolutionManagement bloğunun altına Google Maven deposunu ve Maven merkezi deposunu ekleyin:

   dependencyResolutionManagement {
       repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
       repositories {
           google()
           mavenCentral()
       }
   } 

3. Modül düzeyindeki build.gradle dosyanızın dependencies bölümünde, Android için Yerler SDK'sına bir bağımlılık ekleyin:

   Not: Android 3.3.0 sürümü için Yerler SDK'sı için kotlin-bom 1.8.0 veya sonraki bir sürüm gerekir. Bağımlılık hakkında daha fazla bilgi kotlin-bom için Geçişli bağımlılıklarda en yeni kotlin-stdlib sürümünün kullanımı bölümüne bakın.

   Modern

   dependencies {
       // If updating kotlin-bom version number above, also edit project-level build.gradle definition of $kotlin_version variable
       implementation(platform("org.jetbrains.kotlin:kotlin-bom:$kotlin_version"))
       implementation 'com.google.android.libraries.places:places:3.3.0'
   }

   Kotlin

   dependencies {
       implementation(platform("org.jetbrains.kotlin:kotlin-bom:$kotlin_version"))
       implementation("com.google.android.libraries.places:places:3.3.0")
   }

4. Modül düzeyindeki build.gradle dosyanızda, compileSdk ve minSdk değerlerini aşağıdaki değerlere ayarlayın:
   Not: compileSdk öğesinin 34 veya üzeri bir değere, minSdk değerinin 21 veya daha yüksek olarak ayarlandığından emin olun.

   Modern

   android {
       compileSdk 34
   
       defaultConfig {
           minSdk 21
           // ...
       }
   }

   Kotlin

   android {
       compileSdk = 34
   
       defaultConfig {
           minSdk = 21
           // ...
       }
   }

5. Modül düzeyindeki build.gradle dosyanızın buildFeatures bölümünde, bu prosedürün ilerleyen bölümlerinde tanımlanan meta veri değerlerine erişmek için kullanacağınız BuildConfig sınıfını ekleyin:

   Modern

   android {
     // ...
     buildFeatures {
       buildConfig true
       // ...
     }
   }

   Kotlin

   android {
     // ...
     buildFeatures {
       buildConfig = true
       // ...
     }
   }

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 özelliği 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.

Not: En güncel sistem gereksinimleri ve yükleme talimatları için GitHub'daki Android için Secrets Gradle Plugin belgelerine bakın.

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

1. Android Studio'da üst düzey build.gradle veya build.gradle.kts 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. Modül düzeyindeki build.gradle dosyanızı açın ve aşağıdaki kodu plugins öğesine ekleyin.

   Modern

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

   Kotlin

   plugins {
       id("com.google.android.libraries.mapsplatform.secrets-gradle-plugin")
   }

3. Modül düzeyindeki build.gradle dosyanızda targetSdk ve compileSdk öğelerinin 34 olarak ayarlandığından emin olun.
4. Dosyayı kaydedin ve projenizi Gradle ile senkronize edin.
5. Üst düzey dizininizde secrets.properties dosyasını açın, ardından aşağıdaki kodu ekleyin. YOUR_API_KEY öğesini API anahtarınızla değiştirin. secrets.properties, sürüm kontrol sistemine kontrol edilemiyor. Bu nedenle anahtarınızı bu dosyada saklayın.
   Not: secrets.properties dosyası mevcut değilse dosyayı local.properties dosyasıyla aynı klasörde oluşturun.

   PLACES_API_KEY=YOUR_API_KEY

6. Dosyayı kaydedin.

7. local.defaults.properties dosyasını üst düzey dizininizde, secrets.properties dosyasıyla aynı klasörde olacak şekilde oluşturun ve aşağıdaki kodu ekleyin.

   Not: Kodu gösterildiği gibi girin. DEFAULT_API_KEY kısmını API anahtarınızla değiştirmeyin.

   PLACES_API_KEY=DEFAULT_API_KEY

   Bu dosyanın amacı, secrets.properties dosyası bulunamazsa derlemelerin başarısız olmaması için API anahtarı için yedek konum sağlamaktır. Uygulamayı secrets.properties içermeyen bir sürüm kontrol sisteminden klonlarsanız ve henüz API anahtarınızı sağlamak için yerel olarak bir secrets.properties dosyası oluşturmadıysanız bu durum görülebilir.

8. Dosyayı kaydedin.

9. Android Studio'da modül düzeyindeki build.gradle veya build.gradle.kts dosyanızı açıp secrets özelliğini düzenleyin. secrets özelliği yoksa ekleyin.

   Eklentinin özelliklerini düzenleyerek propertiesFileName öğesini secrets.properties, defaultPropertiesFileName öğesini local.defaults.properties olarak ayarlayın ve diğer özellikleri ayarlayın.

   Modern

   secrets {
       // Optionally specify a different file name containing your secrets.
       // The plugin defaults to "local.properties"
       propertiesFileName = "secrets.properties"
   
       // A properties file containing default secret values. This file can be
       // checked in version control.
       defaultPropertiesFileName = "local.defaults.properties"
   
       // Configure which keys should be ignored by the plugin by providing regular expressions.
       // "sdk.dir" is ignored by default.
       ignoreList.add("keyToIgnore") // Ignore the key "keyToIgnore"
       ignoreList.add("sdk.*")       // Ignore all keys matching the regexp "sdk.*"
   }
           

   Kotlin

   secrets {
       // Optionally specify a different file name containing your secrets.
       // The plugin defaults to "local.properties"
       propertiesFileName = "secrets.properties"
   
       // A properties file containing default secret values. This file can be
       // checked in version control.
       defaultPropertiesFileName = "local.defaults.properties"
   
       // Configure which keys should be ignored by the plugin by providing regular expressions.
       // "sdk.dir" is ignored by default.
       ignoreList.add("keyToIgnore") // Ignore the key "keyToIgnore"
       ignoreList.add("sdk.*")       // Ignore all keys matching the regexp "sdk.*"
   }
           

4. Adım: Places API istemcisini başlatma

Bir etkinlik veya parça içinde Android için Yerler SDK'sını başlatın. Öncelikle hangi SDK sürümünü kullanacağınıza karar vermeniz gerekir: Android için Yerler SDK'sı veya Android için Yerler SDK'sı (Yeni). Ürün sürümleri hakkında daha fazla bilgi için SDK sürümünüzü seçme bölümüne bakın.

Aşağıdaki örnekte, her iki sürüm için SDK'nın nasıl başlatılacağı gösterilmektedir.

Android için Yerler SDK'sı (Yeni)

Places.initializeWithNewPlacesApiEnabled() çağırırken API anahtarını iletin:

Kotlin

    // Define a variable to hold the Places API key.
    val apiKey = BuildConfig.PLACES_API_KEY

    // Log an error if apiKey is not set.
    if (apiKey.isEmpty() || apiKey == "DEFAULT_API_KEY") {
        Log.e("Places test", "No api key")
        finish()
        return
    }

    // Initialize the SDK
    Places.initializeWithNewPlacesApiEnabled(applicationContext, apiKey)

    // Create a new PlacesClient instance
    val placesClient = Places.createClient(this)
    

Java

    // Define a variable to hold the Places API key.
    String apiKey = BuildConfig.PLACES_API_KEY;

    // Log an error if apiKey is not set.
    if (TextUtils.isEmpty(apiKey) || apiKey.equals("DEFAULT_API_KEY")) {
      Log.e("Places test", "No api key");
      finish();
      return;
    }

    // Initialize the SDK
    Places.initializeWithNewPlacesApiEnabled(getApplicationContext(), apiKey);

    // Create a new PlacesClient instance
    PlacesClient placesClient = Places.createClient(this);
    

Android için Yerler SDK'sı

Places.initialize() çağırırken API anahtarını iletin:

Kotlin

    // Define a variable to hold the Places API key.
    val apiKey = BuildConfig.PLACES_API_KEY

    // Log an error if apiKey is not set.
    if (apiKey.isEmpty() || apiKey == "DEFAULT_API_KEY") {
        Log.e("Places test", "No api key")
        finish()
        return
    }

    // Initialize the SDK
    Places.initialize(applicationContext, apiKey)

    // Create a new PlacesClient instance
    val placesClient = Places.createClient(this)
    

Java

    // Define a variable to hold the Places API key.
    String apiKey = BuildConfig.PLACES_API_KEY;

    // Log an error if apiKey is not set.
    if (TextUtils.isEmpty(apiKey) || apiKey.equals("DEFAULT_API_KEY")) {
      Log.e("Places test", "No api key");
      finish();
      return;
    }

    // Initialize the SDK
    Places.initialize(getApplicationContext(), apiKey);

    // Create a new PlacesClient instance
    PlacesClient placesClient = Places.createClient(this);
    

ÖNEMLİ: API anahtarlarını hiçbir zaman doğrudan uygulama koduna eklemeyin. Üretim ortamlarında API anahtarlarını yönetmek için güvenli bir mekanizma kullanılmasını öneririz.

Artık Android için Yerler SDK'sını kullanmaya hazırsınız!

5. Adım: Android cihaz kurun

Android için Yerler SDK'sını kullanan bir uygulamayı çalıştırmak üzere bu uygulamayı, Android 4.0 veya sonraki bir sürümünü temel alan ve Google API'lerini içeren bir Android cihaza ya da Android emülatörüne dağıtmanız gerekir.

• Android cihaz kullanmak için Uygulamaları donanım cihazında çalıştırma başlıklı makaledeki talimatları uygulayın.
• Android emülatörü kullanmak için sanal bir cihaz oluşturabilir ve Android Studio ile birlikte gelen Android Virtual Device (AVD) Manager'ı kullanarak emülatörü yükleyebilirsiniz.
  Not: Android emülatörü kullanmayı tercih ederseniz Play Store sütunu altında Play simgesi () bulunan bir cihaz seçtiğinizden emin olun. Bu simge, söz konusu profillerin tamamen CTS ile uyumlu olduğunu ve Play Store uygulamasını içeren sistem resimlerini kullanabileceğini gösterir:

  

Sonraki adımlar

Projeniz yapılandırıldıktan sonra örnek uygulamaları inceleyebilirsiniz.