Google Play dağıtımı için Android uygulaması yayımlama

2025-02-25

Geçici dağıtım için yayımlamayı
Komut satırını kullanarak yayımlama

Android uygulamalarını kullanıcılara dağıtmak için en yaygın yaklaşım Google Play üzerinden yapılır. Bir uygulama Google Play'e ilk kez gönderildiğinde, Google Play Konsolu aracılığıyla gönderilmelidir. Uygulamanın sonraki sürümleri Visual Studio aracılığıyla gönderilebilir. Her iki durumda da bir Google Play Geliştirici hesabı gereklidir. Google Play'e gönderilen uygulamalar Google'dan onay gerektirir.

.NET Çok Platformlu Uygulama Kullanıcı Arabirimi (.NET MAUI) Android uygulamasını dağıtmak için Google Play'e yüklemeden önce anahtar deponuzdan bir anahtarla imzalamanız gerekir. Anahtar depoları, sertifikaların ve özel anahtarların depoları olarak hizmet veren ikili dosyalardır.

Google Play, uygulamanızı Android Uygulama Paketi (AAB) olarak göndermenizi gerektirir. Google Play, her cihaz yapılandırması için en iyi duruma getirilmiş Android Paketleri (APK) oluşturmak ve sunmak için uygulama paketinizi kullanır, böylece uygulamanızı çalıştırmak için yalnızca belirli bir cihaz için gereken kod ve kaynaklar indirilir. Detaylı bilgi için developer.android.com'da Android Uygulama Paketleri hakkında Android Uygulama Paketleri konusuna bakın.

.NET MAUI Android uygulamasını Google Play aracılığıyla dağıtma işlemi aşağıdaki gibidir:

Google Play Geliştirici hesabı oluşturun. Daha fazla bilgi için bkz. Google Play Geliştirici hesabı oluşturma.
Uygulamanızı Google Play Konsolu'nda oluşturun. Daha fazla bilgi için bkz. Uygulamanızı Google Play Konsolu'nda oluşturma .
Uygulamanızı Google Play Konsolu'nda ayarlayın. Daha fazla bilgi için bkz. Google Play Konsolu'nda uygulamanızı ayarlama.
Uygulamanızın doğru paket biçimini kullandığından emin olun. Daha fazla bilgi için bkz. Doğru paket biçimini sağlama.
Visual Studio'da uygulamanızı derleyip imzalayın ve ardından Google Play Konsolu aracılığıyla dağıtun. Daha fazla bilgi için bkz. Uygulamanızı Google Play Konsolu aracılığıyla dağıtma .

Ardından, uygulamanızın sonraki sürümleri Visual Studio aracılığıyla yayımlanabilir. Daha fazla bilgi için bkz. Uygulamanızı Visual Studioaracılığıyla dağıtma.

Google Play Geliştirici hesabı oluşturma

Android uygulamalarını Google Play'de yayımlamak için bir Google Play Geliştirici hesabı oluşturmanız gerekir:

Google Hesabınızı kullanarak bir Google Play Geliştirici hesabına kaydolun.
Geliştirici kimliğiniz hakkındaki bilgileri girin.
Kaydolma işlemi sırasında, Google Play Geliştirici Dağıtım Sözleşmesi'nigözden geçirmeniz ve kabul etmeniz gerekir.
Tek seferlik 25 ABD doları kayıt ücretini ödeyin.
Doğrulama e-postanızdaki yönergeleri izleyerek kimliğinizi doğrulayın.

Önemli

Google Play aracılığıyla uygulama yayımlamadan önce kimlik doğrulamasının tamamlanması gerekir. Buna ek olarak, yeni kişisel hesap sahiplerinin gerçek bir Android cihazına erişimi olduğunu doğrulamaları gerekir. Daha fazla bilgi için bkz. support.google.com'da yeni geliştirici hesapları için cihaz doğrulama gereksinimleri.

Google Play Geliştirici hesabınız oluşturulduktan sonra Google Play'de uygulama yayımlama işlemine başlayabilirsiniz.

Daha fazla bilgi için bkz. Google Play Geliştirici hesabına kaydolma support.google.com.

Uygulamanızı Google Play Konsolu'nda oluşturma

Google Play Geliştirici hesabınızı oluşturduktan sonra Google Play Konsolu'nda bir uygulama oluşturmanız gerekir:

