<p align="center">
  <h1 align="center">Cordova HMS Push</h1>
</p>


<p align="center">
  <a href="https://www.npmjs.com/package/@hmscore/cordova-plugin-hms-push"><img src="https://img.shields.io/npm/dm/@hmscore/cordova-plugin-hms-push?color=%23007EC6&style=for-the-badge" alt="downloads"></a>
  <a href="https://www.npmjs.com/package/@hmscore/cordova-plugin-hms-push"><img src="https://img.shields.io/npm/v/@hmscore/cordova-plugin-hms-push?color=%23ed2a1c&style=for-the-badge" alt="NPM version"></a>
  <a href="./LICENSE"><img src="https://img.shields.io/npm/l/@hmscore/cordova-plugin-hms-push.svg?color=%3bcc62&style=for-the-badge" alt="License"></a>
</p>

----

This plugin enables communication between Huawei Ads SDK and Cordova platform. It exposes all functionality provided by Huawei Ads SDK.

[> Learn More](https://developer.huawei.com/consumer/en/doc/development/HMS-Plugin-Guides/introduction-0000001050136388?ha_source=hms1)

## Installation

### Cordova

```bash
$ cordova plugin add @hmscore/cordova-plugin-hms-push
```

### Ionic with Cordova Runtime

```bash
$ ionic cordova plugin add @hmscore/cordova-plugin-hms-push
```

### Ionic with Capacitor Runtime

```bash
$ npm install @hmscore/cordova-plugin-hms-push
```

### Ionic Native Wrappers

```bash
$ npm install @hmscore/ionic-native-hms-push
```

## Documentation

- [Quick Start](https://developer.huawei.com/consumer/en/doc/development/HMS-Plugin-Guides/prepare-dev-env-0000001050138343?ha_source=hms1)
- [Reference](https://developer.huawei.com/consumer/en/doc/development/HMS-Plugin-References/overview-0000001050136582?ha_source=hms1)

### Additional Topics

- [Enabling HUAWEI Push Service](https://developer.huawei.com/consumer/en/doc/development/HMS-Plugin-Guides/config-agc-0000001050136396#EN-US_TOPIC_0000001050136396__section7787102592217?ha_source=hms1)
- [Receiving Data Messages In App Killed State](https://developer.huawei.com/consumer/en/doc/development/HMS-Plugin-Guides/receiving-data-messages-at-app-killed-state-0000001058644809?ha_source=hms1)

## Questions or Issues

If you have questions about how to use HMS samples, try the following options:

- [Stack Overflow](https://stackoverflow.com/questions/tagged/huawei-mobile-services) is the best
  place for any programming questions. Be sure to tag your question
  with **`huawei-mobile-services`**.
- [GitHub](https://github.com/HMS-Core/hms-cordova-plugin) is the official repository for these
  plugins, You can open an issue or submit your ideas.
- [Huawei Developer Forum](https://forums.developer.huawei.com/forumPortal/en/home?fid=0101187876626530001&ha_source=hms1)
  HMS Core Module is great for general questions, or seeking recommendations and opinions.
- [Huawei Developer Docs](https://developer.huawei.com/consumer/en/doc/overview/HMS-Core-Plugin?ha_source=hms1)
  is place to official documentation for all HMS Core Kits, you can find detailed documentations in
  there.

If you run into a bug in our samples, please submit an issue to
the [GitHub repository](https://github.com/HMS-Core/hms-cordova-plugin).

## License

Huawei Push Kit Cordova Plugin is licensed under the [Apache 2.0 license](LICENSE).
