Google Play, kullanıcıların indirdiği sıkıştırılmış APK'nın 100 MB'tan fazla olmamasını zorunlu kılar. Bu alan, çoğu uygulama için tüm uygulama kodu ve öğeleri için geniş bir alandır. Ancak bazı uygulamalar yüksek kaliteli grafikler, medya dosyaları veya diğer büyük öğeler için daha fazla alana ihtiyaç duyar. Önceden, uygulamanızın sıkıştırılmış indirme boyutu 100 MB'ı aşıyorsa, ek kaynaklar hazırlayabilirsiniz. Ek dosyaları barındırmak ve sunmak, çoğu zaman idealin altındadır ve kullanıcı deneyimi genellikle pahalıya mal olur. Bu işlemi sizin için kolaylaştırmak üzere ve kullanıcılar için daha keyifli olan Google Play, iki büyük genişletme dosyası eklemenize olanak tanır. APK'nızı destekler.
Google Play, uygulamanızın genişletme dosyalarını barındırır ve bunları şuradaki cihazda sunar: hiçbir maliyeti olmaz. Genişletme dosyaları cihazın paylaşılan depolama konumuna ( SD kart veya USB'ye takılabilir bölüm; “harici” olarak da bilinir. uygulamanızın erişebileceği depolama alanı) gerekir. Google Play, çoğu cihazda genişletme dosyalarını aynı anda indirir APK'yı indirir; böylece kullanıcı, APK'yı ilk kez. Ancak bazı durumlarda, uygulamanızın bu dosyaları Google Play'den indirmesi gerekir Google Ad Manager'a iletebilirsiniz.
Genişletme dosyası kullanmaktan kaçınmak istiyorsanız ve uygulamanızın sıkıştırılmış indirme boyutu daha büyükse boyutu 100 MB'tan büyükse uygulamanızı Android Uygulaması Paketler: 200 MB'a kadar sıkıştırılmış indirme boyutuna olanak tanır. Ayrıca, Uygulama paketleri, APK oluşturma ve Google Play'de oturum açma işlemlerini erteler. Kullanıcılar, yalnızca uygulamanızı çalıştırmak için gereken kod ve kaynakları sağlayın. Bina oluşturmak, imzalamak kullanıcılar birden fazla APK veya genişletme dosyasını yönetebilir. Kullanıcılar daha küçük ve daha optimize edilmiş indirmeler elde eder.
Genel Bakış
Google Play Console'u kullanarak her APK yüklediğinizde APK'ya bir veya iki genişletme dosyası ekleyin. Her dosya en fazla 2 GB olabilir ve istediğiniz biçimde olabilir. seçebilirsiniz, ancak indirme sırasında bant genişliğini korumak için sıkıştırılmış bir dosya kullanmanızı öneririz. Kavram olarak her genişletme dosyası farklı bir rol oynar:
- Ana genişletme dosyası birincil genişletme dosyanızı eklemeniz gerekir.
- yama genişletme dosyası isteğe bağlıdır ve ana genişletme dosyası oluşturun.
Bu iki genişletme dosyasını istediğiniz gibi kullanabilirsiniz, ancak ana genişletme dosyası birincil öğeleri teslim eder ve güncellenmezse nadiren görülür. yama genişletme dosyası daha küçük olmalı ve "yama operatörü" işlevi görmeli veya gerektiğinde geri bildirim vermelisiniz.
Ancak, uygulama güncellemeniz yalnızca yeni bir yama genişletme dosyası gerektirse bile
manifest dosyasında güncellenmiş versionCode
ile yeni bir APK yükleyin. (
Play Console, mevcut bir APK'ya genişletme dosyası yüklemenize izin vermez.)
Not: Yama genişletme dosyası, anlam açısından ana genişletme dosyası olarak, her dosyayı istediğiniz gibi kullanabilirsiniz.
Dosya adı biçimi
Yüklediğiniz her bir genişletme dosyası, seçtiğiniz herhangi bir biçimde (ZIP, PDF, MP4 vb.) olabilir. Ayrıca transkriptinizi bir kümeyi kapsüllemek ve şifrelemek için JOBB aracını kullanın yamalarını ifade eder. Google Play, dosya türünden bağımsız olarak bunları opak ikili blob'lar olarak değerlendirir ve aşağıdaki şemayı kullanarak dosyaları yeniden adlandırır:
[main|patch].<expansion-version>.<package-name>.obb
Bu şemanın üç bileşeni vardır:
main
veyapatch
- Dosyanın ana dosya mı yoksa yama genişletme dosyası mı olduğunu belirtir. Projede her APK için yalnızca bir ana dosya ve bir yama dosyası bulunmalıdır.
<expansion-version>
- Bu, genişletmenin kullanıldığı APK'nın sürüm koduyla eşleşen bir tam sayıdır.
ilk ilişkilendirilen (uygulamanın
android:versionCode
ile eşleşir) değeri) ekleyebilirsiniz."Ad" her ne kadar Play Console size sadece yüklenen bir genişletme dosyasını yeni bir APK ile yeniden kullanırsanız genişletme dosyasının adı değişmez; dosyayı ilk yüklediğinizde ona uygulanan sürümü korur.
<package-name>
- Uygulamanızın Java stili paket adı.
Örneğin, APK sürümünüzün 314159, paket adınızın ise com.example.app olduğunu varsayalım. Şu durumda: bir ana genişletme dosyası yüklediğinizde dosyanın adı şu şekilde olur:
main.314159.com.example.app.obb
Depolama konumu
Google Play genişletme dosyalarınızı bir cihaza indirdiğinde, bunları sistemin paylaşılan depolama konumu. Doğru davranışı sağlamak için, anahtar kelimeleri silmemeli, taşımamalı veya genişletme dosyalarını kullanabilirsiniz. Uygulamanızın Google Play'den indirme işlemini gerçekleştirmesi gerektiğinde dosyaları tam olarak aynı konuma kaydetmeniz gerekir.
getObbDir()
yöntemi, belirli bir konumu döndürür
aşağıdaki biçimde olması gerekir:
<shared-storage>/Android/obb/<package-name>/
<shared-storage>
, paylaşılan depolama alanına giden yoldur.getExternalStorageDirectory()
.<package-name>
, uygulamanızın Java stili paket adıdır ve kullanılabilirgetPackageName()
başlangıç fiyatıyla.
Her uygulama için bu dizinde hiçbir zaman ikiden fazla genişletme dosyası olmaz.
Biri ana genişletme dosyası, diğeri ise yama genişletme dosyasıdır (gerekirse). Geri
sürümlerin üzerine yazılır. Android'den beri
4.4 (API düzeyi 19) nedeniyle uygulamalar, OBB
genişletme dosyalarını harici depolama olmadan okuyabilir
izni gerekir. Ancak, Android 6.0 (API düzeyi 23) ve sonraki sürümlerin bazı uygulamaları için yine de
bu izni beyan etmeniz gerekir.
READ_EXTERNAL_STORAGE
iznini almak için şu adresten izin isteyin:
aşağıdaki gibi çalışır:
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
Android 6 ve sonraki sürümler için çalışma zamanında harici depolama izninin istenmesi gerekir. Ancak Android'in bazı uygulamaları, OBB dosyalarını okumak için izin gerektirmez. İlgili içeriği oluşturmak için kullanılan Aşağıdaki kod snippet'i, harici depolama alanı istenmeden önce okuma erişimini nasıl kontrol edeceğinizi gösterir izin:
Kotlin
val obb = File(obb_filename) var open_failed = false try { BufferedReader(FileReader(obb)).also { br -> ReadObbFile(br) } } catch (e: IOException) { open_failed = true } if (open_failed) { // request READ_EXTERNAL_STORAGE permission before reading OBB file ReadObbFileWithPermission() }
Java
File obb = new File(obb_filename); boolean open_failed = false; try { BufferedReader br = new BufferedReader(new FileReader(obb)); open_failed = false; ReadObbFile(br); } catch (IOException e) { open_failed = true; } if (open_failed) { // request READ_EXTERNAL_STORAGE permission before reading OBB file ReadObbFileWithPermission(); }
Genişletme dosyalarınızın içeriğini paketten çıkarmanız gerekirse
OBB
genişletme dosyalarını yükleyin ve paketlenmemiş verileri kaydetmeyin
aynı dizinde oluşturur. Paketlenmemiş dosyalarınızı dizine kaydetmeniz gerekir
getExternalFilesDir()
tarafından belirtilmiş. Ancak,
mümkünse, doğrudan kaynak metinden doğrudan okumanıza olanak tanıyan bir genişletme dosyası
dosyayı paketten açmanızı gerektirmez. Örneğin, giriş seviyesindeki
verilerinizi doğrudan okuyan APK Genişletme Zip Kitaplığı projesi
.
Dikkat: APK dosyalarının aksine, kullanıcı ve diğer uygulamalar tarafından okunabilir.
İpucu: Medya dosyalarını ZIP dosyası olarak paketliyorsanız medya dosyalarını kullanabilirsiniz.
ofset ve uzunluk kontrollerine sahip dosyalardaki oynatma çağrıları (MediaPlayer.setDataSource()
ve
SoundPool.load()
),
açmanız gerekir. Bunun işe yaraması için, Güvenli Tarama'da bulunan
medya dosyalarını oluşturmak için de kullanılabilir. Örneğin, zip
aracını kullanırken
olmaması gereken dosya soneklerini belirtmek için -n
seçeneğini kullanmanız gerekir.
sıkıştırılmış:
zip -n .mp4;.ogg main_expansion media_files
İndirme işlemi
Google Play çoğu zaman genişletme dosyalarınızı indirir ve kaydeder. APK'yı cihaza indirir. Ancak bazı durumlarda Google Play, genişletme dosyaları indirilemiyor veya kullanıcı, daha önce indirilmiş genişletmeyi silmiş olabilir dosyası olarak da kaydedebilir. Bu durumları ele almak için uygulamanızın dosyaları indirebilmesi gerekir ana etkinlik başladığında kendisine Google Play tarafından sağlanan bir URL kullanılarak gönderilir.
Genel düzeyden indirme işlemi şu şekilde görünür:
- Kullanıcı, uygulamanızı Google Play'den yüklemeyi seçer.
- Google Play genişletme dosyalarını indirebiliyorsa (bu, çoğu
cihazlar) indirildiğinde, bunları APK ile birlikte indirir.
Google Play genişletme dosyalarını indiremezse Yalnızca APK.
- Kullanıcı uygulamanızı başlattığında uygulamanız, genişletme dosyalarının
Cihaza kaydedilmiş olanlar.
- Yanıt evetse uygulamanız kullanıma hazırdır.
- Aksi takdirde, uygulamanızın genişletme dosyalarını Google Play'den HTTP aracılığıyla indirmesi gerekir. Uygulamanız Google Play'in uygulama Lisanslama hizmetini kullanarak Google Play istemcisine bir istek göndermelidir. her bir genişletme dosyasının adı, dosya boyutu ve URL'siyle yanıt verir. Bu bilgileri kullanarak dosyaları indirip uygun depolama konumuna kaydedebilirsiniz.
Dikkat: Reklam oluşturma ve düzenleme için gerekli kodu ve dosyalar halihazırda Google Play'de yer almamışsa, cihazınız üzerinden otomatik olarak yayınlamanız gerekir. Aşağıdaki Genişletme Dosyalarını İndirme bölümünde açıklandığı gibi, kullanabileceğiniz bir kitaplık hazırladık. Bu işlem büyük ölçüde daha basit hale getirir ve minimum miktarda Google'a gönderir.
Geliştirme kontrol listesi
Burada, uygulama:
- Öncelikle, uygulamanızın sıkıştırılmış indirme boyutunun 100 MB'tan fazla olması gerekip gerekmediğini belirleyin. Alan değerlidir ve toplam indirme boyutunuzu mümkün olduğunca küçük tutmalısınız. Uygulamanız grafik öğelerinizin birden fazla ekranda birden çok sürümünü sağlamak için 100 MB'tan fazla yer kullanır yoğunlukları yerine, her APK'nın ayrı ayrı oynatıldığı birden fazla APK yayınlamayı düşünebilirsiniz Yalnızca hedeflediği ekranlar için gerekli öğeleri içerir. En iyi sonuçlar için uygulamanızı Google Play'de yayınlamak için, bir Android App Bundle uygulamanızın tüm derlenmiş kod ve kaynaklarını içerir ancak APK oluşturma ve imzalama işlemlerini Google'a erteler Oyna.
- Hangi uygulama kaynaklarının APK'nızdan ayrılacağını ve bir içinde paketleneceğini belirleyin
ana genişletme dosyası olarak kullanılacak dosya.
Normalde ana genişletme dosyası oluşturun. Ancak kaynaklarınız ana genişletme dosyanızı yüklemek yerine, öğelerinizin geri kalanı için yama dosyasını kullanabilirsiniz.
- Uygulamanızı,
paylaşılan depolama konumuna eklenmez.
Genişletme dosyalarını silmemeniz, taşımamanız veya yeniden adlandırmamanız gerektiğini unutmayın.
Uygulamanız belirli bir biçim talep etmiyorsa aşağıdakiler için ZIP dosyaları oluşturmanızı öneririz: daha sonra, APK Genişletme Zip dosyasını kullanarak bunları okuyun. Kitaplık.
- Uygulamanızın ana etkinliğine, genişletme dosyalarının mevcut olup olmadığını kontrol eden bir mantık ekleyin
cihaz başlatıldıktan sonra cihazda olduğunu gösterir. Dosyalar cihazda değilse URL'leri istemek için Google Play'in uygulama Lisanslama hizmetini kullanın
genişletme dosyalarını seçin, ardından bunları indirip kaydedin.
Yazmanız gereken kod miktarını büyük ölçüde azaltmak ve iyi bir kullanıcı deneyimi sağlamak için işlemi sırasında indirmenizi öneririz. İndirme işlemi sırasında İndirici Kitaplık'ı seçin.
Kitaplığı kullanmak yerine kendi indirme hizmetinizi oluşturmak isterseniz genişletme dosyalarının adını değiştirmemeli ve bunları uygun depolama konumu bilgisidir.
Uygulama geliştirmenizi tamamladığınızda Test Genişletme Dosyalarınız.
Kurallar ve Sınırlamalar
APK genişletme dosyaları ekleme özelliği, uygulamanızı Play Console Uygulamanızı ilk kez yüklerken veya bir uygulamalarında aşağıdaki kurallara ve sınırlamalara dikkat etmeniz gerekir:
- Genişletme dosyaları 2 GB'tan büyük olamaz.
- Genişletme dosyalarınızı Google Play'den indirmek için kullanıcının (uygulamanızı Google Play'den satın alma) Google Play, Uygulama başka yollarla yüklendiyse genişletme dosyalarınızın URL'lerini sağlayın.
- Uygulamanızın içinden indirme işlemi gerçekleştirirken, Google Play'in Her dosya için her bir indirme işlemi benzersizdir ve her birinin süresi, veri gönderildikten kısa bir süre sonra dolar ekleyin.
- Uygulamanızı yeni bir APK ile güncellerseniz veya aynı için birden fazla APK yüklerseniz önceki bir APK için yüklediğiniz genişletme dosyalarını seçebilirsiniz. genişletme dosyasının adı değişmez; APK'nın Dosyanın orijinal olarak ilişkilendirildiği dosya,
- Genişletmek için genişletme dosyalarını birden fazla APK ile birlikte kullanıyorsanız
farklı cihazlar için farklı genişletme dosyaları sağlasanız da ayrı APK'lar yüklemeniz gerekir
benzersiz bir
versionCode
sağlamak için her cihaz için farklı filtreler bildirebilirsiniz. her APK'yı kullanın. - Genişletme dosyalarını değiştirerek uygulamanızda güncelleme yayınlayamazsınız
(uygulamanızı güncellemek için yeni bir APK yüklemeniz gerekir) Yalnızca değişiklikleriniz
genişletme dosyalarınızdaki öğelerle ilgiliyse
versionCode
(ve (versionName
) de olabilir. obb/
cihazınıza başka veriler kaydetmeyin dizininde bulunduğundan emin olun. Bazı verilerin paketini açmanız gerekiyorsa verilerigetExternalFilesDir()
ile belirtilen konuma kaydedin..obb
genişletme dosyasını silmeyin veya yeniden adlandırmayın ( güncelleme) gerekir. Bunu yapmak, Google Play'in (veya uygulamanızın kendisinin) sürekli olarak genişletme dosyasını indirin.- Bir genişletme dosyasını manuel olarak güncellerken önceki genişletme dosyasını silmeniz gerekir.
Genişletme Dosyalarını İndirme
Çoğu durumda Google Play, genişletme dosyalarınızı cihaza aynı zamanda indirir ve kaydeder. aldığı veya güncellediği zamandır. Bu şekilde, genişletme dosyaları kullanıma sunuyoruz. Ancak, bazı durumlarda, uygulamanızın yanıtta size sağlanan bir URL'den isteyerek genişletme dosyalarını kullanabilirsiniz. Google Play'in Uygulama Lisanslama hizmetinden alabilirsiniz.
Genişletme dosyalarınızı indirmek için ihtiyacınız olan temel mantık şudur:
- Uygulamanız başlatıldığında, genişletme dosyalarını paylaşılan depolama konumunda (
Android/obb/<package-name>/
dizini).- Genişletme dosyaları mevcutsa hazırsınız demektir ve uygulamanız devam edebilir.
- Genişletme dosyaları orada yoksa:
- Aşağıdakileri almak için Google Play'in uygulama lisanslamasını kullanarak bir istekte bulunun: uygulamanın genişletme dosyası adları, boyutları ve URL'leri.
- Genişletme dosyalarını indirmek ve kaydetmek için Google Play tarafından sağlanan URL'leri kullanın
ekleyebilirsiniz. Dosyaları paylaşılan depolama konumuna kaydetmeniz gerekir.
(
Android/obb/<package-name>/
) ve sağlanan dosya adını aynen kullanın Google Play'in yanıtıyla.Not: Google Play'in genişletme dosyaları her indirme için benzersizdir ve genişletme dosyalarından her birinin süresi, verildikten kısa bir süre sonra dolar en iyi şekilde yararlanabilirsiniz.
Uygulamanız ücretsizse (ücretli bir uygulama değilse) muhtemelen uygulama Lisanslama hizmetini kullanmamışsınızdır. Esas olarak, bu uygulamaları uygulamanızın lisanslama politikaları hakkında daha fazla bilgi edinin ve kullanıcının uygulamanızı kullanma (Google Play'de uygulama için haklı olarak ödeme yapmış olması) Çevik yaklaşımın genişletme dosyası işlevselliği, lisanslama hizmeti yanıt verecek şekilde geliştirilmiştir uygulamanızın barındırdığı genişletme dosyalarının URL'sini içeren bir URL ekleyerek . Bu nedenle, uygulamanız kullanıcılar için ücretsiz olsa bile, APK genişletme dosyalarını kullanmak için Lisans Doğrulama Kitaplığı (LVL). Tabii ki uygulamanız ücretsiz olduğundan, lisans doğrulamasını zorunlu kılmanız gerekmez; kitaplığını kullanarak, genişletme dosyalarınızın URL'sini döndüren isteği gerçekleştirebilirsiniz.
Not: Uygulamanızın ücretsiz olup olmamasından bağımsız olarak, Google Play ise, yalnızca kullanıcı uygulamanızı Google Play'den edindiyse genişletme dosyası URL'lerini döndürür.
LVL'ye ek olarak, genişletme dosyalarını indiren bir kod kümesine ihtiyacınız vardır. ve cihazın paylaşılan depolama alanındaki uygun konuma kaydeder. Bu prosedürü uygulamanıza yerleştirdiğinizde, dikkat etmeniz gereken birkaç sorun vardır. üzerinde düşünme:
- Cihazda genişletme dosyaları için yeterli alan olmayabilir. Bu nedenle, ve yeterli alan yoksa kullanıcıyı uyarın.
- Kullanıcının engellenmemesi için dosya indirme işlemleri bir arka plan hizmetinde gerçekleşmelidir kullanıcı etkileşimi sağlayın ve indirme işlemi tamamlanırken kullanıcının uygulamanızdan ayrılmasına izin verin.
- İstek ve indirme işlemi sırasında farklı hatalarla karşılaşabilirsiniz. Bu hatalar zarif bir şekilde ele alın.
- İndirme işlemi sırasında ağ bağlantısı değişebilir. Dolayısıyla bu tür değişiklikleri ve kesintiye uğrarsa indirme işlemine devam edin.
- İndirme işlemi arka planda gerçekleşirken, İndirme işleminin ilerlemesini gösterir, işlem tamamlandığında kullanıcıya bilgi verir ve kullanıcıyı geri uygulamanızı sağlayabilirsiniz.
Bu işi sizin için basitleştirmek amacıyla İndirici Kitaplığı'nı tasarladık. lisans hizmeti aracılığıyla genişletme dosyası URL'lerini isteyen, genişletme dosyalarını indirir ve yukarıda listelenen tüm görevleri gerçekleştirir ve hatta etkinliğinizin duraklatılmasına ve devam ettirilmesine indirin. Uygulamanıza İndirme Aracı Kitaplığı'nı ve birkaç kod kancasını ekleyerek ve genişletme dosyalarını indirme işlemi zaten sizin için kodlanmıştır. Bu nedenle, kullanıcılara en iyi minimum çabayla bir kullanıcı deneyimi yaşamanızı sağlamak için İndirici Kitaplığı'nı kullanarak genişletme dosyalarınızı indirin. Aşağıdaki bölümlerde yer alan bilgiler, Google Ads'in uygulamanıza aktarmaktır.
Genişletme dosyalarını indirmek için Google
Play URL'leri için uygulamayı
Lisanslama belgelerinde bir lisans isteği gerçekleştirip genişletme dosya adlarını alın.
ve yanıt ekstralarındaki URL'leri gösterir. Lisanslamanız olarak APKExpansionPolicy
sınıfını (Lisans Doğrulama Kitaplığı'na dahildir) kullanmanız gerekir.
politikası kullanılmalıdır.
İndirme Aracı Kitaplığı hakkında
Uygulamanızla APK genişletme dosyalarını kullanmak ve asgari düzeyde çaba sarf etmeniz gerekiyorsa, Google Play APK Genişletme Kitaplığı paketi. Bu kitaplık, genişletme dosyalarınızı arka plan hizmeti, indirme durumuyla ilgili bir kullanıcı bildirimi gösterir, ağı işler bağlantı kesilir, mümkün olduğunda indirme işlemi devam eder ve daha pek çok işlem yapılır.
İndirme Aracı Kitaplığı'nı kullanarak genişletme dosyası indirmelerini uygulamak için tüm yapmanız gereken:
- Her biri yalnızca birkaç tane gereken özel bir
Service
alt sınıfını veBroadcastReceiver
alt sınıfını genişletin veya sizden gelen kod satırını kullanın. - Ana etkinliğinize, genişletme dosyalarının mevcut olup olmadığını kontrol eden bir mantık ekleyin. indirilmiş olabilir; indirilmediyse, indirme işlemini çağırır ve kullanıcı arayüzü.
- Ana etkinliğinizde, size kullanılabilecek birkaç yöntem içeren bir geri çağırma İndirme işleminin ilerleme durumuyla ilgili güncellemeleri alır.
Aşağıdaki bölümlerde, İndirme Aracı Kitaplığı'nı kullanarak uygulamanızı nasıl ayarlayacağınız açıklanmaktadır.
İndirme Aracı Kitaplığı'nı kullanmaya hazırlanma
İndirici Kitaplığı'nı kullanmak için şunları yapmanız gerekir: SDK Manager'dan iki paket indirin ve uygun kitaplıkları uygulamasını indirin.
İlk olarak Android SDK Yöneticisi'ni açın (Araçlar > SDK Yöneticisi) ve Görünüm ve Davranış > Sistem Ayarları > Android SDK'sı varsa Aşağıdakileri seçip indirmek için SDK Araçları sekmesini kullanın:
- Google Play Lisanslama Kitaplığı paketi
- Google Play APK Genişletme Kitaplığı paketi
Lisans Doğrulama Kitaplığı ve İndirici için yeni bir kitaplık modülü oluşturma Kitaplık'a dokunun. Her kitaplık için:
- Dosya > Yeni > Yeni Modül.
- Yeni Modül Oluştur penceresinde Android Kitaplığı'nı seçin. ve ardından İleri'yi seçin.
- "Google Play Lisans Kitaplığı" gibi bir uygulama/Kitaplık adı belirtin Minimum SDK düzeyi'ni, ardından Sonlandır.
- Dosya > Proje Yapısı.
- Özellikler sekmesini ve Kitaplık'ı seçin
Kod deposu'nda,
<sdk>/extras/google/
dizinindeki kitaplığa girin (Lisans Doğrulama Kitaplığı içinplay_licensing/
veya İndirme Aracı Kitaplığı içinplay_apk_expansion/downloader_library/
). - Yeni modülü oluşturmak için Tamam'ı seçin.
Not: İndirici Kitaplığı, Lisansa bağlıdır Doğrulama Kitaplığı. Lisansın ve belgenin Doğrulama Kitaplığı'nı indirin.
Alternatif olarak, komut satırından projenizi kitaplıkları içerecek şekilde de güncelleyebilirsiniz:
- Dizinleri
<sdk>/tools/
dizinine değiştirin. - Şunu eklemek için:
--library
seçeneği ileandroid update project
işlemini yürütün: LVL ve İndirici Kitaplığı'nı projenize ekleyin. Örnek:android update project --path ~/Android/MyApp \ --library ~/android_sdk/extras/google/market_licensing \ --library ~/android_sdk/extras/google/market_apk_expansion/downloader_library
Hem Lisans Doğrulama Kitaplığı hem de İndirme Aracı Kitaplığı kullanıyorsanız, genişletme dosyalarını indirme olanağını hızlıca entegre edebilirsiniz. Google Play Genişletme dosyaları için seçtiğiniz biçim ve bu dosyaları okuma şekliniz diğer uygulamalarınızdan biri. en iyi uygulamaları paylaşacağım.
İpucu: APK Genişletme paketinde bir örnek uygulama konulu videomuzu izleyin. Örnekte üçüncü bir kitaplık kullanılıyor {0}APK Genişletmesi Zip Kitaplığı adı verilen Apk Genişletme paketinde bulunur.) Eğer ne yapmayı planladığını genişletme dosyalarınız için ZIP dosyalarını kullanırken, APK Genişletme Zip Kitaplığı'nı en iyi şekilde yararlanabilirsiniz. Daha fazla bilgi için aşağıdaki bölüme bakın APK Genişletme Zip Kitaplığı'nı Kullanma hakkında daha fazla bilgi edinin.
Kullanıcı izinlerini bildirme
Genişletme dosyalarını indirmek için İndirici Kitaplığı uygulamanızın manifest dosyasında beyan etmeniz gereken çeşitli izinler gerektiriyor. Onlar şunlardır:
<manifest ...> <!-- Required to access Google Play Licensing --> <uses-permission android:name="com.android.vending.CHECK_LICENSE" /> <!-- Required to download files from Google Play --> <uses-permission android:name="android.permission.INTERNET" /> <!-- Required to keep CPU alive while downloading files (NOT to keep screen awake) --> <uses-permission android:name="android.permission.WAKE_LOCK" /> <!-- Required to poll the state of the network connection and respond to changes --> <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" /> <!-- Required to check whether Wi-Fi is enabled --> <uses-permission android:name="android.permission.ACCESS_WIFI_STATE"/> <!-- Required to read and write the expansion files on shared storage --> <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" /> ... </manifest>
Not: İndirme Aracı Kitaplığı için varsayılan olarak API gerekir. ancak APK Genişletmesi Zip Kitaplığı, API düzeyi 5'i gerektiriyor.
İndirme aracını uygulama
İndirme işlemlerini arka planda gerçekleştirmek için, İndirici Kitaplığı, indirme işlemini
DownloaderService
adlı, genişletmeniz gereken Service
alt sınıfa sahip. İçinde
genişletme dosyalarını sizin için indirmenin yanı sıra, DownloaderService
şunları da yapabilir:
- Şu öğedeki değişiklikleri dinleyen bir
BroadcastReceiver
kaydeder: cihazın ağ bağlantısını (CONNECTIVITY_ACTION
yayın) kullanarak gerektiğinde (örneğin, bağlantı kaybı nedeniyle) indirme işlemini duraklatabilir ve mümkün olduğunda indirme işlemini devam ettirin (bağlantı kazanılır). - İndirme işleminin yeniden denenmesi için
RTC_WAKEUP
alarmı programlar olduğu durumlar da olabilir. - İndirme işleminin ilerleme durumunu gösteren özel bir
Notification
oluşturur ve kontrol edebilirsiniz. - Uygulamanıza, indirme işlemini manuel olarak duraklatma ve devam ettirme izni verir.
- Paylaşılan depolama biriminin eklenmiş ve kullanılabilir olduğunu, dosyaların halihazırda mevcut olmadığını doğrular, genişletme dosyalarını indirmeden önce yeterli alan bulunduğundan emin olun. Ardından kullanıcıya bilgi verir doğru olmadığını anlayabilirsiniz.
Tek yapmanız gereken, uygulamanızda DownloaderService
sınıfını genişleten ve belirli uygulama ayrıntılarını sağlamak için üç yöntemi geçersiz kılan bir sınıf oluşturmaktır:
getPublicKey()
- Bu, yayıncınız için Base64 olarak kodlanmış RSA ortak anahtarı olan bir dize döndürmelidir hesabına sahip olduğunuzu varsayalım. (Lisanslama özelliğini ayarlama başlıklı makaleye bakın).
getSALT()
- Bu,
Policy
lisansının kullandığı rastgele bayt dizisini döndürmelidirObfuscator
oluşturun. Tuz, kodu karartılmışSharedPreferences
verilerinizin lisans verilerinizin kaydedildiği dosya benzersiz olur ve bulunamaz. getAlarmReceiverClassName()
- Bu,
BroadcastReceiver
uygulamanız gerektiğini belirten alarmı alacak yeniden başlatılır (indirici hizmeti beklenmedik bir şekilde durursa bu olabilir).
Örneğin, DownloaderService
öğesinin eksiksiz bir kullanımını burada görebilirsiniz:
Kotlin
// You must use the public key belonging to your publisher account const val BASE64_PUBLIC_KEY = "YourLVLKey" // You should also modify this salt val SALT = byteArrayOf( 1, 42, -12, -1, 54, 98, -100, -12, 43, 2, -8, -4, 9, 5, -106, -107, -33, 45, -1, 84 ) class SampleDownloaderService : DownloaderService() { override fun getPublicKey(): String = BASE64_PUBLIC_KEY override fun getSALT(): ByteArray = SALT override fun getAlarmReceiverClassName(): String = SampleAlarmReceiver::class.java.name }
Java
public class SampleDownloaderService extends DownloaderService { // You must use the public key belonging to your publisher account public static final String BASE64_PUBLIC_KEY = "YourLVLKey"; // You should also modify this salt public static final byte[] SALT = new byte[] { 1, 42, -12, -1, 54, 98, -100, -12, 43, 2, -8, -4, 9, 5, -106, -107, -33, 45, -1, 84 }; @Override public String getPublicKey() { return BASE64_PUBLIC_KEY; } @Override public byte[] getSALT() { return SALT; } @Override public String getAlarmReceiverClassName() { return SampleAlarmReceiver.class.getName(); } }
Uyarı: BASE64_PUBLIC_KEY
değerini güncellemeniz gerekir
aynı olmasını sağlamanız gerekir. Anahtarı, Geliştirici
Konsolda profil bilgilerinizin altında bulunur. Bu, proje başlatma belgesinde
indirme sayısını artırır.
Manifest dosyanızda hizmeti beyan etmeyi unutmayın:
<app ...> <service android:name=".SampleDownloaderService" /> ... </app>
Alarm alıcısını devreye alma
Dosya indirmelerinin ilerlemesini izlemek ve gerekirse indirme işlemini yeniden başlatmak için
DownloaderService
, şu işlem için RTC_WAKEUP
alarmı planlar:
şurada bir BroadcastReceiver
için Intent
sağlar:
uygulamasını indirin. API çağırmak için BroadcastReceiver
öğesini tanımlamanız gerekir
indirme işleminin durumunu kontrol eden ve yeniden başlatılan İndirici Kitaplığı'ndan
gerekebilir.
DownloaderClientMarshaller.startDownloadServiceIfRequired()
işlevini çağırmak için onReceive()
yöntemini geçersiz kılmanız yeterlidir.
Örnek:
Kotlin
class SampleAlarmReceiver : BroadcastReceiver() { override fun onReceive(context: Context, intent: Intent) { try { DownloaderClientMarshaller.startDownloadServiceIfRequired( context, intent, SampleDownloaderService::class.java ) } catch (e: PackageManager.NameNotFoundException) { e.printStackTrace() } } }
Java
public class SampleAlarmReceiver extends BroadcastReceiver { @Override public void onReceive(Context context, Intent intent) { try { DownloaderClientMarshaller.startDownloadServiceIfRequired(context, intent, SampleDownloaderService.class); } catch (NameNotFoundException e) { e.printStackTrace(); } } }
Bunun, adını döndürmeniz gereken sınıf olduğuna dikkat edin
hizmetinizin getAlarmReceiverClassName()
yöntemine (önceki bölüme bakın).
Manifest dosyanızda alıcıyı bildirmeyi unutmayın:
<app ...> <receiver android:name=".SampleAlarmReceiver" /> ... </app>
İndirme işlemi başlatılıyor
Uygulamanızdaki ana etkinlik (başlatıcı simgenizin başlattığı) genişletme dosyalarının cihazda zaten olup olmadığını doğrulamaktan ve genişletme dosyalarının indirmenin başka bir noktası da yoktur.
İndirme işlemini İndirme Aracı Kitaplığı'nı kullanarak başlatmak için aşağıdakiler gerekir: prosedürler:
- Dosyaların indirilip indirilmediğini kontrol edin.
Downloader Library, aşağıdaki işlemleri yapmak için
Helper
sınıfındaki bazı API'leri içerir: bu işlemle ilgili yardım almak istiyorum:getExpansionAPKFileName(Context, c, boolean mainFile, int versionCode)
doesFileExist(Context c, String fileName, long fileSize)
Örneğin, APK Genişletme paketinde sağlanan örnek uygulama etkinliğin
onCreate()
yönteminde aşağıdaki yöntemi izleyerek genişletme dosyalarının cihazda zaten olup olmadığı:Kotlin
fun expansionFilesDelivered(): Boolean { xAPKS.forEach { xf -> Helpers.getExpansionAPKFileName(this, xf.isBase, xf.fileVersion).also { fileName -> if (!Helpers.doesFileExist(this, fileName, xf.fileSize, false)) return false } } return true }
Java
boolean expansionFilesDelivered() { for (XAPKFile xf : xAPKS) { String fileName = Helpers.getExpansionAPKFileName(this, xf.isBase, xf.fileVersion); if (!Helpers.doesFileExist(this, fileName, xf.fileSize, false)) return false; } return true; }
Bu durumda, her
XAPKFile
nesnesi bilinen bir sürümün numarasını ve dosya boyutunu içerir ana genişletme dosyası olup olmadığına dair bir boole dosyası ekleyin. (Örneğe bakın uygulamanınSampleDownloaderActivity
sınıfını ziyaret edin.)Bu yöntem false (yanlış) değerini döndürürse uygulamanın indirme işlemine başlaması gerekir.
DownloaderClientMarshaller.startDownloadServiceIfRequired(Context c, PendingIntent notificationClient, Class<?> serviceClass)
statik yöntemini çağırarak indirme işlemini başlatın.Yöntem aşağıdaki parametreleri alır:
context
: UygulamanızınContext
.notificationClient
: Ana sohbetinizi başlatmak içinPendingIntent
etkinliği'ne dokunun. Bu dil,DownloaderService
öğesininNotification
içinde kullanılır. sağlar. Kullanıcı bildirimi seçtiğinde sistem, burada sağladığınızPendingIntent
öğesini çağırır ve etkinliği açar Genelde indirme işlemini başlatan etkinlik, indirme işleminin ilerleme durumunu gösterir.serviceClass
: Uygulamanız içinClass
nesnesiDownloaderService
, hizmeti başlatmak ve gerekirse indirme işlemini başlatmak için gereklidir.
Yöntem, şunu belirten bir tam sayı döndürür: gerekli olup olmadığına bağlıdır. Olası değerler:
NO_DOWNLOAD_REQUIRED
: Dosyalar zaten varsa döndürülür veya zaten bir indirme işlemi devam ediyor.LVL_CHECK_REQUIRED
: Lisans doğrulaması şu durumlarda döndürülür için gereklidir.DOWNLOAD_REQUIRED
: Genişletme dosyası URL'leri zaten biliniyorsa döndürülür, ancak indirilmedi.
LVL_CHECK_REQUIRED
veDOWNLOAD_REQUIRED
için davranış temelde önemlidir ve normalde bunlarla ilgili endişe duymanıza gerek kalmaz.startDownloadServiceIfRequired()
adlı ana etkinliğinizde, yanıtınNO_DOWNLOAD_REQUIRED
olup olmadığını kontrol edebilirsiniz. YanıtNO_DOWNLOAD_REQUIRED
dışında bir şeyse İndirme İşlemi kitaplığı indirme işlemini başlatır ve etkinlik kullanıcı arayüzünüzü İndirme işleminin ilerleme durumunu görüntüleyin (sonraki adıma bakın). YanıtNO_DOWNLOAD_REQUIRED
ise, dosyalar kullanılabilir durumda demektir ve uygulamanız başlayabilir.Örnek:
Kotlin
override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) // Check if expansion files are available before going any further if (!expansionFilesDelivered()) { val pendingIntent = // Build an Intent to start this activity from the Notification Intent(this, MainActivity::class.java).apply { flags = Intent.FLAG_ACTIVITY_NEW_TASK or Intent.FLAG_ACTIVITY_CLEAR_TOP }.let { notifierIntent -> PendingIntent.getActivity( this, 0, notifierIntent, PendingIntent.FLAG_UPDATE_CURRENT ) } // Start the download service (if required) val startResult: Int = DownloaderClientMarshaller.startDownloadServiceIfRequired( this, pendingIntent, SampleDownloaderService::class.java ) // If download has started, initialize this activity to show // download progress if (startResult != DownloaderClientMarshaller.NO_DOWNLOAD_REQUIRED) { // This is where you do set up to display the download // progress (next step) ... return } // If the download wasn't necessary, fall through to start the app } startApp() // Expansion files are available, start the app }
Java
@Override public void onCreate(Bundle savedInstanceState) { // Check if expansion files are available before going any further if (!expansionFilesDelivered()) { // Build an Intent to start this activity from the Notification Intent notifierIntent = new Intent(this, MainActivity.getClass()); notifierIntent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK | Intent.FLAG_ACTIVITY_CLEAR_TOP); ... PendingIntent pendingIntent = PendingIntent.getActivity(this, 0, notifierIntent, PendingIntent.FLAG_UPDATE_CURRENT); // Start the download service (if required) int startResult = DownloaderClientMarshaller.startDownloadServiceIfRequired(this, pendingIntent, SampleDownloaderService.class); // If download has started, initialize this activity to show // download progress if (startResult != DownloaderClientMarshaller.NO_DOWNLOAD_REQUIRED) { // This is where you do set up to display the download // progress (next step) ... return; } // If the download wasn't necessary, fall through to start the app } startApp(); // Expansion files are available, start the app }
startDownloadServiceIfRequired()
yöntemi başka herhangi bir şey döndürdüğünde (NO_DOWNLOAD_REQUIRED
yerine) tarafındanIStub
için bir örnek oluşturunDownloaderClientMarshaller.CreateStub(IDownloaderClient client, Class<?> downloaderService)
aranıyor.IStub
, etkinliğiniz ile indirme aracı arasında bir bağlantı sağlar Böylece etkinliğiniz, indirme işleminin ilerleme durumuyla ilgili geri çağırmalar alır.CreateStub()
çağrısı yaparakIStub
örneğinizi oluşturmak için iletmeniz gerekirIDownloaderClient
arayüzü veDownloaderService
uygulama hakkında bilgi edindiniz. İndirme ilerleme durumunu alma ile ilgili bir sonraki bölümdeIDownloaderClient
arayüzünü içerir. İndirme durumu değiştiğinde etkinlik arayüzünü güncelleyebilmeniz için bunu genellikleActivity
sınıfınızda uygulamanız gerekir.Etkinliğinizin
onCreate()
yöntemi sırasında,startDownloadServiceIfRequired()
sonrasındaIStub
örneğinizi oluşturmak içinCreateStub()
öğesini çağırmanızı öneririz indirme işlemini başlatır.Örneğin,
onCreate()
için önceki kod örneğinde,startDownloadServiceIfRequired()
sonucuna şu şekilde yanıt verebilirsiniz:Kotlin
// Start the download service (if required) val startResult = DownloaderClientMarshaller.startDownloadServiceIfRequired( this@MainActivity, pendingIntent, SampleDownloaderService::class.java ) // If download has started, initialize activity to show progress if (startResult != DownloaderClientMarshaller.NO_DOWNLOAD_REQUIRED) { // Instantiate a member instance of IStub downloaderClientStub = DownloaderClientMarshaller.CreateStub(this, SampleDownloaderService::class.java) // Inflate layout that shows download progress setContentView(R.layout.downloader_ui) return }
Java
// Start the download service (if required) int startResult = DownloaderClientMarshaller.startDownloadServiceIfRequired(this, pendingIntent, SampleDownloaderService.class); // If download has started, initialize activity to show progress if (startResult != DownloaderClientMarshaller.NO_DOWNLOAD_REQUIRED) { // Instantiate a member instance of IStub downloaderClientStub = DownloaderClientMarshaller.CreateStub(this, SampleDownloaderService.class); // Inflate layout that shows download progress setContentView(R.layout.downloader_ui); return; }
onCreate()
yöntemi geri geldikten sonra etkinliğinizonResume()
numaralı telefona bir arama aldığındaIStub
numaralı telefondanconnect()
adlı kişiyi uygulamanızınContext
cihazına iletin. Öte yandan, EtkinliğinizinonStop()
geri aramasındadisconnect()
.Kotlin
override fun onResume() { downloaderClientStub?.connect(this) super.onResume() } override fun onStop() { downloaderClientStub?.disconnect(this) super.onStop() }
Java
@Override protected void onResume() { if (null != downloaderClientStub) { downloaderClientStub.connect(this); } super.onResume(); } @Override protected void onStop() { if (null != downloaderClientStub) { downloaderClientStub.disconnect(this); } super.onStop(); }
IStub
üzerindeconnect()
çağrılarının yapılması, etkinliğiniziDownloaderService
öğesine bağlar ve böylece etkinliğiniz indirmede yapılan değişikliklerle ilgili geri çağırmalar alırIDownloaderClient
arayüzü üzerinden görebilirsiniz.
İndirme ilerleme durumu alınıyor
İndirme işleminin ilerleme durumuyla ilgili güncellemeleri almak ve DownloaderService
ile etkileşimde bulunmak için İndirme Aracı Kitaplığı'nın IDownloaderClient
arayüzünü uygulamanız gerekir.
İndirme işlemini başlatmak için kullandığınız etkinlik genellikle
indirme durumunu görüntüleme ve hizmete istek gönderme.
IDownloaderClient
için gerekli arayüz yöntemleri şunlardır:
onServiceConnected(Messenger m)
- Etkinliğinizde
IStub
örneğini oluşturduktan sonra yöntemidir; bu yöntem, örneğinize bağlı birMessenger
nesnesi aktarır /DownloaderService
. Hizmete istek göndermek (ör. duraklatma ve devam ettirme) hizmete bağlıIDownloaderService
arayüzünü almak içinDownloaderServiceMarshaller.CreateProxy()
işlevini çağırmalısınız.Önerilen uygulama aşağıdaki gibi görünür:
Kotlin
private var remoteService: IDownloaderService? = null ... override fun onServiceConnected(m: Messenger) { remoteService = DownloaderServiceMarshaller.CreateProxy(m).apply { downloaderClientStub?.messenger?.also { messenger -> onClientUpdated(messenger) } } }
Java
private IDownloaderService remoteService; ... @Override public void onServiceConnected(Messenger m) { remoteService = DownloaderServiceMarshaller.CreateProxy(m); remoteService.onClientUpdated(downloaderClientStub.getMessenger()); }
IDownloaderService
nesnesi başlatıldığında, komutlarını şuraya gönderebilirsiniz: indirme hizmetini kullanabilirsiniz. Örneğin, indirme işlemini duraklatabilir veya devam ettirebilirsiniz (requestPauseDownload()
verequestContinueDownload()
). onDownloadStateChanged(int newState)
- İndirme durumunda bir değişiklik gerçekleştiğinde indirme hizmeti bu çağrıyı çağırır. Örneğin:
indirme işlemi başladığında veya tamamlandığında.
newState
değeri,IDownloaderClient
sınıfınınSTATE_*
sabitlerinden birine göre.Kullanıcılarınıza faydalı bir mesaj sunmak için ilgili bir dize isteyebilirsiniz her eyalet için
Helpers.getDownloaderStringResourceIDFromState()
çağırarak yapabilirsiniz. Bu İndirme Aracı ile paket halinde sunulan dizelerden birinin kaynak kimliğini döndürür Kitaplık'a dokunun. Örneğin, "Dolaşımda olduğunuz için indirme duraklatıldı" dizesiSTATE_PAUSED_ROAMING
değerine karşılık gelir. onDownloadProgress(DownloadProgressInfo progress)
- İndirme hizmeti,
DownloadProgressInfo
nesnesini teslim etmek için bu komutu Bu sayfada, kalan tahmini süre de dahil olmak üzere indirme işleminin ilerlemesiyle ilgili mevcut hız, genel ilerleme durumu ve toplam bilgilerini kullanarak indirme ilerleme durumunu güncelleyebilirsiniz.
İpucu: İndirme işlemini güncelleyen geri çağırma örnekleri için
ilerleme kullanıcı arayüzü içinSampleDownloaderActivity
APK Genişletme paketi.
IDownloaderService
arayüzü için yararlı bulabileceğiniz bazı herkese açık yöntemler şunlardır:
requestPauseDownload()
- İndirme işlemini duraklatır.
requestContinueDownload()
- Duraklatılmış indirme işlemini devam ettirir.
setDownloadFlags(int flags)
- Dosyaların indirilebileceği ağ türleri için kullanıcı tercihlerini ayarlar. İlgili içeriği oluşturmak için kullanılan
mevcut uygulama bir işareti (
FLAGS_DOWNLOAD_OVER_CELLULAR
) desteklemektedir, ancak diğerleri. Varsayılan olarak bu bayrak etkin değildir, bu nedenle indirme işlemi için kullanıcının kablosuz ağa bağlı olması gerekir genişletme dosyalarını kullanabilirsiniz. İndirmeleri etkinleştirmek için bir kullanıcı tercihi belirtmek isteyebilirsiniz hücresel şebeke. Bu durumda şu numarayı arayabilirsiniz:Kotlin
remoteService = DownloaderServiceMarshaller.CreateProxy(m).apply { ... setDownloadFlags(IDownloaderService.FLAGS_DOWNLOAD_OVER_CELLULAR) }
Java
remoteService .setDownloadFlags(IDownloaderService.FLAGS_DOWNLOAD_OVER_CELLULAR);
APKExpansionPolicy'yi Kullanma
Google Play Store'u kullanmak yerine kendi indirme hizmetinizi oluşturmaya karar verirseniz
İndirici Kitaplığı'nı kullanıyorsanız yine de Lisans Doğrulama Kitaplığı'nda sağlanan APKExpansionPolicy
kodunu kullanmanız gerekir. APKExpansionPolicy
sınıfı ServerManagedPolicy
ile neredeyse aynıdır (şurada mevcuttur:
Google Play Lisans Doğrulama Kitaplığı) ancak APK genişletmesi için ek işlem içerir
dosya yanıtı ekstraları.
Not: Önceki bölümde açıklandığı gibi İndirici Kitaplığı'nı kullanırsanız
kitaplığının APKExpansionPolicy
ile tüm etkileşimini sağladığından
bu sınıfa doğrudan göz atın.
Bu sınıfta, mevcut ve açık kaynaklarla ilgili gerekli bilgileri edinmenize genişletme dosyaları:
getExpansionURLCount()
getExpansionURL(int index)
getExpansionFileName(int index)
getExpansionFileSize(int index)
olmadığınızda APKExpansionPolicy
hizmetini nasıl kullanacağınız hakkında daha fazla bilgi
İndirici Kitaplığı'nı kullanarak Uygulamanıza Lisans Ekleme dokümanlarına bakın,
Burada, bunun gibi bir lisans politikasının nasıl uygulanacağını bulabilirsiniz.
Genişletme Dosyasını Okuma
APK genişletme dosyalarınız cihaza kaydedildikten sonra, dosyalarınızı nasıl okuduğunuz
kullandığınız dosyanın türüne bağlıdır. Genel bakış bölümünde belirtildiği gibi,
genişletme dosyaları, sahip olduğunuz herhangi bir dosya olabilir.
ister ancak belirli bir dosya adı biçimi kullanılarak yeniden adlandırılır ve
<shared-storage>/Android/obb/<package-name>/
.
Dosyalarınızı nasıl okuduğunuzdan bağımsız olarak, her zaman öncelikle harici okuma için kullanılabilir. Kullanıcının depolama alanını ya da SD kartı çıkarmıştır.
Not: Uygulamanız başlatıldığında her zaman
harici depolama alanının kullanılabilir ve okunabilir olması için getExternalStorageState()
çağrılır. Bu, birkaç olası dizeden birini döndürür
belirten bir e-posta alırsınız. Sitenizin Google tarafından okunabilmesi için
uygulaması için döndürülen değer MEDIA_MOUNTED
olmalıdır.
Dosya adları alınıyor
Genel bakış bölümünde açıklandığı gibi, APK genişletme dosyalarınız kaydedilir belirli bir dosya adı biçimi kullanarak:
[main|patch].<expansion-version>.<package-name>.obb
Genişletme dosyalarınızın konumunu ve adlarını almak için
Dosyalarınızın yolunu oluşturmak için getExternalStorageDirectory()
ve getPackageName()
yöntemlerini kullanın.
Tam yolu içeren bir diziyi almak için uygulamanızda kullanabileceğiniz bir yöntem aşağıda verilmiştir eklemek için:
Kotlin
fun getAPKExpansionFiles(ctx: Context, mainVersion: Int, patchVersion: Int): Array<String> { val packageName = ctx.packageName val ret = mutableListOf<String>() if (Environment.getExternalStorageState() == Environment.MEDIA_MOUNTED) { // Build the full path to the app's expansion files val root = Environment.getExternalStorageDirectory() val expPath = File(root.toString() + EXP_PATH + packageName) // Check that expansion file path exists if (expPath.exists()) { if (mainVersion > 0) { val strMainPath = "$expPath${File.separator}main.$mainVersion.$packageName.obb" val main = File(strMainPath) if (main.isFile) { ret += strMainPath } } if (patchVersion > 0) { val strPatchPath = "$expPath${File.separator}patch.$mainVersion.$packageName.obb" val main = File(strPatchPath) if (main.isFile) { ret += strPatchPath } } } } return ret.toTypedArray() }
Java
// The shared path to all app expansion files private final static String EXP_PATH = "/Android/obb/"; static String[] getAPKExpansionFiles(Context ctx, int mainVersion, int patchVersion) { String packageName = ctx.getPackageName(); Vector<String> ret = new Vector<String>(); if (Environment.getExternalStorageState() .equals(Environment.MEDIA_MOUNTED)) { // Build the full path to the app's expansion files File root = Environment.getExternalStorageDirectory(); File expPath = new File(root.toString() + EXP_PATH + packageName); // Check that expansion file path exists if (expPath.exists()) { if ( mainVersion > 0 ) { String strMainPath = expPath + File.separator + "main." + mainVersion + "." + packageName + ".obb"; File main = new File(strMainPath); if ( main.isFile() ) { ret.add(strMainPath); } } if ( patchVersion > 0 ) { String strPatchPath = expPath + File.separator + "patch." + mainVersion + "." + packageName + ".obb"; File main = new File(strPatchPath); if ( main.isFile() ) { ret.add(strPatchPath); } } } } String[] retArray = new String[ret.size()]; ret.toArray(retArray); return retArray; }
Bu yöntemi, uygulamanıza Context
ileterek çağırabilirsiniz
ve istenen genişletme dosyasının sürümü.
Genişletme dosyası sürüm numarasını belirlemenin birçok yolu vardır. Basit bir yol,
indirme işlemi başladığında sürümü bir SharedPreferences
dosyasına kaydetmek için
APKExpansionPolicy
sınıfının getExpansionFileName(int index)
yöntemiyle genişletme dosyası adını sorgulamak. Daha sonra, genişletmeye erişmek istediğinizde SharedPreferences
dosyasını okuyarak sürüm kodunu alabilirsiniz
dosyası olarak kaydedebilirsiniz.
Paylaşılan depolama alanından okuma hakkında daha fazla bilgi için Veri Depolama sayfasına bakın. belgelerinden faydalanabilirsiniz.
APK Genişletmesi Zip Kitaplığı'nı kullanma
Google Market Apk Genişletme paketi, APK adlı bir kitaplık içerir.
Genişletme Zip Kitaplığı (<sdk>/extras/google/google_market_apk_expansion/zip_file/
konumundadır). Bu kitaplık, isteğe bağlı
genişletmenizi okumanıza yardımcı olur
kaydedildiklerinden emin olun. Bu kitaplığı kullanarak şuradaki kaynakları kolayca okuyabilirsiniz:
sanal bir dosya sistemi haline getirin.
APK Genişletme Zip Kitaplığı aşağıdaki sınıfları ve API'leri içerir:
APKExpansionSupport
- Genişletme dosya adlarına ve ZIP dosyalarına erişmek için bazı yöntemler sunar:
getAPKExpansionFiles()
- Yukarıda gösterilen ve her iki genişletmeye ait tam dosya yolunu döndüren yöntem dosyası olarak da kaydedebilir.
getAPKExpansionZipFile(Context ctx, int mainVersion, int patchVersion)
- Hem ana dosyanın hem de dosyanın toplamını temsil eden bir
ZipResourceFile
döndürür yama dosyası olarak kaydeder. Yani hemmainVersion
hem depatchVersion
ise bu, şunlar için okuma erişimi sağlayan birZipResourceFile
döndürür: tüm veriler, yama dosyasının verileri ana dosyanın üzerinde birleştirilir.
ZipResourceFile
- Paylaşılan depolama alanındaki bir ZIP dosyasını temsil eder ve tüm işi sanal bir
dosya sistemi oluşturmayı öğreneceksiniz.
APKExpansionSupport.getAPKExpansionZipFile()
kullanarak veyaZipResourceFile
ile yolu. Bu ders, birçok faydalı yöntem içerir ancak çoğuna erişmeleri gerekmez. Önemli yöntemlerden bazıları şunlardır:getInputStream(String assetPath)
- ZIP dosyasındaki bir dosyayı okumak için bir
InputStream
sağlar. İlgili içeriği oluşturmak için kullanılanassetPath
, kök dizin. getAssetFileDescriptor(String assetPath)
AssetFileDescriptor
ZIP dosyası olarak kaydedin.assetPath
, kök dizin. Bu özellik, bazıMediaPlayer
API'leri gibiAssetFileDescriptor
gerektiren belirli Android API'leri için kullanışlıdır.
APEZProvider
- Çoğu uygulamanın bu sınıfı kullanması gerekmez. Bu sınıf, ZIP dosyalarındaki verileri bir içerik aracılığıyla sıralayan bir
ContentProvider
tanımlar sağlayan belirli Android API'lerine dosya erişimi sağlamak içinUri
medya dosyalarınaUri
erişimi bekleniyor. Örneğin, bu ifadeninVideoView.setVideoURI()
ile bir video oynatın.
Medya dosyalarının ZIP sıkıştırması atlanıyor
Medya dosyalarını depolamak için genişletme dosyalarınızı kullanıyorsanız, bir ZIP dosyası yine de şunları yapmanıza olanak tanır:
ofset ve uzunluk kontrolleri sağlayan Android medya oynatma çağrılarını (ör. MediaPlayer.setDataSource()
ve
SoundPool.load()
) tıklayın. Bu amaçla
çalışmak için ZIP dosyasını oluştururken medya dosyalarında ek sıkıştırma işlemi uygulamamanız gerekir
paketlerini ekleyebilirsiniz. Örneğin, zip
aracını kullanırken -n
seçeneğini kullanın:
zip -n .mp4;.ogg main_expansion media_files
ZIP dosyasından okuma
APK Genişletme Zip Kitaplığı'nı kullanırken ZIP dosyanızdan bir dosyayı okumak genellikle takip etmek için:
Kotlin
// Get a ZipResourceFile representing a merger of both the main and patch files val expansionFile = APKExpansionSupport.getAPKExpansionZipFile(appContext, mainVersion, patchVersion) // Get an input stream for a known file inside the expansion file ZIPs expansionFile.getInputStream(pathToFileInsideZip).use { ... }
Java
// Get a ZipResourceFile representing a merger of both the main and patch files ZipResourceFile expansionFile = APKExpansionSupport.getAPKExpansionZipFile(appContext, mainVersion, patchVersion); // Get an input stream for a known file inside the expansion file ZIPs InputStream fileStream = expansionFile.getInputStream(pathToFileInsideZip);
Yukarıdaki kod, ana genişletme dosyanızda veya
dosyasını kullanarak her iki dosyadaki tüm dosyaların birleştirilmiş bir haritasından okuma yapabilirsiniz. Tek yapmanız gereken
getAPKExpansionFile()
yöntemini sağlamanız gerekir: uygulamanız android.content.Context
ve hem ana genişletme dosyası hem de yamanın sürüm numarası
genişletme dosyası olarak gönderin.
Belirli bir genişletme dosyasından okumayı tercih ederseniz istenen genişletme dosyasının yoluyla ZipResourceFile
oluşturucuyu kullanabilirsiniz:
Kotlin
// Get a ZipResourceFile representing a specific expansion file val expansionFile = ZipResourceFile(filePathToMyZip) // Get an input stream for a known file inside the expansion file ZIPs expansionFile.getInputStream(pathToFileInsideZip).use { ... }
Java
// Get a ZipResourceFile representing a specific expansion file ZipResourceFile expansionFile = new ZipResourceFile(filePathToMyZip); // Get an input stream for a known file inside the expansion file ZIPs InputStream fileStream = expansionFile.getInputStream(pathToFileInsideZip);
Genişletme dosyalarınızda bu kitaplığı kullanma hakkında daha fazla bilgi için
örnek uygulamanın SampleDownloaderActivity
sınıfını kullanabilirsiniz. Bu sınıf,
indirilen dosyaları CRC'yi kullanarak doğrulamalıdır. Bu örneği proje başlatma belgesine dayalı olarak
kendiniz uygulamanız için, genişletmenizin bayt boyutunu
dosyaları xAPKS
dizisinde gösterilir.
Genişletme Dosyalarınızı Test Etme
Uygulamanızı yayınlamadan önce test etmeniz gereken iki şey vardır: genişletme dosyalarını ve dosyaları indirmenizi sağlar.
Dosya okumalarını test etme
Uygulamanızı Google Play'e yüklemeden önce uygulamanızın, paylaşılan depolama alanındaki dosyaları okuma yeteneğini test etmesi gerekir. Tek yapmanız gereken dosyaları cihazın paylaşılan depolama alanındaki uygun konuma eklemek ve uygulama:
- Cihazınızda, paylaşılan depolama alanında Google'ın
Play, dosyalarınızı kaydedecek.
Örneğin, paketinizin adı
com.example.android
ise paylaşılan depolama alanındaAndroid/obb/com.example.android/
dizini. (Fiş paylaşılan depolama birimini eklemek ve bunu manuel olarak oluşturmak için test cihazınızı bilgisayarınıza dizinine ekleyin.) - Genişletme dosyalarını bu dizine manuel olarak ekleyin. Dosyalarınızı şu şekilde yeniden adlandırdığınızdan emin olun:
Google Play'in kullanacağı dosya adı biçimiyle eşleşmelidir.
Örneğin, dosya türünden bağımsız olarak
com.example.android
uygulamasının ana genişletme dosyasımain.0300110.com.example.android.obb
olmalıdır. Sürüm kodu, istediğiniz herhangi bir değer olabilir. Unutmayın:- Ana genişletme dosyası her zaman
main
ile, yama dosyası isepatch
. - Paket adı, her zaman dosyanın ekli olduğu APK'nın adıyla eşleşir Google Play
- Ana genişletme dosyası her zaman
- Genişletme dosyaları cihazda bulunduğuna göre, aşağıdaki işlemleri yapmak için uygulamanızı yükleyip çalıştırabilirsiniz: genişletme dosyalarınızı test edin.
Genişletme dosyalarının işlenmesiyle ilgili bazı hatırlatıcıları burada bulabilirsiniz:
.obb
genişletme dosyalarını silmeyin veya yeniden adlandırmayın (paketi açsanız bile verileri farklı bir konuma taşıma). Bunu yaptığınızda Google Play (veya uygulamanızın kendisi) genişletme dosyasını tekrar tekrar indirmek.obb/
cihazınıza başka veriler kaydetmeyin dizininde bulunduğundan emin olun. Bazı verilerin paketini açmanız gerekiyorsa verilerigetExternalFilesDir()
ile belirtilen konuma kaydedin.
Dosya indirmelerini test etme
Çünkü bu işlemi ilk kez yaparken uygulamanızın bazen genişletme dosyalarını manuel olarak indirmesi gerekir bu işlemi test etmeniz ve uygulamanızın bu sorguda başarılı bir şekilde sorgu gönderebildiğinden dosyaları indirin ve cihaza kaydedin.
Uygulamanızda manuel indirme prosedürünü test etmek için dahili test kanalına yayınlayabilir ve böylece yalnızca yetkili test kullanıcıları. Her şey beklendiği gibi çalışıyorsa uygulamanız ana etkinlik başlar başlamaz genişletme dosyalarını indirmeye başlar.
Not: Önceden uygulamaları aşağıdaki ölçütlere göre test edebiliyordunuz: yayınlanmamış bir "taslak" yükleme sürümünü değil. Bu işlev artık devre dışı desteklenir. Bunun yerine, testinizi dahili, kapalı veya açık test kanalına yayınlamanız gerekir. plan yapar ve değişiklikleri uygular. Daha fazla bilgi için bkz. Taslak Uygulamalar Hayır Daha Uzun Süreli Desteklenir.
Uygulamanız güncelleniyor
Google Play'de genişletme dosyalarını kullanmanın en büyük avantajlarından biri de uygulamanızı güncellemeye devam edin. Google Play her APK ile iki genişletme dosyası sağlamanıza olanak tanır; ikinci dosyayı "yama" olarak kullanabilirsiniz güncellemeleri ve yeni öğeleri sağlar. Bu işlem, kullanıcılar için büyük ve pahalı olabilecek ana genişletme dosyasını yeniden indirmeniz gerekebilir.
Yama genişletme dosyası teknik olarak ana genişletme dosyasıyla aynıdır ve Android sistemi veya Google Play, ana ve yama genişletmeniz arasında gerçek yama işlemi gerçekleştirir. dosyası olarak da kaydedebilir. Uygulama kodunuz gerekli tüm yamaları uygulamalıdır.
Genişletme dosyalarınız olarak ZIP dosyalarını kullanıyorsanız APK Genişletme Sıklığı APK Genişletme paketine dahil olan Kitaplık'ta birleştirme ve sizin yama dosyası oluşturun.
Not: Yalnızca yamada değişiklik yapmanız gerekse bile
genişletme dosyasını kullanıyorsanız Google Play'in güncelleme gerçekleştirmesi için APK'yı yine de güncellemeniz gerekir.
Uygulamada kod değişikliği gerekmiyorsa versionCode
öğesini (uygulamada)
manifest'ini kullanabilirsiniz.
APK ile ilişkilendirilmiş ana genişletme dosyasını değiştirmediğiniz sürece Play Console'da, uygulamanızı daha önce yüklemiş olan kullanıcılar ana genişletme dosyasını indirin. Mevcut kullanıcılar yalnızca güncellenen APK'yı ve yeni yamayı alır. genişletme dosyasını (önceki ana genişletme dosyasını korur).
Genişletme dosyalarında yapılan güncellemelerle ilgili unutulmaması gereken birkaç sorun aşağıda belirtilmiştir:
- Uygulamanız için aynı anda yalnızca iki genişletme dosyası olabilir. Bir ana genişletme dosyası ve bir yama genişletme dosyası var. Bir dosya güncellendiğinde Google Play, (ve manuel güncellemeler yaparken uygulamanız da öyle olmalıdır).
- Bir yama genişletme dosyası eklediğinizde Android sistemi, ana genişletme dosyası oluşturun. Uygulamanızı yama verilerini destekleyecek şekilde tasarlamanız gerekir. Ancak APK Genişletme paketinde ZIP dosyalarını kullanmak için bir kitaplık bulunur Bu dosya, yama dosyasındaki verileri ana genişletme dosyasında birleştirir. Böylece, tüm genişletme dosyası verilerini kolayca okuyabilirsiniz.