Android Studio’da Paket Adı Değiştirme: Adım Adım Refactor

Android Studio’da Paket Adı (Package Name) Değiştirme Rehberi: Adım Adım Refactor

Bir Android projesine başlarken çoğumuz geçici paket isimleri veririz veya proje ilerledikçe kurumsal kimlik ya da markalaşma (rebranding) ihtiyacı doğar. Ancak Android Studio kullanan geliştiriciler iyi bilir ki, paket adını kökten değiştirmek bazen tam bir saç baş yoldurma seansına dönüşebilir.

Bu yazımızda, mevcut com.legends.gen.game paket adımızı, yeni kurumsal kimliğimiz olan com.nustware.legends haline adım adım, hiçbir hata almadan nasıl dönüştüreceğimizi inceliyoruz. Hazırsanız başlayalım!

---

Adım 1: Klasör Yapısını Serbest Bırakın (Compact Middle Packages)

Android Studio varsayılan olarak paket isimlerini tek bir satırda birleşik gösterir (com.legends.gen.game). Bizim ise aradaki legends ve gen klasörlerine ayrı ayrı müdahale etmemiz gerekiyor.

• Sol paneldeki Project sekmesinin sağ üstündeki Ayarlar (Dişli Çark veya Üç Nokta) ikonuna tıklayın.
• Appearance seçeneğinin altında yer alan Compact Middle Packages (veya bazı sürümlerde Hide Empty Middle Packages) seçeneğindeki işareti kaldırın.
• Eğer klasörleriniz hala ayrışmadıysa, Project panelinin en üstündeki Android görünüm modunu Project moduna getirin ve app -> src -> main -> java yolunu takip edin. Artık klasörleriniz com -> legends -> gen -> game şeklinde çıplak gözle tek tek ayrılmış olmalı.

---

Adım 2: Refactor Yaparak Klasörleri Yeniden Adlandırın

Burada hedefimiz, eski yapıyı yeni yapıya uydurmak. Dikkat ederseniz eski adımız 4 parçalı (com.legends.gen.game), yeni adımız ise 3 parçalı (com.nustware.legends). Bu yüzden hem isim değiştireceğiz hem de fazla klasörü eriteceğiz.

1. legends klasörüne sağ tıklayın: Refactor -> Rename -> Rename Package adımlarını takip edin. Çıkan pencerede ismi nustware yapın ve Refactor butonuna basın. (Böylece ilk kısım com.nustware oldu).
2. gen klasörüne sağ tıklayın: Yine Refactor -> Rename -> Rename Package diyerek bu klasörün adını legends yapın. (Yapımız com.nustware.legends haline geldi).
3. Fazlalık game klasörünü taşımak: Şu an en altta kalan game klasörünün içindeki tüm Kotlin/Java dosyalarınızı seçin ve sürükleyerek (Drag & Drop) bir üstteki yeni legends klasörünün içine bırakın. İçerisi tamamen boşalan game klasörüne sağ tıklayıp Delete diyerek silebilirsiniz.

Sihirli Dokunuş: Bu refactor işlemi sayesinde tüm kod dosyalarınızın en üstünde yazan package ... satırları Android Studio tarafından otomatik olarak güncellenecektir.

---

Adım 3: build.gradle.kts Güncellemesi (Application ID)

Uygulamanızın Google Play Store'daki benzersiz kimliği applicationId değeridir ve bu değer doğrudan Gradle dosyasından yönetilir.

1. app/build.gradle.kts (veya build.gradle) dosyasını açın.
2. defaultConfig bloğunun altındaki applicationId satırını bulun ve şu şekilde güncelleyin:

android {
    defaultConfig {
        // ... diğer ayarlar
        applicationId = "com.nustware.legends"
    }
}

3. Değişikliğin senkronize olması için sağ üst köşede beliren Sync Now butonuna tıklayın.

---

Adım 4: Manifest Kontrolü ve Projeyi Temizleme

Son olarak, sistemde eski paket adına dair hiçbir kalıntı kalmadığından emin olmalıyız.

• src/main/AndroidManifest.xml dosyasını açın. Eğer en üstteki <manifest> etiketinde eski paket adını içeren bir package="..." niteliği görüyorsanız bunu da com.nustware.legends olarak güncelleyin.
• Üst menüden Build -> Clean Project yapın.
• Temizlik bittikten sonra Build -> Rebuild Project diyerek projenizi tertemiz bir şekilde yeniden derleyin.

Tebrikler! Projeniz artık tamamen com.nustware.legends kimliğiyle yayına ve yeni geliştirmelere hazır.

---

⚠️ Yayından Önce Son Kontrol Listesi

• Firebase & Google Services: Eğer projenizde Firebase veya AdMob kullanıyorsanız, Google Developer Console üzerinden yeni paket adınızla yeni bir google-services.json dosyası üretmeli ve projenize dahil etmelisiniz.
• Google Play Console: Unutmayın, hali hazırda markette com.legends.gen.game adıyla yayında olan bir uygulamanın paket adını güncelleyerek mevcut uygulamanın üzerine yazamazsınız. Bu işlem markete yepyeni bir uygulama yüklemek anlamına gelir.