pushnotifications v17.0.1

Author: marchbold

docs/pushnotifications/changelog.md

@@ -1,3 +1,10 @@
+### 2025.09.17 [v17.0.1]
+
+```
+feat(docs): update onesignal amazon manual integration docs (resolves https://github.com/distriqt/ANE-PushNotifications/issues/629) 
+feat(onesignal): update sdk: android v5.1.37 iOS v5.2.14 (resolves https://github.com/distriqt/ANE-PushNotifications/issues/631)
+```
+
 ### 2025.08.26 [v17.0.0]
 
 ```

docs/pushnotifications/onesignal/_includes/add-apm-appdescriptor.mdx

@@ -32,3 +32,69 @@ You should backup your application descriptor before running this command to ens
 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)
 :::
 
+
+
+
+### Amazon
+
+Amazon is a specific implementation of Android and requires some additional manifest additions if you are distributing your application via the Amazon AppStore.
+
+Firstly generate a custom android manifest addition for your application by running:
+
+```
+apm generate config android
+```
+
+This will create a file `config/android/AndroidManifest.xml` that you can add your required additions to.
+
+Add the following content to the manifest file (noting that you need to add the xmlns:amazon declaration to the manifest tag):
+
+```xml
+<?xml version="1.0" encoding="utf-8"?>
+<manifest xmlns:android="http://schemas.android.com/apk/res/android" xmlns:tools="http://schemas.android.com/tools"
+    xmlns:amazon="http://schemas.amazon.com/apk/res/android">
+
+    <uses-sdk android:minSdkVersion="24" android:targetSdkVersion="35" />
+
+    <uses-permission android:name="com.amazon.device.messaging.permission.RECEIVE" />
+    <permission android:name="${applicationId}.permission.RECEIVE_ADM_MESSAGE" android:protectionLevel="signature" />
+    <uses-permission android:name="${applicationId}.permission.RECEIVE_ADM_MESSAGE" />
+
+    <application>
+
+        <amazon:enable-feature android:name="com.amazon.device.messaging" android:required="false"/>
+        <service android:name="com.onesignal.notifications.services.ADMMessageHandler" android:exported="false" />
+        <service android:name="com.onesignal.notifications.services.ADMMessageHandlerJob"
+                android:permission="android.permission.BIND_JOB_SERVICE"
+                android:exported="false" />
+        <receiver android:name="com.onesignal.notifications.receivers.ADMMessageReceiver"
+                android:permission="com.amazon.device.messaging.permission.SEND"
+                android:exported="true" >
+            <intent-filter>
+                <action android:name="com.amazon.device.messaging.intent.REGISTRATION" />
+                <action android:name="com.amazon.device.messaging.intent.RECEIVE" />
+                <category android:name="${applicationId}" />
+            </intent-filter>
+        </receiver>
+
+    </application>
+
+</manifest>
+```
+
+Then regenerate your application descriptor to include these changes by running:
+
+```bash
+apm generate app-descriptor 
+```
+
+Follow the [guide here](https://documentation.onesignal.com/docs/generate-an-amazon-api-key) to generate your Amazon API Key. You should end up with a file (`api_key.txt`) that you will need to add to the root of your application and ensure it is packaged into your application.
+
+:::warning
+Do not place the `api_key.txt` file in an `assets` folder as mentioned in the OneSignal documentation. Any assets from AIR are automatically added into this directory, so add it at the top level of your application package.
+:::
+
+:::info
+You will need to be using a recent version of AIR to be able to support these additional manifest namespaces and tags.
+:::
+

docs/pushnotifications/onesignal/_includes/add-manual-appdescriptor.mdx

@@ -223,17 +223,18 @@ In the `application` tag, add the following:
 
 ```xml
 <amazon:enable-feature android:name="com.amazon.device.messaging" android:required="false"/>
