Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/arnesson/cordova-plugin-firebase
Cordova plugin for Google Firebase
https://github.com/arnesson/cordova-plugin-firebase
cordova crashlytics firebase google-firebase notifications
Last synced: 3 days ago
JSON representation
Cordova plugin for Google Firebase
- Host: GitHub
- URL: https://github.com/arnesson/cordova-plugin-firebase
- Owner: arnesson
- License: mit
- Created: 2016-06-13T01:51:46.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2024-07-09T10:44:13.000Z (5 months ago)
- Last Synced: 2024-11-26T02:02:34.914Z (17 days ago)
- Topics: cordova, crashlytics, firebase, google-firebase, notifications
- Language: Objective-C
- Homepage: http://arnesson.github.io/cordova-plugin-firebase
- Size: 246 MB
- Stars: 1,006
- Watchers: 65
- Forks: 1,555
- Open Issues: 252
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
- awesome-capacitor - `cordova-plugin-firebase` - team/capacitor/issues/815)) (Cordova plugins / Incompatible)
README
# cordova-plugin-firebase
This plugin brings push notifications, analytics, event tracking, crash reporting and more from Google Firebase to your Cordova project! Android and iOS supported.
## Supported Cordova Versions
- cordova: `>= 6`
- cordova-android: `>= 6.4`
- cordova-ios: `>= 4`
## Installation
Install the plugin by adding it to your project's config.xml:
```
```
or by running:
```
cordova plugin add cordova-plugin-firebase --save
```
### Guides
Great installation and setup guide by Medium.com - [https://medium.com/@felipepucinelli/how-to-add-push...](https://medium.com/@felipepucinelli/how-to-add-push-notifications-in-your-cordova-application-using-firebase-69fac067e821)
### Setup
Download your Firebase configuration files, GoogleService-Info.plist for iOS and google-services.json for android, and place them in the root folder of your cordova project. Check out this [firebase article](https://support.google.com/firebase/answer/7015592) for details on how to download the files.
```
- My Project/
platforms/
plugins/
www/
config.xml
google-services.json <--
GoogleService-Info.plist <--
...
```
###### IMPORTANT NOTES
- This plugin uses a hook (after prepare) that copies the configuration files to the right place, namely `platforms/ios/\/Resources` for ios and `platforms/android` for android.
- Firebase SDK requires the configuration files to be present and valid, otherwise your app will crash on boot or Firebase features won't work.
### PhoneGap Build
Hooks do not work with PhoneGap Build. This means you will have to manually make sure the configuration files are included. One way to do that is to make a private fork of this plugin and replace the placeholder config files (see `src/ios` and `src/android`) with your actual ones, as well as hard coding your app id and api key in `plugin.xml`.
### Google Play Services
Your build may fail if you are installing multiple plugins that use Google Play Services. This is caused by the plugins installing different versions of the Google Play Services library. This can be resolved by installing [cordova-android-play-services-gradle-release](https://github.com/dpa99c/cordova-android-play-services-gradle-release).
If your build is still failing, you can try installing [cordova-android-firebase-gradle-release](https://github.com/dpa99c/cordova-android-firebase-gradle-release). For more info, read the following [comment](https://github.com/dpa99c/cordova-plugin-request-location-accuracy/issues/50#issuecomment-390025013) about locking down the specific versions for play services and firebase. It is suggested to use `+` instead of `15.+` to ensure the correct versions are used.
## Google Tag Manager
Checkout our [guide](docs/GOOGLE_TAG_MANAGER.md) for info on setting up Google Tag Manager.
## Configuring Notifications
Checkout our [guide](docs/NOTIFICATIONS.md) for info on configuring notification icons and colors.
## API
See the full [API](docs/API.md) available for this plugin.
## Supporters
[PassportReader](https://passportreader.app) identity verification API - Get started for free - $0.01 per verification