Android Studio'da Git ve GitHub: Kurulum ve Depo ile Çalışma

Android Studio, Git ve GitHub desteğiyle birlikte gelir: Yerel Git'i yapılandırın, Kişisel Erişim Belirtecini ekleyin ve IDE içinden doğrudan depoları klonlayabilir, commit yapabilir, push işlemlerini gerçekleştirebilir ve dalları yönetebilirsiniz.

Git'in Hızlı Kurulumu ve GitHub Bağlantısı

1. Git'i yükleyin ve Android Studio'da yolunu belirtin: File > Settings > Version Control > Git — Test düğmesine tıklayın (yeşil onay işareti).
2. İsim ve e-posta adresinizi ayarlayın (IDE terminalinde):
   git config --global user.name "Adınız"
   git config --global user.email "[email protected]"
3. GitHub hesabınızı bağlayın: File > Settings > Version Control > GitHub > + > Log In with Token. GitHub üzerinde repo izinlerine sahip (ve gerekirse workflow izinleri de olan) bir Personal access token oluşturun. Belirteci yapıştırın — Android Studio bunu hatırlayacaktır.

Temel İşlemler: Klonlama, Commit, Push, Pull ve Dallanma

• Klonlama: File > New > Project from Version Control, URL'yi girin (https://github.com/username/repo.git), yerel klasörü ve dalı belirtin. IDE projeyi otomatik olarak açacak ve VCS'i yapılandıracaktır.
• Commit: Dosyaları düzenleyin → Version Control (Local Changes) → dosyaları seçin → Add to VCS (Ctrl+Alt+A) → Commit (Ctrl+K). Anlaşılır mesajlar yazın.
• Push: Commit işleminden sonra VCS > Git > Push (Ctrl+Shift+K). Remote'u (genellikle origin) ve dalı seçin.
• Pull: VCS > Git > Pull (Ctrl+T). Merge veya rebase seçeneklerinden birini seçebilirsiniz.
• Dallanma: VCS > Git > New Branch, bir isim verin (feature/login). Dal geçişleri ve yönetimi sağ alttaki Git Branches menüsü üzerinden yapılır.

Pratik kontrol listesi:

• PR oluşturmadan önce her zaman main dalını güncelleyin: pull → dal oluştur → çalış → dalı push et → PR aç.
• Kısa commit mesajları yazın ve mantıksal olarak ilişkili değişiklikleri gruplayın.

Çakışmaların Çözülmesi ve Faydalı Araçlar

• Çakışmalar: Android Studio, Version Control > Incoming/Outgoing bölümünde çakışmalı dosyaları gösterecektir. Merge düğmesine tıklayın — sol/sağ taraftaki değişiklikleri seçebileceğiniz veya manuel olarak birleştirebileceğiniz görsel bir merge düzenleyicisi açılacaktır.
• Stash: VCS > Git > Stash Changes — tamamlanmamış değişiklikleri geçici olarak kaldırır.
• Git Log: VCS > Git > Show History — commit'ler için kullanışlı bir grafik ve arama özelliği sunar.
• Blame: Bir satıra sağ tıklayın → Git → Show Blame — kodu kimin ve ne zaman değiştirdiğini gösterir.
• GitHub üzerinde main dalını koruyun: Protected branches kuralını etkinleştirin ve merge öncesinde PR ve kontrolleri zorunlu kılın (bu ayar GitHub ayarlarında yapılır).

Yaygın Hatalar

• "Git not found": IDE ayarlarında Git yürütülebilir dosyasının yolunu kontrol edin.
• Authentication failed: Belirtecin süresi dolmuş veya yetersiz izinlere sahip — belirteci yeniden oluşturun ve tekrar yapıştırın.
• Push rejected: Önce pull yaparak çakışmaları çözün; yalnızca kişisel depolarda force push kullanılabilir.
• Klonlamadan sonra proje açılmıyor: settings.gradle/settings.gradle.kts dosyasının varlığını ve Gradle ayarlarının doğruluğunu kontrol edin.

SSS

• Boş bir depoda ilk commit'i nasıl oluştururum?
  README.md oluşturun, Add to VCS → Commit → Push. Bu, uzak sunucudaki depo boşsa onu başlatır.
• Android Studio kullanıyorsam CLI'de Git komutlarını öğrenmem gerekir mi?
  Evet — temel komutlar (clone, commit, push, pull, checkout, rebase) hata ayıklama ve IDE dışındaki senaryolar için faydalıdır.
• Son commit'i nasıl geri alırım?
  Commit henüz push edilmemişse: VCS > Git > Reset HEAD... (Soft/Hard seçeneğini belirleyin). Push edilmişse — Git Log üzerinden revert kullanın.

Bu kurulumla rahat bir iş akışı elde edersiniz: klonlama, dallanma, görsel çakışma çözümü ve güvenli push — tüm bunlar araçlar arasında gereksiz geçişler yapmadan gerçekleşir.