Android SDK ve Google API'nin Hızlı Yapılandırılması

Kısa cevap: Android Studio'yu yükleyin, SDK Manager aracılığıyla gerekli API seviyesini ve Google Play services/Google APIs'i indirin, bağımlılıkları build.gradle dosyasına ekleyin ve Google Console'dan bir API anahtarı alın — bundan sonra derleme işlemi ve Google hizmetlerine sahip emülatör çalışacaktır. Aşağıda adım adım ve gereksiz detaylardan arındırılmış şekilde anlatılmaktadır.

Hazırlık: Sistem gereksinimleri ve yollar

• İşletim Sistemi: Windows 10/11 (64-bit), macOS 12+, Linux (Ubuntu 20.04+).
• RAM: Minimum 8 GB, önerilen 16 GB.
• Disk: IDE için 8 GB + SDK/emülatörler için 10–20 GB.
• Java: OpenJDK 17 (genellikle Android Studio ile birlikte gelir).

Varsayılan SDK yolları:

• Linux/macOS: ~/Android/Sdk
• Windows: %LOCALAPPDATA%\Android\Sdk

Android Studio ve SDK Kurulumu

1. Android Studio yükleyicisini indirin ve çalıştırın, ilk açılışta "Standard" profilini seçin — bu profil otomatik olarak SDK, emülatör ve derleme araçlarını yüklemenizi önerecektir.
2. Tools > SDK Manager yolunu izleyin:
   • SDK Platforms sekmesinde gerekli API seviyesini işaretleyin (örneğin API 34 gibi güncel stabil sürüm önerilir).
   • SDK Tools sekmesinde şunları yükleyin: Android SDK Build-Tools, Emulator, Android SDK Platform-Tools, Google Play services, Google APIs Intel x86/x86_64 System Image.
3. İndirme işleminin tamamlanmasını bekleyin — sistem imajları ve Play Services birkaç gigabayt yer kaplar.

Derleme sırasında proje SDK'yı görmüyorsa: File > Project Structure > SDK Location yolunu izleyerek yüklü SDK'nın yolunu belirtin.

Google API'nin Projeye Entegrasyonu

1. build.gradle (Module: app) dosyasına bağımlılıkları ekleyin (örnek):

dependencies {
    implementation 'com.google.android.gms:play-services-maps:18.2.0'
    implementation 'com.google.android.gms:play-services-auth:20.7.0'
}

2. AndroidManifest.xml dosyasına izinleri ve anahtar için meta-data etiketini ekleyin:

<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"/>

<application ...>
    <meta-data
        android:name="com.google.android.geo.API_KEY"
        android:value="YOUR_API_KEY"/>
</application>

3. Google Cloud Console'dan API anahtarını alın: Bir proje oluşturun, gerekli API'leri etkinleştirin (Android için Maps SDK vb.), bir API anahtarı oluşturun ve bunu uygulama/SHA‑1 ile sınırlayın. Hata ayıklama için anahtarı sınırsız bırakabilirsiniz ancak üretim sürümünde mutlaka kısıtlamalar uygulayın.

4. Google API içeren bir emülatör oluşturma: Tools > AVD Manager > Create Virtual Device yolunu izleyin — "Google APIs" veya "Google Play" etiketli bir cihaz ve sistem imajı seçin. Bu tür bir imaj Play Services içerir.

Temel Bileşenlerin Boyutları

Sık Karşılaşılan Hatalar

• "SDK not found" — Project Structure içindeki yolu ve ortam değişkenlerini (ANDROID_HOME/ANDROID_SDK_ROOT) kontrol edin.
• "Google Play services out of date" — Emülatörde Play Services'i sistem güncellemeleri üzerinden güncelleyin veya Play içeren bir imaj kullanın.
• Gradle sync fails — Invalidate Caches / Restart yapın; Gradle Plugin ve Gradle sürümlerini güncelleyin (uyumlu AGP ve Gradle sürümleri önerilir, Gradle 8.x+).
• API anahtarı çalışmıyor — Etkinleştirilen API'leri, anahtar kısıtlamalarını ve imzalı üretim sürümü için SHA‑1 değerini kontrol edin.

SSS

• JDK'yı ayrı olarak yüklemem gerekiyor mu?
  Genellikle Android Studio OpenJDK 17 ile birlikte gelir, ek bir kurulum gerekmez.

• Üretim imzası için SHA‑1 nasıl alınır?
  Keystore'unuz için keytool kullanın: keytool -list -v -keystore my-release-key.jks.

• Play içermeyen bir emülatör olmadan Google Maps'i test edebilir miyim?
  Evet — Google Play Services yüklü gerçek bir cihazda; emülatör için Google APIs/Play içeren bir imaj gerekir.

Gerekirse, hazır bir build.gradle şablonu ve harita ile kimlik doğrulama entegrasyonlu örnek bir Activity gönderebilirim.