developer.android.com nedir ve gerekli dokümantasyonu 2-3 adımda nasıl bulursunuz?
Kısaca: developer.android.com, Google'ın Android geliştiricileri için resmi kaynağıdır; API referansları, kılavuzlar, örnekler (Samples), codelab'ler ve sürüm notlarını içerir. İhtiyacınız olan sayfayı hızlıca bulmak için sitedeki arama özelliğini veya açıklayıcı anahtar kelimelerle Google aramasını kullanın, API seviyesine göre filtreleme yapın ve ilgili Örneği (Sample) açın.
Sitede neler var ve neden önemlidir?
- API Dokümantasyonu (Referans): Sınıfların, metodların ve API seviyesi gereksinimlerinin detaylı açıklamaları.
- Kılavuzlar ve Eğitimler: Kavramlar (yaşam döngüsü, izinler, arka plan işlemleri), pratik rehberler ve codelab'ler.
- Örnekler (Samples): Hızlı başlangıç için GitHub'da bulunan hazır projeler / gömülü kod örnekleri.
- Tasarım: Material Design yönergeleri, uyarlanabilirlik ve erişilebilirlik.
- Dağıtım ve Play: Yayınlama gereksinimleri, para kazanma ve sürüm hazırlıkları.
- Sürüm notları / Geçiş: Platformlardaki değişiklikler, kullanım dışı (deprecated) alternatifler ve geçiş talimatları.
Tek bir işlem yapmanız gerekiyorsa, "API referansı" + sınıf/fonksiyon adını bulun ve açıklamanın sol tarafındaki API seviyesi etiketini kontrol edin.
Gerekli dokümantasyonu hızlı ve doğru şekilde nasıl bulursunuz? (Pratik rehber)
- Anahtar kelimeler yerine hedefinizi netleştirin: "camera" yerine "CameraX capture image sample" veya "CameraX lifecycle integration" arayın.
- Sitedeki dahili arama özelliğini veya Google'ı kullanın: "site:developer.android.com CameraX capture" sorgusu ilgili sayfaları getirecektir.
- Hedef sınıf için Referans sayfasını açın (örneğin, CameraX -> CameraSelector) ve API seviyesi ile Kullanım Dışı (Deprecated) notlarını okuyun.
- Referans sayfasının yanındaki Örnekler (Samples) bölümüne gidin — çalışır bir örneği hemen görmek için projeyi kopyalayın/çalıştırın.
- Yeni bir SDK sürümü kullanıyorsanız, Sürüm notları/Davranış değişiklikleri ve Geçiş kılavuzunu kontrol edin.
Sadece eski örneklere güvenmeyin: birçok örnek uzun süre güncellenmez. Tarihi ve Kullanım Dışı (Deprecated) etiketlerini karşılaştırın.
Pratik arama sorgusu örnekleri
- Activity yaşam döngüsü ve örnekler gerekiyor: "Activity lifecycle guide site:developer.android.com"
- RecyclerView API'sini arıyorsunuz: "RecyclerView adapter site:developer.android.com RecyclerView.Adapter"
- CameraX codelab'i istiyorsunuz: "CameraX codelab developer.android.com" veya "CameraX sample site:developer.android.com"
Sık yapılan hatalar
- Genel kelimelerle arama yapmak (camera, view) — sonuç çok geniş çıkar. Görevi daha spesifik tanımlayın.
- API seviyesini kontrol etmeden metodları uygulamak — uygulama eski cihazlarda bozulur.
- Kullanım Dışı (Deprecated) API'lerin yerine yenilerini koymadan eskimiş örnekleri kullanmak.
SSS
- Hangi API seviyesinin gerektiğini nasıl anlarım? — Referans sayfasında sınıfın yanında minimum API seviyesi belirtilir; uygulamanızın minSdkVersion değerine göre hareket edin.
- Çalışan bir örneği nerede bulabilirim? — API sayfasındaki Örnekler (Samples) bölümünü açın veya ilgili codelab'i arayın.
- Doküman eskimişse ne yapmalıyım? — Geçiş kılavuzunu, Sürüm notlarını veya Kılavuzlar bölümündeki alternatif uygulamaları arayın.
İsterseniz, senaryonuz için (örneğin CameraX, Navigation veya WorkManager) adım adım bir arama planı ve belirli sayfa önerileri hazırlayabilirim.