UWP implementation for SqliteStorage.

[dryganets]

No description provided.

[andpor]

@dryganets would you please update Readme with relevant instructions for working with Windows implementation ?

[rigdern]

@dryganets and I work on the same team. Here are some notes I have about the UWP implementation:

The UWP implementation is very similar to the iOS implementation. There are some differences. Most of them are because we didn't have time to port certain features and we haven't needed them. Here's the list of differences:

• Reading and writing blobs isn't supported.
• We didn't port the sqlcipher stuff.
• We didn't port the custom regex SQL function so REGEXP may not be supported.
• attach isn't supported.
• Some open options aren't supported:
  • dblocation. We weren't sure how to map it to UWP. Also, the Android implementations don't seem to support this.
  • key (related to sqlcipher)
• Differences with delete:
  • The dblocation option isn't supported
  • Closes the DB if it's open. This felt like the right thing to do.

All of the code in the SQLite.Net-PCL directory is from https://github.com/oysteinkrog/SQLite.Net-PCL. It provides a thin wrapper around the C SQLite APIs which enables them to be called from C#. A couple of tweaks were made to the code to fix these bugs:

• Parameter passing issue in Prepare2 for WinRT oysteinkrog/SQLite.Net-PCL#374
• UWP: Crash in .NET native release builds when consuming winsqlite3.dll oysteinkrog/SQLite.Net-PCL#375

This implementation requires at least the Windows 10 Anniversary Update. This is because it relies on the version of SQLite that is built into Windows 10 and this was introduced in the Anniversary Update. You can learn more at https://blogs.windows.com/buildingapps/2017/02/06/using-sqlite-databases-uwp-apps/.

With a little work, this module could be updated to support earlier versions of Windows 10. Here's how:

• When constructing SQLiteApiWinRT, pass false for the useWinSqlite parameter.
• Install the "SQLite for Universal Windows Platform" extension which will bring a version of SQLite into your app: https://marketplace.visualstudio.com/items?itemName=SQLiteDevelopmentTeam.SQLiteforUniversalWindowsPlatform

Adam Comella
Microsoft Corp.

[creambyemute]

@dryganets @rigdern Those are some good insights, though I think @andpor meant the instructions about How to use (Windows) equally to the How to use (iOS) and How to use (Android) section.

So if we have a fresh inited RN project with RN-windows added, what steps have to be taken to be able to use it?

Probably

• Right Click on Solution in VS2017 --> Add --> Existing Project
• Navigate to ../node_modules/react-native-sqlite-storage/src/windows/SQLitePlugin and select the .csproj file
• Right click on your React Native Windows app under your solutions tree and click Add > Reference....
• Check the SQLitePlugin you just added and press Ok
• Open MainReactNativeHost.cs, add using Org.PGSQLite.SQLitePlugin; and add the Package to the list of Packages new SQLitePluginPackage(),