Uygulamalar için Otomatik Yedekleme, Android 6.0 (API düzeyi 23) veya sonraki sürümleri hedefleyen ve bu sürümlerde çalışan uygulamalardaki kullanıcı verilerini otomatik olarak yedekler. Android, uygulama verilerini kullanıcının Google Drive'ına yükleyerek korur. Bu veriler, kullanıcının Google Hesabı kimlik bilgileriyle korunur. Yedekleme, Android 9 veya sonraki sürümlerin yüklü olduğu cihazlarda cihazın PIN'i, deseni veya şifresi kullanılarak uçtan uca şifrelenir. Her uygulama, uygulama kullanıcısı başına en fazla 25 MB yedekleme verisi ayırabilir. Yedekleme verilerini depolamak için ücret alınmaz. Uygulamanız, yedekleme işlemini özelleştirebilir veya yedeklemeleri devre dışı bırakarak kapsam dışında kalmayı seçebilir.
Android'in yedekleme seçeneklerine genel bakış ve hangi verilerin yedeklenip geri yükleneceğiyle ilgili rehberlik için veri yedeklemeye genel bakış bölümünü inceleyin.
Yedeklenen dosyalar
Varsayılan olarak Otomatik Yedekleme, sistem tarafından uygulamanıza atanan dizinlerin çoğundaki dosyaları içerir:
Paylaşılan tercih dosyaları
Uygulamanızın dahili depolama alanına kaydedilen ve
getFilesDir()veyagetDir(String, int)tarafından erişilen dosyalargetDatabasePath(String)tarafından döndürülen dizindeki dosyalar (SQLiteOpenHelpersınıfıyla oluşturulan dosyalar da dahildir)getExternalFilesDir(String)tarafından döndürülen dizindeki harici depolama alanında bulunan dosyalar
Otomatik Yedekleme; getCacheDir(), getCodeCacheDir() ve getNoBackupFilesDir() tarafından döndürülen dizinlerdeki dosyaları hariç tutar. Bu konumlara kaydedilen dosyalar yalnızca geçici olarak gereklidir ve yedekleme işlemlerinden kasıtlı olarak hariç tutulur.
Uygulamanızı belirli dosyaları dahil edecek ve hariç tutacak şekilde yapılandırabilirsiniz. Daha fazla bilgi için Dosyaları dahil etme ve hariç tutma bölümüne bakın.
Yedek konumu
Yedekleme verileri, kullanıcının Google Drive hesabındaki özel bir klasörde depolanır ve uygulama başına 25 MB ile sınırlıdır. Kaydedilen veriler, kullanıcının kişisel Google Drive kotasından düşülmez. Yalnızca en son yedekleme saklanır. Yedekleme yapıldığında önceki yedekler silinir. Yedekleme verileri, kullanıcı veya cihazdaki diğer uygulamalar tarafından okunamaz.
Kullanıcılar, Google Drive Android uygulamasında yedeklenen uygulamaların listesini görebilir. Android destekli bir cihazda kullanıcılar bu listeyi Drive uygulamasının gezinme çekmecesinde Ayarlar > Yedekleme ve sıfırlama bölümünde bulabilir.
Her cihaz kurulumu kullanım ömrüne ait yedekler, aşağıdaki örneklerde açıklandığı gibi ayrı veri kümelerinde depolanır:
Kullanıcının iki cihazı varsa her cihaz için bir yedek veri kümesi bulunur.
Kullanıcı bir cihazı fabrika ayarlarına sıfırlayıp aynı hesapla kurarsa yedek, yeni bir veri kümesinde depolanır. Eski veri kümeleri, belirli bir süre işlem yapılmadığında otomatik olarak silinir.
Yedekleme programı
Aşağıdaki koşulların tümü karşılandığında yedeklemeler otomatik olarak gerçekleşir:
- Kullanıcı, cihazda yedeklemeyi etkinleştirmiştir. Android 9'da bu ayar Ayarlar > Sistem > Yedekleme bölümündedir.
- Son yedeklemenin üzerinden en az 24 saat geçmiş olmalıdır.
- Cihaz boştadır.
- Cihaz bir kablosuz ağa bağlıysa (cihaz kullanıcısı mobil veri yedeklemelerini etkinleştirmediyse)
Uygulamada bu koşullar her gece gerçekleşir ancak bir cihaz hiçbir zaman yedeklenmeyebilir (örneğin, hiçbir zaman ağa bağlanmıyorsa). Ağ bant genişliğinden tasarruf etmek için yükleme yalnızca uygulama verileri değiştiğinde gerçekleşir.
Otomatik yedekleme sırasında sistem, uygulamayı kapatarak dosya sistemine yazma işlemini durdurur. Varsayılan olarak, yedekleme sistemi kötü bir kullanıcı deneyimini önlemek için ön planda çalışan uygulamaları yoksayar. android:backupInForeground özelliğini true olarak ayarlayarak varsayılan davranışı geçersiz kılabilirsiniz.
Android, test sürecini basitleştirmek için uygulamanızın yedeklemesini manuel olarak başlatmanıza olanak tanıyan araçlar içerir. Daha fazla bilgi için Yedekleme ve geri yüklemeyi test etme başlıklı makaleyi inceleyin.
Programı geri yükle
Uygulama her yüklendiğinde (Play Store'dan, cihaz kurulumu sırasında sistem daha önce yüklenmiş uygulamaları yüklerken veya adb install komutu çalıştırılarak) veriler geri yüklenir. Geri yükleme işlemi, APK yüklendikten sonra ancak uygulama kullanıcı tarafından başlatılmadan önce gerçekleşir.
İlk cihaz kurulum sihirbazı sırasında kullanıcıya mevcut yedek veri kümelerinin bir listesi gösterilir ve hangi veri kümesinden veri geri yüklemek istediği sorulur. Seçilen yedekleme veri kümesi, cihazın üst veri kümesi olur. Cihaz, kendi yedeklerinden veya üst veri kümesinden geri yükleme yapabilir. Her iki kaynaktan da yedekleme varsa cihaz kendi yedeklemesine öncelik verir. Kullanıcı cihaz kurulum sihirbazını kullanmadıysa cihaz yalnızca kendi yedeklerinden geri yükleme yapabilir.
Android, test sürecini basitleştirmek için uygulamanızın geri yükleme işlemini manuel olarak başlatmanıza olanak tanıyan araçlar içerir. Daha fazla bilgi için Yedekleme ve geri yüklemeyi test etme başlıklı makaleyi inceleyin.
Yedeklemeyi etkinleştirme ve devre dışı bırakma
Android 6.0 (API düzeyi 23) veya sonraki sürümleri hedefleyen uygulamalar otomatik olarak Otomatik Yedekleme'ye katılır. Yedeklemeyi etkinleştirmek veya devre dışı bırakmak için uygulama manifest dosyanızda boole değerini android:allowBackup olarak ayarlayın. Varsayılan değer true olsa da aşağıdaki örnekte gösterildiği gibi özelliği manifest dosyanızda açıkça ayarlamanızı öneririz:
<manifest ... >
...
<application android:allowBackup="true" ... >
...
</application>
</manifest>
android:allowBackup değerini false olarak ayarlayarak yedeklemeleri devre dışı bırakabilirsiniz. Uygulamanız, durumunu başka bir mekanizma aracılığıyla yeniden oluşturabiliyorsa veya hassas bilgilerle çalışıyorsa bu yöntemi kullanabilirsiniz.
Dosyaları dahil etme ve hariç tutma
Sistem, varsayılan olarak neredeyse tüm uygulama verilerini yedekler. Daha fazla bilgi için yedeklenen dosyalar ile ilgili bölüme bakın.
Aktarım türüne göre yedeklemeye hangi verilerin dahil edileceğini kontrol edebilirsiniz.
Otomatik Yedekleme, Google Drive'a bulut yedeklemelerini ve doğrudan cihazdan cihaza (D2D) aktarımları destekler. Yapılandırma yöntemleri, Android sürümüne ve uygulamanızın targetSdkVersion değerine göre değişiklik gösterir.
- Android 11 veya daha eski sürümleri çalıştıran cihazlar için Android 11 ve daha eski sürümlerde yedeklemeyi kontrol etme başlıklı makaleyi inceleyin.
- Android 12 veya sonraki sürümlerin yüklü olduğu cihazlarda, API düzeyi 31 ve sonraki sürümleri hedefleyen uygulamalar
data-extraction-rulesbiçimini kullanır. Ayrıntılar için Android 12 veya sonraki sürümlerde yedeklemeyi kontrol etme başlıklı makaleyi inceleyin. data-extraction-rulesbiçimi, platformlar arası aktarımları da (ör. iOS'e) destekler. Bu özellik Android 16 QPR2'den itibaren kullanılabilir. Daha fazla bilgi için Platformlar arası aktarımları yapılandırma başlıklı makaleyi inceleyin.
Android 11 ve önceki sürümlerde yedeklemeyi kontrol etme
Android 11 (API düzeyi 30) veya daha eski sürümleri çalıştıran cihazlarda hangi dosyaların yedekleneceğini kontrol etmek için bu bölümdeki adımları uygulayın.
AndroidManifest.xmldosyanızda, aşağıdaki örnekte gösterildiği gibi<application>öğesineandroid:fullBackupContentözelliğini ekleyin. Bu özellik, yedekleme kurallarını içeren bir XML dosyasına işaret eder.<application ... android:fullBackupContent="@xml/backup_rules"> </application>res/xml/dizininde@xml/backup_rulesadlı bir XML dosyası oluşturun. Bu dosyada,<include>ve<exclude>öğelerini içeren reklam kuralları ekleyin. Aşağıdaki örnekte,device.xmlhariç tüm paylaşılan tercihler yedeklenmektedir:<?xml version="1.0" encoding="utf-8"?> <full-backup-content> <include domain="sharedpref" path="."/> <exclude domain="sharedpref" path="device.xml"/> </full-backup-content>
Yedekleme için gereken cihaz koşullarını tanımlama
Uygulamanız cihazda hassas bilgiler kaydediyorsa uygulama verilerinizin kullanıcının yedeklemesine dahil edileceği koşulları belirtebilirsiniz. Android 9 (API düzeyi 28) veya sonraki sürümlerde aşağıdaki koşulları ekleyebilirsiniz:
clientSideEncryption: Kullanıcının yedeği, istemci tarafı gizli anahtarıyla şifrelenmiştir. Bu şifreleme biçimi, kullanıcının Android 9 veya sonraki sürümlerde yedeklemeyi etkinleştirmesi ve cihazı için ekran kilidi ayarlaması (PIN, desen veya şifre) koşuluyla Android 9 veya sonraki sürümlerin yüklü olduğu cihazlarda etkinleştirilir.deviceToDeviceTransfer: Kullanıcı, yedeğini yerel cihazlar arası aktarımı destekleyen başka bir cihaza (ör. Google Pixel) aktarıyor.
Geliştirme cihazlarınızı Android 9'a yükselttiyseniz yükseltme işleminden sonra veri yedeklemeyi devre dışı bırakıp yeniden etkinleştirmeniz gerekir. Bunun nedeni, Android'in yedeklemeleri yalnızca Ayarlar'da veya kurulum sihirbazında kullanıcıları bilgilendirdikten sonra istemci tarafı gizli anahtarla şifrelemesidir.
Dahil etme koşullarını bildirmek için yedekleme kuralları grubunuzdaki <include> öğelerinde requireFlags özelliğini seçilen bir değere veya değerlere ayarlayın:
backup_rules.xml
<?xml version="1.0" encoding="utf-8"?>
<full-backup-content>
<!-- App data isn't included in user's backup
unless client-side encryption is enabled. -->
<include domain="file" path="."
requireFlags="clientSideEncryption" />
</full-backup-content>
Uygulamanızda anahtar/değer yedekleme sistemi kullanılıyorsa veya BackupAgent'yi kendiniz uyguluyorsanız BackupDataOutput nesnesinin taşıma işaretleri grubu ile özel yedekleme aracınızın FLAG_CLIENT_SIDE_ENCRYPTION_ENABLED veya FLAG_DEVICE_TO_DEVICE_TRANSFER işaretleri arasında bit düzeyinde karşılaştırma yaparak bu koşullu şartları yedekleme mantığınıza da uygulayabilirsiniz.
Aşağıdaki kod snippet'inde bu yöntemin örnek bir kullanımı gösterilmektedir:
Kotlin
class CustomBackupAgent : BackupAgent() {
override fun onBackup(
oldState: ParcelFileDescriptor?,
data: BackupDataOutput?,
newState: ParcelFileDescriptor?
) {
if (data != null) {
if ((data.transportFlags and
FLAG_CLIENT_SIDE_ENCRYPTION_ENABLED) != 0) {
// Client-side backup encryption is enabled.
}
if ((data.transportFlags and FLAG_DEVICE_TO_DEVICE_TRANSFER) != 0) {
// Local device-to-device transfer is enabled.
}
}
}
// Implementation of onRestore() here.
}
Java
public class CustomBackupAgent extends BackupAgent {
@Override
public void onBackup(
ParcelFileDescriptor oldState,
BackupDataOutput data,
ParcelFileDescriptor newState
) throws IOException {
if ((data.getTransportFlags() &
FLAG_CLIENT_SIDE_ENCRYPTION_ENABLED) != 0) {
// Client-side backup encryption is enabled.
}
if ((data.getTransportFlags() &
FLAG_DEVICE_TO_DEVICE_TRANSFER) != 0) {
// Local device-to-device transfer is enabled.
}
}
// Implementation of onRestore() here.
}
Android 12 veya sonraki sürümlerde yedeklemeyi kontrol etme
Uygulamanız Android 12 (API düzeyi 31) veya sonraki sürümleri hedefliyorsa Android 12 ya da sonraki sürümleri çalıştıran cihazlarda hangi dosyaların yedekleneceğini kontrol etmek için bu bölümdeki adımları uygulayın.
AndroidManifest.xmldosyanızda, aşağıdaki örnekte gösterildiği gibi<application>öğesineandroid:dataExtractionRulesözelliğini ekleyin. Bu özellik, yedekleme kurallarını içeren bir XML dosyasına işaret eder.<application ... android:dataExtractionRules="backup_rules.xml"> </application>res/xml/dizinindebackup_rules.xmladlı bir XML dosyası oluşturun. Bu dosyada,<include>ve<exclude>öğelerini içeren reklam kuralları ekleyin. Aşağıdaki örnekte,device.xmlhariç tüm paylaşılan tercihler yedeklenmektedir:<?xml version="1.0" encoding="utf-8"?> <data-extraction-rules> <cloud-backup [disableIfNoEncryptionCapabilities="true|false"]> <include domain="sharedpref" path="."/> <exclude domain="sharedpref" path="device.xml"/> </cloud-backup> </data-extraction-rules>
XML yapılandırma söz dizimi
Yapılandırma dosyasının XML söz dizimi, uygulamanızın hedeflediği ve çalıştığı Android sürümüne göre değişir.
Android 11 veya önceki sürümler
Android 11 veya daha eski sürümleri çalıştıran cihazlarda yedeklemeyi kontrol eden yapılandırma dosyası için aşağıdaki XML söz dizimini kullanın.
<full-backup-content>
<include domain=["file" | "database" | "sharedpref" | "external" |
"root" | "device_file" | "device_database" |
"device_sharedpref" | "device_root" ] path="string"
requireFlags=["clientSideEncryption" | "deviceToDeviceTransfer"] />
<exclude domain=["file" | "database" | "sharedpref" | "external" |
"root" | "device_file" | "device_database" |
"device_sharedpref" | "device_root" ] path="string" />
</full-backup-content>
Android 12 veya sonraki sürümler
Uygulamanız Android 12 (API düzeyi 31) veya sonraki sürümleri hedefliyorsa Android 12 veya sonraki sürümleri çalıştıran cihazlarda yedeklemeyi kontrol eden yapılandırma dosyası için aşağıdaki XML söz dizimini kullanın.
<data-extraction-rules>
<cloud-backup [disableIfNoEncryptionCapabilities="true|false"]>
...
<include domain=["file" | "database" | "sharedpref" | "external" |
"root" | "device_file" | "device_database" |
"device_sharedpref" | "device_root" ] path="string"/>
...
<exclude domain=["file" | "database" | "sharedpref" | "external" |
"root" | "device_file" | "device_database" |
"device_sharedpref" | "device_root" ] path="string"/>
...
</cloud-backup>
<device-transfer>
...
<include domain=["file" | "database" | "sharedpref" | "external" |
"root" | "device_file" | "device_database" |
"device_sharedpref" | "device_root" ] path="string"/>
...
<exclude domain=["file" | "database" | "sharedpref" | "external" |
"root" | "device_file" | "device_database" |
"device_sharedpref" | "device_root" ] path="string"/>
...
</device-transfer>
<cross-platform-transfer platform="ios">
...
<include domain=["file" | "database" | "sharedpref" | "external" |
"root" | "device_file" | "device_database" |
"device_sharedpref" | "device_root" ] path="string"/>
...
<exclude domain=["file" | "database" | "sharedpref" | "external" |
"root" | "device_file" | "device_database" |
"device_sharedpref" | "device_root" ] path="string"/>
...
<platform-specific-params bundleId="string" teamId="string" contentVersion="string"/>
...
</cross-platform-transfer>
</data-extraction-rules>
Yapılandırmanın her bölümü (<cloud-backup>, <device-transfer>, <cross-platform-transfer>) yalnızca ilgili aktarım türü için geçerli olan kurallar içerir. Bu ayrım sayesinde, örneğin bir dosyayı veya dizini Google Drive yedeklemelerinden hariç tutarken cihazdan cihaza (D2D) aktarımlar veya platformlar arası aktarımlar sırasında aktarmaya devam edebilirsiniz. Bu özellik, buluta yedeklenemeyecek kadar büyük olan ancak cihazlar arasında sorunsuz bir şekilde aktarılabilen dosyalarınız varsa kullanışlıdır.
Belirli bir yedekleme modu için kural yoksa (ör. <device-transfer> bölümü eksikse) bu mod, Yedeklenen dosyalar bölümünde açıklandığı gibi no-backup ve cache dizinleri hariç tüm içerikler için tamamen etkinleştirilir.
Uygulamanız, yedeklemenin yalnızca şifrelenebildiği durumlarda (ör. kullanıcının kilit ekranı olduğunda) gerçekleşmesini sağlamak için <cloud-backup> bölümünde disableIfNoEncryptionCapabilities işaretini ayarlayabilir. Bu kısıtlama ayarlandığında, kullanıcının cihazı şifrelemeyi desteklemiyorsa yedeklerin buluta gönderilmesi durdurulur. Ancak cihazdan cihaza aktarımlar sunucuya gönderilmediği için şifrelemeyi desteklemeyen cihazlarda bile çalışmaya devam eder.
Dahil etme ve hariç tutma öğelerinin söz dizimi
<full-backup-content>, <cloud-backup> ve <device-transfer> etiketlerinin içinde (cihazın Android sürümüne ve uygulamanızın targetSDKVersion değerine bağlı olarak) <include> ve <exclude> öğelerini tanımlayabilirsiniz:
<include>Yedeklenecek dosya veya klasörü belirtir. Varsayılan olarak otomatik yedekleme, neredeyse tüm uygulama dosyalarını içerir. Bir
<include>öğesi belirtirseniz sistem artık varsayılan olarak herhangi bir dosya eklemez ve yalnızca belirtilen dosyaları yedekler. Birden fazla dosya eklemek için birden fazla<include>öğesi kullanın.Android 11 ve önceki sürümlerde bu öğe,
requireFlagsözelliğini de içerebilir. Bu özellik, yedekleme için koşullu gereksinimleri tanımlama bölümünde daha ayrıntılı olarak ele alınmıştır.getCacheDir(),getCodeCacheDir()veyagetNoBackupFilesDir()tarafından döndürülen dizinlerdeki dosyalar, dahil etmeye çalışsanız bile her zaman hariç tutulur.<exclude>Yedekleme sırasında hariç tutulacak bir dosya veya klasör belirtir. Genellikle yedekleme kapsamı dışında tutulan bazı dosyalar şunlardır:
Sunucu tarafından verilen veya cihazda oluşturulan, cihaza özgü tanımlayıcıları olan dosyalar. Örneğin, Firebase Cloud Messaging (FCM), bir kullanıcı uygulamanızı yeni bir cihaza her yüklediğinde kayıt jetonu oluşturmalıdır. Eski kayıt jetonu geri yüklenirse uygulama beklenmedik şekilde davranabilir.
Uygulama hata ayıklamayla ilgili dosyalar.
Uygulamanın 25 MB'lık yedekleme kotasını aşmasına neden olan büyük dosyalar.
Her <include> ve <exclude> öğesi aşağıdaki iki özelliği içermelidir:
domainKaynağın konumunu belirtir. Bu özellik için geçerli değerler şunlardır:
root: Bu uygulamaya ait tüm özel dosyaların depolandığı dosya sistemindeki dizin.file:getFilesDir()tarafından döndürülen dizinler.database:getDatabasePath()tarafından döndürülen dizinler.SQLiteOpenHelperile oluşturulan veritabanları burada depolanır.sharedpref:SharedPreferencesdosyalarının depolandığı dizin.external:getExternalFilesDir()tarafından döndürülen dizin.device_root:rootile benzerdir ancak cihaz korumalı depolama alanı içindir.device_file:fileile benzerdir ancak cihaz korumalı depolama alanı için kullanılır.device_database:databaseile benzerdir ancak cihaz korumalı depolama alanı için kullanılır.device_sharedpref:sharedprefile benzerdir ancak cihaz korumalı depolama alanı içindir.
pathYedeklemeye dahil edilecek veya yedeklemeden hariç tutulacak bir dosya ya da klasör belirtir. Aşağıdakileri göz önünde bulundurun:
- Bu özellik, joker karakter veya normal ifade söz dizimini desteklemez.
./kullanarak geçerli dizine referans verebilirsiniz ancak güvenlik nedeniyle..kullanarak ana dizine referans veremezsiniz.- Bir dizin belirtirseniz kural, dizindeki ve yinelemeli alt dizinlerdeki tüm dosyalar için geçerli olur.
Platformlar Arası Aktarımları Yapılandırma
Android 16 QPR2 (API düzeyi 36.1) sürümünden itibaren, Android olmayan cihazlara ve cihazlardan veri aktarımı için Otomatik Yedekleme'yi yapılandırabilirsiniz. Bunu yapmak için Android 12 veya sonraki sürümlerin söz diziminde gösterildiği gibi <data-extraction-rules> yapılandırmanıza <cross-platform-transfer> öğesini ekleyin. Zorunlu platform özelliğini kullanarak hedef platformu belirtmeniz gerekir. Desteklenen tek değer ios.
Bu bölümde, hangi verilerin aktarılacağını belirtmek için Dahil etme ve hariç tutma öğelerinin söz dizimi bölümünde açıklandığı gibi standart <include> ve <exclude> öğelerini kullanabilirsiniz.
Ayrıca, sistemin uygulamanızı hedef platformdaki ilgili uygulamayla eşleştirmesine yardımcı olmak için <platform-specific-params> öğesini eklemeniz gerekir.
Bu öğe aşağıdaki zorunlu özelliklere sahiptir:
bundleId: Uygulamanın diğer platformdaki paket kimliği (ör. iOS uygulamanızın paket kimliği).teamId: Uygulamanın diğer platformdaki ekip kimliği (ör. iOS uygulamanızın ekip kimliği).contentVersion: Tanımladığınız ve dışa aktarılan veri biçimiyle ilişkili bir sürüm dizesi.
bundleId ve teamId özellikleri, veri bütünlüğünü ve uygulamalar arası doğru eşleşmeyi doğrulamak için kullanılır. Dışa aktarma sırasında verilerin yalnızca diğer platformdaki belirtilen uygulamaya aktarılmasını ve içe aktarma sırasında bu Android uygulamasının yalnızca söz konusu uygulamadan veri almasını garanti ederler.
XML kurallarının sağladığı olanakların ötesinde, veri dönüştürme ve aktarma süreci üzerinde daha ayrıntılı kontrol için özel bir BackupAgent uygulayabilir ve Cross-Platform Transfer API'lerini kullanabilirsiniz.
iOS Aktarımları İçin Dosya Eşleme
Dosyaları iOS'e aktarırken <include> kurallarında belirttiğiniz Android domain ve path, belirli bir dizin yapısıyla eşlenir. Aşağıdaki tabloda, Android domain temel alınarak iOS'teki hedef yolların aktarım hedefi köküne göre konumu gösterilmektedir:
Android domain |
iOS'teki yol (aktarım köküne göre) |
|---|---|
root |
app/ |
file |
app/files/ |
database |
app/databases/ |
sharedpref |
app/shared_prefs/ |
external |
external/files/ |
device_root |
device/app/ |
device_file |
device/app/files/ |
device_database |
device/app/databases/ |
device_sharedpref |
device/app/shared_prefs/ |
Örneğin, <include domain="file"
path="my_settings.txt"/> ile eklenen bir dosya, iOS tarafında aktarım hedefi köküne göre app/files/my_settings.txt konumunda kullanılabilir.
BackupAgent'ı uygulama
Otomatik Yedekleme'yi uygulayan uygulamaların BackupAgent uygulaması gerekmez.
Ancak dilerseniz özel bir BackupAgent uygulayabilirsiniz. Bunu yapmanın genellikle iki nedeni vardır:
onRestoreFinished()veonQuotaExceeded()gibi yedekleme etkinlikleriyle ilgili bildirim almak istiyorsanız. Bu geri çağırma yöntemleri, uygulama çalışmıyor olsa bile yürütülür.Yedeklemek istediğiniz dosya grubunu XML kurallarıyla kolayca ifade edemiyorsanız. Bu nadir durumlarda, istediğiniz verileri depolamak için
onFullBackup(FullBackupDataOutput)'yi geçersiz kılan birBackupAgentuygulayabilirsiniz. Sistemin varsayılan uygulamasını korumak içinsuper.onFullBackup()ile üst sınıfta ilgili yöntemi çağırın.
BackupAgent uygularsanız sistem varsayılan olarak uygulamanızın anahtar/değer yedekleme ve geri yükleme işlemini gerçekleştirmesini bekler. Bunun yerine dosya tabanlı Otomatik Yedekleme'yi kullanmak için uygulamanızın manifest dosyasında android:fullBackupOnly özelliğini true olarak ayarlayın.
Otomatik yedekleme ve geri yükleme işlemleri sırasında sistem, uygulamanın çakışmalara neden olabilecek dosyalara erişmesini önlemek ve uygulamanın BackupAgent içinde geri çağırma yöntemlerini yürütmesine izin vermek için uygulamayı kısıtlı modda başlatır. Bu kısıtlanmış modda, uygulamanın ana etkinliği otomatik olarak başlatılmaz, içerik sağlayıcıları başlatılmaz ve uygulamanın manifest dosyasında beyan edilen herhangi bir alt sınıf yerine temel sınıf Application örneklendirilir.
BackupAgent sınıfınız, anahtar/değer çifti yedeklemesi için kullanılan onBackup() ve onRestore() soyut yöntemlerini uygulamalıdır. Anahtar/değer yedeklemesi yapmak istemiyorsanız bu yöntemlerin uygulamasını boş bırakabilirsiniz.
Daha fazla bilgi için BackupAgent'ı genişletme başlıklı makaleyi inceleyin.
BackupAgent'ta platformlar arası aktarımları işleme
Android 16 QPR2 (API düzeyi 36.1) ile başlayarak, platformlar arası veri aktarımlarını daha iyi desteklemek için BackupAgent içinde birkaç yeni API kullanılabilir.
Yeni Taşıma İşareti:
FLAG_CROSS_PLATFORM_TRANSFER_IOS: Bu işaret,BackupAgentuygulamanıza sağlanantransportFlagsöğesine eklenir.onFullBackupuygulamasında, mevcut yedekleme işlemi bir iOS cihazına Veri Dışa Aktarma Aracı işleminin parçasıysa bu işaret ayarlanır.- Yeni
onRestoreFileaşırı yüklemesinde, veriler bir iOS cihazdan içe aktarılıyorsa bu işaret ayarlanır.
Yeni onRestoreFile yöntemi:
Tek bir FullRestoreDataInput parametresi alan yeni bir onRestoreFile aşırı yüklemesi kullanıma sunuldu. Bu nesne, geri yükleme işlemi hakkında daha fazla bağlam bilgisi sağlar:
FullRestoreDataInput.getTransportFlags(): Mevcut geri yükleme işlemi için taşıma işaretlerini döndürür. Bu işaretlerFLAG_CROSS_PLATFORM_TRANSFER_IOSdeğerini içerebilir.FullRestoreDataInput.getContentVersion(): Platformlar arası aktarım sırasında diğer platformdaki kaynak uygulama tarafından sağlanan içerik sürümü dizesini döndürür. Kaynak tarafından sağlanmazsa bu değer boş bir dizedir.
Yeni Boyut Tahmini Yöntemi:
onEstimateFullBackupBytes(): Bu yöntem, uygulamanızın yedeklemeyi planladığı verilerin tahmini boyutunu belirtmenize olanak tanır. Uygulamanız yedekleme sırasında önemli veri dönüşümleri gerçekleştiriyorsa veya büyük miktarda veri işliyorsa varsayılan sistem provasını önleyerek verimliliği artırabileceği için bu yöntemi uygulamanız kesinlikle önerilir. Küçük ve basit yedeklemeleri olan uygulamalar için bu yöntem genellikle gerekli değildir.
Örnek kullanım:
Kotlin
// In your custom BackupAgent class
override fun onFullBackup(out: FullBackupDataOutput) {
// Check if this is a cross-platform export to iOS
if ((out.transportFlags and FLAG_CROSS_PLATFORM_TRANSFER_IOS) != 0) {
Log.d(TAG, "onFullBackup for iOS transfer")
// Your custom export logic here
// Call fullBackupFile() for files to include
}
}
override fun onRestoreFile(input: FullRestoreDataInput) {
if ((input.transportFlags and FLAG_CROSS_PLATFORM_TRANSFER_IOS) != 0) {
val sourceContentVersion = input.contentVersion
Log.d(TAG, "onRestoreFile from iOS, content version: $sourceContentVersion")
// Your custom import logic here, using input.data, input.destination, etc.
}
}
// Optional: Provide an estimate of the backup size
override fun onEstimateFullBackupBytes(): Long {
return calculateEstimatedBackupSize()
}
Java
// In your custom BackupAgent class
@Override
public void onFullBackup(FullBackupDataOutput out) throws IOException {
// Check if this is a cross-platform export to iOS
if ((out.getTransportFlags() & FLAG_CROSS_PLATFORM_TRANSFER_IOS) != 0) {
Log.d(TAG, "onFullBackup for iOS transfer");
// Your custom export logic here
// Call fullBackupFile() for files to include
}
}
@Override
public void onRestoreFile(FullRestoreDataInput input) {
if ((input.getTransportFlags() & FLAG_CROSS_PLATFORM_TRANSFER_IOS) != 0) {
String sourceContentVersion = input.getContentVersion();
Log.d(TAG, "onRestoreFile from iOS, content version: " + sourceContentVersion);
// Your custom import logic here, using input.getData(), input.getDestination(), etc.
}
}
// Optional: Provide an estimate of the backup size
@Override
public long onEstimateFullBackupBytes() {
return calculateEstimatedBackupSize();
}