Skip to content

Commit

Permalink
feat!(android): bump platform requirements (#122)
Browse files Browse the repository at this point in the history
* feat!(android): bump platform requirements
* doc(android): drop cordova-android 8.x specifics
* doc(android): bump platform requirements
  • Loading branch information
erisu committed Aug 27, 2021
1 parent 8e7b399 commit 84f64da
Show file tree
Hide file tree
Showing 3 changed files with 15 additions and 13 deletions.
21 changes: 9 additions & 12 deletions docs/INSTALLATION.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

- [Installation](#installation)
- [Installation Requirements](#installation-requirements)
- [Cordova Android 8.x Specifics](#cordova-android-8x-specifics)
- [Cordova-Android 9.x Specifics](#cordova-android-9x-specifics)
- [Android details](#android-details)
- [Co-existing with Facebook Plugin](#co-existing-with-facebook-plugin)
- [Co-existing with plugins that use Firebase](#co-existing-with-plugins-that-use-firebase)
Expand All @@ -26,6 +26,7 @@
| -------------- | ----------- | --------------- | ----------- | --------- |
| 1.0.0 | 10.0.0 | 8.0.0 | 5.1.1 | 1.8.0 |
| 2.0.0 | 10.0.0 | 8.0.0 | 6.0.0 | 1.8.0 |
| 3.0.0 | 10.0.0 | 9.0.0 | 6.0.0 | 1.8.0 |

To install from the command line:

Expand Down Expand Up @@ -74,24 +75,20 @@ By default, on iOS, the plugin will register with APNS. If you want to use FCM o
> Note: You need to specify the SENDER_ID variable in your config.xml if you plan on installing/restoring plugins using the prepare method. The prepare method will skip installing the plugin otherwise.
```xml
<plugin name="@havesource/cordova-plugin-push" spec="2.0.0" />
<plugin name="@havesource/cordova-plugin-push" spec="3.0.0" />
```

### Cordova Android 8.x Specifics
### Cordova-Android 9.x Specifics

You will need to install the `cordova-support-google-services` plugin. This plugin enables the Google APIs and Firebase services for your Android application.
**Using AndroidX Library:**

If your application uses many plugins and references over 64K methods, you will need to enable multidex. If multidex is not enabled, your build should fail and you should see the following error:
As of version **3.0.0**, this plugin has migrated from the Android Support Library to AndroidX. Since Cordova-Android 9.x does not use the AndroidX library by default, you will need to install the [`cordova-plugin-androidx-adapter`](https://www.npmjs.com/package/cordova-plugin-androidx-adapter) plugin.

```log
trouble writing output:
Too many field references: 131000; max is 65536.
You may try using --multi-dex option.
```
This plugin will migrate any Android Support Library references to AndroidX.

To enable multidex, use the `phonegap-plugin-multidex` plugin.
Please note that this will also migrate references of other plugins.

These two plugins are only necessary for the Cordova Android 8.x releases.
If you are using **Cordova Android 8.x** please continue reading in the **Cordova Android 8.x Specifics** section.

## Android details

Expand Down
5 changes: 5 additions & 0 deletions package.json
Original file line number Diff line number Diff line change
Expand Up @@ -38,6 +38,11 @@
},
"engines": {
"cordovaDependencies": {
"3.0.0": {
"cordova": ">=10.0.0",
"cordova-android": ">=9.0.0",
"cordova-ios": ">=6.0.0"
},
"2.0.0": {
"cordova": ">=10.0.0",
"cordova-android": ">=8.0.0",
Expand Down
2 changes: 1 addition & 1 deletion plugin.xml
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@

<engines>
<engine name="cordova" version=">=10.0.0"/>
<engine name="cordova-android" version=">=8.0.0"/>
<engine name="cordova-android" version=">=9.0.0"/>
<engine name="cordova-ios" version=">=6.0.0"/>
</engines>

Expand Down

0 comments on commit 84f64da

Please sign in to comment.