Skip to content

Reinstallation

Uninstall xDrip+

Historical data

Uninstalling xDrip+ will also remove all data and settings without possible recovery.
Make sure you backup database and or all settings before.
It is recommended to upload data to Nightscout.


This shouldn't usually be necessary but you might need to uninstall xDrip+ to troubleshoot, or if you need to change it to or from a forked version. You can uninstall xDrip+ like any other Android app with a long press on the icon or from Android Settings -> Apps.

Reinstall xDrip+

Follow this sequence:

  1. Backup (locally or in the cloud)
  2. Uninstall xDrip+
  3. Install xDrip+
  4. Restore (from local or cloud backup)
  5. Check all your settings and recreate your alarms

Backup

You can either backup the database locally or in your Google Drive.

Backup the database

The database contains all BG readings, treatments and notes. It is strongly recommended that you backup your database and keep a copy on another device if you want to keep your existing data and as a safety precaution against a phone loss, crash, ...
Using upload to Nightscout is also strongly recommended.

Exporting the database will also save settings.

From the main xDrip+ display select the upper right 3 dots menu.

Select Import Export features.

Select Export database.


The current database will be saved in /storage/emulated/0/xDrip or Internal Storage/xDrip You need to authorize xDrip+ to access your phone memory.
You can make as many backups as your memory can store.

If you're fast enough to touch the SHARE writing before it disappears you can use your phone share options to send the database to another device or copy it to another location.

Your backup will be named exportYYYYMMDD-HHMMSS.zip with YYYY current year, MM month, DD day, and HHMMSS for hour minutes and seconds. This will allow you to have multiple backups identified by a unique timestamp.

If you want to keep a safe copy, send the file to yourself by email, save in on a cloud drive or copy it via USB to a computer.

It is an SQLite database you can browse with various utilities like SQLite Browser.


Restore

You can restore the database from a local copy or from your Google Drive.

Restore settings

When xDrip+ install is complete, if a backup is available, xDrip+ will propose to restore it automatically.
Select RESTORE SETTINGS

If you don't see this message, restore them manually.

Restore a database

Data loss

Restoring a database will delete all current data.
Restore a database with the same version of xDrip+ used to export it.
Make sure to backup the current database before restoring a database.

When xDrip+ install is complete, if a database backup is available, xDrip+ might propose to restore it automatically.

Make sure this is the database you want to restore then select RESTORE

Note: the current database will be exported first, for safety, you will find it in the list named b4import and the date/time the import was done. This will allow you to recover it if necessary.


If you want to restore a specific backup, from the main xDrip+ display select the upper right 3 dots menu.

Select Import Export features.

Select Import database.

Instructions are displayed. You don't need to move the backup file if you didn't move it from another device, you don't need to unzip it. Be cautious on restoring a database with a different xDrip+ version: it is recommended that you install the xDrip+ version that was used to perform the export before importing, then you can update xDrip+.

Select the database you want to import, look at the date and size (use the phone file browser) to be sure to pick the right one.

Once sure you're trying to restore the correct backup, Ok

If you restored the wrong database, just redo the same steps and select the latest b4import version to roll back.

Android 11 and above

There is an issue with recent Android versions that will force you to restore the database several (3 to 4) times before you can see the full contents.


Cloud backup

Cloud backup allows you to save a zipped file containing both database and settings in your Google Drive.
You must be logged in your Google account to use this feature.

Select Cloud Backup.

In order to use this feature you should first select a backup location.

Select backup location

  • Use alternate file will allow you to select a different folder and backup file when restoring.
  • When doing your first backup, or when recovering an xDrip+ reinstall on the same phone, select Automatically manage.

You must authorize xDrip+ to access your Google Account. xDrip+ will only store and retrieve the backup file from your Google Drive. Nothing else.

Once done xDrip+ will confirm access:

xDrip+ will create a new folder named xDrip-Backups in the root of your Google drive.

Do backup now

Once your backup location selected you can perform a backup. The backup file will be created on your device and then uploaded to your Google cloud drive.

You can check cloud backup status at the top of the current view.

You can make cloud backup execute automatically every day.
Do not enable this if you're using a limited mobile data plan.

Restore from backup

Data loss

Restoring a database will delete all current data.
Restore a database with the same version of xDrip+ used to export it.
Make sure to backup the current database before restoring a database.

Restore will copy the cloud database locally and replace the current database.

Once done, xDrip+ will restart.


New phone migration

Perform the following operations:

On the old phone:

  1. Backup settings and database locally or in your Google drive.
  2. If you won't use Google cloud backup, send yourself both settings and database backups, or copy them to a computer.

  3. If this old phone is connected to a sensor or a bridge, make sure to disable collection so that it won't interfere when you start using your new phone.

  4. If this old phone was master for xDrip+ sync followers, remove the master role.

On the new phone:

  1. Install the same version of xDrip+ you are using on the old phone.
  2. If you didn't use Google cloud backup:
    Backup settings and database (this is only needed to create the correct folders).
    Copy the files you sent yourself via mail, or from a computer to the right folders.

  3. Restore settings and database from the local backup or from your Google Drive.

  4. If the new phone is connected to a sensor or a bridge, connect it now. (Your data source will be correct but you'll need to recover connection).


Last modified 24/12/2022