-<service android:name="com.onesignal.ADMMessageHandler" android:exported="false" />
-<service android:name="com.onesignal.ADMMessageHandlerJob"
-         android:permission="android.permission.BIND_JOB_SERVICE"
-         android:exported="false" />
-<receiver android:name="com.onesignal.ADMMessageHandler$Receiver"
-          android:permission="com.amazon.device.messaging.permission.SEND" >
-    <intent-filter>
-        <action android:name="com.amazon.device.messaging.intent.REGISTRATION" />
-        <action android:name="com.amazon.device.messaging.intent.RECEIVE" />
-        <category android:name="APPLICATION_PACKAGE" />
-    </intent-filter>
+<service android:name="com.onesignal.notifications.services.ADMMessageHandler" android:exported="false" />
+<service android:name="com.onesignal.notifications.services.ADMMessageHandlerJob"
+          android:permission="android.permission.BIND_JOB_SERVICE"
+          android:exported="false" />
+<receiver android:name="com.onesignal.notifications.receivers.ADMMessageReceiver"
+          android:permission="com.amazon.device.messaging.permission.SEND"
+          android:exported="true" >
+  <intent-filter>
+    <action android:name="com.amazon.device.messaging.intent.REGISTRATION" />
+    <action android:name="com.amazon.device.messaging.intent.RECEIVE" />
+    <category android:name="APPLICATION_PACKAGE" />
+  </intent-filter>
 </receiver>
 ```
 

static/asdocs/pushnotifications/all-classes.html

@@ -67,4 +67,4 @@ <h3><a href="class-summary.html" target="classFrame" style="color:black">All Cla
       </table>
    </body>
 </html>
-<!--Copyright Michael Archbold 2025<br/>Tue Aug 26 2025, 07:46 PM +10:00  -->
+<!--Copyright Michael Archbold 2025<br/>Wed Sep 17 2025, 12:06 PM +10:00  -->

static/asdocs/pushnotifications/all-index-A.html

@@ -60,4 +60,4 @@
 		 User has authorised this application to display notifications 
 		 </td></tr><tr><td class="idxrow" colspan="2"><a href="com/distriqt/extension/pushnotifications/Service.html#AZURE" onclick="javascript:loadClassListFrame('com/distriqt/extension/pushnotifications/class-list.html');">AZURE</a> &mdash; Constant Static Property, class com.distriqt.extension.pushnotifications.<a href="com/distriqt/extension/pushnotifications/Service.html" onclick="javascript:loadClassListFrame('com/distriqt/extension/pushnotifications/class-list.html');">Service</a></td></tr><tr><td width="20"></td><td>
 		 Microsoft Azure Notification Hub
-		 </td></tr><tr><td colspan="2" style="padding-bottom:20px"></td></tr><tr><td colspan="2"><font color="black" size="10px" style="bold">A</font>&nbsp;&nbsp;<a href="all-index-B.html" onclick="javascript:loadClassListFrame('index-list.html');">B</a>&nbsp;&nbsp;<a href="all-index-C.html" onclick="javascript:loadClassListFrame('index-list.html');">C</a>&nbsp;&nbsp;<a href="all-index-D.html" onclick="javascript:loadClassListFrame('index-list.html');">D</a>&nbsp;&nbsp;<a href="all-index-E.html" onclick="javascript:loadClassListFrame('index-list.html');">E</a>&nbsp;&nbsp;<a href="all-index-F.html" onclick="javascript:loadClassListFrame('index-list.html');">F</a>&nbsp;&nbsp;<a href="all-index-G.html" onclick="javascript:loadClassListFrame('index-list.html');">G</a>&nbsp;&nbsp;<a href="all-index-H.html" onclick="javascript:loadClassListFrame('index-list.html');">H</a>&nbsp;&nbsp;<a href="all-index-I.html" onclick="javascript:loadClassListFrame('index-list.html');">I</a>&nbsp;&nbsp;<a href="all-index-J.html" onclick="javascript:loadClassListFrame('index-list.html');">J</a>&nbsp;&nbsp;<a href="all-index-K.html" onclick="javascript:loadClassListFrame('index-list.html');">K</a>&nbsp;&nbsp;<a href="all-index-L.html" onclick="javascript:loadClassListFrame('index-list.html');">L</a>&nbsp;&nbsp;<a href="all-index-M.html" onclick="javascript:loadClassListFrame('index-list.html');">M</a>&nbsp;&nbsp;<a href="all-index-N.html" onclick="javascript:loadClassListFrame('index-list.html');">N</a>&nbsp;&nbsp;<a href="all-index-O.html" onclick="javascript:loadClassListFrame('index-list.html');">O</a>&nbsp;&nbsp;<a href="all-index-P.html" onclick="javascript:loadClassListFrame('index-list.html');">P</a>&nbsp;&nbsp;<a href="all-index-Q.html" onclick="javascript:loadClassListFrame('index-list.html');">Q</a>&nbsp;&nbsp;<a href="all-index-R.html" onclick="javascript:loadClassListFrame('index-list.html');">R</a>&nbsp;&nbsp;<a href="all-index-S.html" onclick="javascript:loadClassListFrame('index-list.html');">S</a>&nbsp;&nbsp;<a href="all-index-T.html" onclick="javascript:loadClassListFrame('index-list.html');">T</a>&nbsp;&nbsp;<a href="all-index-U.html" onclick="javascript:loadClassListFrame('index-list.html');">U</a>&nbsp;&nbsp;<a href="all-index-V.html" onclick="javascript:loadClassListFrame('index-list.html');">V</a>&nbsp;&nbsp;<a href="all-index-W.html" onclick="javascript:loadClassListFrame('index-list.html');">W</a>&nbsp;&nbsp;<a href="all-index-X.html" onclick="javascript:loadClassListFrame('index-list.html');">X</a>&nbsp;&nbsp;<a href="all-index-Y.html" onclick="javascript:loadClassListFrame('index-list.html');">Y</a>&nbsp;&nbsp;<a href="all-index-Z.html" onclick="javascript:loadClassListFrame('index-list.html');">Z</a>&nbsp;&nbsp;</td></tr></table><p></p><center class="copyright"><footer>Copyright <a href="https://michaelarchbold.com" target="_top">Michael Archbold</a> 2025</footer><br/>Tue Aug 26 2025, 07:46 PM +10:00  </center></div></body></html><!--Copyright Michael Archbold 2025<br/>Tue Aug 26 2025, 07:46 PM +10:00  -->
+		 </td></tr><tr><td colspan="2" style="padding-bottom:20px"></td></tr><tr><td colspan="2"><font color="black" size="10px" style="bold">A</font>&nbsp;&nbsp;<a href="all-index-B.html" onclick="javascript:loadClassListFrame('index-list.html');">B</a>&nbsp;&nbsp;<a href="all-index-C.html" onclick="javascript:loadClassListFrame('index-list.html');">C</a>&nbsp;&nbsp;<a href="all-index-D.html" onclick="javascript:loadClassListFrame('index-list.html');">D</a>&nbsp;&nbsp;<a href="all-index-E.html" onclick="javascript:loadClassListFrame('index-list.html');">E</a>&nbsp;&nbsp;<a href="all-index-F.html" onclick="javascript:loadClassListFrame('index-list.html');">F</a>&nbsp;&nbsp;<a href="all-index-G.html" onclick="javascript:loadClassListFrame('index-list.html');">G</a>&nbsp;&nbsp;<a href="all-index-H.html" onclick="javascript:loadClassListFrame('index-list.html');">H</a>&nbsp;&nbsp;<a href="all-index-I.html" onclick="javascript:loadClassListFrame('index-list.html');">I</a>&nbsp;&nbsp;<a href="all-index-J.html" onclick="javascript:loadClassListFrame('index-list.html');">J</a>&nbsp;&nbsp;<a href="all-index-K.html" onclick="javascript:loadClassListFrame('index-list.html');">K</a>&nbsp;&nbsp;<a href="all-index-L.html" onclick="javascript:loadClassListFrame('index-list.html');">L</a>&nbsp;&nbsp;<a href="all-index-M.html" onclick="javascript:loadClassListFrame('index-list.html');">M</a>&nbsp;&nbsp;<a href="all-index-N.html" onclick="javascript:loadClassListFrame('index-list.html');">N</a>&nbsp;&nbsp;<a href="all-index-O.html" onclick="javascript:loadClassListFrame('index-list.html');">O</a>&nbsp;&nbsp;<a href="all-index-P.html" onclick="javascript:loadClassListFrame('index-list.html');">P</a>&nbsp;&nbsp;<a href="all-index-Q.html" onclick="javascript:loadClassListFrame('index-list.html');">Q</a>&nbsp;&nbsp;<a href="all-index-R.html" onclick="javascript:loadClassListFrame('index-list.html');">R</a>&nbsp;&nbsp;<a href="all-index-S.html" onclick="javascript:loadClassListFrame('index-list.html');">S</a>&nbsp;&nbsp;<a href="all-index-T.html" onclick="javascript:loadClassListFrame('index-list.html');">T</a>&nbsp;&nbsp;<a href="all-index-U.html" onclick="javascript:loadClassListFrame('index-list.html');">U</a>&nbsp;&nbsp;<a href="all-index-V.html" onclick="javascript:loadClassListFrame('index-list.html');">V</a>&nbsp;&nbsp;<a href="all-index-W.html" onclick="javascript:loadClassListFrame('index-list.html');">W</a>&nbsp;&nbsp;<a href="all-index-X.html" onclick="javascript:loadClassListFrame('index-list.html');">X</a>&nbsp;&nbsp;<a href="all-index-Y.html" onclick="javascript:loadClassListFrame('index-list.html');">Y</a>&nbsp;&nbsp;<a href="all-index-Z.html" onclick="javascript:loadClassListFrame('index-list.html');">Z</a>&nbsp;&nbsp;</td></tr></table><p></p><center class="copyright"><footer>Copyright <a href="https://michaelarchbold.com" target="_top">Michael Archbold</a> 2025</footer><br/>Wed Sep 17 2025, 12:06 PM +10:00  </center></div></body></html><!--Copyright Michael Archbold 2025<br/>Wed Sep 17 2025, 12:06 PM +10:00  -->

static/asdocs/pushnotifications/all-index-B.html

@@ -16,4 +16,4 @@
 
 		 		 </td></tr><tr><td class="idxrow" colspan="2"><a href="com/distriqt/extension/pushnotifications/builders/CategoryBuilder.html#build()" onclick="javascript:loadClassListFrame('com/distriqt/extension/pushnotifications/builders/class-list.html');">build</a>() &mdash; method,  class com.distriqt.extension.pushnotifications.builders.<a href="com/distriqt/extension/pushnotifications/builders/CategoryBuilder.html" onclick="javascript:loadClassListFrame('com/distriqt/extension/pushnotifications/builders/class-list.html');">CategoryBuilder</a></td></tr><tr><td width="20"></td><td></td></tr><tr><td class="idxrow" colspan="2"><a href="com/distriqt/extension/pushnotifications/builders/ChannelBuilder.html#build()" onclick="javascript:loadClassListFrame('com/distriqt/extension/pushnotifications/builders/class-list.html');">build</a>() &mdash; method,  class com.distriqt.extension.pushnotifications.builders.<a href="com/distriqt/extension/pushnotifications/builders/ChannelBuilder.html" onclick="javascript:loadClassListFrame('com/distriqt/extension/pushnotifications/builders/class-list.html');">ChannelBuilder</a></td></tr><tr><td width="20"></td><td>
 	     Create an instance of the Channel
-	     	     </td></tr><tr><td colspan="2" style="padding-bottom:20px"></td></tr><tr><td colspan="2"><a href="all-index-A.html" onclick="javascript:loadClassListFrame('index-list.html');">A</a>&nbsp;&nbsp;<font color="black" size="10px" style="bold">B</font>&nbsp;&nbsp;<a href="all-index-C.html" onclick="javascript:loadClassListFrame('index-list.html');">C</a>&nbsp;&nbsp;<a href="all-index-D.html" onclick="javascript:loadClassListFrame('index-list.html');">D</a>&nbsp;&nbsp;<a href="all-index-E.html" onclick="javascript:loadClassListFrame('index-list.html');">E</a>&nbsp;&nbsp;<a href="all-index-F.html" onclick="javascript:loadClassListFrame('index-list.html');">F</a>&nbsp;&nbsp;<a href="all-index-G.html" onclick="javascript:loadClassListFrame('index-list.html');">G</a>&nbsp;&nbsp;<a href="all-index-H.html" onclick="javascript:loadClassListFrame('index-list.html');">H</a>&nbsp;&nbsp;<a href="all-index-I.html" onclick="javascript:loadClassListFrame('index-list.html');">I</a>&nbsp;&nbsp;<a href="all-index-J.html" onclick="javascript:loadClassListFrame('index-list.html');">J</a>&nbsp;&nbsp;<a href="all-index-K.html" onclick="javascript:loadClassListFrame('index-list.html');">K</a>&nbsp;&nbsp;<a href="all-index-L.html" onclick="javascript:loadClassListFrame('index-list.html');">L</a>&nbsp;&nbsp;<a href="all-index-M.html" onclick="javascript:loadClassListFrame('index-list.html');">M</a>&nbsp;&nbsp;<a href="all-index-N.html" onclick="javascript:loadClassListFrame('index-list.html');">N</a>&nbsp;&nbsp;<a href="all-index-O.html" onclick="javascript:loadClassListFrame('index-list.html');">O</a>&nbsp;&nbsp;<a href="all-index-P.html" onclick="javascript:loadClassListFrame('index-list.html');">P</a>&nbsp;&nbsp;<a href="all-index-Q.html" onclick="javascript:loadClassListFrame('index-list.html');">Q</a>&nbsp;&nbsp;<a href="all-index-R.html" onclick="javascript:loadClassListFrame('index-list.html');">R</a>&nbsp;&nbsp;<a href="all-index-S.html" onclick="javascript:loadClassListFrame('index-list.html');">S</a>&nbsp;&nbsp;<a href="all-index-T.html" onclick="javascript:loadClassListFrame('index-list.html');">T</a>&nbsp;&nbsp;<a href="all-index-U.html" onclick="javascript:loadClassListFrame('index-list.html');">U</a>&nbsp;&nbsp;<a href="all-index-V.html" onclick="javascript:loadClassListFrame('index-list.html');">V</a>&nbsp;&nbsp;<a href="all-index-W.html" onclick="javascript:loadClassListFrame('index-list.html');">W</a>&nbsp;&nbsp;<a href="all-index-X.html" onclick="javascript:loadClassListFrame('index-list.html');">X</a>&nbsp;&nbsp;<a href="all-index-Y.html" onclick="javascript:loadClassListFrame('index-list.html');">Y</a>&nbsp;&nbsp;<a href="all-index-Z.html" onclick="javascript:loadClassListFrame('index-list.html');">Z</a>&nbsp;&nbsp;</td></tr></table><p></p><center class="copyright"><footer>Copyright <a href="https://michaelarchbold.com" target="_top">Michael Archbold</a> 2025</footer><br/>Tue Aug 26 2025, 07:46 PM +10:00  </center></div></body></html><!--Copyright Michael Archbold 2025<br/>Tue Aug 26 2025, 07:46 PM +10:00  -->
+	     	     </td></tr><tr><td colspan="2" style="padding-bottom:20px"></td></tr><tr><td colspan="2"><a href="all-index-A.html" onclick="javascript:loadClassListFrame('index-list.html');">A</a>&nbsp;&nbsp;<font color="black" size="10px" style="bold">B</font>&nbsp;&nbsp;<a href="all-index-C.html" onclick="javascript:loadClassListFrame('index-list.html');">C</a>&nbsp;&nbsp;<a href="all-index-D.html" onclick="javascript:loadClassListFrame('index-list.html');">D</a>&nbsp;&nbsp;<a href="all-index-E.html" onclick="javascript:loadClassListFrame('index-list.html');">E</a>&nbsp;&nbsp;<a href="all-index-F.html" onclick="javascript:loadClassListFrame('index-list.html');">F</a>&nbsp;&nbsp;<a href="all-index-G.html" onclick="javascript:loadClassListFrame('index-list.html');">G</a>&nbsp;&nbsp;<a href="all-index-H.html" onclick="javascript:loadClassListFrame('index-list.html');">H</a>&nbsp;&nbsp;<a href="all-index-I.html" onclick="javascript:loadClassListFrame('index-list.html');">I</a>&nbsp;&nbsp;<a href="all-index-J.html" onclick="javascript:loadClassListFrame('index-list.html');">J</a>&nbsp;&nbsp;<a href="all-index-K.html" onclick="javascript:loadClassListFrame('index-list.html');">K</a>&nbsp;&nbsp;<a href="all-index-L.html" onclick="javascript:loadClassListFrame('index-list.html');">L</a>&nbsp;&nbsp;<a href="all-index-M.html" onclick="javascript:loadClassListFrame('index-list.html');">M</a>&nbsp;&nbsp;<a href="all-index-N.html" onclick="javascript:loadClassListFrame('index-list.html');">N</a>&nbsp;&nbsp;<a href="all-index-O.html" onclick="javascript:loadClassListFrame('index-list.html');">O</a>&nbsp;&nbsp;<a href="all-index-P.html" onclick="javascript:loadClassListFrame('index-list.html');">P</a>&nbsp;&nbsp;<a href="all-index-Q.html" onclick="javascript:loadClassListFrame('index-list.html');">Q</a>&nbsp;&nbsp;<a href="all-index-R.html" onclick="javascript:loadClassListFrame('index-list.html');">R</a>&nbsp;&nbsp;<a href="all-index-S.html" onclick="javascript:loadClassListFrame('index-list.html');">S</a>&nbsp;&nbsp;<a href="all-index-T.html" onclick="javascript:loadClassListFrame('index-list.html');">T</a>&nbsp;&nbsp;<a href="all-index-U.html" onclick="javascript:loadClassListFrame('index-list.html');">U</a>&nbsp;&nbsp;<a href="all-index-V.html" onclick="javascript:loadClassListFrame('index-list.html');">V</a>&nbsp;&nbsp;<a href="all-index-W.html" onclick="javascript:loadClassListFrame('index-list.html');">W</a>&nbsp;&nbsp;<a href="all-index-X.html" onclick="javascript:loadClassListFrame('index-list.html');">X</a>&nbsp;&nbsp;<a href="all-index-Y.html" onclick="javascript:loadClassListFrame('index-list.html');">Y</a>&nbsp;&nbsp;<a href="all-index-Z.html" onclick="javascript:loadClassListFrame('index-list.html');">Z</a>&nbsp;&nbsp;</td></tr></table><p></p><center class="copyright"><footer>Copyright <a href="https://michaelarchbold.com" target="_top">Michael Archbold</a> 2025</footer><br/>Wed Sep 17 2025, 12:06 PM +10:00  </center></div></body></html><!--Copyright Michael Archbold 2025<br/>Wed Sep 17 2025, 12:06 PM +10:00  -->