Android Studio projenizi ayarlama

Gezinme SDK'sı Maven üzerinden kullanılabilir. Şu tarihten sonra: geliştirme projenizi oluşturduktan sonra, Google Ads API'sini kullanarak biri olabilir.

Gezinme SDK'sı için Maven'i kullanma (önerilir)

Aşağıda, en basit ve en basit araç olan google() Maven deposu kullanılmaktadır. gezinme SDK'sını projenize eklemenin önerilen yolunu inceleyin.

1. Gradle veya Maven yapılandırmanıza şu bağımlılığı ekleyin: yerine VERSION_NUMBER yer tutucusunu sürümünü kullanabilirsiniz.

   Gradle

   Modül düzeyindeki build.gradle öğenize aşağıdakileri ekleyin:

   dependencies {
       ...
       implementation 'com.google.android.libraries.navigation:navigation:VERSION_NUMBER'
   }
   

   Maven

   pom.xml cihazınıza şunları ekleyin:

   <dependencies>
     ...
     <dependency>
       <groupId>com.google.android.libraries.navigation</groupId>
       <artifactId>navigation</artifactId>
       <version>VERSION_NUMBER</version>
     </dependency>
   </dependencies>
   

2. Haritalar SDK'sını kullanan bağımlılıklarınız varsa ve Haritalar SDK'sını temel alan, beyan edilen her bir bağımlılığa bağımlılık.

   Gradle

   Üst düzey build.gradle sayfanıza şu öğeleri ekleyin:

   allprojects {
       ...
       // Required: you must exclude the Google Play service Maps SDK from
       // your transitive dependencies. This is to ensure there won't be
       // multiple copies of Google Maps SDK in your binary, as the Navigation
       // SDK already bundles the Google Maps SDK.
       configurations {
           implementation {
               exclude group: 'com.google.android.gms', module: 'play-services-maps'
           }
       }
   }
   

   Maven

   pom.xml cihazınıza şunları ekleyin:

   <dependencies>
     <dependency>
     <groupId>project.that.brings.in.maps</groupId>
     <artifactId>MapsConsumer</artifactId>
     <version>1.0</version>
       <exclusions>
         <!-- Navigation SDK already bundles Maps SDK. You must exclude it to prevent duplication-->
         <exclusion>  <!-- declare the exclusion here -->
           <groupId>com.google.android.gms</groupId>
           <artifactId>play-services-maps</artifactId>
         </exclusion>
       </exclusions>
     </dependency>
   </dependencies>
   

Derlemeyi yapılandırma

Projeyi oluşturduktan sonra, oluşturduğunuz bir Gezinme SDK'sı başarıyla geliştirildi ve kullanıldı.

Yerel mülkleri güncelleme

• Gradle Komut Dosyaları klasöründe, local.properties dosyasını açın ve android.useDeprecatedNdk=true.

Gradle derleme komut dosyasını güncelleme

• build.gradle (Module:app) dosyasını açın ve aşağıdaki kuralları kullanın şartlarını karşılayacak şekilde güncellemek için Gezinme SDK'sını kullanın ve optimizasyon seçeneklerini de kullanabilirsiniz.

  Navigasyon SDK'sı için gerekli ayarlar

  1. minSdkVersion değerini 23 veya daha yüksek bir değere ayarlayın.
  2. targetSdkVersion değerini 33 veya daha yüksek bir değere ayarlayın.
  3. javaMaxHeapSize değerini artıran bir dexOptions ayarı ekleyin.
  4. Ek kitaplıkların konumunu ayarlayın.
  5. Şu öğe için repositories ve dependencies ekleyin: Gezinme SDK'sı.
  6. Bağımlılıklardaki sürüm numaralarını en son sürüm numarasıyla değiştirin kullanılabilir.

  Derleme süresini kısaltmak için isteğe bağlı ayarlar

  • Kod küçültmeyi ve kaynağı etkinleştirin küçülme bağımlılıklardan kullanılmayan kodu ve kaynakları kaldırmak için R8/ProGuard kullanarak. Eğer R8/ProGuard adımının çalışması çok fazla zaman alıyor. multidex üzerine konuşacağız.
  • Derlemeye dahil edilen dil çevirilerinin sayısını azaltın: Set Geliştirme sırasında bir dil için resConfigs. Nihai derleme için kullandığınız diller için resConfigs değerini ayarlayın. Varsayılan olarak Gradle tarafından desteklenen tüm dillere ilişkin kaynak dizelerini içerir Gezinme SDK'sı.

  Java8 desteği için şeker azaltma ekleme

  • Uygulamanızı Android Gradle eklentisi 4.0.0 veya daha yüksek olursa eklenti, birkaç Java 8 dilinin kullanılmasına yönelik desteği de genişletir API'ler. Bkz. Java 8 desugaring destek konulu videomuzu izleyin. Nasıl yapıldığını öğrenmek için aşağıdaki örnek derleme komut dosyası snippet'ine derleme ve bağımlılık seçenekleridir.

