Android Studio'da SHA-1 Alma - Adım Adım Rehber 2026
Android Studio'da SHA-1 Fingerprint Alma
Firebase, Google Play API ve Uygulama İmzalama için Adım Adım Rehber
İçindekiler
Android Studio'da SHA-1 fingerprint almak, Firebase entegrasyonu, Google Play Games API, Google Maps API ve diğer Google servisleri için zorunlu bir adımdır. Bu rehberde 3 farklı yöntemle SHA-1 değerinizi nasıl alacağınızı adım adım öğreneceksiniz.
SHA-1 Nedir ve Neden Gerekli?
SHA-1 (Secure Hash Algorithm 1), Android uygulamanızın dijital sertifikasının benzersiz bir özetidir (fingerprint). Google Play Console, Firebase ve diğer API sağlayıcıları, uygulamanızın kimliğini doğrulamak için bu değeri kullanır.
Yöntem 1: Terminal / Komut Satırı (En Hızlı)
Bu yöntem, doğrudan keytool komutunu kullanarak debug keystore'unuzdan SHA-1 değerini almanızı sağlar. En hızlı ve en güvenilir yöntemdir.
Mac ve Linux İçin
# Terminal'i açın ve aşağıdaki komutu yapıştırın:
keytool -list -v -keystore ~/.android/debug.keystore -alias androiddebugkey -storepass android -keypass android
Windows İçin
# Komut İstemi (CMD) veya PowerShell'i açın:
keytool -list -v -keystore "%USERPROFILE%\.android\debug.keystore" -alias androiddebugkey -storepass android -keypass android
keytool komutu bulunamadı hatası alırsanız, Java JDK'nın bin dizinini PATH ortam değişkeninize eklemeniz veya komutu tam yol ile çalıştırmanız gerekir:
"C:\Program Files\Android\Android Studio\jbrin\keytool.exe" -list -v -keystore "%USERPROFILE%\.android\debug.keystore" -alias androiddebugkey -storepass android -keypass android
Çıktıda şu satırları arayın:
Certificate fingerprints:
SHA1: A1:B2:C3:D4:E5:F6:...:12:34:56:78:90
SHA256: AB:CD:EF:12:34:...:56:78:90:AB:CD
Yöntem 2: Gradle signingReport
Android Studio'nun entegre Gradle aracı ile tüm imza konfigürasyonlarınızı tek seferde görüntüleyebilirsiniz.
Adım Adım Uygulama
- Android Studio'da sağ panelde Gradle sekmesine tıklayın
- Tasks > android > signingReport görevini çift tıklayın
- Alternatif olarak terminal'de şu komutu çalıştırın:
# Proje dizininde (app klasörünün üst dizini):
./gradlew signingReport
Bu komut hem debug hem de release (eğer tanımlıysa) SHA-1 değerlerini aynı anda gösterir.
Yöntem 3: Android Studio Araçları
App Links Assistant Üzerinden
- Menüden Tools > App Links Assistant seçin
- Open Digital Asset Links File Generator tıklayın
- SHA-1 fingerprint bilgisi ekranda görüntülenecektir
Not: Bu yöntem her zaman tüm projelerde kullanılamayabilir.
Debug vs Release Keystore Karşılaştırması
| Özellik | Debug Keystore | Release Keystore |
|---|---|---|
| Otomatik oluşturma | ✅ Evet, Android Studio otomatik oluşturur | ❌ Hayır, siz oluşturmalısınız |
| Konum | ~/.android/debug.keystore |
Sizin belirlediğiniz .jks dosyası |
| Varsayılan şifre | android |
Sizin belirlediğiniz şifre |
| Varsayılan alias | androiddebugkey |
Sizin belirlediğiniz alias |
| Google Play kabulü | ❌ Kabul edilmez | ✅ Gerekli |
| Firebase kullanımı | ✅ Geliştirme için | ✅ Yayınlama için zorunlu |
Release SHA-1 Alma
Google Play Console'a uygulama yüklerken veya Firebase'i production ortamında kullanırken release keystore SHA-1 değerine ihtiyaç duyarsınız.
Kendi Release Keystore'unuz İçin
keytool -list -v -keystore /yol/dosyaniz/release-key.jks -alias sizin-alias-adiniz
Komutu çalıştırdığınızda şifrenizi girmeniz istenecektir.
.jks veya .keystore) ve şifrenizi güvenli bir yerde saklayın. Kaybolursa, uygulamanızı güncelleyemezsiniz ve yeni bir uygulama olarak yayınlamak zorunda kalırsınız!
Firebase'e SHA-1 Ekleme
SHA-1 değerini aldıktan sonra Firebase Console'a eklemeniz gerekir:
- Firebase Console'a gidin
- Projenizi seçin
- Proje Ayarları (dişli ikonu) > Genel sekmesi
- Uygulamanız bölümünden Android uygulamanızı seçin
- SHA sertifika parmak izleri bölümüne tıklayın
- SHA-1'i ekle butonuna basın ve değeri yapıştırın
- Kaydet butonuna tıklayın
Sık Sorulan Sorular (SSS)
❓ SHA-1 ve SHA-256 arasındaki fark nedir?
SHA-1 daha eski ve 40 karakterli bir hash'tir. SHA-256 daha güvenli ve 64 karakterlidir. Google, modern API'ler için SHA-256 kullanımını önerse de birçok servis hâlâ SHA-1 talep eder. İkisini de kaydetmeniz en güvenlisi olur.
❓ Debug keystore silinirse ne olur?
Debug keystore silindiğinde Android Studio bir sonraki build'de otomatik olarak yeni bir tane oluşturur. Ancak yeni SHA-1 değeri farklı olacaktır. Firebase gibi servislerde eski SHA-1'i kaldırıp yenisini eklemeniz gerekir.
❓ SHA-1 değerim neden "keytool error" veriyor?
En yaygın nedenler: Java JDK yüklü değil, PATH ayarı eksik, keystore dosyası bulunamıyor veya şifre yanlış. Windows'ta keytool'un tam yolunu kullanmayı deneyin.
❓ Google Play App Signing kullanıyorsam ne yapmalıyım?
Google Play App Signing etkinse, Google Play Console'da App Signing sayfasından hem uygulama imza sertifikası hem de yükleme sertifikası SHA-1 değerlerini kopyalayabilirsiniz. Firebase'e genellikle uygulama imza sertifikasının SHA-1'ini eklemeniz gerekir.
❓ SHA-1 değerim değişebilir mi?
Debug SHA-1, keystore silinip yeniden oluşturulduğunda değişir. Release SHA-1 ise keystore'u değiştirmediğiniz sürece sabit kalır. Release keystore'unuzu asla kaybetmeyin!
Yorumlar
Yorum Gönder