agerange v0.0.1

Author: marchbold

docs/agerange/_includes/add-apm-appdescriptor.mdx

@@ -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/agerange/_includes/add-apm.mdx

@@ -0,0 +1,40 @@
+
+
+
+:::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.
+:::
+
+import SetupAPM from '../../_includes/apm/setup-apm.mdx'
+
+<SetupAPM />
+
+
+### Install the extension 
+
+Install the extension by running: 
+
+```
+apm install com.distriqt.AgeRange
+```
+
+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.AgeRange.ane	# AgeRange 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/agerange/_includes/add-manual-appdescriptor.mdx

@@ -0,0 +1,59 @@
+
+## 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.AgeRange</extensionID>
+	<extensionID>com.distriqt.Core</extensionID>
+	<extensionID>com.jetbrains.kotlin</extensionID>
+</extensions>
+```
+
+
+
+## iOS 
+
+
+
+### Entitlements 
+
+The following additions are for the `Entitlements` node of the iPhone section in your application descriptor:
+
+```xml
+<iPhone>
+	<Entitlements><![CDATA[
+
+		HERE
+
+	]]></Entitlements>
+</iPhone>
+```
+
+You need to add the correct entitlement for the **Declared Age Range** capability:
+
+```xml
+<key>com.apple.developer.declared-age-range</key>
+<true/>
+```
+
+
+## Android 
+
+### Manifest Additions
+
+The AgeRange extension only supports API version 23 and higher so you need to specify this in your manifest. You should add the listing below to your manifest.
+
+```xml
+<manifest android:installLocation="auto">
+	<uses-sdk android:minSdkVersion="23" android:targetSdkVersion="35" />
+	
+	<application>
+	</application>
+</manifest>
+```
+
+
+
+

docs/agerange/_includes/add-manual.mdx

@@ -0,0 +1,43 @@
+
+:::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 extension is required by this extension. You must include this extension in your application.
+
+The Core extension 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).
+
+
+
+### Android Support
+
+The Android Support libraries encompass the Android Support, Android X and common Google libraries.
+
+These libraries are specific to Android. There are no issues including these on all platforms, they are just **required** for Android.
+
+This extension requires the following extensions:
+
+- [com.jetbrains.kotlin](https://github.com/distriqt/ANE-AndroidSupport/raw/master/lib/com.jetbrains.kotlin.ane)
+
+You can access these extensions here: [https://github.com/distriqt/ANE-AndroidSupport](https://github.com/distriqt/ANE-AndroidSupport).
+

docs/agerange/add-the-extension.mdx

@@ -0,0 +1,78 @@
+---
+title: Add the Extension
+sidebar_label: AIR
+---
+
+import Tabs from '@theme/Tabs'
+import TabItem from '@theme/TabItem'
+
+import InstallAPM from './_includes/add-apm.mdx'
+import InstallManual from './_includes/add-manual.mdx'
+
+import AppDescriptorAPM from './_includes/add-apm-appdescriptor.mdx'
+import AppDescriptorManual from './_includes/add-manual-appdescriptor.mdx'
+
+
+
+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
+  Id="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
+  Id="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 (AgeRange.isSupported)
+{
+	// Functionality here
+}
+```
+
+
+

docs/agerange/add-the-plugin.md

@@ -0,0 +1,107 @@
+---
+title: Add the Plugin
+sidebar_label: Unity
+---
+
+First step is always to add the plugin to your development environment. 
+
+
+## Asset Store
+
+Open the Asset Store in your browser and add the plugin to your assets.
+
+Open the Package Manager (Window > Package Manager) in the Unity Editor and select the "My Assets" section. Select the plugin, and click Import in the bottom right.
+
+
+## Manual Installation
+
+In unity you import the package by selecting `Assets / Import Package / Custom Package ...` and then browsing to the unity plugin package file: `com.distriqt.AgeRange.unitypackage`.
+
+![](images/unity-import-package.png)
+
+You can manually download the extension from our repository:
+
+- https://github.com/distriqt/ANE-AgeRange
+
+
+
+## Import the Plugin
+
+
+This will present the import dialog and display all the files for the plugin, make sure all the files are selected.
+
+The plugin will be added to your project and you can now use the plugins functionality in your application.
+
+
+
+
+## Resolve Android Dependencies
+
+This plugin depends on some common Android libraries, particularly the Google Play Core Library, which enables in-app reviews.
+
+You can get these dependencies using one of the following methods.
+
+
+### Unity Jar Resolver
+
+This is the suggested method.
+
+Use the *Unity Jar Resolver* plugin to download and manage the Android dependencies. 
+
+
+
+#### Importing
+
+> If you already use the *Unity Jar Resolver* in your project you can skip this step.
+
+- Download the latest version of the [*Unity Jar Resolver*](https://github.com/googlesamples/unity-jar-resolver/releases)
+- Import the plugin by selecting `Assets / Import Package / Custom Package ...` and locate the plugin you downloaded. The plugin will be in the zip named: `external-dependency-manager-latest.unitypackage` 
+- In the *Import Unity Package* window, click Import
+
+
+#### Resolving
+
+By default, the resolver should run automatically and will add the dependencies required by this plugin. 
+
+If you have need to resolve the dependencies manually then you will need to:
+
+- Open the menu under: `Assets / External Dependency Manager / Android Resolver`
+- Select `Resolve` or `Force Resolve`
+
+
+More information on the *Unity Jar Resolver* can be found [here](https://github.com/googlesamples/unity-jar-resolver)
+
+
+
+### Custom Gradle AgeRange
+
+Unity's in-built gradle build support and exporting to android studio does not support per plugin gradle script. Therefore, this plugin cannot add the dependencies by itself.
+
+The `mainAgeRange.gradle` is generated when you enable the **Custom Gradle AgeRange** property on the Player window.
+
+The `build.gradle` exists in generated Gradle project when you enable the **Export Project** property on the Player window and Build the project.
+
+Update the `dependencies` section in your `mainAgeRange.gradle` or `build.gradle` as below:
+
+```
+dependencies {
+    compile fileTree(dir: 'libs', include: ['*.jar'])
+    
+	implementation 'com.google.android.play:core:1.9.1'
+}
+```
+
+
+## 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.
+
+
+```csharp
+if (AgeRange.isSupported)
+{
+	// Functionality here
+}
+```