https://github.com/hicsail/ionic-hockeyapp
Need HockeyApp in your Ionic application, add this package!
https://github.com/hicsail/ionic-hockeyapp
2 3 android app cordova cordova-plugin cordova-plugin-hockeyapp hockey hockeyapp hockeyapp-plugin hockeyapp-provider ionic ionic-cordova ionic-framework ionic-native ionic-plugin ionic2 ionic3 ios
Last synced: about 2 months ago
JSON representation
Need HockeyApp in your Ionic application, add this package!
- Host: GitHub
- URL: https://github.com/hicsail/ionic-hockeyapp
- Owner: hicsail
- License: mit
- Created: 2017-04-13T20:39:05.000Z (about 8 years ago)
- Default Branch: master
- Last Pushed: 2018-07-13T16:12:33.000Z (almost 7 years ago)
- Last Synced: 2025-03-29T00:12:54.778Z (2 months ago)
- Topics: 2, 3, android, app, cordova, cordova-plugin, cordova-plugin-hockeyapp, hockey, hockeyapp, hockeyapp-plugin, hockeyapp-provider, ionic, ionic-cordova, ionic-framework, ionic-native, ionic-plugin, ionic2, ionic3, ios
- Language: TypeScript
- Homepage:
- Size: 2.73 MB
- Stars: 18
- Watchers: 9
- Forks: 7
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Ionic-HockeyApp
[](https://www.npmjs.com/package/ionic-hockeyapp)
[](https://nodei.co/npm/ionic-hockeyapp/)
[](https://nodei.co/npm/ionic-hockeyapp/)
[](https://github.com/hicsail/ionic-hockeyapp/blob/master/LICENSE)
[](https://github.com/hicsail/ionic-hockeyapp)
Need HockeyApp in your Ionic application, add this package!
This is an Ionic wrapper of the [cordova-plugin-hockeyapp](https://github.com/bitstadium/HockeySDK-Cordova) to make it easier to add [HockeyApp](http://hockeyapp.net/) into your Ionic application.
- [Supported Ionic Platforms](#supported-ionic-platforms)
- [Getting Started](#getting-started)
- [How to use](#how-to-use)
- [Example](#example)
- [API Reference](#api-reference)
- [Contributing](#contributing)
- [License](#license)
## Supported Ionic Platforms
Ionic 2 & 3 are fully supported, the latest version of Ionic that was tested is v3.6.1.
## Getting Started
Start by creating a [HockeyApp account](http://hockeyapp.net/) and register your app with the service.
### Install the official [HockeyApp plugin](https://github.com/bitstadium/HockeySDK-Cordova) by running this command:
```bash
ionic cordova plugin add cordova-plugin-hockeyapp@latest
```
### Install ionic-hockeyapp
```bash
npm install ionic-hockeyapp --save
```
### Add the HockeyApp provider to [app.module.ts](https://github.com/hicsail/ionic-hockeyapp/blob/master/example/src/app/app.module.ts)
```ts
import { HockeyApp } from 'ionic-hockeyapp';
providers: [
HockeyApp
]
```
## How to use
After following the Getting Started guide. Import HockeyApp provider into your class and call HockeyApp.
Start the HockeyApp Service in [app.component.ts](https://github.com/hicsail/ionic-hockeyapp/blob/master/example/src/app/app.component.ts)
```ts
import { HockeyApp } from 'ionic-hockeyapp';
import { Platform, App } from 'ionic-angular';
constructor(..., app:App, hockeyapp:HockeyApp) {
platform.ready().then(() => {
// The Android ID of the app as provided by the HockeyApp portal. Can be null if for iOS only.
let androidAppId = '9e49aeddaa96488891f0a46b52b27618';
// The iOS ID of the app as provided by the HockeyApp portal. Can be null if for android only.
let iosAppId = '7ea7b82b9b6e4366a8c8dd57e07b2743';
// Specifies whether you would like crash reports to be automatically sent to the HockeyApp server when the end user restarts the app.
let autoSendCrashReports = false;
// Specifies whether you would like to display the standard dialog when the app is about to crash. This parameter is only relevant on Android.
let ignoreCrashDialog = true;
hockeyapp.start(androidAppId, iosAppId, autoSendCrashReports, ignoreCrashDialog);
//So app doesn't close when hockey app activities close
//This also has a side effect of unable to close the app when on the rootPage and using the back button.
//Back button will perform as normal on other pages and pop to the previous page.
platform.registerBackButtonAction(() => {
let nav = app.getRootNav();
if (nav.canGoBack()) {
nav.pop();
} else {
nav.setRoot(this.rootPage);
}
});
});
}
```
After starting HockeyApp, import into pages, providers, and components and you are good to go.
```ts
import { HockeyApp } from 'ionic-hockeyapp';
constructor(..., private hockeyApp:HockeyApp) {
this.hockeyApp.trackEvent('Hello World');
}
```
## Example
Check out the example Ionic application in the [example folder](https://github.com/hicsail/ionic-hockeyapp/tree/master/example).
Android Screenshot | iOS Screenshot
:-------------------------:|:-------------------------:
 | 
## API Reference
Read the [Cordova HockeyApp API Reference](https://github.com/bitstadium/HockeySDK-Cordova#api-reference) for official documentation.
## Contributing
If you want to make an improvement, please feel free to fork this repo and submit a pull request.
Possible enhancements:
- Update HockeyApp start command to add Login Mode.
- Add Unit Tests
- ~~Make library promise based~~. Added in v0.1.6
## License
### MIT License
Copyright (c) 2017 Boston University - Software and Application Innovation Lab
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.