Hazır özellikli uygulama paketi oluşturma

Google Play Instant deneyimi oluşturmak için Android App Bundle Bu tür bir paket, anında özellikli uygulama paketi'ne gidin. Bu belgede, Google Ads hesaplarınıza özellikli uygulama paketleri için geliştirme ortamına ve Hazır özellikli uygulama paketi yapılandırma, derleme, test etme ve yayınlama.

Desteği sonlandırılan özelliği kullanan mevcut bir hazır uygulama projeniz varsa eklentisi (com.android.feature), nasıl yapılacağını öğrenin hazır uygulamanızı Android App Bundle'ları destekleyecek şekilde taşıyın.

Geliştirme ortamını ayarlama

Bir uygulama paketi içinde hazır uygulama deneyimi sağlamak için Google Play Hazır Geliştirme SDK'sı. SDK'yı şu adreslerden biriyle yükleyebilirsiniz: aşağıdaki yöntemlerden birini tercih edebilirsiniz:

Ayrıca, hazır uygulama deneyiminizi yerel olarak test etmek isterseniz ya fiziksel ya da sanal bir cihaz olmalıdır.

Gerekli yürütme koşulları hakkında bilgi edinin

Google Play Instant, özel bir türde hazır uygulama paketleri çalıştırır. Daha fazla güvenlik için SELinux korumalı alanı. Bu korumalı alan, bir diğer uygulamalarla sınırlı türde etkileşimler kurmak için kullanılabilir. İlgili içeriği oluşturmak için kullanılan aşağıdaki bölümlerde bu korumalı alanın özellikleri daha ayrıntılı olarak açıklanmaktadır.

Desteklenen izinler ve işlemler

Hazır sürüm etkin uygulama paketleri yalnızca aşağıdaki listede bulunan izinleri kullanabilir:

Desteklenmeyen genel izinleri kullanma

Aşağıda, kaldırmanız gereken yaygın, desteklenmeyen izinlerin bir listesi bulunmaktadır. ve her biri için önerilen taşıma yolundan kaldırmalısınız:

  • ACCESS_WIFI_STATE: Aşağıdaki değeri içeren ACCESS_NETWORK_STATE kullanın: ACCESS_WIFI_STATE ile benzer bilgiler sağlar.
  • BILLING: Bu, desteği sonlandırılmış bir izindir. Şunu kullanın: Google Play Faturalandırma Kitaplığı, Bu işlem için artık com.android.vending.BILLING izni gerekmiyor.
  • READ/WRITE_EXTERNAL_STORAGE: Hazır uygulamaların harici depolama alanı; dahili depolama kullanın.
  • com.google.android.c2dm.permission.RECEIVE ve permission.C2D_MESSAGE: C2DM kullanımdan kaldırıldı. Firebase Cloud Messaging'e (FCM) geçiş yapın. FCM'ye göre herhangi bir ek izne gerek yoktur.

Ayrıca, hazır sürüm etkin uygulama paketleri aşağıdakileri yapamaz:

Yüklü uygulamalara erişim

Hazır deneyim geliştirirken bu deneyimle etkileşime giremeyeceğini Aşağıdaki durumlardan biri geçerli değilse cihaza yüklenen uygulamalar:

  • Yüklü bir uygulamadaki bir veya daha fazla etkinlik, true öğesine android:visibleToInstantApps öğesi – Bu öğe kullanılabilir .
  • Yüklü bir uygulama, şunları içeren bir intent filtresine sahiptir: CATEGORY_BROWSABLE.
  • Hazır uygulama deneyimi, ACTION_SEND ACTION_SENDTO veya ACTION_SEND_MULTIPLE eyleme dökülebilir.

Hazır uygulama deneyimleri için projenizi yapılandırma

Google Play Instant ile uyumlu olması için birkaç tane yapılandırmanız gerekir özelliklerini dikkatlice inceleyin. Aşağıdaki bölümler ve bu konuları açıklayın.

Proje bağımlılıklarını tanımlama

Uygulamanızda Google Play Instant API'lerini kullanmak için aşağıdakileri ekleyin uygulama modülünüzün build.gradle yapılandırma dosyasındaki beyanı:

Eski

implementation "com.google.android.gms:play-services-instantapps:17.0.0"

Kotlin

implementation("com.google.android.gms:play-services-instantapps:17.0.0")

Doğru sürüm kodlarını tanımlama

Uygulamanızın hazır uygulama deneyiminin sürüm kodu Yüklenebilir uygulamanın sürüm kodu. Beklenti, kullanıcıların web sitesinden Google Play Instant deneyimini kullanarak uygulamayı indirip erişim izni isteyebilir. Android çerçevesi bu geçişi bir uygulama olarak kabul eder güncelleyin.

