Document/improve installation and configuration process

jggc commented 5 years ago

Document how this plugin can be used as a drop-in replacement for the firestore portion of the firebase-js-sdk.

In summary :

Install this plugin (now distributed as cordova-firestore-dropin)
Install cordova-plugin-firebase-authentication
Write some wrappers around the non-standard authentication functions, and, if required, this wrapper can also manage authentication in both js and native sdks when some components are still using the JavaScript version
- In our case we are using JavaScript sdk for firebase storage and native sdk for firestore, so we need both authentication libraries to work in parallel
Rewrite firestore.batch calls to not use batch as it is currently not supported by this plugin (or make a feature/pull request if you really need it)

I will work on providing sample wrapper code as code snippets or as a separate library to show how to glue together all the moving parts and have them working fine on all platforms : cordova-firestore-dropin, cordova-plugin-firebase-authentication and firebase-js-sdk.

drahuks commented 5 years ago

Thank you for sharing. I will have a look at this and come back to you

drahuks commented 5 years ago

Can you please tell me what changes you made in this fork? I see that the original plugin has been updated a few days ago

jggc commented 5 years ago

The original plugin developer added proper sub collection recursion a few days ago but there were still a few things missing. See this commit message for some details https://github.com/jggc/cordova-plugin-firestore/commit/b1581b86c7239aa97873f93efa24c48d0fe55a4e

Basically I added/refactored everything that was missing in this plugin to make it a drop-in replacement for the JS-SDK in our project which is a React application that does all the basic Firestore operations except delete using react-redux-firebase and direct Firestore calls.

I plan on trying to merge that upstream but we will be maintaining our own fork anyways for the foreseeable future as our use case is likely more demanding/mature than the original developer planned for. And since this is quite a big refactoring of the JavaScript code with breaking changes and a somewhat new philosophy I wouldn't be surprised if that was not merged but I will try, the guy was really helpful so far.

jggc / cordova-plugin-firestore

Document/improve installation and configuration process #1