Google Play Geliştirici hesabınızdaoturum açın.
Google Play KonsoluTüm uygulamalar sekmesinde Uygulama oluştur düğmesini seçin:
Uygulama oluştur sayfasında uygulama ayrıntılarınızı girin ve Uygulama oluştur düğmesini seçin:

Google Play Konsolu'nda bir uygulama oluşturma hakkında daha fazla bilgi için destek.google.com'daki uygulamanızı oluşturun ve ayarlayın bölümüne bakın.

Google Play Konsolu'nda uygulamanızı ayarlama

Uygulamanızı oluşturduktan sonra ayarlamanız gerekir. Uygulamanızın panosu en önemli tüm adımlarda size yol gösterir.

Uygulamanızı ayarlamaya başlamak için soldaki menüden Dashboard seçin. Sayfanın üst kısmındaki uygulamanızın ayrıntıları altında, uygulama kurulumu ve sürümüyle ilgili farklı kategoriler ve görevler bulacaksınız. Uygulamanızı Google Play'de başlatabilmeniz için önce zorunlu görevleri tamamlamanız gerekir. Görevi tamamladığınızda yeşil bir tik işareti ve üstü çizili metin görürsünüz. Bölümün en üstündeki ilerleme çubuğu da güncelleştirilir. Daha fazla bilgi için support.google.com adresinde Uygulama panosundaki uygulamanızı ayarlama bölümüne bakın.

Doğru paket biçimini sağlayın

Google Play dağıtımı için bir .NET MAUI Android uygulaması yayımlamak için uygulama paketi biçiminizin yayın derlemeleri için varsayılan paket biçimi olan AAB olması gerekir. Uygulamanızın paket biçiminin doğru ayarlandığını doğrulamak için:

Visual Studio'nun Çözüm Gezgini'nde .NET MAUI uygulama projenize sağ tıklayın ve Özellikleröğesini seçin. Ardından Android > Seçenekleri sekmesine gidin ve Sürüm alanının değerinin paketolarak ayarlandığından emin olun:

yayımlama

Uygulamanızı Google Play Konsolu aracılığıyla dağıtma

Google Play'e bir AAB ilk kez gönderildiğinde, Google Play Konsolu aracılığıyla manuel olarak yüklenmelidir. Bu, Google Play'in gelecekteki tüm paketlerde anahtarın imzasını uygulamanın ilk sürümü için kullanılan orijinal anahtarla eşleştirmesini sağlar. Uygulamayı Google Play Konsolu aracılığıyla karşıya yüklemek için önce Visual Studio'da derlenmesi ve imzalanması gerekir.

Visual Studio'da uygulamanızı derlemek ve imzalamak için:

Visual Studio araç çubuğunda, Hata Ayıklama Hedefi açılan listesini kullanarak Android Öykünücüleri ve ardından seçtiğiniz öykünücüyü seçin:
Hata ayıklama (debug) yapılandırmasından sürüm (release) yapılandırmasına geçmek için Visual Studio araç çubuğunda Çözümler Yapılandırması (Solutions Configuration) açılan listesini kullanın:
Çözüm Gezginiiçinde, .NET MAUI uygulama projenize sağ tıklayın ve "Yayımla..."seçin:

Arşiv Yöneticisi açılır ve Visual Studio uygulama paketinizi arşivlemeye başlar:
Arşiv Yöneticisiarşivleme başarıyla tamamlandıktan sonra arşivinizin seçili olduğundan emin olun ve ardından uygulamanızı dağıtma işlemine başlamak için Dağıt ... düğmesini seçin:

Dağıt - Kanal Seç iletişim kutusu görüntülenir.

Dağıt - Kanal Seç iletişim kutusunda Geçici düğmesini seçin.
Dağıt - İmzalama Kimliği iletişim kutusunda yeni bir imzalama kimliği oluşturmak için + düğmesini seçin:

Android Keystore oluştur iletişim kutusu görüntülenir.

Not

Alternatif olarak, İçeri Aktar düğmesi seçilerek mevcut bir imzalama kimliği kullanılabilir.
Android Keystore oluştur iletişim kutusunda, anahtar deposuolarak bilinen yeni bir imza kimliği oluşturmak için gerekli bilgileri girin ve ardından Oluştur düğmesini seçin.
- Takma ad. Anahtarınız için tanımlayıcı bir ad girin.
- Parola. Anahtarınız için güvenli bir parola oluşturun ve onaylayın.
- Geçerlik. Anahtarınızın geçerli olacağı süreyi yıl cinsinden ayarlayın.
- Tam ad, kuruluş birimi, kuruluş, şehir veya yerellik, eyalet veya il ve ülke kodu. Bu bilgiler uygulamanızda görüntülenmez, ancak sertifikanıza eklenir.
Yeni bir sertifika içeren yeni bir anahtar deposu C:\Users{Username}\AppData\Local\Xamarin\Mono for Android\Keystore{Alias}{Alias}.keystorekaydedilecek.

