Adım adım rehber: İlk Android projesi

Kerem Aydın·7 Temmuz 2026·⏱3 dk

Android geliştirmeye başlamak için üç şeye ihtiyacınız var: Android Studio'yu kurmak, Kotlin'i seçmek ve minimal bir proje oluşturmak (örneğin bir sayaç). Bu size pratik deneyim kazandırır ve uygulamayı hemen emülatörde veya telefonda çalıştırmanızı sağlar.

Nereden başlamalı ve hangi kararları almalısınız?

  1. Amaç: Google Play'de yayınlamak mı yoksa kişisel bir proje mi? Bu durum güvenlik gereksinimlerini, metrikleri ve analitiği etkiler.
  2. Dil: Kotlin'i seçin — daha kompakt, null güvenliği açısından daha sağlamdır ve Google tarafından önerilir. Eski kodlarla (legacy) çalışmanız gerekiyorsa Java uygundur.
  3. Araçlar: Android Studio (IDE), Android SDK (platform paketleri ve sistem imajları), Gradle (derleme).
  4. Cihaz: AVD (emülatör) ayarlayın veya USB hata ayıklaması açık olan gerçek bir telefon kullanın.

Hızlı bir başlangıç için Empty Activity şablonunu ve Kotlin'i kullanın. Bu size hazır bir proje yapısı ve doğru Gradle konfigürasyonu sağlayacaktır.

Ortam kurulumu (kısa ve adım adım)

  1. Android Studio'yu indirin ve kurulum sırasında Android SDK ile Android Virtual Device seçeneklerini işaretleyin.
  2. SDK Manager'da gerekli API'leri yükleyin (geniş uyumluluk için compileSdk = en son sürüm, minSdk = 21–24 önerilir).
  3. Device Manager'da bir AVD oluşturun (örneğin Pixel, API 33–34).
  4. Gradle senkronizasyonunu kontrol edin: Tools → Sync Project with Gradle Files. Hata varsa, ilgili API'nin platform paketlerinin yüklü olup olmadığını kontrol edin.

Sık karşılaşılan bir hata, seçilen AVD için sistem imajının eksik olması veya compileSdk ile yüklü SDK'ların uyuşmamasıdır. Bu durum "Failed to sync Gradle" hatasına neden olur.

Basit uygulama: "Buton → Sayaç" uygulaması

Amaç: Bir TextView ve Button içeren, butona basıldığında sayının arttığı bir uygulama.

res/layout/activity_main.xml:

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical"
    android:gravity="center"
    android:padding="16dp">

    <TextView
        android:id="@+id/textCounter"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="0"
        android:textSize="32sp" />

    <Button
        android:id="@+id/buttonIncrement"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="Artır" />
</LinearLayout>

MainActivity.kt:

class MainActivity : AppCompatActivity() {

    private var count = 0

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)

        val textCounter: TextView = findViewById(R.id.textCounter)
        val buttonIncrement: Button = findViewById(R.id.buttonIncrement)

        buttonIncrement.setOnClickListener {
            count++
            textCounter.text = count.toString()
        }
    }
}

Emülatörde veya telefonda çalıştırın — UI olaylarını ve Activity yaşam döngüsünü işleyen çalışan bir örnek elde edeceksiniz.

Bundan sonra ne öğrenmeli? (Sıra ve öncelikler)

  • Activity/Fragment yaşam döngüsü (onCreate → onStart → onResume → onPause → onStop → onDestroy).
  • Mimari: MVVM + ViewModel + LiveData/StateFlow, UI ve mantığın ayrılması.
  • Listeler: RecyclerView ve adaptörler.
  • Ağ işlemleri: Retrofit/OkHttp + Coroutines.
  • Veri depolama: Room veya DataStore.
  • Modern UI: Jetpack Compose (XML'e alternatif, yeni projeler için faydalı).

Pratik yapın: Küçük uygulamalar geliştirin (notlar, zamanlayıcı, yapılacaklar listesi). Her biri size belirli beceriler kazandırır: veri depolama, ağ istekleri, kimlik doğrulama.

Sık yapılan hatalar

  • Her şeyi Activity içinde yapmak: Sorumluluk ayrımı ilkesini ihlal eder.
  • Yaşam döngüsünü göz ardı etmek: Context sızıntıları, ekran döndürme sırasında çökmeler.
  • Yanlış minSdk seçimi: Uyumluluk kaybı veya kodda gereksiz kontroller.
  • Kamera/konum kullanırken izin yönetiminin (runtime permissions) eksik olması.

SSS

  • Java öğrenmek zorunda mıyım? Zorunlu değil, ancak eski projeleri desteklemek için faydalıdır.
  • XML mi Compose mu seçmeliyim? Yeni projeler için Compose'u değerlendirin — UI'yi basitleştirir ve daha hızlı gelişir. Mevcut uygulamaları desteklemek için XML hala günceldir.
  • Telefonda nasıl hata ayıklarım? USB hata ayıklamayı açın, kabloyla bağlayın ve Android Studio'da cihazı seçin.

Sonuç: Android Studio kurulumuyla başlayın, Kotlin ile basit bir proje (sayaç) oluşturun, yaşam döngüsü, mimari ve ağ işlemlerini sırayla öğrenin — böylece daha karmaşık uygulamalar için sağlam bir temel atmış olursunuz.