application v8.1.0

Author: marchbold

docs/application/_includes/add-apm-appdescriptor.md renamed to docs/application/_includes/add-apm-appdescriptor.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.Application
+```
+
+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.Application.ane	# Application 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/application/_includes/add-apm.md

@@ -12,6 +12,7 @@ The following should be added to your `extensions` node in your application desc
 	<extensionID>androidx.core</extensionID>
 	<extensionID>com.distriqt.playservices.Base</extensionID>
 	<extensionID>com.distriqt.playservices.AppSet</extensionID>
+	<extensionID>com.jetbrains.kotlin</extensionID>
 </extensions>
 ```
 
@@ -64,6 +65,34 @@ Generally this is your AIR application id prefixed by `air.` unless you have spe
 ```
 
 
+#### Android Gradle Version 
+
+We have updated the required gradle version used to build your application to be higher than the default AIR currently uses (April 2025). 
+
+To specify a higher version add the following to your android node in your application descriptor:
+
+```xml
+<android>
+    <gradleVersion>8.9</gradleVersion>
+    <androidGradlePluginVersion>8.7.3</androidGradlePluginVersion>
+
+  ...
+</android>
+```
+
+If you don't do this you will see the following error when building your application:
+
+```
+Unexpected failure: Unable to run java: com.adobe.air.ADTException: gradle tool failed: 
+FAILURE: Build failed with an exception.
+
+...
+
+   > BUG! exception in phase 'semantic analysis' in source unit '_BuildScript_' Unsupported class file major version 65
+```
+
+
+
 #### MultiDex Applications 
 
 :::warning

docs/application/_includes/add-apm.mdx

@@ -36,6 +36,7 @@ These libraries are specific to Android. There are no issues including these on
 This extension requires the following extensions:
 
 - [androidx.core](https://github.com/distriqt/ANE-AndroidSupport/raw/master/lib/androidx.core.ane)
+- [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/application/_includes/add-manual-appdescriptor.md renamed to docs/application/_includes/add-manual-appdescriptor.mdx

@@ -7,11 +7,11 @@ 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 InstallAPM from './_includes/add-apm.mdx'
+import InstallManual from './_includes/add-manual.mdx'
 
-import AppDescriptorAPM from './_includes/add-apm-appdescriptor.md'
-import AppDescriptorManual from './_includes/add-manual-appdescriptor.md'
+import AppDescriptorAPM from './_includes/add-apm-appdescriptor.mdx'
+import AppDescriptorManual from './_includes/add-manual-appdescriptor.mdx'
 
 Here we will show you how to add the extension to your development environment and make the necessary changes to your application descriptor to correctly support the extension.
 

docs/application/_includes/add-manual.md renamed to docs/application/_includes/add-manual.mdx

@@ -1,3 +1,9 @@
+### 2025.08.08 [v8.1.0]
+
+```
+fix(ios): resolve issue with scale not correctly reflecting state (resolves https://github.com/distriqt/ANE-Application/issues/300)
+```
+
 ### 2024.12.11 [v8.0.0]
 
 ```

docs/application/add-the-extension.mdx

@@ -20,6 +20,7 @@ trace( "screenHeight: " + Application.service.display.displayMetrics.screenHeigh
 trace( "screenWidth:  " + Application.service.display.displayMetrics.screenWidth );
 trace( "xdpi:         " + Application.service.display.displayMetrics.xdpi );
 trace( "ydpi:         " + Application.service.display.displayMetrics.ydpi );
+trace( "scale:        " + Application.service.display.displayMetrics.scale );
 trace( "nativeScale:  " + Application.service.display.displayMetrics.nativeScale );
 ```
 
@@ -33,9 +34,24 @@ The iOS screen density is determined from a lookup and is not provided by the AP
 
 ### Native Scale
 
-The `nativeScale` property is only valid on iOS. 
+The `scale` & `nativeScale` property are only valid on iOS. 
 
-This value reflects the scale factor needed to convert from the default logical coordinate space into the device coordinate space of this screen. The default logical coordinate space is measured using points. For Retina displays, the scale factor may be 3.0 or 2.0 and one point can represented by nine or four pixels, respectively. For standard-resolution displays, the scale factor is 1.0 and one point equals one pixel.
+These value reflects the scale factor needed to convert from the default logical coordinate space into the device coordinate space of this screen. The default logical coordinate space is measured using points. For Retina displays, the scale factor may be 3.0 or 2.0 and one point can represented by nine or four pixels, respectively. For standard-resolution displays, the scale factor is 1.0 and one point equals one pixel.
 
 This native scale property will change on an iOS device if the screen is put into it's "zoomed" display state and knowing this value can allow you to react accordingly.
 
+The following logic is useful when checking for the zoomed state of a device:
+
+```as3
+function isZoomed( displayMetrics:DisplayMetrics ):Boolean
+{
+    return displayMetrics.scale < displayMetrics.nativeScale;
+}
+
+if (isZoomed( Application.service.device.displayMetrics ))
+{
+    // zoomed state
+}
+```
+
+

docs/application/changelog.md

@@ -55,12 +55,18 @@ Application.service.display.setDisplayMode( DisplayMode.FULLSCREEN );
 
 ### Layout Modes
 
+:::caution Android 15 (API v35)
+With Android 15 apps are edge-to-edge by default on devices running Android 15 if the app is targeting Android 15 (API level 35). This means that layout modes are ignored and SHORT_EDGES, NEVER, and DEFAULT are interpreted as ALWAYS so that users don't see a black bar caused by the display cutout and appear edge-to-edge.
+:::
+
+
 Modern devices are moving towards smaller bezels and larger aspect ratios. On these devices, *display cutouts* or *"notches"* are a popular way to achieve an edge-to-edge experience while providing space for important sensors on the front of the device.
 
 We have two main options when displaying our content around cutouts, and how it will appear will depend on the display mode you are using. 
 
 - `LayoutMode.CUTOUT_SHORT_EDGES`: The window is allowed to extend into the cutout areas;
 - `LayoutMode.CUTOUT_NEVER`: The window is never allowed to overlap with the cutout area;
+- `LayoutMode.CUTOUT_ALWAYS`: Content is always allowed to extend into the cutout areas. **If your app targets SDK 35 and is running on an Android 15 device, this is the only allowed mode** ;
 
 To set the layout mode, pass the required mode as the second parameter to the `setDisplayMode()` function:
 
@@ -176,6 +182,7 @@ Ensure you place this within the `application` tag eg:
             <uses-permission android:name="android.permission.WAKE_LOCK" />
 
             <application>
+                <meta-data android:name="android.max_aspect" android:value="2.5" />
             </application>
         
         </manifest>

docs/application/display/display-metrics.md

@@ -1,7 +1,7 @@
 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"><!-- saved from url=(0014)about:internet --><html>
    <head>
       <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-      <title>All Classes - distriqt // Application</title>
+      <title>All Classes - Application</title>
       <base target="classFrame">
       <link rel="stylesheet" href="style.css" type="text/css" media="screen">
       <link rel="stylesheet" href="print.css" type="text/css" media="print">
@@ -121,4 +121,4 @@ <h3><a href="class-summary.html" target="classFrame" style="color:black">All Cla
       </table>
    </body>
 </html>
-<!--Copyright distriqt 2016<br/>Wed Dec 11 2024, 02:02 PM +10:00  -->
+<!--Copyright Michael Archbold 2025<br/>Fri Aug 8 2025, 01:18 PM +10:00  -->