• 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
  

• 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.
  

• Medya içeriği
  
• Belgeler ve diğer dosyalar
  
• Veritabanları
  

• 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.
  

• 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.
  

• 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.
  

• 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.
  

1. 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.
   
2. 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.
   
3. 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.
   

// 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 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;

  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;

• 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.
  

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;

  // 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);

  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;

  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;

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;

  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; 

TJDocumentsContract.JavaClass.deleteDocument (TAndroidHelper.contentResolver, Uri);

  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; 

  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;

  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; 

• 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.
  

<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"
                 android:maxSdkVersion="28" />

• Uygulamanıza READ_EXTERNAL_STORAGE izin verilmiş olmalıdır.
  
• Dosyalar, aşağıdaki iyi tanımlanmış medya koleksiyonlarından birinde bulunmalıdır:
  

• Query yöntemini çalışan bir iş parçacığında çağırın.
  
• Sütun dizinlerini önbelleğe alın, böylece  sorgu sonucundan bir satırı her işlediğinizde çağırmanız gerekmez.
  
• Kimliği, kod parçacığında gösterildiği gibi içerik URI'sine ekleyin.
  
• Android 10 ve sonraki sürümleri çalıştıran cihazlar, MediaStoreAPI'de tanımlanan sütun adlarını gerektirir. Uygulamanızdaki bağımlı bir kitaplık, API'de tanımsız bir sütun adı bekliyorsa, örneğin uygulamanızın işleminde sütun adını dinamik olarak çevirmek için CursorWrapper "MimeType" kullanın.
  

  // ParcelFileDescriptor kullanarak belli bir medya öğesini açın.
 procedure DosyaAc_FileDescriptor(Uri : JNet_Uri);
 var
   pfd : JParcelFileDescriptor;
   readOnlyMode : JString;
   resolver : JContentResolver;
 begin
   resolver := TAndroidHelper.Context.getContentResolver;
   // "r" salt okunur, "rw" oku-yaz
   // "rwt" mevcut dosya muhteviyatını kısaltma ve üzerine yazma.
   readOnlyMode := stringtoJString('r');
   try
     pfd := resolver.openFileDescriptor(Uri, readOnlyMode);
     // "pfd" üzerinde işlemler yapın.
     Memo1.Lines.Add(jstringtostring( pfd.toString));
   except
     on E: Exception do
       Application.ShowException(E);
   end;
 end;

// InputStream kullanarak belli bir medya öğesi açın.
 procedure DosyaAc_FileStream(Uri : JNet_Uri);
 var
   jis: JInputStream;
   resolver : JContentResolver;
 begin
   resolver := TAndroidHelper.Context.getContentResolver;
   try
     jis := resolver.openInputStream(Uri);
     // "jis" üzerinde işlemler yapın.
     Memo1.Lines.Add(jstringtostring( jis.toString));
   except
     on E: Exception do
       Application.ShowException(E);
   end;
 end;

1. Uygulamanızın bildiriminde ACCESS_MEDIA_LOCATION izni isteyin.
   

1. MediaStore (SDK seviyesi 29 ve sonrasında geçerli olan) setRequireOriginal nesnesi ile arayarak fotoğrafın tam baytları almak ve aşağıdaki kod parçacığında gösterildiği gibi, fotoğrafın URI’sine geçmek için:
   

• Dahili depolama için Android 11’de de fark yok. Android 10 ve öncesinde olduğu gibi, aynı şekilde dosyalara ulaşmak sınırsız. Yine izin gerekmiyor.
  
• Dosya paylaşma aynı şekilde, yani yine Content API (FileProvider) ve “Intent.setAction(TJIntent.JavaClass.ACTION_SEND);” niyeti ile çağırma şekli devam etmekte. FileProvider için Delphi 10.3 Rio’dan itibaren yerleşik gelen Project Options->Application->Entitlement List kısmındaki "Secure File Sharing" seçeneğini işaretlemeli, 10.3 önceki sürümlerinde ise Android’de Dosya Depolama ve Paylaşma > “Dosya paylaşımı için FileProvider kullanma” altında anlatıldığı şekilde ilave edilerek bu API kullanmaya devam edilmelidir.
  