Önemli

Anahtar deposu ve parola Visual Studio çözümünüzde kaydedilmez. Bu nedenle, bu verileri yedeklediğinizden emin olun. Kaybederseniz uygulamanızı aynı imzalama kimliğiyle imzalayamazsınız.
Dağıt - İmzalama Kimliği iletişim kutusunda, yeni oluşturduğunuz imzalama kimliğinizi seçin ve Farklı Kaydet düğmesini seçin.

Arşiv Yöneticisi yayımlama işlemini görüntüler.
Farklı Kaydet iletişim kutusunda, paketinize ait konumun ve dosya adının doğru olduğunu onaylayın ve Kaydet düğmesini seçin.
İmzalama Parolası iletişim kutusunda, imzalama kimliği parolanızı girin ve tamam düğmesini seçin:
Arşiv Yöneticisi'de, yayımlama süreci tamamlandıktan sonra Dağıtımı Aç düğmesini seçin.

Visual Studio, yayımlanan uygulamayı içeren klasörü açar.

Yayımlanan uygulama daha sonra Google Play Konsolu aracılığıyla Google Play'de yayınlanabilir. Bunu yapmak için önce Google Play Konsolu'nda bir sürüm oluşturmanız gerekir. Sürüm, bir uygulamayı başlatmak veya bir güncelleştirme yayınlamak için hazırlayacağınız bir veya daha fazla uygulama sürümünün birleşimidir. Aşağıdaki parçalarda bir yayın oluşturabilirsiniz:

Dahili test. İç test sürümleri, seçebileceğiniz en fazla 100 test edici için kullanılabilir.
Kapalı test. Kapalı test sürümleri, uygulamanızın yayın öncesi sürümünü test edip geri bildirim gönderebilen, seçtiğiniz sınırlı sayıda test edici tarafından kullanılabilir.
Testi açın. Açık test sürümleri Google Play'de test eden kişiler tarafından kullanılabilir. Kullanıcılar, Mağaza listenizden testlere katılabilir.
Üretim. Üretim sürümleri, seçtiğiniz ülkelerdeki tüm Google Play kullanıcıları tarafından kullanılabilir.

Google Play Konsolu'nda bir yayını oluşturma hakkında daha fazla bilgi için support.google.com'da Yayın hazırlama ve kullanıma sunma konusuna bakın.

Önemli

Google Play'e gönderilen uygulamalar genellikle bir gözden geçirme sürecinden geçer. Daha fazla bilgi için bkz. Uygulamanızı gözden geçirme hazırlama ve Uygulamanızı support.google.com yayımlama.

Uygulamanızı Visual Studio aracılığıyla dağıtma

Visual Studio'dan dağıtabilmeniz için önce bir AAB'nin Google Play'e önceden gönderilmiş ve gözden geçirilmiş olması gerekir. Visual Studio'dan ilk kez Play Konsolu'ndan yüklenmemiş bir AAB dağıtmaya çalışırsanız aşağıdaki hatayı alırsınız:

Google Play, bu uygulama için ilk paketinizi (APK/AAB) el ile yüklemenizi gerektirir. Bunun için geçici bir paket kullanabilirsiniz.

Bu hata oluştuğunda, Google Play Konsolu aracılığıyla bir AAB'yi el ile yükleyin. Daha sonra uygulamanın sonraki sürümleri Visual Studio aracılığıyla yayımlanabilir. Ancak, her karşıya yükleme için uygulamanın sürüm kodunu değiştirmeniz gerekir, aksi takdirde aşağıdaki hata oluşur:

Sürüm kodu (1) olan bir AAB zaten yüklenmiş durumda.

Bu hatayı çözmek için uygulamayı farklı bir sürüm numarasıyla yeniden derleyin ve ardından Visual Studio aracılığıyla Google Play'e yeniden gönderin.

Not

