https://github.com/hypery2k/nativescript-fabric

Handling App URLs in nativescript apps
https://github.com/hypery2k/nativescript-fabric

android farming ios nativescript nativescript-plugin

Last synced: 3 months ago
JSON representation

Handling App URLs in nativescript apps

• Host: GitHub
• URL: https://github.com/hypery2k/nativescript-fabric
• Owner: hypery2k
• License: mit
• Created: 2016-11-28T07:11:25.000Z (about 8 years ago)
• Default Branch: develop
• Last Pushed: 2023-12-15T03:01:00.000Z (about 1 year ago)
• Last Synced: 2024-04-26T00:25:24.235Z (8 months ago)
• Topics: android, farming, ios, nativescript, nativescript-plugin
• Language: JavaScript
• Homepage:
• Size: 2.84 MB
• Stars: 29
• Watchers: 6
• Forks: 14
• Open Issues: 14
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# NativeScript Fabric Plugin ![apple](https://cdn3.iconfinder.com/data/icons/picons-social/57/16-apple-32.png) ![android](https://cdn4.iconfinder.com/data/icons/logos-3/228/android-32.png)

[![Greenkeeper badge](https://badges.greenkeeper.io/hypery2k/nativescript-fabric.svg)](https://greenkeeper.io/)

[![Build Status](https://travis-ci.org/hypery2k/nativescript-fabric.svg?branch=master)](https://travis-ci.org/hypery2k/nativescript-fabric)

[![Donate with Bitcoin](https://martinreinhardt-online.de/assets/img/button-badge-bitcoin.svg)](bitcoin:3NKtxw1SRYgess5ev4Ri54GekoAgkR213D)

[![npm version](https://badge.fury.io/js/nativescript-fabric.svg)](http://badge.fury.io/js/nativescript-fabric)

[![Maintainability](https://api.codeclimate.com/v1/badges/85a5fd560b331cd8922e/maintainability)](https://codeclimate.com/github/hypery2k/nativescript-fabric/maintainability)

[![NPM](https://nodei.co/npm/nativescript-fabric.png?downloads=true&downloadRank=true&stars=true)](https://nodei.co/npm/nativescript-fabric/)



> Feel free to **donate**

>

> 

> 

> 

> Or donate Bitcoins: bitcoin:3NKtxw1SRYgess5ev4Ri54GekoAgkR213D

>

> [![Bitcoin](https://martinreinhardt-online.de/bitcoin.png)](bitcoin:3NKtxw1SRYgess5ev4Ri54GekoAgkR213D)

>

> Also via [greenaddress](https://greenaddress.it/pay/GA3ZPfh7As3Gc2oP6pQ1njxMij88u/)

# Usage

## Installation

Go to [Crashlytics](https://fabric.io/kits/ios/crashlytics/install) and pick of the needed API-Key and API-Secret:

![](etc/crashlytics_configuration.png)

Create a file fabric.json in the project root folder and add the API-Key and API-Secret: 

```

{

    "using_ios": true,

    "using_android": true,

    "api_key": "...",

    "api_secret": "..."

}

```

```

$ tns plugin add nativescript-fabric

```

Or if you want to use the development version (nightly build), which maybe not stable!:

```

$ tns plugin add nativescript-fabric@next

```

### Android

Add the API-Key to your AndroidManifest.xml:

```

 ....

  

    ...

    

  

```

### iOS

No further confiugration needed

## Additional information

### Android 

For more details see [fabric.io/kits/android/crashlytics](https://fabric.io/kits/android/crashlytics/install).

### iOS

For more details see [fabric.io/kits/ios/crashlytics](https://fabric.io/kits/ios/crashlytics/manual-install?step=1).

## API

Init the plugin in your app (for angular apps use main.ts):

```

import { Fabric } from 'nativescript-fabric';

Fabric.init();

```

Afterwards you can use the instance methods for logging (general error logging is already added):

* `Fabric.logSignUp(method: string, success: boolean);`

* `Fabric.logLogin(method: string, success: boolean);`

* `Fabric.logContentView(id: string, name: string, type: string)`

* `Fabric.logCustomEvent(withName: string, customAttributes: Map)`

* `Fabric.logError(error: any, msg?: string)`

## Angular

```

import { FabricModule } from 'nativescript-fabric/angular';

NgModule({

  ...

  imports: [

    FabricModule.forRoot()

  ],

```

# Known Issues

## com.android.ide.common.process.ProcessException

```

FAILURE: Build failed with an exception.

* What went wrong:

Execution failed for task ':app:transformClassesWithDexForF0F1F2F3F4F5Debug'.

> com.android.build.api.transform.TransformException: com.android.ide.common.process.ProcessException: java.util.concurrent.ExecutionException: com.android.dex.DexIndexOverflowException: Cannot merge new index 69013 into a non-jumbo instruction!nto a non-jumbo instruction!

```

set the following in your app.gradle:

```

android {

    ...

    dexOptions {

        jumboMode true

    }

}

```

## XML Parsing error

```

Error:/app/build/intermediates/res/merged/debug/values/com_crashlytics_build_id.xml uncompiled XML file passed as argument. Must be compiled first into .flat file.

```

Try adding:

```

android.enableAapt2 = false

```

to your `gradle.properties` file.