• Android’de Dosya Depolama ve Paylaşma bulunan örnek projedeki (Android 10 SDK 29 veya altı hedeflendiğinde) çalışan harici depolama komutları, ör: “Memo1.Lines.SaveToFile(TPath.Combine(TPath.GetSharedDownloadsPath, 'memo1Harici.txt'));” Android 11 SDK 30’u hedeflendiği anda, aynı uygulamada “Cannot create file “(storage/emulated/0/Download/memo1Harici.txt”. Permission denied” hatası veriyor. “DeleteFile” komutu İndirilenler / GetSharedDownloadsPath altındaki dosyaları silmiyor. Bu durum sadece “Download” değil tüm Paylaşılan Harici klasörler için geçerli. Buların sebebi, yukarıdaki konularda bahsedildiği gibi, Android 11 kısıtlamaları.
  
• Android 10 öncesi ile Android 11 ile mecburi olan Kapsamlı Depolama sonrasındaki dosya kayıt depolama değişiklikleri ve güncel durum:
  

• “requestLegacyExternalStorage”  Kapsamlı Depolamadan çıkarılmış olup artık ulaşmak isteyen uygulamalar G.P.Store’da reddediliyor. Uygulamanızı yayınlamak istiyorsanız AndroidManifest.template.xml’de şu değişikliği yapınız:
  

android:requestLegacyExternalStorage="false">

• All Files Access API (ACTION_MANAGE_STORAGE), Google Play Store tarafından reddediliyor, ama bu izin varsa (ve uygulama yayınlanmayacaksa) Android 11 öncesinde olduğu gibi dosya okuyup kaydedebiliyor. Buna ihtiyaç duyarsanız “AndroidManifest.template.xml” altına <uses-permission android:name="android.permission.MANAGE_EXTERNAL_STORAGE" /> ekleyip, çalışma zamanında da “ACTION_MANAGE_APP_ALL_FILES_ACCESS_PERMISSION” izni isteyip ACTION_MANAGE_STORAGE intentini çağırmanız gerekiyor.
  
• Paylaşmalı Veritabanları / Databases BlobStoreManager API sadece Android 11 SDK 30 ve üstünde çalışıp, Android 10 ve önceki sürümlerde çalışmamakta, bugün için çok az cihaz desteklediği için incelemeye alınmadı.
  
• Paylaşmalı (harici) depolamaya SAF ve MediaStore ile ulaşma:
  

• URI Alma: Yukarıdaki eğitim kodlarından sadece ilk üçü olan Kullanma Vakaları örnekleri, hem dosya Uri’lerini hem de bunlara ulaşma izni almaktadır. OnActivityResult ile bunların eylemleri yakalanarak harici dosya URI’lerine ulaşma tanıtılmaktadır.
  
• Diğer örneklerin tümü ise bu 3 kullanma vakaları eylemleri ile elde edilen URI’ler ile nasıl işlem yapılacağını anlatmakta. Dosya Uri’sini bilmiyorsanız bunları kullanamıyorsunuz.
  
• Ayrıca eski ACTION_GET_CONTENT niyeti de, ACTION_OPEN_DOCUMENT’in benzeri şekilde, Sistem Seçiciyi çağırıp Uri almak için kullanılabilmektedir; fakat kalıcı ulaşma izni sağlamamaktadır.
  
• MediaStore.Files ile de medya depolamasındaki dosyaların Uri’si alınabilmektedir, fakat “Medya mağazasında ayrıca 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” ibaresinden dolayı bu konu muhteviyatına alınmadı. MediaStore.Downloads ve getMediaUri sınıfları da yine harici depolama dosya Uri’lerine ulaşmayı sağlasa da yalnızca SDK 29 ve üstü destek vermektedir.
  
• Eğer vaka kullanmadan, direk olarak bildiğiniz bir dosya Uri’sini (ör: content://com.android.providers.downloads.documents/documents/16874) herhangi kodla dosya üzerinde işlem yapmak isterseniz, “java.lang.SecurityException: Permission Denial: reading ... requires that you obtain access using ACTION_OPEN_DOCUMENT or related APIs” hata iletisi alıp, dosyaya ulaşamıyorsunuz.
  
• Özet olarak, Kapsamlı Depolamada harici depolama dosya kayıt uygulamaları, Uri darboğazında. Üstelik SDK 29 öncesi eski sürümleri kullanan piyasadaki Android cihazların tamamını kapsamak istiyorsanız, SAF kullanma vakaları kullanmak zorundasınız, bunların dışında çıkış yolu yok. Android Developer konferans, video, duyurularında Kapsamlı Depolamaya geçme amaçlarının gereksiz izinlerini kaldırmak olduğunu iddia ediyorlar, fakat gerçekte geliştiricileri ve kullanıcılar açısından tam tersi bir durum gerçekleşmiş durumda.
  
• Örnek kodlar (SAF eğitim konusundakilerin tümü ve MediaStore konusundakilerin çoğu) SDK seviyesi 1-24 arasında olup, Delphi 10.x sürümleri tarafından desteklenmektedir.
  
• SDK seviyeleri 29 ve 30 olan MediaStore’daki “Downloads”, “getMediaUri” sınıfları, Dosya küçük resimleri (thumbnails) yükleme > loadThumbnail, Mevcut bir koleksiyona medya öğesi eklemek / Add an item > VOLUME_EXTERNAL_PRIMARY, Medya dosyaları bekleme durumunu yenileme / Toggle pending status for media files > IS_PENDING flag, Başka uygulamaların medya dosyalarının güncellenmesi / Update other apps' media files > RecoverableSecurityException, - Medya dosya gruplarını yönetin / Manage groups of media files > createWriteRequest createTrashRequest createFavoriteRequest” için Delphi 11 gereklidir.
  
• Dosya paylaşma için, harici klasörde ise yine önce önce Uri alıp, dahili klasöre kopyalamalısınız. Kopyalamak için de Akış (JInputStream, JFileOutputStream) komutlarını kullanmanız gerekmektedir. SAF ile alınmış Uri varsa Harici depolamada; yeni dosya açma, okuma, kaydetme, kopyalama amaçları için kullanabilirsiniz. Akışlar Sistem Dosya Seçiciyi açmaz.
  
• Harici Depolama İçin Yürürlükten Kalkanlar:
  

// HariciDosya := TPath.Combine(TPath.GetSharedDownloadsPath,'delphican.txt');
Memo1.Lines.SaveToFile(HariciDosya);
TFile.Copy(DahiliDosya, HariciDosya);
DeleteFile(HariciDosya);
Uri := TJnet_Uri.JavaClass.fromFile(TJFile.JavaClass.init(StringToJString(HariciDosya)));
Uri := TJnet_Uri.JavaClass.parse(StringToJString('file:///' + HariciDosya));
JinputStream1 := TJFileInputStream.JavaClass.init(StringToJString(HariciDosya));
Uri := TJFileProvider.JavaClass.getUriForFile(TAndroidHelper.Context,  
    LAuthority, TJFile.JavaClass.init(StringToJString(HariciDosya)));
Intent := TJFileProvider.JavaClass.getUriForFile(TJnet_Uri.JavaClass.fromFile
   (TJFile.JavaClass.init(StringToJString(HariciDosya))));
Uri := TAndroidHelper.JFileToJURI (TJFile.JavaClass.init(StringToJString(dosya)));
Uri := TJFileProvider.JavaClass.getUriForFile(Context, LAuthority, AFile);

• Özetle tüm File, Content, FileProvider eylem ve niyetleri ile Harici dizinlere (scoped / depreciated) ulaşılamıyor.
  (Not: ACTION_OPEN_DOCUMENT_TREE ile dosyanın bulunduğu dizine ulaşma izni alınırsa, bu komutlarla ulaşılabilir, fakat bu niyet Delphi 10’da çalışmadığı için denenemedi.)
  

• Depolama Erişimi Çerçevesi / Storage Access Framework SAF kullanmak için Project -> Uses Permissions altından herhangi bir İzin gerekmemektedir, hepsi kapatılabilir. Proje içinden de “PermissionsService.RequestPermissions” vs. ile herhangi bir İzin çağrılmadan kullanılabilir. Örnek projedeki tüm izinler kapatılmıştır.
  

• SAF ile dosyalara ulaşmak için sadece Kullanma Vakaları (ACTION_CREATE_DOCUMENT, ACTION_OPEN_DOCUMENT, ACTION_OPEN_DOCUMENT_TREE) niyetlerini çağırmak kâfidir. Yalnız bunların herbiri, eski TFile.Copy’den farklı olarak, Sistem Seçici / System Picker arabirimini açmaktadır.
  

• ACTION _CREATE_DOCUMENT farklı kaydet benzeri bir arabirim ile yeni dosya kaydetmek için,  ACTION_OPEN_DOCUMENT ise mevcut dosyaları açıp, göstermek, değiştirmek için kullanılır. ACTION_OPEN_DOCUMENT_TREE sadece dizinlere değil altındaki tüm dosyalara da ulaşma amaçlıdır.
  

• SAF kullanırken AndroidManifest.template.xml içinde intent-filter kısmı Delphi ile hazır halde geliyor, başka niyet eklemeye lüzum yok.
  

            <intent-filter>  
                <action android:name="android.intent.action.MAIN" />
                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>

• SAF Durum Vakaları; tüm Delphi 10 sürümleri ile yerleşik geldiği için, SDK 30’u hedefleyen Delphi projelerinde sadece gerekli Android kütüphaneleri ve örnek kodlar ile çağırılarak, hemen kullanılabilir durumdadır.
  

• Medya deposu / MediaStore ile ses, görüntü, video dosyalarına ve sürüm 11 üstünde İndirilenlere yazma sınırlandırılmamıştır: Ör. Resmi izinsiz olarak kaydedebilirsiniz.
  

• Media kolleksiyonları sadece İzin ile okunabilir.
  

• Görüntü konum verisi için ACCESS_MEDIA_LOCATION gereklidir.
  
• PDF, metin, vb. dosyalara ulaşmak “Sistem Seçici” System Picker ile mümkündür.
  
• Kolleksiyon dışında okuma yazma için “Sistem Seçici” gereklidir.
  
• Project -> Uses Permissions altında WRITE_EXTERNAL_STORAGE seçeneği SDK 29 üstünde kapatılmalıdır. READ_EXTERNAL_STORAGE okuma için gereklidir.
  
• MediaStore Uri sınıfları, SDK 29 üstündeki dosyalara ulaşma amacıyla için çıkarıldığı için, Delphi 11 öncesi kütüphanelerinde mevcut değil. Dolayısıyla yukarıdaki MediaStore eğitim kodlarının çoğu sadece Java’dan Object Pascal’a aktarılamadı.
  
• Çalışma zamanında da cihazın SDK seviyesine bakılarak, (SDK<28) yazma izni istenmeli veya (SDK>=29) için istenmemelidir.
  
• AndroidManifest.template.xml Değişiklikleri :
  

<uses-sdk android:minSdkVersion="%minSdkVersion%" android:targetSdkVersion="30" />
android:requestLegacyExternalStorage="false">

• MediaStore’da da harici depolamada okuma izni gerekiyor, yazma izni gerekmiyor. Android 10 öncesi sürümlerle uyumluluk için Project -> Uses Permissions altında WRITE_EXTERNAL_STORAGE seçeneğini kaldırıp, Manifest’te şunu ekleyiniz:   

<%uses-permission%>
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"
   android:maxSdkVersion="28" />

• Dosya kopyalama artık harici depolamadan tek komutla (TFile.Copy) gerçekleştirilemiyor. Önce Kullanma Vaka (ACTION_OPEN_DOCUMENT veya ACTION_CREATE_DOCUMENT) niyetini çağırıyoruz.  Sonra “IletiFaaliyetiYakala” ve “OnActivityResult” ile talep kodunu yakalıyoruz. En son Uri ve akışlar (JInputStream, JFileOutputStream) ile yeni açtığımız dosyaya yazıyoruz.
  
• Örnek proje içerisindeki bazı kısımlar çalışmayabilir. Delphi ve Android sürümleri ile bildirilirse ileride güncellenebilir. Hepimize faydalı olması dileği ile..
  

• Dosya paylaşma

procedure TForm1.ButtonDosyaPaylasinClick(Sender: TObject);
var
  Intent: JIntent;
  mime: JMimeTypeMap;
  ExtToMime: JString;
  ExtFile: string;
  Dosya: string;
begin
  Dosya := DosyaAdi(UriCan);
  ExtFile := AnsiLowerCase(StringReplace(TPath.GetExtension(Dosya),
    '.', '', []));
  mime := TJMimeTypeMap.JavaClass.getSingleton();
  ExtToMime := mime.getMimeTypeFromExtension(StringToJString(ExtFile));
  Intent := TJIntent.Create;
  Intent.setAction(TJIntent.JavaClass.ACTION_SEND);
  Intent.setDataAndType(UriCan, ExtToMime);
  Intent.putExtra(TJIntent.JavaClass.EXTRA_STREAM, JParcelable(UriCan));
  Intent.addFlags(TJIntent.JavaClass.FLAG_GRANT_READ_URI_PERMISSION);
  TAndroidHelper.Activity.startActivity(TJIntent.JavaClass.createChooser(Intent,
    StrToJCharSequence('Paylaş Bakalım: ')));
end;

• Dosya kopyalayın Dahili -> Harici

procedure TForm1.ButtonDosyaKopyalayinDahilidenHariciyeClick(Sender: TObject);
(* TFile.Copy(TPath.Combine(TPath.GetDocumentsPath, 'delphican.pdf'),
  TPath.Combine(TPath.GetSharedDownloadsPath, 'delphican.pdf')); *)
  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(TPath.GetFileName(DosyaKopyalanan)));
    Intent.putExtra(TJDocumentsContract.JavaClass.EXTRA_INITIAL_URI,
      JParcelable(seciciBaslangicUri));
    MainActivity.startActivityForResult(Intent,
      Dosya_Kopyala_Dahiliden_Hariciye);
  end;
begin
  DosyaKopyalanan := TPath.Combine(TPath.GetDocumentsPath, 'delphican.pdf');
  PdfDosyasiOlustur(nil);
end;
 
procedure TForm1.DosyaKopyalaci_DahilidenHariciye(Dosya: string);
const
  bufferSize = 4096 * 2;
var
  noOfBytes: Integer;
  b: TJavaArray<Byte>;
  DosyaOku: JInputStream;
  DosyaYaz: JFileOutputStream;
  pfd: JParcelFileDescriptor;
begin
  if not FileExists(Dosya) then
  begin
    Teblig(Dosya + ' bulunamadı!');
    exit;
  end;
  try
    DosyaOku := TAndroidHelper.Context.getContentResolver.openInputStream
      (TJnet_Uri.JavaClass.fromFile(TJFile.JavaClass.init
      (StringToJString(Dosya))));
    pfd := TAndroidHelper.Activity.getContentResolver.openFileDescriptor(UriCan,
      StringToJString('w'));
    DosyaYaz := TJFileOutputStream.JavaClass.init(pfd.getFileDescriptor);
    b := TJavaArray<Byte>.Create(bufferSize);
    noOfBytes := DosyaOku.read(b);
    while (noOfBytes > 0) do
    begin
      DosyaYaz.write(b, 0, noOfBytes);
      noOfBytes := DosyaOku.read(b);
    end;
    DosyaYaz.close;
    DosyaOku.close;
  except
    on E: Exception do
      Application.ShowException(E);
  end;
end;

• Dosya kopyalayın Harici -> Dahili

procedure TForm1.ButtonDosyaKopyalayinHaricidenDahiliyeClick(Sender: TObject);
(* TFile.Copy(TPath.Combine(TPath.GetSharedDownloadsPath, 'delphican.pdf'),
  TPath.Combine(TPath.GetPublicPath, 'delphican.pdf')); *)
var
  Intent: JIntent;
begin
  Intent := TJIntent.Create;
  Intent.setAction(TJIntent.JavaClass.ACTION_OPEN_DOCUMENT);
  Intent.addCategory(TJIntent.JavaClass.CATEGORY_OPENABLE);
  Intent.setType(StringToJString('*/*'));
  TAndroidHelper.Activity.startActivityForResult(Intent,
    Dosya_Kopyala_Hariciden_Dahiliye);
end;
 
procedure TForm1.DosyaKopyalaci_HaricidenDahiliye;
const
  bufferSize = 4096 * 2;
var
  noOfBytes: Integer;
  b: TJavaArray<Byte>;
  DosyaOku: JInputStream;
  DosyaYaz: JFileOutputStream;
  Dosya: string;
begin
  try
    Dosya := TPath.Combine(TPath.GetPublicPath, DosyaAdi(UriCan));
    if FileExists(Dosya) then
    begin
      Teblig('"' + Dosya + '" zaten mevcut!');
      exit;
    end;
    DosyaYaz := TJFileOutputStream.JavaClass.init(StringToJString(Dosya));
    DosyaOku := TAndroidHelper.Context.getContentResolver.
      openInputStream(UriCan);
    b := TJavaArray<Byte>.Create(bufferSize);
    noOfBytes := DosyaOku.read(b);
    while (noOfBytes > 0) do
    begin
      DosyaYaz.write(b, 0, noOfBytes);
      noOfBytes := DosyaOku.read(b);
    end;
    DosyaYaz.close;
    DosyaOku.close;
  except
    on E: Exception do
      Application.ShowException(E);
  end;
end;

var
Intent: JIntent;
begin
Intent := TJIntent.Create;
Intent.setAction(TJIntent.JavaClass.ACTION_OPEN_DOCUMENT);  // ACTION_GET_CONTENT);
Intent.addCategory(TJIntent.JavaClass.CATEGORY_OPENABLE);
Intent.setType(StringToJString('*/*'));
TAndroidHelper.Activity.startActivityForResult(Intent, 77);
End;



procedure OnActivityResult(RequestCode, ResultCode: Integer;
 Data: JIntent);
var
 Uri: JNet_Uri;
 Ad: string;
 AItem: TSkinListViewItem;
 UriString: JString;
begin

 if ResultCode = TJActivity.JavaClass.RESULT_OK then
 begin
 Uri := nil;

 ad:='';
   if Assigned(Data) then
   begin
     if (Data = nil) then
     begin
       exit;
     end;
     Uri := Data.getData;
     Ad := jstringtostring(Uri.getPath);// gerçek dosya adı
     if RequestCode = 77 then
     begin
        // kayıt       
     end;
   end;
 end;
end;

function TForm1.DosyaAdi(Uri: JNet_Uri): string;
var
 C: JCursor;
 I: integer;
begin
 C := TAndroidHelper.Activity.getContentResolver.query(Uri, nil,
   StringToJString(''), nil, StringToJString(''));
 C.moveToFirst;
 Result := '';
 for I := 0 to C.getColumnCount - 1 do
 begin
   if JStringToString(C.getColumnName(I)) = 'document_id' then
   begin
     Result  := JStringToString(C.getString(I));
     Break;
   end;
 end;
 Result := StringReplace(Result, 'primary:', '', [rfReplaceAll]);
end;