Skip to content

Commit

Permalink
Add docs about extracting database from app
Browse files Browse the repository at this point in the history
  • Loading branch information
jjoseba committed Feb 25, 2023
1 parent f33a064 commit 3f3cd2a
Show file tree
Hide file tree
Showing 4 changed files with 31 additions and 0 deletions.
30 changes: 30 additions & 0 deletions support/troubleshooting/appdatabase.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,30 @@
Extract app databases from device
=================================

To help with fixing bugs, there may be some times when accessing the actual
data in the local database for the device can be helpful. The steps below
describe how to get this data:


#. First of all, you'll need Android Studio version 4.2 or higher. Download the latest version for your
operating system from the official page: https://developer.android.com/studio
#. Enable USB debugging on your phone/device (under Settings > System > Developer Options, you may need
to enable developer options first - see: https://android.tutorials.how/enable-developer-options/)
#. Connect the device to your computer and open the app
#. Under Android Studio, from the menu bar select View > Tool Windows > App Inspection.
#. Select the Database Inspector tab and then select device and the Oppia app running process from the menu
#. The databases in the currently running app appear in the Databases pane, you should be able to see at
least ``mobilelearning.db`` and ``oppia.db``

#. Right click in the ``mobilelearning.db`` database icon and select "Export as file"

.. image:: images/export-db.png
:align: center

#. In the dialog, select SQL as the file type, and click the export button.

.. image:: images/export-db-dialog.png
:align: center

Now, you have a backup of your app's current database state, that can be used to recreate
any ongoing issue by a developer.
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added support/troubleshooting/images/export-db.png
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
1 change: 1 addition & 0 deletions support/troubleshooting/index.rst
Original file line number Diff line number Diff line change
Expand Up @@ -9,3 +9,4 @@ Troubleshooting an Oppia Implementation
block
translations
debug
appdatabase

0 comments on commit 3f3cd2a

Please sign in to comment.