Uygulamanın sürüm numarası, uygulamanın proje dosyasındaki ApplicationVersion tamsayı özelliğinin değeri artırılarak güncelleştirilebilir.

Uygulamanızı Visual Studio'dan Google Play'e yüklemek için önce Google Play Konsolu'nda API erişimini ayarlamanız gerekir.

Google API erişimini etkinleştirme

Google Play Geliştirici Yayımlama API'si, Visual Studio'nun bir uygulamanın yeni sürümlerini Google Play'e yüklemesini sağlar. Visual Studio'nun API çağrıları yapmaya başlayabilmesi için önce Google Play Geliştirici hesabınızda API erişimini ayarlamanız gerekir. Bu, Google Play Geliştirici hesabınızı bir Google Cloud projesine bağlamayı ve OAuth istemcisiyle Google Play Geliştirici Yayımlama API'sine erişimi yapılandırmayı içerir.

Google API erişimini etkinleştirmek için:

Google Play Geliştirici hesabınızdaoturum açın.
Google Play Konsoluiçinde, Kurulum öğesini genişletin ve API Erişimiseçin. Ardından API erişimi sayfasında bağlanacak proje seçin düğmesini seçin:

Google Play Geliştirici API'lerini kullanmak için Google Play Geliştirici hesabınıza bağlı olması gereken bir Google Cloud projesi gerekir.

Not

Google Play Geliştirici hesabı yalnızca tek bir Google Cloud projesine bağlanabilir. Bu nedenle, bir Google Play Geliştirici hesabından birden çok uygulama yayımlarsanız, hepsi aynı Google Cloud projesini paylaşmalıdır.
API erişimi sayfasında, yeni bir Google Cloud projesi oluştur radyo düğmesini seçin ve ardından Kaydet düğmesine tıklayın.

Yeni bir Google Cloud projesi oluşturulur ve Google Play Geliştirici hesabınıza bağlanır.
API erişimi sayfasındaki OAuth istemcileri bölümünde OAuth onayını yapılandır ekranını seçin:
OAuth onay ekranı sayfasında, gerekli kullanıcı türü için radyo düğmesini seçin ve ardından OLUŞTUR düğmesine tıklayın.

Kullanıcı türleri hakkında daha fazla bilgi için bkz. support.google.com kullanıcı türü .
Uygulama kaydı düzenleme sayfasında, gerekli olarak işaretlenmiş alanları doldurun ve ardından KAYDET VE DEVAM ET düğmesini seçin:
Uygulama kaydını düzenleme sayfasında, KAPSAM EKLE VEYA KALDIR düğmesini seçin:
Güncelleme seçili kapsamları açılır menüsünde, tablodan ./auth/androidpublisher kapsamını seçin ve ardından GÜNCELLE düğmesini seçin:

Not

Tablodaki diğer kapsamlar, standart kapsamlar olduğundan isteğe bağlı olarak seçilebilir.
Uygulama kaydını düzenle sayfasında Kimlik Bilgileri sekmesini seçin:
Kimlik Bilgileri sayfasında + CREATE CREDENTIALS düğmesini ve ardından OAuth istemci kimliği öğesini seçin:
OAuth istemci kimliği oluştur sayfasında, Uygulama türü açılan menüsünden Masaüstü uygulaması seçin, Adı alanına Visual Studio girin ve ardından CREATE düğmesini seçin:
OAuth istemcisi oluşturma iletişim kutusunda, JSON'u İNDİR veri düğmesini seçerek istemci kimliğinizi ve gizli anahtarınızı indirin. Bu daha sonra gerekli olacaktır. Ardından Tamam düğmesine tıklayarak iletişim kutusunu kapatın.

Google Play Geliştirici hesabınıza Google API'sinin etkinleştirilmesi hakkında daha fazla bilgi için developers.google.com'da Başlarken bölümüne bakınız. OAuth onay ekranınızı ayarlama hakkında daha fazla bilgi için bkz. support.google.com'da OAuth onay ekranınızı ayarlama .

Uygulamanızı Visual Studio aracılığıyla yükleyin

Visual Studio'da uygulamanızı derlemek ve imzalamak için:

Visual Studio araç çubuğunda, Hata Ayıklama Aracı açılır listesini kullanarak önce Android Öykünücüleri ve ardından istediğiniz öykünücüyü seçin:
Yayın yapılandırmasına geçmek için Visual Studio araç çubuğunda Çözümler Yapılandırması açılır listesini kullanarak hata ayıklama yapılandırmasını değiştirin.
Çözüm Gezgini'nde, .NET MAUI uygulama projenize sağ tıklayın ve Yayımla...seçeneğini seçin:

