Merge "docs: improve docs for sqlite package summary am: 59640a9f am:...

Applications use these classes to manage private databases. If creating a

Applications use these classes to manage private databases. If creating a

content provider, you will probably have to use these classes to create and

content provider, you will probably have to use these classes to create and

manage your own database to store content. See <a

manage your own database to store content. See <a

href="{@docRoot}guide/topics/providers/content-providers.html">Content Providers</a> to learn

href="{@docRoot}guide/topics/providers/content-providers.html">Content Providers</a>

the conventions for implementing a content provider. See the

to learn the conventions for implementing a content provider. If you are working

NotePadProvider class in the NotePad sample application in the SDK for an

with data sent to you by a provider, you do not use these SQLite classes, but

example of a content provider. Android ships with SQLite version 3.4.0

instead use the generic {@link android.database} classes.

<p>If you are working with data sent to you by a provider, you will not use

these SQLite classes, but instead use the generic {@link android.database}

<p>The Android SDK and Android emulators both include the

classes.

<a href="{@docRoot}studio/command-line/sqlite3.html">sqlite3</a> command-line

<p>Android ships with the sqlite3 database tool in the <code>tools/</code>

database tool. On your development machine, run the tool from the

folder. You can use this tool to browse or run SQL commands on the device. Run by

<code>platform-tools/</code> folder of your SDK. On the emulator, run the tool

typing <code>sqlite3</code> in a shell window.

with adb shell, for example, <code>adb -e shell sqlite3</code>.

<p>The version of SQLite depends on the version of Android. See the following table:

<table style="width:auto;">

  <tr><th>Android API</th><th>SQLite Version</th></tr>

  <tr><td>API 24</td><td>3.9</td></tr>

  <tr><td>API 21</td><td>3.8</td></tr>

  <tr><td>API 11</td><td>3.7</td></tr>

  <tr><td>API 8</td><td>3.6</td></tr>

  <tr><td>API 3</td><td>3.5</td></tr>

  <tr><td>API 1</td><td>3.4</td></tr>

</table>

<p>Some device manufacturers include different versions of SQLite on their devices.

  There are two ways to programmatically determine the version number.

<ul>

  <li>If available, use the sqlite3 tool, for example:

    <code>adb -e shell sqlite3 --version</code>.</li>

  <li>Create and query an in-memory database as shown in the following code sample:

    <pre>

    String query = "select sqlite_version() AS sqlite_version";

    SQLiteDatabase db = SQLiteDatabase.openOrCreateDatabase(":memory:", null);

    Cursor cursor = db.rawQuery(query, null);

    String sqliteVersion = "";

    if (cursor.moveToNext()) {

        sqliteVersion = cursor.getString(0);

    }</pre>

  </li>

</ul>

</BODY>

</BODY>

</HTML>

</HTML>