diff --git a/CHANGES.md b/CHANGES.md index cfc253326..bdd08da16 100644 --- a/CHANGES.md +++ b/CHANGES.md @@ -1,8 +1,9 @@ # Changes -## cordova-sqlite-storage 2.0.3-pre2 +## cordova-sqlite-storage 2.0.3 - Drop engines rule from package.json +- Doc fixes ### cordova-sqlite-storage 1.5.4 diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index b23a05dbe..63c6af677 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -1,11 +1,23 @@ -## Bugs and other issues +# General + +**IMPORTANT:** Please raise general questions in [litehelpers / Cordova-sqlite-help / issues](https://github.com/litehelpers/Cordova-sqlite-help/issues). + +## Reproducible bugs - Verify the results of calling the echoTest and selfTest functions as described in README.md - Check the pitfalls and other troubleshooting steps in README.md and [brodybits / Avoiding-some-Cordova-pitfalls](https://github.com/brodybits/Avoiding-some-Cordova-pitfalls) -- Reproduce the issue in a fresh, clean project, ideally based on [brodybits / Cordova-sqlite-bootstrap-test](https://github.com/brodybits/Cordova-sqlite-bootstrap-test) +- Reproduce the issue in a fresh, clean project, preferably based on [brodybits / Cordova-sqlite-bootstrap-test](https://github.com/brodybits/Cordova-sqlite-bootstrap-test) or [brodybits / cordova-sqlite-test-app](https://github.com/brodybits/cordova-sqlite-test-app). Please see README.md for more details. +## Feature requests + +Feature requests are welcome for community discussion and future consideration. Preference will be given to paid customers. Please contact for more information. + +## Other questions + +**NOTE:** As stated above please other questions in [litehelpers / Cordova-sqlite-help / issues](https://github.com/litehelpers/Cordova-sqlite-help/issues). + ## Contributing patches - Patches with bug fixes are helpful, especially when submitted with test code. diff --git a/HISTORY.md b/HISTORY.md index 206ce8339..3d2769f1f 100644 --- a/HISTORY.md +++ b/HISTORY.md @@ -134,6 +134,10 @@ New versions introduced available under GPL or commercial licensing options with support for PhoneGap Build - Cordova-sqlite-evplus (legacy) versions with GPL or premium commercial licensing options +## Major changes 2017 + +Windows platform toolset dependency updated for Visual Studio 2017 + ## Recent changes See CHANGES.md diff --git a/README.md b/README.md index b8401f5ea..c407b4ea7 100644 --- a/README.md +++ b/README.md @@ -140,7 +140,6 @@ See the [Sample section](#sample) for a sample with a more detailed explanation. - Truncation issue with UNICODE `\u0000` character (same as `\0`) - No background processing - INCORRECT error code (0) and INCONSISTENT error message (missing actual error info) in error callbacks ref: [litehelpers/Cordova-sqlite-storage#539](https://github.com/litehelpers/Cordova-sqlite-storage/issues/539) - - Issue with emojis and other 4-octet UTF-8 characters (apparently not stored correctly) ref: [litehelpers/Cordova-sqlite-storage#564](https://github.com/litehelpers/Cordova-sqlite-storage/issues/564) - Not possible to read BLOB column values - It is **not** possible to use this plugin with the default "Any CPU" target. A specific target CPU type **must** be specified when building an app with this plugin. - This version has dependency on platform toolset libraries included by Visual Studio 2017 ([litehelpers/Cordova-sqlite-storage#580](https://github.com/litehelpers/Cordova-sqlite-storage/issues/580)). Visual Studio 2015 is now supported by [litehelpers / Cordova-sqlite-legacy-build-support](https://github.com/litehelpers/Cordova-sqlite-legacy-build-support). @@ -185,7 +184,7 @@ See the [Sample section](#sample) for a sample with a more detailed explanation. - Also tested with multi-page applications - This project is self-contained though with sqlite3 dependencies auto-fetched by npm. No dependencies on other plugins such as cordova-plugin-file - Windows version uses a customized version of the performant [doo / SQLite3-WinRT](https://github.com/doo/SQLite3-WinRT) C++ component. -- [SQLCipher](https://www.zetetic.net/sqlcipher/) support for Android/iOS/Windows is available at: [litehelpers / Cordova-sqlcipher-adapter](https://github.com/litehelpers/Cordova-sqlcipher-adapter) +- [SQLCipher](https://www.zetetic.net/sqlcipher/) support for Android/iOS/macOS/Windows is available at: [litehelpers / Cordova-sqlcipher-adapter](https://github.com/litehelpers/Cordova-sqlcipher-adapter) - Intellectual property: - All source code is tracked to the original author in git - Major authors are tracked in AUTHORS.md @@ -431,7 +430,7 @@ See **Security of sensitive data** in the [Security](#security) section above. - iOS/macOS version does not support certain rapidly repeated open-and-close or open-and-delete test scenarios due to how the implementation handles background processing - As described below, auto-vacuum is NOT enabled by default. -- The Android and Windows versions do not always handle four-byte UTF-8 characters emoji characters such as `\u1F603` (SMILING FACE, MOUTH OPEN) correctly ref: [litehelpers/Cordova-sqlite-storage#564](https://github.com/litehelpers/Cordova-sqlite-storage/issues/564). It is sometimes possible to store and retrieve such characters but certain operations hex conversions do not work properly with the default [Android-sqlite-connector](https://github.com/liteglue/Android-sqlite-connector) database implementation. It is suspected that such characters would be stored incorrectly in the Android and Windows versions. This is not an issue in case the built-in Android database is used (using the `androidDatabaseImplementation: 2` setting in `window.sqlitePlugin.openDatabase`) +- The Android platform version does not always handle four-byte UTF-8 characters emoji characters such as `\u1F603` (SMILING FACE, MOUTH OPEN) correctly ref: [litehelpers/Cordova-sqlite-storage#564](https://github.com/litehelpers/Cordova-sqlite-storage/issues/564). It is sometimes possible to store and retrieve such characters but certain operations hex conversions do not work properly with the default [Android-sqlite-connector](https://github.com/liteglue/Android-sqlite-connector) database implementation. It is suspected that such characters would be stored incorrectly in the Android platform version. This is not an issue in case the built-in Android database is used (using the `androidDatabaseImplementation: 2` setting in `window.sqlitePlugin.openDatabase`) - It is possible to request a SQL statement list such as "SELECT 1; SELECT 2" within a single SQL statement string, however the plugin will only execute the first statement and silently ignore the others ref: [litehelpers/Cordova-sqlite-storage#551](https://github.com/litehelpers/Cordova-sqlite-storage/issues/551) - INSERT statement that affects multiple rows (due to SELECT cause or using TRIGGER(s), for example) reports incorrect rowsAffected on Android in case the built-in Android database used (using the `androidDatabaseImplementation` option in `window.sqlitePlugin.openDatabase`) - Memory issue observed when adding a large number of records due to the JSON implementation which is improved in [litehelpers / Cordova-sqlite-evcore-extbuild-free](https://github.com/litehelpers/Cordova-sqlite-evcore-extbuild-free) (available with GPL or commercial license options) @@ -483,7 +482,7 @@ Some more limitations are tracked in the [open Cordova-sqlite-storage documentat - Maximum record size supported - Actual behavior when using SAVEPOINT(s) - R-Tree is not fully tested with Android -- UNICODE characters not fully tested +- Some more UNICODE characters - ORDER BY random() (ref: [litehelpers/Cordova-sqlite-storage#334](https://github.com/litehelpers/Cordova-sqlite-storage/issues/334)) - UPDATE/DELETE with LIMIT or ORDER BY (newer Android/iOS versions) - Integration with JXCore for Cordova (must be built without sqlite(3) built-in) @@ -491,10 +490,11 @@ Some more limitations are tracked in the [open Cordova-sqlite-storage documentat - WITH clause (not supported by some older sqlite3 versions) - Handling of invalid transaction and transaction.executeSql arguments - Use of database locations on macOS -- Use of very large REAL numbers such as 1234567890123.4 +- Extremely large and small INTEGER and REAL values ref: [litehelpers/Cordova-sqlite-storage#627](https://github.com/litehelpers/Cordova-sqlite-storage/issues/627)) - More emojis and other 4-octet UTF-8 characters - `?NNN`/`:AAA`/`@AAAA`/`$AAAA` parameter placeholders ref: , ) - Single-statement and SQL batch transaction calls with invalid arguments (TBD behavior subject to change) +- Other [open Cordova-sqlite-storage testing issues](https://github.com/litehelpers/Cordova-sqlite-storage/issues?q=is%3Aissue+is%3Aopen+label%3Atesting) @@ -567,7 +567,7 @@ FUTURE TBD: Proper date/time handling will be further tested and documented at s - IndexedDBShim adapter - Further cleanup of [support](#support) section - Resolve or document remaining [open Cordova-sqlite-storage bugs](https://github.com/litehelpers/Cordova-sqlite-storage/issues?q=is%3Aissue+is%3Aopen+label%3Abug) -- Resolve [open Cordova-sqlite-storage documentation issues](https://github.com/litehelpers/Cordova-sqlite-storage/issues?q=is%3Aissue+is%3Aopen+label%3Adocumentation) +- Resolve [doc-needed issues on Cordova-sqlite-help](https://github.com/litehelpers/Cordova-sqlite-help/issues?q=is%3Aissue%20label%3Adoc-needed) and [doc-needed issues on Cordova-sqlite-storage](https://github.com/litehelpers/Cordova-sqlite-storage/issues?q=is%3Aissue%20label%3Adoc-needed) ## For future considertion @@ -1304,8 +1304,8 @@ Please include the following: ## Where to ask for help Once you have followed the directions above, you may request free support in the following location(s): -- [litehelpers / Cordova-sqlite-storage / issues](https://github.com/litehelpers/Cordova-sqlite-storage/issues) -- [litehelpers / Cordova-sqlite-help](https://github.com/litehelpers/Cordova-sqlite-help) +- **For reproducible bugs only:** [litehelpers / Cordova-sqlite-storage / issues](https://github.com/litehelpers/Cordova-sqlite-storage/issues) +- **For other questions:** [litehelpers / Cordova-sqlite-help / issues](https://github.com/litehelpers/Cordova-sqlite-help/issues) Please include the information described above otherwise. diff --git a/package.json b/package.json index 578df93d1..688f3e10a 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "cordova-sqlite-storage", - "version": "2.0.3-pre2", + "version": "2.0.3", "description": "Native interface to SQLite for PhoneGap/Cordova", "cordova": { "id": "cordova-sqlite-storage", diff --git a/plugin.xml b/plugin.xml index d4a608021..76d783ab5 100644 --- a/plugin.xml +++ b/plugin.xml @@ -2,7 +2,7 @@ + version="2.0.3"> Cordova sqlite storage plugin