Merge "docs: improve docs for sqlite package summary" into nyc-dev

This commit is contained in:
Mark Lu
2016-09-26 17:12:48 +00:00
committed by Android (Google) Code Review

View File

@@ -6,15 +6,44 @@ classes that an application would use to manage its own private database.
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>