Kullanıcıların beklediği sürüm oluşturma şemasını izlediğinizden emin olmak için aşağıdaki talimatları uygulayın: şu stratejilerden birini seçin:

  • Google Play Instant deneyimi için sürüm kodlarını 1'de yeniden başlatın.
  • Yüklenebilir APK'nın sürüm kodunu yüksek bir sayı artırın. Örneğin: 1000, hazır uygulama deneyiminizin sürümünde yeterli alan bulunduğundan emin olun sayısını artırır.

Hazır uygulamanızı ve yüklenebilir uygulamanızı iki ayrı Android Studio projeleri. Ancak bunu yaparsanız uygulamanızı Google Play'de yayınlayın:

  1. Her iki Android Studio projesinde de aynı paket adını kullanın.
  2. Google Play Console'da her iki varyantı da aynı uygulamaya yükleyin.
ziyaret edin.

Uygulamanızın sürümünü ayarlama hakkında daha fazla bilgi için uygulamasında gösterilir.

Hedef korumalı alan sürümünü güncelleyin

Hazır uygulamanızın AndroidManifest.xml dosyasının Google Play Instant'ın desteklediği korumalı alan ortamı. Tamamlayabilirsiniz Bu güncellemeyi, uygulamanızın verilerine android:targetSandboxVersion özelliğini ekleyerek <manifest> öğesi, aşağıdaki kod snippet'inde gösterildiği gibi:

<manifest
   xmlns:android="http://schemas.android.com/apk/res/android"
  ...
   android:targetSandboxVersion="2" ...>

Daha fazla bilgi için targetSandboxVersion özelliğini gönderin.

Hazır özellikli uygulama modüllerini bildirme

Uygulama paketinizin hazır uygulama deneyimlerini desteklediğini aşağıdakileri kullanarak beyan edebilirsiniz: aşağıdaki yöntemleri kullanabilirsiniz:

  • Yalnızca temel içeren bir uygulama paketiniz varsa modülünü kullanarak, ayarlarınızı anında uygulama paketi aşağıdaki gibidir:

    1. Görünüm >'ü seçerek Proje panelini açın Araç Pencereleri > Proje menü çubuğundan yapabilirsiniz.
    2. Genellikle "app" adlı temel modülünüzü sağ tıklayın ve Yeniden düzenleyin > Hazır Uygulama Desteği'ni etkinleştirin.
    3. Görünen iletişim kutusunda, açılır menüden temel modülünüzü seçin.
    4. Tamam'ı tıklayın.

    Android Studio, modülün manifest dosyasına aşağıdaki bildirimi ekler:

    <manifest ... xmlns:dist="http://schemas.android.com/apk/distribution">
    <dist:module dist:instant="true" />
    ...
</manifest>

  • Birden fazla modül içeren mevcut bir uygulama paketiniz varsa şunları yapabilirsiniz: Hazır sürüm etkin bir özellik oluştur modülünü inceleyin. Bu işlem ayrıca uygulamanızın temel modülünü anında etkinleştirir ve size çoklu anında giriş noktaları uygulamasını indirin.

ziyaret edin.

Oturum açma desteği ekleyin

Hazır uygulama deneyiminiz kullanıcıların oturum açmasına izin veriyorsa hazır uygulamanız paketinin Şifreler için Smart Lock'u desteklemesi gerekir: Android. Bir mühendisle "Anında oyna" oyun, bunun yerine Google Play Games Hizmetleri oturum açma özelliğini kullanmalısınız.

Yürütme ortamını destekleme

Hazır deneyimlerin çalıştırıldığı SELinux korumalı alanı ile uyumlu olmak için Hazır özellikli uygulama paketinizi oluştururken aşağıdakileri göz önünde bulundurun:

  • myUid() değerini paylaşmayın, Bu, uygulama işleminizin çekirdeğine UID.
  • Uygulamanız Android 8.1 (API düzeyi 27) veya önceki sürümleri hedefliyorsa bir Network Security Config dosyasıyla birlikte cleartextTrafficPermitted - false. Hazır sürüm deneyimleri HTTP'yi desteklemez yardımcı olur. Android 9 veya sonraki sürümleri hedefleyen uygulamalar için temiz metin trafiği varsayılan olarak devre dışıdır.

  • Hazır uygulama deneyiminiz, şu tarihe kadar kullanıcının cihazına indirilmiş olarak kalır: hazır uygulama deneyimi önbelleği temizlenir. Bu işlem, aşağıdakilerden birinde gerçekleşir durumlar:

    • Hazır uygulama deneyimi önbelleğinin çöp toplaması, çünkü cihaz kullanılabilir bellek azalıyor.
    • Kullanıcı cihazını yeniden başlatır.

    Her iki işlem de gerçekleşirse kullanıcının hazır uygulama deneyiminizi yeniden indirmesi gerekir belirlemeniz gerekir.

  • Sistemin depolama alanı çok azsa hazır uygulama deneyiminin kullanıcı verileri dahili depolama alanından kaldırılır. Dolayısıyla, düzenli olarak uygulamanızın sunucusuyla senkronize edilmesi önerilir. Böylece, kullanıcının ilerleme durumu korunur.

