New Relic Unity Plugin
=====================

Unity plugins for the New Relic iOS and Android agents.

API documentation is included within. View by opening doc/index.html

Installing the New Relic plugin
---------------------

1. Install newrelic-unity-plugin.unitypackage into your project by going
   to "Assets > Import Package > Custom Package..." and select newrelic-unity-plugin.unitypackage.

2. Create a new GameObject in your project's initial scene by going to "GameObject > Create Empty" and naming it "NewRelicAgent"

3. Add NewRelicAgent.cs script (located in Assets/Plugins) to NewRelicAgent GameObject by dragging it on top of "NewRelicAgent" in the Hierarchy tab

4. In the Inspector tab, set the iOS and Android Application Token from your New Relic Mobile apps. (We recommend separate New Relic Mobile apps for separate platforms.)

5. Build for your platform (iOS or Android) & open the resulting project (Xcode or Android Studio). AndroidStudio can import the generated project.
   
   Android notes:
   Ensure that your app requests the INTERNET permission through the Player Settings inspector window.
   In Other Settings, Configuration, ensure Internet Access drop down is set to 'Required'. This will result in the following permission added
   to the app's manifest: 
        <uses-permission android:name="android.permission.INTERNET" />

   iOS notes:
   If using crash reporting, the dSYM for the released build will need to be uploaded to New Relic for symbolication to create readable stack traces. See instructions here: https://docs.newrelic.com/docs/mobile-monitoring/new-relic-mobile/getting-started/ios-agent-crash-reporting#manual-dsym
   If the app is built with Bitcode enabled, the dSYM needs to be retrieved from Apple prior to upload: https://docs.newrelic.com/docs/mobile-monitoring/new-relic-mobile/miscellaneous/retrieve-upload-dsyms-bitcode-enabled-apps

And you're good to go!


Copyright ©2016 New Relic, Inc. All Rights Reserved.
See LICENSE file for license details and third-party library information.


Credits
-------
This plugin uses
[mod-pbxproj](https://github.com/kronenthaler/mod-pbxproj)


New Relic Unity Package version 1.1.0
--------------------------------------------------------

Using New Relic iOS Agent version 5.8.0
Using New Relic Android Agent version 5.7.1
