08-12-2021, Saat: 22:31
Delphi ile Android 11 SDK 30 Kapsamlı Depolama
Scoped Storage : SAF & MediaStore API
Android 10 Gizlilik Değişiklikleri
Android 10 (API seviyesi 29), kullanıcıların gizliliğini daha iyi korumak için bir dizi özellik ve davranış değişikliği sunar. Bu değişiklikler, kullanıcıların verileri ve uygulamalara sağladıkları yetenekler üzerinde sahip oldukları şeffaflığı ve kontrolü genişletir. Bu özellikler, uygulamanızın bağlı olduğu belirli davranışların veya verilerin, platformun eski sürümlerine kıyasla farklı davranabileceği anlamına gelebilir. Uygulamanız, kullanıcı verilerini işlemek için mevcut en iyi uygulamaları izliyorsa, uygulamanız üzerindeki etkiler minimum düzeyde olmalıdır.
Uygulama dosyalarına ve medyaya yönelik harici depolama erişimi
Varsayılan olarak, Android 10 ve sonraki sürümleri hedefleyen uygulamalara harici depolamaya veya kapsamlı depolamaya kapsamlı erişim verilir. Bu tür uygulamalar, depolamayla ilgili herhangi bir kullanıcı izni istemeye gerek kalmadan harici bir depolama aygıtında aşağıdaki dosya türlerini görebilir:
· getExternalFilesDir (TPath.GetPublicPath) kullanılarak erişilen uygulamaya özel dizindeki dosyalar.
· Uygulamanın medya mağazasında oluşturduğu fotoğraflar, videolar ve ses klipleri.
Kapsamlı depolama ile harici depolama cihazlarına kaydedilmiş dosyaları paylaşma, ulaşma ve değiştirme hakkında daha fazla bilgi için harici depolama dosyaları yönetme ve medya dosyalarını ulaşma ve değiştirme kılavuzlarına bakın.
https://developer.android.com/about/vers...cy/changes
Android 11 (API 30) Gizlilik ve Güvenlik
Android 11'i hedefleyen uygulamaların, yalnızca kendi oluşturdukları harici depolama alanındaki dosyalara ("scoped storage") erişmeye izni vardır. Ayrıca uygulamaya özel bir dizinde bulunan dosyalara ek olarak; ana dizindeki "Müzik", "Resimler" veya "Video" dizinleri erişime dahildir. Diğer herhangi bir dosyaya ancak ve ancak "Depolama Erişim Çerçevesi / Storage Access Framework" aracılığıyla ve kullanıcı izni yoluyla erişilebilir.
Uygulamada belirlenen konum izni sayesinde üretilen EXIF konum verisinin başarıyla işlenmiş olmasından emin olmak için Android 11, video ve fotoğraf kayıt "niyetlerini / intents" yalnızca sistem kamera uygulamasına olmak üzere sınırlar.
https://tr.wikipedia.org/wiki/Android_11
Android 11, kullanıcı gizliliğini geliştirmek için aşağıdakiler dahil olmak üzere değişiklikler ve kısıtlamalar getirmiştir:
- Kapsamlı depolama mecburiyeti : Harici depolama dizinlerine erişim, uygulamaya özel bir dizin ve uygulamanın oluşturduğu belirli ortam türleriyle sınırlıdır.
- İzinlerin otomatik olarak sıfırlanması : Kullanıcılar bir uygulamayla birkaç aydır etkileşimde bulunmadıysa, sistem uygulamanın hassas izinlerini otomatik olarak sıfırlar.
- Arka planda konum erişimi : Uygulamalara arka planda konum izni vermek için kullanıcıların sistem ayarlarına yönlendirilmesi gerekir.
- Paket görünürlüğü : Bir uygulama, cihazda yüklü uygulamaların listesini sorguladığında, döndürülen liste filtrelenir.
- Kapsamlı depolama sınırlaması
- Arka planda konum erişimi ve resim, video ve ses dosyalarına ulaşma için yeni izinler
Uygulamanız MANAGE_EXTERNAL_STORAGE iznine erişilmesini gerektirmiyorsa uygulamanızı başarılı bir şekilde yayınlayabilmek için bu izni uygulamanızın manifest dosyasından kaldırmanız gerekir. Politikaya uygun alternatiflerin uygulanması hakkında ayrıntılı bilgiyi aşağıda bulabilirsiniz.
Uygulamanız kabul edilebilir kullanım ile ilgili politika gereksinimlerini karşılıyorsa veya istisna olarak tutulmaya uygunsa Play Console'daki Beyan Formu'nu kullanarak bunu ve diğer yüksek riskli izinleri bildirmeniz gerekir.
Politika gereksinimlerini karşılamayan veya Beyan Formu gönderilmeyen uygulamalar Google Play'den kaldırılabilir.
Tüm dosyalara erişim iznine yalnızca uygulamanız, gizliliği daha fazla koruyan en iyi uygulamaları verimli bir şekilde kullanamadığında (ör. Depolama Erişim Çerçevesi veya Media Store API kullanımı) erişmelisiniz.
Buna ek olarak, uygulamanın izin kullanımı, izin verilen kullanımlar kapsamına girmeli ve uygulamanın temelişleviyle doğrudan bağlantılı olmalıdır. Temel işlev, uygulamanın asıl amacı olarak tanımlanır. Bu temel işlev olmadan uygulama "çalışmaz" veya kullanışlı olmaz. Temel işlevin yanı sıra bu temel işlevi oluşturan tüm temel özellikler, uygulamanın açıklamasında belirgin bir şekilde belgelenmeli ve tanıtılmalıdır.
https://support.google.com/googleplay/an...7955?hl=tr
Paylaşılan depolamaya genel bakış
Diğer uygulamalar tarafından erişilebilen veya erişilmesi gereken ve kullanıcı uygulamanızın yüklemesini kaldırsa bile kaydedilen kullanıcı verileri için paylaşılan depolamayı kullanır.
Android, paylaşılabilir veri türlerini depolamak ve bunlara erişmek için aşağıdaki API'ler sağlar:
- Medya içeriği: Sistem, bu tür dosyalar için standart genel dizinler sağlar, böylece kullanıcının tüm fotoğrafları için ortak bir konumu, tüm müzik ve ses dosyaları için başka bir ortak konumu vb. vardır. Uygulamanız, platformu MediaStore API'sini kullanarak bu içeriğe erişebilir.
- Belgeler ve diğer dosyalar: Sistem, PDF belgeleri ve EPUB biçimini kullanan kitaplar gibi diğer dosya türlerini içeren özel bir dizine sahiptir. Uygulamanız, platformun Depolama Erişim Çerçevesini (SAF) kullanarak bu dosyalara erişebilir.
- Veritabanları : Android 11 (API düzeyi 30) ve sonraki sürümlerde sistem, birden fazla uygulamanın kullanabileceği büyük Veritabanlarıni önbelleğe alır. Bu Veritabanları, makine öğrenimi ve medya oynatma gibi kullanma vakalarını destekleyebilir. Uygulamalar, BlobStoreManager API'yi kullanarak bu paylaşılan Veritabanlarıne erişebilir.
Kapsamlı Depolama / Scoped Storage
Android 10 ve 11 gizlilik ve güvenlik değişikliklerinden sonra harici depolamaya erişim kapsamlı hale getirilmiş olup, artık dosyalara ulaşmanın 4 ana yolu mevcuttur:
1. Depolama Erişim Çerçevesi / Storage Access Framework (SAF)
2. MediaStore API
3. All Files Access API
4. Paylaşmalı Veritabanları API
All Files Access API (ACTION_MANAGE_APP_ALL_FILES_ACCESS_PERMISSION izni ve ACTION_MANAGE_STORAGE niyeti) sadece dosya yöneticisi ve antivirus türü uygulamalar için çıkarılmış olup, diğer tüm uygulamalar Google Play Store tarafından reddedilmektedir.
Paylaşmalı Veritabanları / Databases (BlobStoreManager) API de sadece Android 11 SDK 30 ve üstünde çalışmakta olup, Android 10 ve önceki sürümlerde çalışmamaktadır.
Dolayısıyla bu iki API konuya dahil edilmemiştir.
Depolama Erişim Çerçevesi / Storage Access Framework (SAF)
Android 4.4 (API seviyesi 19), Storage Access Framework (SAF) sınıfını sunmuştur. SAF, kullanıcıların tercih ettikleri tüm belge depolama sağlayıcılarında belgelere, resimlere ve diğer dosyalara göz atmasını ve bunları açmasını kolaylaştırır. Standart, kullanımı kolay bir kullanıcı arayüzü, kullanıcıların dosyalara göz atmasına ve uygulamalar ve sağlayıcılar arasında tutarlı bir şekilde son bilgilere erişmesine olanak tanır.
Bulut veya yerel depolama hizmetleri, DocumentsProvider hizmetlerini kapsayan bir uygulama uygulayarak bu ekosisteme katılabilir. Bir sağlayıcının belgelerine erişmesi gereken istemci uygulamaları, yalnızca birkaç satır kodla SAF ile entegre olabilir.
SAF aşağıdakileri ihtiva eder:
- Belge sağlayıcı —Bir depolama hizmetinin (Google Drive gibi) yönettiği dosyaları ortaya çıkarmasına izin veren bir içerik sağlayıcı. Bir belge sağlayıcı, sınıfın bir alt DocumentsProvider sınıfı olarak uygulanır. Belge sağlayıcı şeması, geleneksel bir dosya hiyerarşisine dayanır, ancak belge sağlayıcınızın verileri fiziksel olarak nasıl depolayacağı size bağlıdır. Android platformu, İndirilenler, Görüntüler ve Videolar gibi çeşitli yerleşik belge sağlayıcıları içerir.
- İstemci uygulaması Her bir özel uygulama vakaları olan ACTION_CREATE_DOCUMENT, ACTION_OPEN_DOCUMENT ve ACTION_OPEN_DOCUMENT_TREE niyet eylemlerini (intent action) çağırır ve belge sağlayıcıları tarafından döndürülen dosyaları alır.
- Seçici —Kullanıcıların, istemci uygulamasının arama kriterlerini karşılayan tüm belge sağlayıcılarından belgelere erişmesine olanak tanıyan bir sistem kullanıcı arabirimi.
- Kullanıcıların yalnızca tek bir uygulamadan değil, tüm belge sağlayıcılardan gelen içeriğe göz atmasına olanak tanır.
- Uygulamanızın, bir belge sağlayıcıya ait belgelere uzun vadeli, kalıcı erişime sahip olmasını mümkün kılar. Bu erişim sayesinde kullanıcılar sağlayıcıya dosya ekleyebilir, düzenleyebilir, kaydedebilir ve silebilir.
- Yalnızca sürücü takılıyken görünen USB depolama sağlayıcıları gibi birden çok kullanıcı hesabını ve geçici kökleri destekler.
SAF, DocumentsProvider sınıfın bir alt sınıfı olan bir içerik sağlayıcı etrafında toplanır. Bir belge sağlayıcı içinde veriler, geleneksel bir dosya hiyerarşisi olarak yapılandırılmıştır:

Şekil 1. Belge sağlayıcı veri modeli. Bir Kök, tek bir Belgeye işaret eder ve ardından tüm ağacın yayılmasını başlatır.
Aşağıdakilere dikkat ediniz:
- Her belge sağlayıcı, bir belge ağacını keşfetmeye başlama noktaları olan bir veya daha fazla 'kök' bildirir. Her kökün benzersiz bir değeri vardır COLUMN_ROOT_ID ve bu kökün altındaki içeriği temsil eden bir belgeye (bir dizine) işaret eder. Kökler, birden çok hesap, geçici USB depolama aygıtı veya kullanıcı oturum açma/oturum kapatma gibi kullanım durumlarını desteklemek için tasarım gereği dinamiktir.
- Her kökün altında tek bir belge bulunur. Bu belge 1'den N'ye kadar belgeye işaret eder ve bunların her biri sırayla 1'den N'ye kadar belgeye işaret edebilir.
- Her depolama arka ucu, benzersiz bir COLUMN_DOCUMENT_ID. Cihaz yeniden başlatmaları arasında kalıcı URI izinleri için kullanıldığından, belge kimlikleri benzersiz olmalı ve yayınlandıktan sonra değişmemelidir.
- Belgeler, açılabilir bir dosya (belirli bir MIME türüyle) veya ek belgeler içeren bir dizin ( MIME_TYPE_DIR MIME türüyle) olabilir.
- Her belge, COLUMN_FLAGS tarafından açıklandığı gibi farklı yeteneklere sahip olabilir. Örneğin FLAG_SUPPORTS_WRITE, FLAG_SUPPORTS_DELETE ve FLAG_SUPPORTS_THUMBNAIL. Aynı COLUMN_DOCUMENT_ID çoklu dizinleri dahil edilebilir.
Yukarıda belirtildiği gibi, belge sağlayıcı veri modeli, geleneksel bir dosya hiyerarşisine dayanmaktadır. Ancak DocumentsProvider API kullanarak erişebildiğiniz sürece verilerinizi fiziksel olarak istediğiniz gibi saklayabilirsiniz. Örneğin, verileriniz için etiket tabanlı bulut depolamayı kullanabilirsiniz.
Şekil 2, bir fotoğraf uygulamasının depolanan verilere erişmek için SAF'ı nasıl kullanabileceğini gösterir:

