Paylaşılan depolama alanına erişim gerektiren uygulamaların çoğu, medya dosyalarını paylaşma ve medya dışı dosya paylaşma ile ilgili en iyi uygulamaları izleyebilir. Ancak bazı uygulamaların temel kullanım alanı, cihazdaki dosyalara geniş kapsamlı erişim gerektirmesine rağmen gizlilik dostu depolama alanı en iyi uygulamalarını kullanarak bu dosyalara verimli bir şekilde erişememektedir. Android, bu durumlar için tüm dosyalara erişim adlı özel bir uygulama erişimi sağlar.
Örneğin, bir antivirüs uygulamasının birincil kullanım alanı, farklı dizinlerdeki çok sayıda dosyanın düzenli olarak taranmasını gerektirebilir. Bu tarama, sistem dosya seçiciyi kullanarak dizinleri seçmek için tekrarlanan kullanıcı etkileşimleri gerektiriyorsa kötü bir kullanıcı deneyimi sunar. Dosya yöneticisi uygulamaları, yedekleme ve geri yükleme uygulamaları ve belge yönetimi uygulamaları gibi diğer kullanım alanları için de benzer dikkat edilmesi gerekir.
Tüm dosyalara erişim isteğinde bulunma
Uygulamalar, aşağıdakileri yaparak kullanıcıdan tüm dosyalara erişim isteğinde bulunabilir:
MANAGE_EXTERNAL_STORAGEiznini manifest dosyasında beyan edin.- Kullanıcıları, uygulamanız için aşağıdaki seçeneği etkinleştirebilecekleri bir sistem ayarları sayfasına yönlendirmek üzere
ACTION_MANAGE_ALL_FILES_ACCESS_PERMISSIONintent işlemini kullanın: Tüm dosyaları yönetmek için erişime izin ver.
Uygulamanıza MANAGE_EXTERNAL_STORAGE izni verilip verilmediğini öğrenmek için Environment.isExternalStorageManager() numaralı telefonu arayın.
MANAGE_EXTERNAL_STORAGE izninin izin verdiği işlemler
MANAGE_EXTERNAL_STORAGE izni aşağıdakileri sağlar:
Ortak depolama alanındaki tüm dosyalara okuma ve yazma erişimi.
MediaStore.Filestablosunun içeriğine erişmeHem USB on-the-go (OTG) sürücüsünün hem de SD kartın kök dizinine erişim.
/Android/data/,/sdcard/Androidve/sdcard/Androidürününün çoğu alt dizini hariç olmak üzere tüm dahili depolama dizinlerine yazma erişimi. Bu yazma erişimi, doğrudan dosya yolu erişimini içerir.Bu izin verilen uygulamalar, depolama biriminde
Android/data/alt dizini olarak görünen diğer uygulamalara ait uygulamaya özel dizinlere yine de erişemez.
MANAGE_EXTERNAL_STORAGE iznine sahip uygulamalar, MediaStore API'yi veya doğrudan dosya yollarını kullanarak bu ek dosya ve dizinlere erişebilir. Ancak Depolama Aksesuar Çerçevesi'ni kullandığınızda bir dosyaya veya dizine yalnızca MANAGE_EXTERNAL_STORAGE izni olmadan erişebiliyorsanız erişebilirsiniz.
Başka bir uygulamanın depolama alanı yönetim etkinliğini çağırma
Android 12 (API düzeyi 31) ve sonraki sürümlerde hem MANAGE_EXTERNAL_STORAGE iznine hem de QUERY_ALL_PACKAGES iznine sahip uygulamalar (ör. dosya yönetimi uygulamaları) kullanıcıları başka bir uygulamanın özel alan yönetimi etkinliğine göndermek için getManageSpaceActivityIntent() kullanabilir.
getManageSpaceActivityIntent() yöntemi, bir paket adı ve istek kodu alır ve aşağıdakilerden birini döndürür:
- Belirtilen paket adına sahip uygulamada özel bir "alanı yönet" etkinliği tanımlanmışsa
PendingIntent.getManageSpaceActivityIntent()yöntemini çağıran dosya yönetimi uygulaması, kullanıcıları özel etkinliğe göndermek için döndürülen intent'i çağırabilir. - Belirtilen paket adına sahip uygulama "alan yönet" etkinliği tanımlamıyorsa
null.
Test için MANAGE_EXTERNAL_STORAGE iznini etkinleştirme
MANAGE_EXTERNAL_STORAGE izninin uygulamanızı nasıl etkilediğini keşfetmek için testi izinle etkinleştirebilirsiniz. Bunu yapmak için test cihazınıza bağlı makinede aşağıdaki komutu çalıştırın:
adb shell appops set --uid PACKAGE_NAME MANAGE_EXTERNAL_STORAGE allow
Google Play bildirimi
Bu bölümde, Google Play'de uygulama yayınlayan geliştiricilere yönelik bir bildirim yer almaktadır.
Google Play Store, paylaşılan depolamaya geniş erişim iznini sınırlamak için Android 11'i (API düzeyi 30) veya sonraki sürümleri hedefleyen ve MANAGE_EXTERNAL_STORAGE izni aracılığıyla tüm dosyalara erişim isteyen uygulamaları değerlendirmek üzere politikasını güncelledi. Bu politika
Mayıs 2021 itibarıyla geçerlidir.
Uygulamanız Android 11 veya sonraki sürümleri hedefliyorsa ve MANAGE_EXTERNAL_STORAGE iznini bildiriyorsa Android Studio, Şekil 1'de gösterilen lint uyarısını gösterir. Bu uyarı, Google Play Store'un izin kullanımını sınırlayan bir politikası olduğunu hatırlatır.
MANAGE_EXTERNAL_STORAGE izniyle ilgili Google Play politikasını hatırlatan hata mesajı.
MANAGE_EXTERNAL_STORAGE iznini yalnızca uygulamanız Depolama Erişim Çerçevesi veya Media Store API gibi gizliliği daha fazla koruyan API'leri verimli bir şekilde kullanamadığında isteyin. Uygulamanızın izin kullanımı, izin verilen kullanımlar kapsamına girmeli ve uygulamanın temel işleviyle doğrudan bağlantılı olmalıdır. Uygulamanızda aşağıdakilerden herhangi birine benzer bir kullanım alanı varsa MANAGE_EXTERNAL_STORAGE iznini isteyebileceğini unutmayın:
- Dosya yöneticileri
- Yedekleme ve geri yükleme uygulamaları
- Virüsten korunma uygulamaları
- Doküman yönetimi uygulamaları
- Cihazda dosya arama
- Disk ve dosya şifreleme
- Cihazlar arasında veri taşıma