Update docs to use apm

Author: marchbold

README.md

@@ -24,6 +24,9 @@ your application to your own error logging server.
 
 ## Documentation
 
+Latest documentation can be found in the [documentation site](https://docs.airnativeextensions.com/docs/exceptions) along with the [asdocs](https://docs.airnativeextensions.com/asdocs/exceptions). 
+
+
 This extension is very simple in the implementation, having only 2 main functions.
 
 To start catching exceptions you simply call `setUncaughtExceptionHandler()` at 

docs/site/docs/exceptions/_includes/add-apm-appdescriptor.md

@@ -0,0 +1,20 @@
+
+
+Updating your application descriptor will insert the required `extensionID`'s and generate the manifest and info additions for your application. 
+
+You update your application descriptor by running:
+
+```
+apm generate app-descriptor src/MyApp-app.xml
+```
+
+Change the path (`src/MyApp-app.xml`) to point to your application descriptor.
+
+:::caution
+This will modify your application descriptor replacing the manifest additions and info additions with the ones generated from `apm`. 
+
+You should backup your application descriptor before running this command to ensure you don't lose any information.
+
+If you need to insert custom data into these sections see the guides for [Android](https://github.com/airsdk/apm/wiki/Usage-Generate#android) and [iOS](https://github.com/airsdk/apm/wiki/Usage-Generate#ios)
+:::
+

docs/site/docs/exceptions/_includes/add-apm.md

@@ -0,0 +1,72 @@
+
+
+
+:::info 
+Note: All of the commands below should be run in a terminal / command prompt in the root directory of your application, generally the level above your source directory.
+:::
+
+**If you don't have an APM project setup, expand the guide below to setup an APM project before installing the extension.**
+
+<details><summary>Setup APM</summary>
+<p>
+
+### Install APM
+
+If you haven't installed `apm` follow the install guide on [airsdk.dev](https://airsdk.dev/docs/basics/install-apm).
+
+
+### Setup an APM project 
+
+You will need an APM project for your application.
+
+
+There are many ways to do this and for more options see the [APM documentation](https://github.com/airsdk/apm/wiki/Usage-ProjectsAndPackages#initialise). Here we will just initialise a new empty project:
+
+```
+apm init
+```
+
+#### Check your github token
+
+We use github to secure our extensions so you must have created a github personal access token and configured `apm` to use it. 
+
+To do this create a token using this [guide from github](https://docs.github.com/en/github/authenticating-to-github/keeping-your-account-and-data-secure/creating-a-personal-access-token) and then set it in your apm config using:
+
+```
+apm config set github_token ghp_XXXXXXXXXXXXXXXXXXXXXXXXXXXX
+```
+
+If you don't do this correctly you may find the install will fail.
+
+</p>
+</details>
+
+
+### Install the extension 
+
+Install the extension by running: 
+
+```
+apm install com.distriqt.Exceptions
+```
+
+This will download and install the extension, required assets, and all dependencies.
+
+Once complete `apm` will have created something like the following file structure: 
+
+```
+.
+|____ ane
+| |____ com.distriqt.Exceptions.ane		# Exceptions extension
+| |____ [dependencies]
+|____ apm_packages						# cache directory - ignore
+|____ project.apm						# apm project file
+```
+
+- Add the `ane` directory to your IDE. *See the tutorials located [here](/docs/tutorials/getting-started) on adding an extension to your IDE.*
+
+:::info
+We suggest you use the locations directly in your builds rather than copying the files elsewhere. The reason for this is if you ever go to update the extensions using `apm` that these updates will be pulled into your build automatically.
+:::
+
+

docs/site/docs/exceptions/_includes/add-manual-appdescriptor.md

@@ -0,0 +1,12 @@
+
+### Extension IDs
+
+The following should be added to your `extensions` node in your application descriptor to identify all the required ANEs in your application:
+
+```xml
+<extensions>
+    <extensionID>com.distriqt.Exceptions</extensionID>
+    <extensionID>com.distriqt.Core</extensionID>
+</extensions>
+```
+

docs/site/docs/exceptions/_includes/add-manual.md

@@ -0,0 +1,29 @@
+
+:::info
+The following guide is used to manually install the extension, download dependencies and update the application descriptor. We highly recommend installing extensions using `apm`. Using `apm` will automate the installation and automatically handle updates and dependencies along with greatly simplifying the application descriptor generation.
+:::
+
+
+First step is always to add the extension to your development environment. Download the extension from the repository and then follow the tutorial located [here](/docs/tutorials/getting-started) to add the extension to your development environment.
+
+
+
+
+### Dependencies
+
+Many of our extensions use some common libraries, for example, the Android Support libraries.
+
+We have to separate these libraries into separate extensions in order to avoid multiple versions of the libraries being included in your application and causing packaging conflicts. This means that you need to include some additional extensions in your application along with the main extension file.
+
+You will add these extensions as you do with any other extension, and you need to ensure it is packaged with your application.
+
+
+#### Core 
+
+The Core ANE is required by this ANE. You must include and package this extension in your application.
+
+The Core ANE doesn't provide any functionality in itself but provides support libraries and frameworks used by our extensions.
+It also includes some centralised code for some common actions that can cause issues if they are implemented in each individual extension.
+
+You can access this extension here: [https://github.com/distriqt/ANE-Core](https://github.com/distriqt/ANE-Core).
+

docs/site/docs/exceptions/add-the-extension.mdx

@@ -0,0 +1,73 @@
+---
+title: Add the Extension
+sidebar_label: Add the Extension
+---
+
+import Tabs from '@theme/Tabs'
+import TabItem from '@theme/TabItem'
+
+import InstallAPM from './_includes/add-apm.md'
+import InstallManual from './_includes/add-manual.md'
+
+import AppDescriptorAPM from './_includes/add-apm-appdescriptor.md'
+import AppDescriptorManual from './_includes/add-manual-appdescriptor.md'
+
+
+The simplest way to install and manage your AIR native extensions and libraries is to use the AIR Package Manager (`apm`). We highly recommend using `apm`, as it will handle downloading all required dependencies and manage your application descriptor (Android manifest additions, iOS info additions etc).
+
+However you can choose to install it manually, as you would have done in the past. 
+
+## Install
+
+<Tabs
+  groupId="packagemanager"
+  defaultValue="apm"
+  values={[
+    {label: 'APM', value: 'apm'},
+    {label: 'Manual', value: 'manual'},
+  ]}>
+
+  <TabItem value="apm" >
+	<InstallAPM/>
+  </TabItem>
+  <TabItem value="manual" >
+	<InstallManual/>
+  </TabItem>
+  
+</Tabs>
+
+
+## Application Descriptor
+
+<Tabs
+  groupId="packagemanager"
+  defaultValue="apm"
+  values={[
+    {label: 'APM', value: 'apm'},
+    {label: 'Manual', value: 'manual'},
+  ]}>
+
+  <TabItem value="apm" >
+	<AppDescriptorAPM/>
+  </TabItem>
+  <TabItem value="manual" >
+	<AppDescriptorManual/>
+  </TabItem>
+  
+</Tabs>
+
+
+
+## Checking for Support
+
+You can use the `isSupported` flag to determine if this extension is supported on the current platform and device.
+
+This allows you to react to whether the functionality is available on the device and provide an alternative solution if not.
+
+
+```actionscript
+if (Exceptions.isSupported)
+{
+	// Functionality here
+}
+```

docs/site/docs/exceptions/images/msp_logo.png

@@ -0,0 +1,42 @@
+---
+title: Exceptions
+hide_title: true
+slug: /exceptions/
+---
+
+![Exceptions](images/promo.png)
+
+# Exceptions
+
+Exceptions is an AIR Native Extension to enable a global exception handler for iOS and Android.
+
+This will catch and store information about crashes of your application allowing you to process
+them on the next application run. In using this extension you can report crashes and errors in 
+your application to your own error logging server. 
+
+
+### Features
+
+- Catch exceptions 
+- Process exceptions on startup 
+- Single API interface - your code works across supported platforms with no modifications
+- Sample project code and ASDocs reference
+
+
+## Documentation
+
+Latest documentation can be found in the [documentation site](https://docs.airnativeextensions.com/docs/exceptions) along with the [asdocs](https://docs.airnativeextensions.com/asdocs/exceptions). 
+
+Quick Example: 
+
+```actionscript
+Exceptions.service.setUncaughtExceptionHandler();
+```
+
+
+## Acknowledgements
+
+This extension was made possible with support by [MovieStarPlanet](http://corporate.moviestarplanet.com/) 
+
+![MovieStarPlanet](images/msp_logo.png)
+

docs/site/docs/exceptions/images/promo.png

@@ -0,0 +1,35 @@
+---
+title: Usage
+sidebar_label: Usage
+---
+
+This extension is very simple in the implementation, having only 2 main functions.
+
+To start catching exceptions you simply call `setUncaughtExceptionHandler()` at 
+some point at the beginning of your application.
+
+```actionscript
+Exceptions.service.setUncaughtExceptionHandler();
+```
+
+
+To check if your application crashed previously you use the `hasPendingException()` function.
+
+```actionscript
+if (Exceptions.service.hasPendingException())
+{
+	var report:ExceptionReport = Exceptions.service.getPendingException();
+	trace( "date: "+    new Date(report.timestamp).toLocaleString() );
+	trace( "name: "+    report.name );
+	trace( "reason: "+  report.reason );
+	trace( "report: "+  report.report );
+}
+```
+
+:::note 
+You can generally only have **one** exception handler in an application.
+ 
+So if you are using another library that tracks exceptions (Google Analytics or a bug tracker) then the functionality provided here may not work or may stop the library from working.
+
+You should decide which is the more important method and ensure only one method is used in your application. 
+:::