Aşağıda, uygulamanın Gradle derleme komut dosyası örneğini bulabilirsiniz. Kontrol edin örnek uygulamalar üzerinden, Kullandığınız navigasyon SDK'sı biraz ileride veya bu belgelere bir göz atalım.

apply plugin: 'com.android.application'

ext {
    navSdk = "__NAVSDK_VERSION__"
}

android {
    compileSdk 33
    buildToolsVersion='28.0.3'

    defaultConfig {
        applicationId "<your id>"
        // Navigation SDK supports SDK 23 and later.
        minSdkVersion 23
        targetSdkVersion 33
        versionCode 1
        versionName "1.0"
        // Set this to the languages you actually use, otherwise you'll include resource strings
        // for all languages supported by the Navigation SDK.
        resConfigs "en"
        multiDexEnabled true
    }

    dexOptions {
        // This increases the amount of memory available to the dexer. This is required to build
        // apps using the Navigation SDK.
        javaMaxHeapSize "4g"
    }
    buildTypes {
        // Run ProGuard. Note that the Navigation SDK includes its own ProGuard configuration.
        // The configuration is included transitively by depending on the Navigation SDK.
        // If the ProGuard step takes too long, consider enabling multidex for development work
        // instead.
        all {
            minifyEnabled true
            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
        }
    }
    compileOptions {
        // Flag to enable support for the new language APIs
        coreLibraryDesugaringEnabled true
        // Sets Java compatibility to Java 8
        sourceCompatibility JavaVersion.VERSION_1_8
        targetCompatibility JavaVersion.VERSION_1_8
    }
}

repositories {
    // Navigation SDK for Android and other libraries are hosted on Google's Maven repository.
    google()
}

dependencies {
    // Include the Google Navigation SDK.
    // Note: remember to exclude Google Play service Maps SDK from your transitive
    // dependencies to avoid duplicate copies of the Google Maps SDK.
    api "com.google.android.libraries.navigation:navigation:${navSdk}"

    // Declare other dependencies for your app here.

    annotationProcessor "androidx.annotation:annotation:1.7.0"
    coreLibraryDesugaring 'com.android.tools:desugar_jdk_libs:1.1.9'
}

API anahtarını uygulamanıza 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.

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 dosyasını seçin ve aşağıdaki kodu altındaki dependencies öğesine ekleyin buildscript.

   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 öğesi.

   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, 34 olarak ayarlandı.
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.

   NAV_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.

   NAV_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. AndroidManifest.xml dosyanızda şuna gidin: com.google.android.geo.API_KEY ve android:value attribute öğesini güncelleyin. <meta-data> etiketi mevcut değilse bunu <application> etiketi.

   <meta-data
       android:name="com.google.android.geo.API_KEY"
       android:value="${MAPS_API_KEY}" />

   Note: com.google.android.geo.API_KEY is the recommended metadata name for the API key. A key with this name can be used to authenticate to multiple Google Maps-based APIs on the Android platform, including the Navigation SDK for Android. For backwards compatibility, the API also supports the name com.google.android.maps.v2.API_KEY. This legacy name allows authentication to the Android Maps API v2 only. An application can specify only one of the API key metadata names. If both are specified, the API throws an exception.

10. In Android Studio, open your module-level build.gradle or build.gradle.kts file and edit the secrets property. If the secrets property does not exist, add it.

    Edit the properties of the plugin to set propertiesFileName to secrets.properties, set defaultPropertiesFileName to local.defaults.properties, and set any other properties.

    Groovy

    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.*"
    }
            

Uygulamanıza gerekli ilişkilendirmeleri dahil edin

Uygulamanızda Android için Navigasyon SDK'sını kullanıyorsanız uygulamanızın yasal uyarılarının bir parçası olarak atıf metni ve açık kaynak lisansları bölümüne ekleyin.

Gerekli atıf metnini ve açık kaynak lisanslarını şurada bulabilirsiniz: Android zip dosyası için gezinme SDK'sı:

• NOTICE.txt
• LICENSES.txt