PhoneGap-SQLitePlugin-Android/README.md

133 lines
4.3 KiB
Markdown
Raw Normal View History

2011-06-23 10:03:47 -04:00
Phonegap SQLitePlugin
=====================
DISCLAIMER:
We are brand new to objective-c, so there could be problems with our code!
Installing
==========
2012-03-07 10:50:27 -05:00
For installing with PhoneGap 1.3.0:
in PGSQLitePlugin.h file change for PhoneGaps JSONKit.h implementation.
2012-03-07 10:50:27 -05:00
#ifdef PHONEGAP_FRAMEWORK
#import <PhoneGap/PGPlugin.h>
#import <PhoneGap/JSONKit.h>
#import <PhoneGap/PhoneGapDelegate.h>
#import <PhoneGap/File.h>
#import<PhoneGap/FileTransfer.h>
#else
#import "PGPlugin.h"
#import "JSON.h"
#import "PhoneGapDelegate.h"
#import "File.h"
#endif
In the Project Build Phases tab, select the "Link Binary with Libraries" dropdown menu and add 2 libraries:
2012-01-31 21:56:03 -05:00
libsqlite3.0.dylib
libsqlite3.dylib
Drag .h and .m files into your project's Plugins folder (in xcode) -- I always
just have "Create references" as the option selected.
Take the precompiled javascript file from build/, or compile the coffeescript
file in src/ to javascript WITH the top-level function wrapper option (default).
Use the resulting javascript file in your HTML.
Look for the following to your project's PhoneGap.plist:
2011-09-26 20:05:16 -04:00
<key>Plugins</key>
<dict>
...
</dict>
Insert this in there:
2011-09-26 20:05:16 -04:00
<key>PGSQLitePlugin</key>
<string>PGSQLitePlugin</string>
General Usage
=============
## Coffee Script
2011-09-26 20:05:16 -04:00
db = new PGSQLitePlugin("test_native.sqlite3")
db.executeSql('DROP TABLE IF EXISTS test_table')
db.executeSql('CREATE TABLE IF NOT EXISTS test_table (id integer primary key, data text, data_num integer)')
2011-09-26 20:05:16 -04:00
db.transaction (tx) ->
2011-09-26 20:05:16 -04:00
tx.executeSql [ "INSERT INTO test_table (data, data_num) VALUES (?,?)", "test", 100], (res) ->
2011-09-26 20:05:16 -04:00
# success callback
2011-09-26 20:05:16 -04:00
console.log "insertId: #{res.insertId} -- probably 1"
console.log "rowsAffected: #{res.rowsAffected} -- should be 1"
2011-09-26 20:05:16 -04:00
# check the count (not a part of the transaction)
db.executeSql "select count(id) as cnt from test_table;", (res) ->
console.log "rows.length: #{res.rows.length} -- should be 1"
console.log "rows[0].cnt: #{res.rows[0].cnt} -- should be 1"
2011-09-26 20:05:16 -04:00
, (e) ->
2011-09-26 20:05:16 -04:00
# error callback
2011-09-26 20:05:16 -04:00
console.log "ERROR: #{e.message}"
## Plain Javascript
var db;
db = new PGSQLitePlugin("test_native.sqlite3");
db.executeSql('DROP TABLE IF EXISTS test_table');
db.executeSql('CREATE TABLE IF NOT EXISTS test_table (id integer primary key, data text, data_num integer)');
db.transaction(function(tx) {
return tx.executeSql(["INSERT INTO test_table (data, data_num) VALUES (?,?)", "test", 100], function(res) {
console.log("insertId: " + res.insertId + " -- probably 1");
console.log("rowsAffected: " + res.rowsAffected + " -- should be 1");
return db.executeSql("select count(id) as cnt from test_table;", function(res) {
console.log("rows.length: " + res.rows.length + " -- should be 1");
return console.log("rows[0].cnt: " + res.rows[0].cnt + " -- should be 1");
});
}, function(e) {
return console.log("ERROR: " + e.message);
});
});
Lawnchair Adapter Usage
=======================
Include the following js files in your html:
- lawnchair.js (you provide)
- pgsqlite_plugin.js
- lawnchair_pgsqlite_plugin_adapter.js (must come after pgsqlite_plugin.js)
The `name` option will determine the sqlite filename. Optionally, you can change it using the `db` option.
In this example, you would be using/creating the database at: *Documents/kvstore.sqlite3* (all db's in PGSQLitePlugin are in the Documents folder)
kvstore = new Lawnchair { name: "kvstore", adapter: PGSQLitePlugin.lawnchair_adapter }, () ->
# do stuff
Using the `db` option you can create multiple stores in one sqlite file. (There will be one table per store.)
recipes = new Lawnchair {db: "cookbook", name: "recipes", ...}
ingredients = new Lawnchair {db: "cookbook", name: "ingredients", ...}
2011-09-28 14:20:54 -04:00
### Other notes from @Joenoon:
I played with the idea of batching responses into larger sets of
writeJavascript on a timer, however there was only a barely noticeable
performance gain. So I took it out, not worth it. However there is a
massive performance gain by batching on the client-side to minimize
PhoneGap.exec calls using the transaction support.