- Üyelik Tarihi
- 24 Ağu 2026
- Mesajlar
- 16
- Beğeniler
- 1
- Puanlar
- 3
Merhaba arkadaşlar,
Bu konuda Android uygulamalarda sıkça karşılaştığımız APK ve AAB dosyalarının ne olduğunu, aralarındaki farkları, hangi durumda hangisinin kullanılması gerektiğini ve uygulamanızı yayınlamadan önce paket hazırlarken dikkat etmeniz gereken noktaları detaylı şekilde anlatacağız.
Özellikle ilk defa Android uygulama yayınlayacak kullanıcıların APK ve AAB konusunda kafası karışabiliyor. İki dosya türü de Android uygulamalarıyla ilgili olsa da kullanım amaçları ve yayınlama süreçleri birbirinden farklıdır.
APK, yani Android Package Kit, Android işletim sisteminde bir uygulamanın kurulabilmesini sağlayan paket dosyasıdır.
Bilgisayarlardaki .exe dosyalarına benzer şekilde düşünebilirsiniz. Hazırlanan bir APK dosyası Android cihazınıza aktarıldığında, cihaz gerekli izinleri sağlıyorsa uygulamayı doğrudan kurabilirsiniz.
Örneğin uygulamanızı Google Play üzerinde yayınlamadan önce kendi telefonunuzda test etmek istiyorsanız APK oluşturabilirsiniz.
APK dosyaları genellikle;
gibi işlemlerde kullanılmaktadır.
Ancak APK dosyasını oluşturmuş olmanız uygulamanın doğrudan mağazaya gönderilmeye hazır olduğu anlamına gelmez. Paket adı, sürüm bilgileri, imzalama işlemleri ve kullanılan Android SDK sürümleri gibi birçok ayarın doğru yapılandırılmış olması gerekir.
AAB, yani Android App Bundle, Android uygulamalarının özellikle Google Play üzerinden yayınlanması için kullanılan paket formatıdır.
AAB dosyasını APK'dan ayıran en önemli noktalardan biri, son kullanıcıya doğrudan kurulmak amacıyla hazırlanmamasıdır.
Uygulamanızı AAB olarak Google Play'e yüklediğinizde gerekli APK dosyaları kullanıcının cihazına göre Google Play tarafından oluşturulur.
Bunun avantajı, kullanıcının cihazında ihtiyaç duyulmayan dosyaların indirilmesinin önüne geçilebilmesidir.
Örneğin uygulamanız içerisinde farklı ekran çözünürlükleri, işlemci mimarileri veya dil dosyaları bulunuyorsa her kullanıcı bütün dosyaları indirmek zorunda kalmaz.
Bu nedenle mağazada yayınlanacak uygulamalarda AAB kullanımı oldukça önemlidir.
En basit şekilde anlatmak gerekirse:
APK → Telefona doğrudan kurulabilen uygulama paketidir.
AAB → Uygulamanın mağazaya yüklenmesi ve cihazlara uygun APK'ların oluşturulması amacıyla kullanılan yayın paketidir.
Dolayısıyla uygulamanızı yalnızca kendi cihazınızda test edecekseniz çoğu durumda APK yeterlidir.
Google Play üzerinde yayınlama yapacaksanız ise yayın sürecine uygun şekilde imzalanmış bir AAB paketi hazırlamanız gerekir.
Paket alma işlemine doğrudan geçmeden önce uygulamanızın yayın ayarlarını kontrol etmeniz önemlidir.
Çünkü yanlış hazırlanmış bir paket daha sonrasında sürüm güncellerken veya Google Play'e yükleme yaparken sorun oluşturabilir.
Özellikle aşağıdaki bilgileri kontrol etmenizi öneriyoruz.
Her Android uygulamasının kendisine ait benzersiz bir paket adı bulunur.
Örnek:
com.firmaadi.uygulamaadi
Paket adı uygulamanızın kimliği olarak düşünülebilir.
Uygulamanızı mağazada yayınladıktan sonra paket adını değiştirmek çoğu durumda yeni bir uygulama oluşturmak anlamına geleceği için bu bilgiyi en başta doğru belirlemeniz önemlidir.
Rastgele veya daha sonra değiştirmeyi düşündüğünüz bir paket adıyla uygulamayı yayınlamamanızı tavsiye ediyoruz.
Telefonda uygulama simgesinin altında görüntülenecek uygulama adının doğru olduğundan emin olun.
Test aşamasında kullanılan;
Test App
My Application
Deneme
gibi isimlerin yayın paketinde unutulması oldukça sık karşılaşılan bir durumdur.
Paket oluşturmadan önce uygulamanın gerçek adını kontrol edin.
Uygulamanın varsayılan Android ikonu ile yayınlanmaması için kendi uygulama ikonlarınızı projeye ekleyin.
İkonların farklı Android cihazlarda düzgün görüntülenip görüntülenmediğini mümkünse gerçek cihaz üzerinde kontrol edin.
Özellikle yuvarlak ikon kullanan cihazlarda logonun kenarlardan kesilmemesine dikkat edin.
Android uygulamalarında sürüm yönetimi oldukça önemlidir.
Genellikle kullanıcıya gösterilen bir sürüm adı ve sistem tarafından takip edilen bir sürüm kodu bulunur.
Örneğin:
Sürüm: 1.0.0
Sürüm Kodu: 1
İlk yayınınızı yaptıktan sonra yeni bir güncelleme gönderirken sürüm kodunun yükseltilmesi gerekir.
Örneğin ilk yayın:
versionCode: 1
Yeni güncelleme:
versionCode: 2
şeklinde ilerleyebilir.
Aynı sürüm koduyla tekrar paket yüklemeye çalışmanız mağaza tarafında hata almanıza neden olabilir.
Burada dikkat edilmesi gereken diğer bir konu da Debug ve Release paketleridir.
Debug paketleri geliştirme ve test işlemleri için hazırlanır.
Uygulamanızı geliştirirken hızlı bir şekilde telefona yükleyip kontrol etmek için kullanılabilir.
Release paketi ise uygulamanın kullanıcıya dağıtılacak sürümüdür.
Google Play'e gönderilecek veya gerçek kullanıcılara dağıtılacak uygulamalarda mümkün olduğunca release sürümü hazırlanmalıdır.
Release paketinde gereksiz debug özelliklerinin bulunmadığından ve uygulamanın doğru anahtar ile imzalandığından emin olun.
Android tarafında en önemli konulardan biri uygulamanın imzalanmasıdır.
Release olarak hazırlanan uygulamanın bir imzalama anahtarı bulunur. Bu anahtar uygulamanın kimliğinin korunmasında ve sonraki sürümlerin doğrulanmasında rol oynar.
Burada özellikle dikkat etmeniz gereken konu şudur:
İmzalama bilgilerinizin yedeğini mutlaka alın.
Keystore dosyanızı ve gerekli bilgileri güvenli bir yerde saklayın. Bunları yalnızca bilgisayarınızın masaüstünde bırakmanız doğru bir yedekleme yöntemi değildir.
Ayrıca keystore dosyasını forum, Discord veya herkese açık herhangi bir alanda paylaşmayın.
APK dosyanız başarıyla oluşturulduysa yayınlamadan veya müşteriye göndermeden önce gerçek bir Android cihaz üzerinde test etmenizi öneriyoruz.
Sadece uygulamanın açılıp açılmadığına bakmak yeterli değildir.
Şunları mümkün olduğunca kontrol edin:
Mümkünse uygulamayı yalnızca geliştirme yaptığınız telefonda değil, farklı Android sürümüne sahip ikinci bir cihazda da deneyin.
Uygulamanızın geliştirme ve test işlemleri tamamlandıktan sonra Google Play yayını için AAB dosyanızı oluşturabilirsiniz.
AAB almadan önce özellikle;
Paket adı → Uygulama adı → İkon → Sürüm bilgisi → İmzalama → Release ayarları
sırasıyla tekrar kontrol edilmelidir.
AAB dosyasının başarılı şekilde oluşturulması uygulamanın mağaza tarafından kesin olarak kabul edileceği anlamına gelmez.
Google Play tarafında hedef Android sürümü, uygulama izinleri, gizlilik politikası, veri güvenliği beyanları ve mağaza politikaları gibi ek gereksinimler bulunabilir.
Bu nedenle paket hazırlama ile Google Play yayınlama işlemini birbirinden ayrı iki aşama olarak değerlendirmek daha doğrudur.
Uygulamanız daha önce yayınlandıysa yeni paket hazırlarken en önemli konulardan biri mevcut kullanıcıların uygulamayı güncelleyebilmesidir.
Yeni bir uygulama oluşturmak yerine mevcut uygulamaya güncelleme gönderecekseniz paket kimliği ve sürüm/imzalama yapılandırmanızın mevcut uygulamayla uyumlu olması gerekir.
Ayrıca yeni sürüm kodunun önceki yayından yüksek olması gerekir.
Örneğin mevcut uygulamanız:
1.0.0 – versionCode 1
ise yeni güncellemeniz:
1.1.0 – versionCode 2
olarak hazırlanabilir.
Sadece uygulamanın görünen sürüm adını değiştirmek yeterli olmayabilir.
APK veya AAB hazırlama aşamasında karşılaşılan problemlerin büyük bölümü birkaç temel ayardan kaynaklanmaktadır.
Paket oluşturulamıyor:
Projede derleme hatası veya uyumsuz bir bağımlılık bulunabilir. Hata çıktısındaki ilk gerçek hata kontrol edilmelidir.
AAB mağazaya yüklenmiyor:
Sürüm kodu, paket adı, imzalama veya mağazanın güncel gereksinimleri kontrol edilmelidir.
APK telefona kurulmuyor:
Cihazda aynı uygulamanın farklı imzaya sahip başka bir sürümü bulunabilir veya Android sürümü uygulamanın gereksinimlerini karşılamıyor olabilir.
Güncelleme yerine ayrı uygulama olarak kuruluyor:
Paket adının mevcut uygulamayla aynı olup olmadığı kontrol edilmelidir.
Uygulama release sürümünde açılmıyor:
Debug ortamında çalışan fakat release yapılandırmasında eksik kalan API, yapılandırma veya küçültme/obfuscation ayarları kontrol edilmelidir.
Kısaca toparlayacak olursak;
Uygulamanızı telefonunuza doğrudan kurmak, test etmek veya mağaza dışında dağıtmak istiyorsanız APK kullanabilirsiniz.
Uygulamanızı Google Play üzerinden yayınlamak istiyorsanız yayın sürecine uygun AAB paketi hazırlamanız gerekir.
Geliştirme sürecinde APK ile testlerinizi yaptıktan sonra son kontrolleri tamamlayıp release AAB oluşturmak genellikle daha düzenli bir çalışma yöntemi olacaktır.
APK veya AAB oluştururken yalnızca paketin başarıyla alınmasına odaklanmayın.
Paket adı, sürüm kodu, imzalama anahtarı ve release yapılandırması ileride yayınlayacağınız güncellemeler açısından en az uygulamanın kendisi kadar önemlidir.
Özellikle ilk uygulamanızı yayınlıyorsanız keystore ve proje dosyalarınızın yedeğini aldıktan sonra yayın işlemlerine başlamanızı tavsiye ediyoruz.
APK/AAB oluştururken bir hata ile karşılaşırsanız forumda yeni bir konu açabilirsiniz. Konunuza kullandığınız geliştirme ortamını, aldığınız hata mesajını ve mümkünse ekran görüntüsünü eklerseniz sorunun daha hızlı anlaşılmasını sağlayabilirsiniz.
Herkese iyi geliştirmeler.
Bu konuda Android uygulamalarda sıkça karşılaştığımız APK ve AAB dosyalarının ne olduğunu, aralarındaki farkları, hangi durumda hangisinin kullanılması gerektiğini ve uygulamanızı yayınlamadan önce paket hazırlarken dikkat etmeniz gereken noktaları detaylı şekilde anlatacağız.
Özellikle ilk defa Android uygulama yayınlayacak kullanıcıların APK ve AAB konusunda kafası karışabiliyor. İki dosya türü de Android uygulamalarıyla ilgili olsa da kullanım amaçları ve yayınlama süreçleri birbirinden farklıdır.
APK Nedir?
APK, yani Android Package Kit, Android işletim sisteminde bir uygulamanın kurulabilmesini sağlayan paket dosyasıdır.
Bilgisayarlardaki .exe dosyalarına benzer şekilde düşünebilirsiniz. Hazırlanan bir APK dosyası Android cihazınıza aktarıldığında, cihaz gerekli izinleri sağlıyorsa uygulamayı doğrudan kurabilirsiniz.
Örneğin uygulamanızı Google Play üzerinde yayınlamadan önce kendi telefonunuzda test etmek istiyorsanız APK oluşturabilirsiniz.
APK dosyaları genellikle;
- Uygulamayı fiziksel cihazda test etmek,
- Uygulamayı Google Play dışında dağıtmak,
- Müşteriye veya test ekibine deneme sürümü göndermek,
- Uygulamanın yayınlanmadan önce son kontrollerini yapmak
gibi işlemlerde kullanılmaktadır.
Ancak APK dosyasını oluşturmuş olmanız uygulamanın doğrudan mağazaya gönderilmeye hazır olduğu anlamına gelmez. Paket adı, sürüm bilgileri, imzalama işlemleri ve kullanılan Android SDK sürümleri gibi birçok ayarın doğru yapılandırılmış olması gerekir.
AAB Nedir?
AAB, yani Android App Bundle, Android uygulamalarının özellikle Google Play üzerinden yayınlanması için kullanılan paket formatıdır.
AAB dosyasını APK'dan ayıran en önemli noktalardan biri, son kullanıcıya doğrudan kurulmak amacıyla hazırlanmamasıdır.
Uygulamanızı AAB olarak Google Play'e yüklediğinizde gerekli APK dosyaları kullanıcının cihazına göre Google Play tarafından oluşturulur.
Bunun avantajı, kullanıcının cihazında ihtiyaç duyulmayan dosyaların indirilmesinin önüne geçilebilmesidir.
Örneğin uygulamanız içerisinde farklı ekran çözünürlükleri, işlemci mimarileri veya dil dosyaları bulunuyorsa her kullanıcı bütün dosyaları indirmek zorunda kalmaz.
Bu nedenle mağazada yayınlanacak uygulamalarda AAB kullanımı oldukça önemlidir.
APK ile AAB Arasındaki Temel Fark Nedir?
En basit şekilde anlatmak gerekirse:
APK → Telefona doğrudan kurulabilen uygulama paketidir.
AAB → Uygulamanın mağazaya yüklenmesi ve cihazlara uygun APK'ların oluşturulması amacıyla kullanılan yayın paketidir.
Dolayısıyla uygulamanızı yalnızca kendi cihazınızda test edecekseniz çoğu durumda APK yeterlidir.
Google Play üzerinde yayınlama yapacaksanız ise yayın sürecine uygun şekilde imzalanmış bir AAB paketi hazırlamanız gerekir.
APK veya AAB Hazırlamadan Önce Yapılması Gerekenler
Paket alma işlemine doğrudan geçmeden önce uygulamanızın yayın ayarlarını kontrol etmeniz önemlidir.
Çünkü yanlış hazırlanmış bir paket daha sonrasında sürüm güncellerken veya Google Play'e yükleme yaparken sorun oluşturabilir.
Özellikle aşağıdaki bilgileri kontrol etmenizi öneriyoruz.
1. Paket Adınızı Belirleyin
Her Android uygulamasının kendisine ait benzersiz bir paket adı bulunur.
Örnek:
com.firmaadi.uygulamaadi
Paket adı uygulamanızın kimliği olarak düşünülebilir.
Uygulamanızı mağazada yayınladıktan sonra paket adını değiştirmek çoğu durumda yeni bir uygulama oluşturmak anlamına geleceği için bu bilgiyi en başta doğru belirlemeniz önemlidir.
Rastgele veya daha sonra değiştirmeyi düşündüğünüz bir paket adıyla uygulamayı yayınlamamanızı tavsiye ediyoruz.
2. Uygulama Adını Kontrol Edin
Telefonda uygulama simgesinin altında görüntülenecek uygulama adının doğru olduğundan emin olun.
Test aşamasında kullanılan;
Test App
My Application
Deneme
gibi isimlerin yayın paketinde unutulması oldukça sık karşılaşılan bir durumdur.
Paket oluşturmadan önce uygulamanın gerçek adını kontrol edin.
3. Uygulama İkonunu Hazırlayın
Uygulamanın varsayılan Android ikonu ile yayınlanmaması için kendi uygulama ikonlarınızı projeye ekleyin.
İkonların farklı Android cihazlarda düzgün görüntülenip görüntülenmediğini mümkünse gerçek cihaz üzerinde kontrol edin.
Özellikle yuvarlak ikon kullanan cihazlarda logonun kenarlardan kesilmemesine dikkat edin.
4. Sürüm Bilgilerini Ayarlayın
Android uygulamalarında sürüm yönetimi oldukça önemlidir.
Genellikle kullanıcıya gösterilen bir sürüm adı ve sistem tarafından takip edilen bir sürüm kodu bulunur.
Örneğin:
Sürüm: 1.0.0
Sürüm Kodu: 1
İlk yayınınızı yaptıktan sonra yeni bir güncelleme gönderirken sürüm kodunun yükseltilmesi gerekir.
Örneğin ilk yayın:
versionCode: 1
Yeni güncelleme:
versionCode: 2
şeklinde ilerleyebilir.
Aynı sürüm koduyla tekrar paket yüklemeye çalışmanız mağaza tarafında hata almanıza neden olabilir.
Release ve Debug APK Arasındaki Fark
Burada dikkat edilmesi gereken diğer bir konu da Debug ve Release paketleridir.
Debug paketleri geliştirme ve test işlemleri için hazırlanır.
Uygulamanızı geliştirirken hızlı bir şekilde telefona yükleyip kontrol etmek için kullanılabilir.
Release paketi ise uygulamanın kullanıcıya dağıtılacak sürümüdür.
Google Play'e gönderilecek veya gerçek kullanıcılara dağıtılacak uygulamalarda mümkün olduğunca release sürümü hazırlanmalıdır.
Release paketinde gereksiz debug özelliklerinin bulunmadığından ve uygulamanın doğru anahtar ile imzalandığından emin olun.
Uygulama İmzalama Nedir?
Android tarafında en önemli konulardan biri uygulamanın imzalanmasıdır.
Release olarak hazırlanan uygulamanın bir imzalama anahtarı bulunur. Bu anahtar uygulamanın kimliğinin korunmasında ve sonraki sürümlerin doğrulanmasında rol oynar.
Burada özellikle dikkat etmeniz gereken konu şudur:
İmzalama bilgilerinizin yedeğini mutlaka alın.
Keystore dosyanızı ve gerekli bilgileri güvenli bir yerde saklayın. Bunları yalnızca bilgisayarınızın masaüstünde bırakmanız doğru bir yedekleme yöntemi değildir.
Ayrıca keystore dosyasını forum, Discord veya herkese açık herhangi bir alanda paylaşmayın.
APK Paketi Hazırlandıktan Sonra Ne Yapılmalı?
APK dosyanız başarıyla oluşturulduysa yayınlamadan veya müşteriye göndermeden önce gerçek bir Android cihaz üzerinde test etmenizi öneriyoruz.
Sadece uygulamanın açılıp açılmadığına bakmak yeterli değildir.
Şunları mümkün olduğunca kontrol edin:
- Uygulama sıfırdan kurulabiliyor mu?
- Açılış ekranı düzgün çalışıyor mu?
- İnternet bağlantısı kullanan bölümler çalışıyor mu?
- Kullanıcı girişi yapılabiliyor mu?
- Bildirim sistemi varsa bildirim geliyor mu?
- Dosya/kamera/konum gibi izinler doğru isteniyor mu?
- Uygulama kapatılıp tekrar açıldığında sorun oluşuyor mu?
- Farklı ekran boyutlarında tasarım bozuluyor mu?
- Geri tuşu ve uygulama içi yönlendirmeler doğru çalışıyor mu?
- Uygulama ikonunda veya isminde hata var mı?
Mümkünse uygulamayı yalnızca geliştirme yaptığınız telefonda değil, farklı Android sürümüne sahip ikinci bir cihazda da deneyin.
AAB Dosyası Ne Zaman Hazırlanmalı?
Uygulamanızın geliştirme ve test işlemleri tamamlandıktan sonra Google Play yayını için AAB dosyanızı oluşturabilirsiniz.
AAB almadan önce özellikle;
Paket adı → Uygulama adı → İkon → Sürüm bilgisi → İmzalama → Release ayarları
sırasıyla tekrar kontrol edilmelidir.
AAB dosyasının başarılı şekilde oluşturulması uygulamanın mağaza tarafından kesin olarak kabul edileceği anlamına gelmez.
Google Play tarafında hedef Android sürümü, uygulama izinleri, gizlilik politikası, veri güvenliği beyanları ve mağaza politikaları gibi ek gereksinimler bulunabilir.
Bu nedenle paket hazırlama ile Google Play yayınlama işlemini birbirinden ayrı iki aşama olarak değerlendirmek daha doğrudur.
Güncelleme Yayınlarken Nelere Dikkat Edilmeli?
Uygulamanız daha önce yayınlandıysa yeni paket hazırlarken en önemli konulardan biri mevcut kullanıcıların uygulamayı güncelleyebilmesidir.
Yeni bir uygulama oluşturmak yerine mevcut uygulamaya güncelleme gönderecekseniz paket kimliği ve sürüm/imzalama yapılandırmanızın mevcut uygulamayla uyumlu olması gerekir.
Ayrıca yeni sürüm kodunun önceki yayından yüksek olması gerekir.
Örneğin mevcut uygulamanız:
1.0.0 – versionCode 1
ise yeni güncellemeniz:
1.1.0 – versionCode 2
olarak hazırlanabilir.
Sadece uygulamanın görünen sürüm adını değiştirmek yeterli olmayabilir.
Sık Karşılaşılan Hatalar
APK veya AAB hazırlama aşamasında karşılaşılan problemlerin büyük bölümü birkaç temel ayardan kaynaklanmaktadır.
Paket oluşturulamıyor:
Projede derleme hatası veya uyumsuz bir bağımlılık bulunabilir. Hata çıktısındaki ilk gerçek hata kontrol edilmelidir.
AAB mağazaya yüklenmiyor:
Sürüm kodu, paket adı, imzalama veya mağazanın güncel gereksinimleri kontrol edilmelidir.
APK telefona kurulmuyor:
Cihazda aynı uygulamanın farklı imzaya sahip başka bir sürümü bulunabilir veya Android sürümü uygulamanın gereksinimlerini karşılamıyor olabilir.
Güncelleme yerine ayrı uygulama olarak kuruluyor:
Paket adının mevcut uygulamayla aynı olup olmadığı kontrol edilmelidir.
Uygulama release sürümünde açılmıyor:
Debug ortamında çalışan fakat release yapılandırmasında eksik kalan API, yapılandırma veya küçültme/obfuscation ayarları kontrol edilmelidir.
APK mı AAB mi Kullanmalıyım?
Kısaca toparlayacak olursak;
Uygulamanızı telefonunuza doğrudan kurmak, test etmek veya mağaza dışında dağıtmak istiyorsanız APK kullanabilirsiniz.
Uygulamanızı Google Play üzerinden yayınlamak istiyorsanız yayın sürecine uygun AAB paketi hazırlamanız gerekir.
Geliştirme sürecinde APK ile testlerinizi yaptıktan sonra son kontrolleri tamamlayıp release AAB oluşturmak genellikle daha düzenli bir çalışma yöntemi olacaktır.
Son Olarak
APK veya AAB oluştururken yalnızca paketin başarıyla alınmasına odaklanmayın.
Paket adı, sürüm kodu, imzalama anahtarı ve release yapılandırması ileride yayınlayacağınız güncellemeler açısından en az uygulamanın kendisi kadar önemlidir.
Özellikle ilk uygulamanızı yayınlıyorsanız keystore ve proje dosyalarınızın yedeğini aldıktan sonra yayın işlemlerine başlamanızı tavsiye ediyoruz.
APK/AAB oluştururken bir hata ile karşılaşırsanız forumda yeni bir konu açabilirsiniz. Konunuza kullandığınız geliştirme ortamını, aldığınız hata mesajını ve mümkünse ekran görüntüsünü eklerseniz sorunun daha hızlı anlaşılmasını sağlayabilirsiniz.
Herkese iyi geliştirmeler.