Arşiv Yöneticisi açılır ve Visual Studio uygulama paketinizi arşivlemeye başlar:
Arşiv Yöneticisiarşivleme başarıyla tamamlandıktan sonra arşivinizin seçili olduğundan emin olun ve ardından uygulamanızı dağıtma işlemine başlamak için Dağıt ... düğmesini seçin:

Dağıt - Kanal Seç iletişim kutusu görüntülenir.

Dağıt - Kanal Seç iletişim kutusunda Google Play düğmesini seçin:
Dağıt - İmzalama Kimliği iletişim kutusunda, uygulamayı Google Play Konsolu aracılığıyla dağıtım için oluştururken oluşturduğunuz imzalama kimliğini seçin ve ardından devam düğmesini seçin:

Google Play Geliştirici hesabınızın ayrıntılarını ekleme

Google Play Geliştirici hesabınızı Visual Studio'ya eklemek için:

Dağıt - Google Play Hesabı iletişim kutusunda + düğmesini seçerek Google Play Geliştirici hesabınızın ayrıntılarını ekleyin:
Google API Access Kaydet iletişim kutusunda bir açıklama ve OAuth istemci kimliğiniz ile istemci gizli dizinizi girin ve kaydet düğmesine tıklayın:

Not

Hesap açıklaması, birden fazla Google Play Geliştirici hesabı kaydetmeyi ve farklı Google Play Geliştirici hesaplarına uygulama yüklemeyi mümkün kılar.

Bir web tarayıcısı açılır.
Web tarayıcısında Google Play Geliştirici hesabınızda oturum açın. Oturum açıldıktan sonra, Google'ın uygulamayı doğrulamadığını belirten bir ileti görüntülenebilir. Bu durumda devam düğmesini seçin.
Uygulamayı yetkilendirmek için web tarayıcısında devam düğmesini seçin:

Web tarayıcısı bir doğrulama kodu alır.

Önemli

Web tarayıcısını kapatmayın.
Visual Studio'da, Dağıt - Google Play Hesabı iletişim kutusunda Devam etseçin:

Uygulamanızı yüklemek için bir kanal seçin

Uygulamanızın yüklendiği Google Play parçasını seçmek için:

Dağıt - Google Play track iletişim kutusunda uygulamanızın yüklendiği parçayı seçin. Google Play, uygulamanızı karşıya yüklemek için beş kanal sunar.
- İç dağıtım, uygulamanızın dahili test ve kalite güvencesi denetimleri için hızla dağıtılması amacıyla kullanılmalıdır.
- Alfa, uygulamanızın erken bir sürümünü küçük bir test edici grubuna yüklemek için kullanılmalıdır.
- Beta, uygulamanızın erken bir sürümünü daha büyük bir test edici grubuna yüklemek için kullanılmalıdır.
- Üretim, Google Play mağazasına tam dağıtım için kullanılmalıdır.
- Özel yapılandırma, e-posta adresleri kullanılarak bir test edenler listesi oluşturularak, uygulamanızın yayın öncesi sürümlerini belirli kullanıcılarla test etmek amacıyla kullanılmalıdır.
Önemli

Özel parçayı görmüyorsanız Google Play Konsolu'nda bu parça için bir sürüm oluşturduğunuzdan emin olun. Daha fazla bilgi için support.google.com adresinde Sürüm Hazırlama ve Kullanıma Sunma bölümüne bakın.

Uygulamanızın yüklendiği parçayı seçin ve ardından Karşıya Yükle düğmesini seçin:

Google Play testi hakkında daha fazla bilgi için, support.google.com'da Açık, Kapalı veya Dahili Test Ayarlama bölümüne bakın.
Visual Studio, uygulamanızı Google Play'de yayımlamaya başlar. İmzalama Parolası iletişim kutusunda, imzalama kimliği için oluşturduğunuz parolanızı girin ve tamam düğmesini seçin:

Visual Studio uygulama paketinizi imzalar ve Google Play'e yükler.

Önemli

Google Play'e gönderilen uygulamalar genellikle bir gözden geçirme sürecinden geçer. Daha fazla bilgi için bkz. Uygulamanızı gözden geçirme hazırlama ve Uygulamanızı support.google.com yayımlama.