Hazır uygulama deneyimi iş akışları için mantık ekleyin

Uygulama paketinizi hazır uygulama deneyimlerini destekleyecek şekilde yapılandırdıktan sonra aşağıdaki bölümlerde gösterilen mantığa dayalıdır.

Uygulamanın hazır uygulama deneyimi çalıştırıp çalıştırmadığını kontrol etme

Uygulamanızın mantığı, kullanıcının uygulama veya hazır uygulama deneyimi, isInstantApp() yöntemidir. Bu yöntem, şu anda çalıştırılan işlem birtrue hazır uygulama deneyimi.

Yükleme istemi görüntüle

Uygulamanızın veya oyununuzun deneme sürümünü oluşturuyorsanız Google Play Instant, bir istem görüntülemenizi sağlayan hazır uygulama deneyimini kullanarak, kullanıcıları doğrudan olanak tanır. Bu istemi görüntülemek için şunu kullanın: InstantApps.showInstallPrompt() yöntemini çağırın:

Kotlin

class MyInstantExperienceActivity : AppCompatActivity {
    // ...
    private fun showInstallPrompt() {
        val postInstall = Intent(Intent.ACTION_MAIN)
                .addCategory(Intent.CATEGORY_DEFAULT)
                .setPackage(your-installed-experience-package-name)

        // The request code is passed to startActivityForResult().
        InstantApps.showInstallPrompt(this@MyInstantExperienceActivity,
                postInstall, request-code, /* referrer= */ null)
    }
}

Java

public class MyInstantExperienceActivity extends AppCompatActivity {
    // ...
    private void showInstallPrompt() {
        Intent postInstall = new Intent(Intent.ACTION_MAIN)
                .addCategory(Intent.CATEGORY_DEFAULT)
                .setPackage(your-installed-experience-package-name);

        // The request code is passed to startActivityForResult().
        InstantApps.showInstallPrompt(MyInstantExperienceActivity.this,
                postInstall, request-code, /* referrer= */ null);
    }
}

Yüklü bir deneyime veri aktarma

Kullanıcı hazır uygulama deneyiminizden memnun kalırsa uygulamanızı uygulamasını indirin. İyi bir kullanıcı deneyimi sağlamak için Hazır uygulama deneyiminizden tam sürüme aktarıldığına dair sürümünü kullanabilirsiniz.

Kullanıcı, Android 8.0 (API düzeyi 26) veya sonraki sürümleri çalıştıran bir cihaz kullanıyorsa ve uygulamanız bir targetSandboxVersion belirtiyorsa 2 olarak ayarlarsanız kullanıcının verileri aktarılır otomatik olarak uygulamanızın tam sürümüne otomatik olarak yüklenir. Aksi takdirde manuel olarak da oluşturabilirsiniz. Bunu yapmak için aşağıdaki API'lerden birini kullanın:

  • Android 8.0 (API düzeyi 26) ve sonraki sürümleri çalıştıran cihazlar için Cookie API'yi kullanın (örnek uygulama)
  • Kullanıcıların Android 7.1 çalıştıran cihazlarda deneyiminizle etkileşimde bulunup bulunmadığı (API düzeyi 25) ve altında, Storage API için destek ekleyin: örnek uygulama

Uygulama paketini oluşturma

Uygulamanızı oluşturmak için Android Studio'yu veya komut satırı arayüzünü kullanabilirsiniz. hazır özellikli uygulama paketidir.

Android Studio

Android Studio'da, aşağıdakileri seçerek uygulama paketinizi oluşturabilirsiniz: Oluştur > Derleme Paketleri / APK'lar > Paketleri oluşturun. Okuyucu Gelirleri Yöneticisi'ni Projenizi oluşturma başlıklı makaleyi inceleyin.

Komut satırı arayüzü

Uygulama paketini aşağıdaki komuttan da oluşturabilirsiniz: satır ekleyin.

64 bit mimarileri destekleme

Google Play'de yayınlanan uygulamaların 64 bit mimarileri desteklemesi gerekir. Bu makale için Uygulamanızın 64 bit sürümü performans iyileştirmeleri sunar ve (yalnızca 64 bit donanıma sahip cihazlar için) 64 bit desteği hakkında daha fazla bilgi edinin.