Şekil2. Depolama Erişim Çerçevesi akış şeması
Aşağıdakilere dikkat ediniz:
- SAF'ta sağlayıcılar ve müşteriler doğrudan etkileşime girmez. İstemci, dosyalarla etkileşim (yani, dosyaları okumak, düzenlemek, oluşturmak veya silmek) için izin ister.
- Bir uygulamanın (bu örnekte, bir fotoğraf uygulaması) ACTION_OPEN_DOCUMENT veya ACTION_CREATE_DOCUMENT niyeti etkileşimi. Niyet /intent şartları daha da hassaslaştırmak için filtreler içerebilir; örneğin, "image” MIME türüne sahip tüm açılabilir dosyaları verir.
- Niyet harekete geçtiğinde, sistem seçici her kayıtlı sağlayıcıya gider ve kullanıcıya eşleşen içerik köklerini gösterir.
- Seçici, temeldeki belge sağlayıcıları çok farklı olsa bile, kullanıcılara belgelere erişmek için standart bir arabirim sağlar. Örneğin, şekil 2 bir Google Drive sağlayıcısını, bir USB sağlayıcısını ve bir bulut sağlayıcısını göstermektedir.
Şekil 3. (Sistem Dosya) Seçici
Kullanıcı İndirilenler klasörünü seçtikten sonra resimler görüntülenir. Şekil 4, bu işlemin sonucunu göstermektedir. Kullanıcı artık bu görüntülerle sağlayıcının ve istemci uygulamasının desteklediği şekillerde etkileşim kurabilir.
Şekil 4. Sistem seçicide görüntülendiği şekliyle İndirilenler klasöründe saklanan resimler
İstemci uygulaması yazma
Android 4.3 ve önceki sürümlerde, uygulamanızın başka bir uygulamadan dosya almasını istiyorsanız, ACTION_PICK veya ACTION_GET_CONTENT gibi bir niyeti çağırılması gerekir. Kullanıcı daha sonra içinden bir dosya seçeceği tek bir uygulama seçmeli ve seçilen uygulama, kullanıcının mevcut dosyalara göz atması ve aralarından seçim yapması için bir kullanıcı arabirimi sağlamalıdır.
Android 4.4 (API düzeyi 19) ve sonraki sürümlerde, ACTION_OPEN_DOCUMENT kullanıcının diğer uygulamaların kullanıma sunduğu tüm dosyalara göz atmasına olanak tanıyan, sistem kontrollü bir seçici kullanıcı arabirimini görüntüleyen niyeti kullanma ek seçeneğiniz vardır. Bu tek kullanıcı arayüzünden kullanıcı, desteklenen uygulamalardan herhangi birinden bir dosya seçebilir.
Android 5.0 (API düzeyi 21) ve sonraki sürümlerde, kullanıcının bir istemci uygulamasının erişmesi için bir dizin seçmesine olanak tanıyan ACTION_OPEN_DOCUMENT_TREE niyetini de kullanabilirsiniz.
Not: ACTION_OPEN_DOCUMENT niyetinin ACTION_GET_CONTENT‘in yerine geçmesi amaçlanmamıştır. Kullanma Vakası uygulamanızın ihtiyaçlarına bağlıdır:
- ACTION_GET_CONTENT Uygulamanızın yalnızca verileri okumasını veya içe aktarmasını istiyorsanız kullanın. Bu yaklaşımla uygulama, resim dosyası gibi verilerin bir kopyasını içe aktarır.
- ACTION_OPEN_DOCUMENT Uygulamanızın bir belge sağlayıcıya ait belgelere uzun süreli, kalıcı erişime sahip olmasını istiyorsanız kullanın. Bir örnek, kullanıcıların bir belge sağlayıcıda depolanan görüntüleri düzenlemesine izin veren bir fotoğraf düzenleme uygulaması olabilir.
https://developer.android.com/guide/topi...t-provider
Paylaşılan depolama alanından belgelere ve diğer dosyalara erişme
Android 4.4 (API düzeyi 19) ve sonraki sürümleri çalıştıran cihazlarda, uygulamanız Depolama Erişim Çerçevesini kullanarak harici depolama birimleri ve bulut tabanlı depolama dahil olmak üzere bir belge sağlayıcıyla etkileşim kurabilir. Bu çerçeve, kullanıcıların bir belge sağlayıcı seçmek için bir sistem seçiciyle etkileşime girmesine ve uygulamanızın oluşturacağı, açacağı veya değiştireceği belirli belgeleri ve diğer dosyaları seçmesine olanak tanır.
Kullanıcı, uygulamanızın erişebileceği dosyaları veya dizinleri seçmeye dahil olduğundan, bu mekanizma herhangi bir sistem izni gerektirmez ve kullanıcı denetimi ve gizliliği artırılır. Ayrıca, uygulamaya özel bir dizinin dışında ve medya deposunun dışında depolanan bu dosyalar, uygulamanızın yüklemesi kaldırıldıktan sonra cihazda kalır.
Çerçeveyi kullanmak aşağıdaki adımları içerir:
- Bir uygulama, depolamayla ilgili bir eylem içeren bir niyeti çağırır. Bu eylem, çerçevenin kullanıma sunduğu belirli bir kullanma vakasına karşılık gelir.
- Kullanıcı, bir belge sağlayıcısına göz atmasına ve depolamayla ilgili eylemin gerçekleştiği bir konum veya belge seçmesine olanak tanıyan bir Sistem Seçici gösterilir.
- Uygulama, kullanıcının seçtiği konumu veya belgeyi temsil eden bir URI'ye okuma ve yazma erişimi kazanır. Bu URI'yi kullanarak uygulama, seçilen konumda işlemler gerçekleştirebilir.
Ancak uygulamanız medya deposunu kullanıyorsa, diğer uygulamaların medya dosyalarına erişmek için READ_EXTERNAL_STORAGE iznini istemeniz gerekir. Android 9 (API düzeyi 28) veya daha eski sürümleri çalıştıran cihazlarda, READ_EXTERNAL_STORAGE uygulamanızın oluşturduğu medya dosyaları da dahil olmak üzere herhangi bir medya dosyasına erişim izni istemesi gerekir.
Bu kılavuz, çerçevenin dosyalar ve diğer belgelerle çalışmak için desteklediği farklı kullanım durumlarını açıklar. Ayrıca, kullanıcı tarafından seçilen konumda işlemlerin nasıl gerçekleştirileceğini de açıklar.
Belgelere ve diğer dosyalara erişmek için vakaları kullanın
Storage Access Framework, dosyalara ve diğer belgelere erişmek için aşağıdaki Kullanma Vakalarını destekler.
Yeni bir dosya oluşturun
ACTION_CREATE_DOCUMENT niyet eylemi, kullanıcıların belirli bir yerde bir dosyayı kaydetmesi için izin verir.
Bir belge veya dosya açın
ACTION_OPEN_DOCUMENT niyet eylemi, kullanıcıların belirli bir belgeyi açması veya dosyayı seçmesi için izin verir.
Bir dizinin içeriğine erişim izni verin
ACTION_OPEN_DOCUMENT_TREE Android 5.0 (API düzeyi 21) ve sonraki sürümlerde bulunan niyet eylemi, kullanıcıların belirli bir dizini seçmesine olanak tanıyarak uygulamanızın bu dizindeki tüm dosyalara ve alt dizinlere erişmesine izin verir.
Aşağıdaki bölümler, her bir kullanma vakasının nasıl yapılandırılacağına ilişkin rehberlik sağlar.
Yeni bir dosya oluşturun
ACTION_CREATE_DOCUMENT Sistem dosyası seçiciyi yüklemek ve kullanıcının bir dosyanın içeriğini yazacağı konumu seçmesine izin vermek için niyet eylemini (intent action) kullanır. Bu işlem, diğer işletim sistemlerinin kullandığı "farklı kaydet" iletişim kutularında kullanılana benzer.
Not: ACTION_CREATE_DOCUMENT mevcut bir dosyanın üzerine yazılamaz. Uygulamanız aynı ada sahip bir dosyayı kaydetmeye çalışırsa, sistem dosya adının sonuna parantez içinde bir sayı ekler.
Uygulamanız yeni dosyayı örneğin confirmation.pdf, zaten o ada sahip dosya bulunan bir dizinde kaydetmeye çalışırsa, sistem yeni dosyayı confirmation(1).pdf adıyla kaydeder.
Niyeti yapılandırırken, dosyanın adını ve MIME türünü belirtin. İsteğe bağlı olarak, EXTRA_INITIAL_URI ekstra niyeti kullanarak, dosya seçicinin ilk yüklediğinde görüntülemesi gereken dosyanın veya dizinin URI'sini belirtin.
Aşağıdaki kod parçacığı, bir dosya oluşturma niyetinin nasıl oluşturulacağını ve çağrılacağını gösterir:
// PDF belgesi oluşturma için talep kodu.
const Dosya_Olustur : integer = 11; //CREATE_FILE = 1
procedure PdfDosyasiOlustur(seciciBaslangicUri : JNet_Uri);
var
Intent : JIntent;
begin
Intent := TJIntent.Create;
Intent.setAction(TJIntent.JavaClass.ACTION_CREATE_DOCUMENT);
Intent.addCategory(TJIntent.JavaClass.CATEGORY_OPENABLE);
Intent.setType(StringToJString('application/pdf'));
Intent.putExtra(TJIntent.JavaClass.EXTRA_TITLE,StringToJString('fatura.pdf'));
// İsteğe bağlı olarak, uygulamanız dosyayı oluşturduğunda
// sistem dosya seçici tarafından açılacak dizin için bir URI belirleyin.
Intent.putExtra(TJDocumentsContract.JavaClass.EXTRA_INITIAL_URI,
JParcelable(seciciBaslangicUri));
MainActivity.startActivityForResult(Intent, Dosya_Olustur);
end;
Bir dosya açın
Uygulamanız, kullanıcıların benzerleriyle paylaşmak veya başka belgelere aktarmak isteyebilecekleri verileri girdiği depolama birimi olarak belgeleri kullanabilir. Birkaç örnek, bir kullanıcının bir üretkenlik belgesi açmasını veya bir EPUB dosyası olarak kaydedilmiş bir kitabı açmasını içerir.
Bu durumlarda, ACTION_OPEN_DOCUMENT sistemin dosya seçici uygulamasını açan niyeti çağırarak kullanıcının açılacak dosyayı seçmesine izin verin. Yalnızca uygulamanızın desteklediği dosya türlerini göstermek için bir MIME türü belirtin. Ayrıca, isteğe bağlı olarak, EXTRA_INITIAL_URI ekstra niyetini kullanarak dosya seçicinin ilk yüklendiğinde görüntülemesi gereken dosyanın URI'sini belirtebilirsiniz.
Aşağıdaki kod parçacığı, bir PDF belgesi açma niyetinin nasıl oluşturulacağını ve çağrılacağını gösterir:
// Bir PDF belgesi seçmek için talep kodu.
// const Pdf_Dosyasi_Sec : integer = 22; //PICK_PDF_FILE = 2
procedure PdfDosyasiOlustur(seciciBaslangicUri : JNet_Uri);
var
Intent: JIntent;
begin
Intent := TJIntent.Create;
Intent.setAction(TJIntent.JavaClass.ACTION_OPEN_DOCUMENT);
Intent.addCategory(TJIntent.JavaClass.CATEGORY_OPENABLE);
Intent.setType(StringToJString('application/pdf'));
// İsteğe bağlı olarak, sistem dosya seçici yüklendiğinde
// gösterilecek dosya için bir URI belirleyin.
Intent.putExtra(TJDocumentsContract.JavaClass.EXTRA_INITIAL_URI,
JParcelable(seciciBaslangicUri));
TAndroidHelper.Activity.startActivityForResult(Intent, Pdf_Dosyasi_Sec);
end;
Bir dizinin içeriğine erişim izni verin
Not: Bu bölümde açıklanan niyet eylemi (intent action), Android 5.0 (API düzeyi 21) ve sonraki sürümlerde mevcuttur.
Dosya yönetimi ve medya oluşturma uygulamaları, genellikle bir dizin hiyerarşisindeki dosya gruplarını yönetir. Uygulamanızda bu özelliği sağlamak için, Android 11'den (API düzeyi 30) başlayan bazı istisnalar dışında, kullanıcının bir dizin ağacının tamamına erişim vermesine izin veren ACTION_OPEN_DOCUMENT_TREE niyet eylemini kullanın. Uygulamanız daha sonra seçilen dizindeki ve alt dizinlerindeki herhangi bir dosyaya erişebilir. ACTION_OPEN_DOCUMENT_TREE uygulamasını kullanırken, uygulamanız yalnızca kullanıcının seçtiği dizindeki dosyalara erişim kazanır. Kullanıcı tarafından seçilen bu dizinin dışında bulunan diğer uygulamaların dosyalarına erişiminiz yok. Bu kullanıcı kontrollü erişim, kullanıcıların uygulamanızla tam olarak hangi içeriği paylaşacaklarını seçmelerine imkan sağlar.
İsteğe bağlı olarak, EXTRA_INITIAL_URI ilave niyetini kullanarak dosya seçicinin ilk yüklendiğinde görüntülemesi gereken dizinin URI'sini belirtebilirsiniz.
Aşağıdaki kod parçacığı, bir dizin açma niyetinin nasıl oluşturulacağını ve çağrılacağını gösterir:
procedure DizinAc(YuklenecekUri : JNet_Uri); // Sistem dosya seçici kullanarak bir dizin seçin var Intent : JIntent; begin Intent := TJIntent.Create; Intent.setAction(TJIntent.JavaClass.ACTION_OPEN_DOCUMENT_TREE); // İsteğe bağlı olarak, sistem dosya seçici yüklendiğinde // açılacak dizin için bir URI belirleyin. Intent.putExtra(TJDocumentsContract.JavaClass.EXTRA_INITIAL_URI, JParcelable(YuklenecekUri)); Mainactivity.startActivityForResult(Intent, Dizin_Agaci_Ac); end;
Dikkat: ACTION_OPEN_DOCUMENT_TREE kullanılarak erişilen dizindeki çok sayıda dosyayı yinelerseniz, uygulamanızın performansı düşebilir.
Erişim kısıtlamaları
Android 11 (API düzeyi 30) ve sonraki sürümlerde, ACTION_OPEN_DOCUMENT_TREE aşağıdaki dizinlere erişim istemek için niyet eylemini kullanamazsınız:
- Dahili depolama biriminin kök dizini.
- Kartın öykünmesi veya çıkarılabilir olmasına bakılmaksızın, aygıt üreticisinin güvenilir olduğunu düşündüğü her bir SD kart sürücüsünün kök dizini. Güvenilir sürücü, bir uygulamanın çoğu zaman başarıyla erişebildiği birimdir.
Download
- dizini.
-
Android/data/
- dizini ve tüm alt dizinleri.
Android/obb/
- dizini ve tüm alt dizinleri.
Kullanıcı sistemin dosya seçicisini kullanarak bir dosya veya dizin seçtikten sonra, aşağıdaki kodu onActivityResult kullanarak seçilen öğenin URI'sini alabilirsiniz:
procedure TForm1.IletiFaaliyetiYakala(const Sender: TObject; const M: TMessage); begin if M is TMessageResultNotification then OnActivityResult( TMessageResultNotification(M).RequestCode, TMessageResultNotification(M).ResultCode, TMessageResultNotification(M).Value); end; procedure TForm1.OnActivityResult(RequestCode, ResultCode: Integer; Data: JIntent); var Uri: Jnet_Uri; begin if ResultCode = TJActivity.JavaClass.RESULT_OK then begin // Sonuç verisi kullanıcının seçtiği // belge veya dizin için bir URI içerir. Uri := nil; if Assigned(Data) then begin Uri := Data.getData; if RequestCode = sizin-talep-kodunuz then begin // URI’sini kullanarak belge üzerinde işlemler gerçekleştirin. end; end; end;
Uygulamanız, seçilen öğenin URI'sine bir referans alarak, öğe üzerinde birkaç işlem gerçekleştirebilir. Örneğin, öğenin meta verilerine erişebilir, öğeyi yerinde düzenleyebilir ve silebilirsiniz.
Aşağıdaki bölümler, kullanıcının seçtiği dosyalar üzerindeki eylemlerin nasıl tamamlanacağını gösterir.
Bir sağlayıcının desteklediği işlemleri belirleyin
Farklı içerik sağlayıcılar, belgeler üzerinde, belgeyi kopyalama veya belgenin küçük resmini görüntüleme gibi farklı işlemlerin gerçekleştirilmesine izin verir. Belirli bir sağlayıcının hangi işlemleri desteklediğini belirlemek için Document.COLUMN_FLAGS değerini tetkik edin. Uygulamanızın kullanıcı arayüzü, yalnızca sağlayıcının desteklediği seçenekleri gösterebilir.
Kalıcı izinler
Uygulamanız okumak veya yazmak için bir dosya açtığında sistem, uygulamanıza bu dosya için kullanıcının cihazı yeniden başlatılana kadar süren bir URI izni verir. Bununla birlikte, uygulamanızın bir resim düzenleme uygulaması olduğunu ve kullanıcıların en son düzenledikleri 5 resme doğrudan uygulamanızdan erişmesini istediğinizi varsayalım. Kullanıcının cihazı yeniden başlatıldıysa, dosyaları bulması için kullanıcıyı sistem seçiciye geri göndermeniz gerekir.
Cihaz yeniden başlatmalarında dosyalara erişimi korumak ve daha iyi bir kullanıcı deneyimi oluşturmak için uygulamanız, aşağıdaki kod parçacığında gösterildiği gibi, sistemin sunduğu kalıcı URI iznini "alabilir":
// TakeFlags: integer; Intent := TJIntent.Create; TakeFlags := Intent.getFlags and (TJIntent.JavaClass.FLAG_GRANT_READ_URI_PERMISSION or TJIntent.JavaClass.FLAG_GRANT_WRITE_URI_PERMISSION); // En yeni veriyi tetkik et TAndroidHelper.Activity.getContentResolver.takePersistableUriPermission (Uri, TakeFlags);
Dikkat: takePersistableUriPermission çağırıldıktan sonra bile, ilişkili belge taşınır veya silinirse, uygulamanız URI'ye erişimi korumaz. Bu durumlarda, URI'ye yeniden erişim sağlamak için tekrar izin istemeniz gerekir.
Belge meta verilerini inceleyin
Bir belgenin URI'sine sahip olduğunuzda, onun meta verilerine erişim kazanırsınız. Bu kod parçacığı, URI tarafından belirtilen bir belgenin meta verilerini alır:
procedure GoruntuMetaVerisiDokumu(uri : JNet_Uri); (* dumpImageMetaData *)
// Sorgu, tek bir belgeye uygulandığı için, sadece tek satır döndürür.
// Alanları filtreleme, sıralama veya seçmeye ihtiyaç yoktur.
// Çünkü tüm alanları bir belge için istiyoruz.
var
displayName, size : JString;
sizeIndex : integer;
cursor : JCursor;
begin
cursor := TAndroidHelper.Activity.getContentResolver.query(uri,nil,nil,nil,nil,nil);
try
if (cursor<>nil) then
if (cursor.moveToFirst) then
begin
displayName := cursor.getString (cursor.getColumnIndex
(TJOpenableColumns.JavaClass.DISPLAY_NAME));
Memo1.Lines.Add({TAG.ToString +} 'Görünen Ad: ' +
JStringToString (displayName));
sizeIndex:=cursor.getColumnIndex(TJOpenableColumns.JavaClass.SIZE);
size := nil;
if not (cursor.isNull(sizeIndex)) then
size := cursor.getString(sizeIndex)
else
size:=StringToJString ('Bilinmiyor');
Memo1.Lines.Add({TAG.ToString +} 'Boyut: ' + JStringToString (size));
end;
finally
cursor.close;
end;
end;
Belge açın
Bir belgenin URI'sine referans vererek, daha sonraki işlemler için bir belge açabilirsiniz. Bu bölüm, bir bit eşlem ve bir giriş akışı açma örneklerini gösterir.
bit eşlem / bitmap
Aşağıdaki kod parçacığı, Bitmap URI'si verilen bir dosyanın nasıl açılacağını gösterir :
function UridenBiteslemAl (uri : JNet_Uri): JBitmap; (* getBitmapFromUri *)
var
fileDescriptor : JFileDescriptor;
parcelFileDescriptor : JParcelFileDescriptor;
image : JBitmap;
begin
Result := nil;
try
parcelFileDescriptor := TAndroidHelper.Activity
.getContentResolver.openFileDescriptor(uri,StringToJString('r'));
fileDescriptor := parcelFileDescriptor.getFileDescriptor;
image := TJBitmapFactory.JavaClass.decodeFileDescriptor(fileDescriptor);
parcelFileDescriptor.close;
result := image;
except
on E: Exception do
ShowMessage(e.Message);
end;
Not: Bu işlemi UI iş parçacığında değil arka plan iş parçacığında tamamlamanız gerekir.
Bitmap'i açtıktan sonra, onu bir ImageControl içinde gösterebilirsiniz.
Giriş akışı/ Inputstream
Aşağıdaki kod parçacığı, URI'si verilen bir InputStream nesnesinin nasıl açılacağını gösterir. Bu pasajda, dosyanın satırları bir dizgeye okunuyor:
function TForm1.MetinDosyasiOkuyucu(Uri : JNet_Uri): string; (* readTextFromUri *) const bufferSize = 4096*2; var inputStream : JInputStream; b : TJavaArray<Byte>; ms: TMemoryStream; sl: TStringList; bufflen: Integer; begin result := ''; try inputStream := TAndroidHelper.Context.getContentResolver.openInputStream(Uri); ms := TMemoryStream.Create; bufflen := inputStream.available; b := TJavaArray<Byte>.Create(bufflen); inputStream.read(b); ms.Write(b.Data^, bufflen); ms.position := 0; sl := TStringList.Create; sl.LoadFromStream(ms); result := sl.Text; sl.Free; b.Free; ms.Free; inputStream.Close; except on E: Exception do Application.ShowException(E); end; end;
Belge düzenleyin
Bir metin belgesini yerinde düzenlemek için Depolama Erişim Çerçevesini kullanabilirsiniz.
Not: DocumentFile sınıfının canWrite yöntemi uygulamanızın mutlaka bir belgeyi düzenleyebileceğini göstermez. Çünkü Document.COLUMN_FLAGS eğer FLAG_SUPPORTS_DELETE veya FLAG_SUPPORTS_WRITE içeriyorsa true döndürür. Uygulamanızın belirli bir belgeyi düzenleyip düzenleyemeyeceğini belirlemek için doğrudan FLAG_SUPPORTS_WRITE değerini sorgulayın.
Aşağıdaki kod parçacığı, verilen URI tarafından temsil edilen belgenin içeriğinin üzerine yazar:
procedure MetinBelgesiDegistir(uri : JNet_Uri); (* alterDocument *)
var
pfd : JParcelFileDescriptor;
fileOutputStream : JFileOutputStream;
begin
try
pfd := TAndroidHelper.Activity.getContentResolver
.openFileDescriptor(uri,StringToJString('w'));
fileOutputStream := TJFileOutputStream.JavaClass.init(pfd.getFileDescriptor);
fileOutputStream.write(StringToJString('Üzerine yazıldı ' + timetostr(Now)).getBytes);
fileOutputStream.close;
pfd.close;
except
on E: Exception do
ShowMessage(e.Message);
end;
end;
Bir belgeyi silin
Bir belge için URI'niz varsa ve belgenin Document.COLUMN_FLAGS içeriği SUPPORTS_DELETE varsa, belgeyi silebilirsiniz. Örneğin:
TJDocumentsContract.JavaClass.deleteDocument (TAndroidHelper.contentResolver, Uri);
Eşdeğer bir medya URI'si alın
getMediaUri yöntemi verilen belgeler sağlayıcısına URI'siyle eşdeğer bir medya deposu URI’si sağlar. 2 URI, aynı temel öğeye atıfta bulunur. Medya deposu URI'sini kullanarak, paylaşılan depodan medya dosyalarına daha kolay erişebilirsiniz.
Not: Bu yöntem herhangi bir yeni izin vermez. Uygulamanızın, belirli bir belge sağlayıcı URI'sine (ör. belgeyi açarak) erişmek için gerekli izinlere zaten sahip olması gerekir.
ExternalStorageProvider URI'leri getMediaUri yöntemini destekler. Android 12 (API düzeyi 31) ve sonraki sürümlerde, MediaDocumentsProvider URI'leri de bu yöntemi destekler.
Sanal bir dosya açın
Android 7.0 (API düzeyi 25) ve sonraki sürümlerde uygulamanız, Storage Access Framework'ün kullanıma sunduğu sanal dosyaları kullanabilir. Sanal dosyaların ikili gösterimi olmamasına rağmen, uygulamanız içeriklerini farklı bir dosya türüne zorlayarak veya ACTION_VIEW niyet eylemini kullanarak bu dosyaları görüntüleyerek açabilir.
Sanal dosyaları açmak için, istemci uygulamanızın bunları işlemek için özel bir mantık içermesi gerekir. Dosyanın bayt temsilini almak istiyorsanız, örneğin dosyayı önizlemek için, belge sağlayıcısından alternatif bir MIME türü talep etmeniz gerekir.
Not: Bir uygulama, openInputStream yöntemini kullanarak bir sanal dosyayı doğrudan açamayacağından, ACTION_OPEN_DOCUMENT veya ACTION_OPEN_DOCUMENT_TREE eylemi içeren niyeti oluştururken CATEGORY_OPENABLE kategorisini kullanmayın.
Kullanıcı bir seçim yaptıktan sonra, aşağıdaki kod parçacığında gösterildiği gibi, dosyanın sanal olup olmadığını belirlemek için sonuç verilerindeki URI'yi kullanın:
function SanalDosyami(Uri : JNet_Uri): boolean; (* isVirtualFile *) var flags : integer; cursor : JCursor; s : TJavaObjectArray<JString>; begin if (not TJDocumentsContract.JavaClass.isDocumentUri(TAndroidHelper.Context,Uri)) then begin result := false; exit; end; s := TJavaObjectArray<JString>.Create(0); s[0] := TJDocumentsContract_Document.JavaClass.COLUMN_FLAGS; cursor := TAndroidHelper.Activity.getContentResolver.query(uri,s,nil,nil,nil); flags:=0; if (cursor.moveToFirst) then flags:=cursor.getInt(0); cursor.close; result := (flags and TJDocumentsContract_Document.JavaClass.FLAG_VIRTUAL_DOCUMENT) <> 0; end;
Belgenin sanal bir dosya olduğunu doğruladıktan sonra, dosyayı "image/png" benzeri MIME türüne çevirebilirsiniz. Aşağıdaki kod parçacığı, bir sanal dosyanın bir görüntü olarak gösterilip gösterilmeyeceğinin nasıl kontrol edileceğini gösterir ve eğer öyleyse, sanal dosyadan bir girdi akışı alır:
function SanalDosyaIcinGirisAkisiAl(Uri : JNet_Uri; mimeTypeFilter : String): JInputStream;
var (* getInputStreamForVirtualFile *)
openableMimeTypes : TJavaObjectArray<JString>;
resolver : JContentResolver;
begin
resolver := TAndroidHelper.Activity.getContentResolver;
openableMimeTypes := resolver.getStreamTypes(uri,StringToJString(mimeTypeFilter));
if ((openableMimeTypes = nil) or (openableMimeTypes.Length < 1)) then
begin
Teblig('Dosya bulunamadı!');
result := nil;
exit;
end;
result := resolver.openTypedAssetFileDescriptor(uri,openableMimeTypes[0],nil)
.createInputStream;
end;
https://developer.android.com/training/d...ents-files
MediaStore API
MediaProvider ve uygulamalar arasındaki sözleşme sınıfıdır. Desteklenen URI'ler ve sütunlar için tanımları içerir.
Medya sağlayıcısı, herhangi bir bağlı depolama cihazlarındaki Audio, Video ve Images gibi yaygın medya tipleri için dizinlenmiş bir koleksiyon sağlar. Her koleksiyon, temel alınan içeriğin birincil MIME türüne göre düzenlenir; örneğin, image/* içeriği Images altındaki dizine eklenir. Files kolleksiyonu tüm koleksiyonlar boyunca geniş bir görünüm sağlar ve MIME türüne göre filtre uygulamaz.
createWriteRequest, createDeleteRequest, createTrashRequest, createFavoriteRequest sınıflarını kullanır.
https://developer.android.com/reference/...MediaStore
Medya dosyalarına paylaşılan depolama alanından erişin
Daha zenginleştirilmiş bir kullanıcı deneyimi sağlamak için birçok uygulama, kullanıcıların harici bir depolama biriminde bulunan medyaya katkıda bulunmasına ve bu medyaya erişmesine olanak tanır. Çerçeve, bu medya dosyalarının daha kolay alınmasına ve güncellenmesine izin veren, medya deposu adı verilen medya koleksiyonlarına optimize edilmiş bir dizin sağlar. Uygulamanızın yüklemesi kaldırıldıktan sonra bile bu dosyalar kullanıcının cihazında kalır.
Not: Uygulamanız, kullanıcıya yalnızca uygulamanız içinde değer sağlayan medya dosyaları ile çalışıyorsa, bunları harici depolama içindeki uygulamaya özel dizinlerde depolamak en iyisidir.
Medya deposu soyutlamasıyla etkileşim kurmak için, uygulamanızın bağlamından (context) aldığınız bir ContentResolver nesnesini kullanın:
var
projection, selectionArgs: TJavaObjectArray<JString>;
selection, sortOrder: JString;
cursor: JCursor;
begin
selection := where-şartı-bulunan-sql-seçme-değişkeni
projection := alınacak-medya-veritabanı-sütunları //TJavaObjectArray<JString>.Create(3);
//projection.Items[0] := TJAudio_AlbumColumns.JavaClass.ALBUM;
//projection.Items[1] := TJAudio_AlbumColumns.JavaClass.ARTIST;
//projection.Items[2] := StringToJString('_id');
selectionArgs := seçme-şartı-değişken-değerleri
sortOrder := order by-sıralama-şartı
cursor := MainActivity.getContentResolver.query(
TJAudio_Albums.JavaClass.EXTERNAL_CONTENT_URI,
projection,
selection,
selectionArgs,
sortOrder);
while (cursor.moveToNext) do
begin
// Projeksiyondan medya kalemini temsil eden bir URI almak için bir ID sütünü kullanın
end;
cursor.close;
end;
Sistem kendiliğinden harici bir depolama birimini tarar ve medya dosyalarını aşağıdaki iyi tanımlanmış koleksiyonlara ekler:
• Görüntüler fotoğraf ve ekran görüntüleri de dahil olmak üzere, DCIM/ve Pictures/dizinlerinde saklanır. Sistem bu dosyaları MediaStore.Images tablosuna ekler.
• Videolar DCIM/, Movies/, ve Pictures/ dizinlerinde saklanır. Sistem bu dosyaları MediaStore.Video tablosuna ekler.
• Ses dosyaları saklanır, Alarms/, Audiobooks/, Music/, Notifications/, Podcasts/, ve Ringtones/dizinleri. Ayrıca sistem, Music/veya Movies/dizinlerindeki ses çalma listelerini ve dizindeki ses kayıtlarını tanır Recordings/. Sistem bu dosyaları MediaStore.Audio tablosuna ekler. Kayıtlar dizini, Android 11 (API düzeyi 30) ve önceki sürümlerde kullanılamaz.
• İndirilen dosyalar Download dizininde depolanan Android 10 (API düzeyi 29) ve sonraki sürümleri çalıştıran cihazlarda bu dosyalar MediaStore.Downloads tabloda depolanır. Bu tablo, Android 9 (API düzeyi 28) ve daha düşük sürümlerde mevcut değildir.
Medya deposunda MediaStore.Files içeriği, uygulamanızın Android 10 veya sonraki sürümleri hedefleyen uygulamalarda bulunan kapsamlı depolama kullanıp kullanmadığına bağlıdır:
- Kapsamlı depolama etkinleştirilirse koleksiyon yalnızca uygulamanızın oluşturduğu fotoğrafları, videoları ve ses dosyalarını gösterir. Çoğu geliştiricinin
MediaStore.Files diğer uygulamalardan medya dosyalarını görüntülemek için kullanması gerekmez, ancak bunu yapmak için özel bir gereksiniminiz varsa,
READ_EXTERNAL_STORAGE izin beyan edebilirsiniz. Ancak uygulamanızın oluşturmadığı dosyaları açmak için MediaStore API'lerini kullanmanız önerilir.
- Kapsamlı depolama yoksa veya kullanılmıyorsa, koleksiyon her tür medya dosyasını gösterir.
Medya dosyaları üzerinde işlem yapmadan önce, uygulamanızın bu dosyalara erişmek için ihtiyaç duyduğu izinleri beyan ettiğinden emin olun. Ancak, uygulamanızın ihtiyaç duymadığı veya kullanmadığı izinleri beyan etmemesi gerektiğini unutmayın.
Depolama izni
Uygulamanızdaki medya dosyalarına erişmek için izin modeli, uygulamanızın Android 10 veya sonraki sürümleri hedefleyen uygulamalarda bulunan kapsamlı depolamayı kullanıp kullanmadığına bağlıdır.
Kapsamlı depolama etkinleştirilecek ise
Uygulamanız kapsamlı depolama kullanıyorsa, yalnızca Android 9 (API düzeyi 28) veya daha eski sürümleri çalıştıran cihazlar için depolamayla ilgili izinler istemelidir. Bu şartı, uygulamanızın bildirim dosyasındaki izin bildirimine android:maxSdkVersion özniteliği ekleyerek sağlayabilirsiniz :
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" android:maxSdkVersion="28" />
Android 10 veya sonraki sürümleri çalıştıran cihazlar için depolamayla ilgili izinleri gereksiz yere istemeyin. Uygulamanız, koleksiyon da dahil olmak üzere iyi tanımlanmış medya koleksiyonlarına MediaStore.Downloads depolamayla ilgili herhangi bir izin istemeden katkıda bulunabilir. Örneğin bir kamera uygulaması geliştiriyorsanız , medya deposuna yazdığınız görüntülerin sahibi uygulamanız olduğundan depolamayla ilgili izinler istemeniz gerekmez.
Diğer uygulamaların oluşturduğu dosyalara erişmek için aşağıdaki koşulların her birinin doğru olması gerekir:
- Uygulamanıza READ_EXTERNAL_STORAGE izin verilmiş olmalıdır.
- Dosyalar, aşağıdaki iyi tanımlanmış medya koleksiyonlarından birinde bulunmalıdır:
MediaStore.Video
MediaStore.Audio
Not: Bir dosya olarak MediaStore.Images, MediaStore.Videoya da MediaStore.Audio sorguları kullanarak görüntülenebilir olduğu gibi, MediaStore.Files sorgusu ile de görüntülenebilir.
ocuments/XXXXXX.pdf" diye bir yol çıkıyor sonra bu yolu kullanamıyorum.