Android Studio projesi oluşturma

BİLDİRİM: Android için Yerler SDK'sının 2.0.0 ve sonraki sürümleri AndroidX'i seçin. Bu sürümden itibaren eski destek kitaplığı kullanımdan kaldırılacaktır desteklenir. Uyumluluğu korumak için projelerinizi AndroidX kullanıyor.

Uygulamanızı Android için Yerler SDK'sını kullanacak şekilde yapılandırmak için aşağıdaki adımları uygulayın: adımları. Bunlar, Android için Yerler SDK'sını kullanan tüm uygulamalarda gereklidir.

1. Adım: Android Studio'yu kurun

Bu dokümanda, Android Studio Hedgehog ve Android Gradle eklentisi sürümü 8.2'dir.

Not: Geliştirme ortamınız farklı bir sürüm kullanıyorsa adımlarında değişiklik yapmanız gerekebilir. Daha fazla daha fazla bilgi edinmek için bkz. Android Gradle eklentisi ve Android Studio uyumluluğu.

2. adım: SDK'yı ayarlama

Android için Yerler SDK'sını kullanarak Google'ın Maven deposu. Alıcı: SDK'yı uygulamanıza ekledikten sonra aşağıdakileri yapın:

1. Üst düzey settings.gradle.kts dosyanıza Gradle eklenti portalı, Google Maven deposu, ve Maven merkez deposu pluginManagement blokunun altında. pluginManagement bloğu komut dosyasındaki diğer tüm ifadelerden önce görünmelidir.

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

2. Üst düzey settings.gradle.kts dosyanıza Google'ın Maven deposu ve Maven merkez deposu dependencyResolutionManagement bloğunun altında:

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

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

   Not: Android sürümü için Yerler SDK'sı 3.5.0 sürümü için kotlin-bom 1.8.0 veya sonraki sürümler gerekir. Örneğin, kotlin-bom bağımlılığı hakkında daha fazla bilgi için bkz. Geçişli bağımlılıklarda en yeni kotlin-stdlib sürümünün kullanımı.

   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.5.0")
   }

4. Modül düzeyindeki build.gradle dosyanızda compileSdk ve minSdk için şu değerlere:
   Not: compileSdk öğesinin 34 veya daha yüksek bir değere ve minSdk değerine ayarlayın 21 veya daha yüksek bir değer 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, daha sonra tanımlanan meta veri değerlerine erişmek için kullandığınız BuildConfig sınıfını ekleyin. bu prosedürde:

   Modern

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

   Kotlin

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

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

Bu bölümde, web siteleri tarafından güvenli bir şekilde referans verilebilmesi için API anahtarınızı nasıl depolayacağınız açıklanmaktadır. en iyi şekilde yararlanabilirsiniz. API anahtarınızı sürüm kontrol sisteminize kontrol etmemeniz gerekir, bu nedenle dosyayı, uygulamanızın kök dizininde bulunan secrets.properties dosyasında depolayarak belirler. secrets.properties dosyası hakkında daha fazla bilgi için bkz. Gradle özellikleri dosyaları.

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

Not: Bkz. Android için Secrets Gradle Plugin dokümanlarına göz atabilirsiniz.

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

1. Android Studio'da üst düzey build.gradle.kts veya build.gradle dosyasını seçin ve aşağıdaki kodu altındaki dependencies öğesine ekleyin buildscript.

   Kotlin

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

   Modern

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

2. Modül düzeyindeki build.gradle.kts veya build.gradle dosyanızı açın ve plugins öğesine aşağıdaki kodu ekleyin.

   Kotlin

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

   Modern

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

3. Modül düzeyindeki build.gradle.kts veya build.gradle dosyanızda targetSdk ve compileSdk ayarlandığı için 34 yaşa.
4. Dosyayı kaydedin ve projenizi Gradle ile senkronize edin.
5. secrets.properties dosyasını en üst düzey dizininizde açın ve şunu ekleyin: aşağıdaki kodu kullanabilirsiniz. YOUR_API_KEY kısmını API anahtarınızla değiştirin. Anahtarınızı bu dosyada depolayın secrets.properties, sürüm kontrolüne kontrol edilmekten hariç tutulduğundan bahsedeceğim.
   Not: secrets.properties dosyası local.properties dosyasıyla aynı klasörde oluşturun.

   PLACES_API_KEY=YOUR_API_KEY

6. Dosyayı kaydedin.

7. Üst düzey dizininizde local.defaults.properties dosyasını oluşturun. klasörünü secrets.properties dosyası olarak kaydedin, ardından aşağıdaki kodu ekleyin.

   Not: Kodu gösterildiği gibi girin. Değiştirme API anahtarınızla DEFAULT_API_KEY.

   PLACES_API_KEY=DEFAULT_API_KEY

   Bu dosyanın amacı, Derlemelerin başarısız olmaması için secrets.properties dosyası bulunamadı. Bu durum, uygulamayı, secrets.properties ve sağlamak için henüz yerel olarak bir secrets.properties dosyası oluşturmadınız API anahtarı.

8. Dosyayı kaydedin.

9. Android Studio'da modül düzeyindeki build.gradle.kts veya build.gradle dosyasını açın ve secrets özelliğini düzenleyin. Öğe secrets mülkü mevcut değil, ekleyin.

   propertiesFileName eklentisini şuna ayarlamak için eklentinin özelliklerini düzenleyin: secrets.properties, defaultPropertiesFileName değerini şu şekilde ayarla: local.defaults.properties ve diğer özellikleri ayarlayın.

   Kotlin

   secrets {
       // To add your Maps API key to this project:
       // 1. If the secrets.properties file does not exist, create it in the same folder as the local.properties file.
       // 2. Add this line, where YOUR_API_KEY is your API key:
       //        MAPS_API_KEY=YOUR_API_KEY
       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.*"
   }
           

   Modern

   secrets {
       // To add your Maps API key to this project:
       // 1. If the secrets.properties file does not exist, create it in the same folder as the local.properties file.
       // 2. Add this line, where YOUR_API_KEY is your API key:
       //        MAPS_API_KEY=YOUR_API_KEY
       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 SDK'nın hangi sürümünü kullanacağınıza karar verin: 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 başlıklı makaleyi inceleyin.

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

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

Çağrı yaparken API anahtarını iletin Places.initializeWithNewPlacesApiEnabled():

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ı

Çağrı yaparken API anahtarını iletin Places.initialize():

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);
    

.

'nı inceleyin.

'nı inceleyin.

ÖNEMLİ: API anahtarlarını hiçbir zaman doğrudan uygulama kodudur. Üretim ortamlarında şunu kullanmanızı öneririz: güvenli mekanizma API anahtarlarını yönetin.

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 istiyorsanız bunu bir Android cihaza veya Android'e dağıtmanız gerekir. Android 5.0 veya sonraki sürümleri temel alan ve Google API'leri.

• Android cihaz kullanmak için şu adresteki talimatları uygulayın: Uygulamaları donanım cihazında çalıştırma.
• Android emülatörü kullanmak için sanal cihaz oluşturabilir ve Android Sanal Cihaz (AVD) Yöneticisi bir uygulamadır.
  Not: Android emülatörü kullanmayı seçerseniz Play Store sütununun altında görüntülenen Oynat simgesi olan bir cihaz seçin. Bu simge, bu profillerin tamamen CTS olduğunu gösterir uyumlu olmalıdır ve Play Store uygulamasını içeren sistem resimlerini kullanabilir:

  

Sonraki adımlar

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