Hazır uygulama deneyimini test etme

Hazır özellikli uygulama paketinizi yayınlamadan önce hazır uygulama sürümünü test edebilirsiniz aşağıdaki konumlardan birinden deneyim sahibi olmanız gerekir:

ziyaret edin.

Android Studio

Android Studio'yu kullanarak uygulamanızın hazır uygulama deneyimini yerel bir makinede test etmek için: aşağıdaki adımları tamamlayın:

  1. Test cihazınızda uygulamanızın yüklü bir sürümü varsa somut olarak ortaya koyar.
  2. Android Studio'da, Çalıştır/Hata Ayıklama Yapılandırmaları'nın Genel sekmesi iletişim kutusunun, Anında dağıt uygulamasında onay kutusunu işaretleyin.
  3. Çalıştır > menü çubuğundaki Çalıştır'ı tıklayın veya araç çubuğundan uygulamanızın anlık durumunu test etmek istediğiniz cihazı seçin paylaşmaya istekli olmalıdır. Uygulamanızın hazır uygulama deneyimi, kullandığınız test cihazında yüklenir seçilir.

Komut satırı arayüzü

Komut satırını kullanarak uygulamanızın hazır uygulama deneyimini yerel bir makinede test etmek için: aşağıdaki adımları tamamlayın:

  1. Test cihazınızda uygulamanızın yüklü bir sürümü varsa somut olarak ortaya koyar.
  2. Hazır uygulamanızı başka cihazdan yüklemek ve şu komutu kullanın:
ia run output-from-build-command

Dahili test kanalı

Uygulamanızın hazır deneyimini Play Store'dan veya web sitesini ziyaret ettikten sonra uygulamayı dahili test parça Play Console'da bulabilirsiniz.

Uygulamanızı dahili test kanalına yayınlamak için aşağıdaki adımları tamamlayın:

  1. Uygulama paketinizi yükleme başlıklı makaledeki adımları uygulayarak uygulama paketinizi yükleyin. inceleyin.
  2. Yüklenen paketi dahili test kanalında yayınlanmak üzere hazırlayın. Örneğin, daha fazla bilgi için Nasıl hazırlanacağınızı ve nasıl yapılacağını kullanıma sunmak sürümleri hakkında daha fazla bilgi edinin.

  3. Bir cihazda dahili test kullanıcısı hesabında oturum açın, ardından anlık görüntünüzü başlatın deneyimi aşağıdaki yüzeylerden birinde kullanabilirsiniz:

    • Uygulamanızın Play mağaza girişindeki Şimdi Dene düğmesi.
    • Uygulamanızın web sitesindeki bir banner'daki bağlantı.
ziyaret edin.

Uygulama paketini üretim kanalına yayınlama

Hazır özellikli uygulama paketinizi yayınlamak için aşağıdaki adımları tamamlayın:

  1. Henüz yapmadıysanız uygulama paketinizi bir sürümle imzalayın key'i tıklayın ve uygulama paketini Play Console.
  2. Play Console'da Sürüm yönetimi > Android Hazır Uygulamalar, ardından hazır uygulama üretimi kanalına gidin.
  3. Kitaplıktan güncelle'yi, ardından hazır sürüm etkin uygulama paketini seçin. indiremezsiniz.

Hazır uygulama deneyiminizi nerede yayınlayacağınızı seçin

Uygulamanız için hazır uygulama deneyimini kullanıma sunmak, Google Kullanıcıların uygulamanızı yükleyebileceği ülkeler ve bölgeler. Bu olanak uygulamanızın hazır uygulama deneyimini Belirli ülke ve bölgelerde bulunan kullanıcılar

Ek kaynaklar

Hazır uygulama deneyimleri ve Android App Bundle'lar oluşturma hakkında daha fazla bilgi edinmek için şu sayfayı inceleyin: şu kaynakları inceleyin:

Video: Anında Uygulama Paketi Oluşturma
Android App Bundle'a hazır uygulama deneyimini nasıl ekleyeceğinizi öğrenin: oturumuna katıldım.
Video: Android App Bundle ile daha küçük boyutlu uygulamalar yayınlama
Uygulama paketlerinin, uygulamanızı daha hızlı bir şekilde geliştirmenize ve oluşturmanıza nasıl yardımcı olduğunu öğrenin daha küçük APK'lar hazırlayabilirsiniz.
Codelab: İlk Android App Bundle'ınız
Android App Bundle oluşturma ve Android App Bundle'a özellik eklemeyle ilgili adım adım açıklamalı kılavuz eder.
Android App Bundle Biçimi
bundletool komut satırı programının bir uygulamayı nasıl düzenlediği hakkında daha fazla bilgi edinin paketinden yararlanırsınız.