refactor: deprecate suppressNotification parameter in icon methods

Author: johnborges

ios/Sources/AppIconPlugin/AppIconPlugin.swift

@@ -30,21 +30,18 @@ public class AppIconPlugin: CAPPlugin, CAPBridgedPlugin {
     }
 
     @objc func reset(_ call: CAPPluginCall) {
-        let suppressNotification = call.getBool("suppressNotification") ?? true
-
-        setIcon(iconName: nil, suppressNotification: suppressNotification, call)
+        let _ = call.getBool("suppressNotification") // Deprecated: parameter is ignored
+        setIcon(iconName: nil, call)
     }
 
     @objc func change(_ call: CAPPluginCall) {
-
         guard let iconName = call.getString("name") else {
             call.reject("Must provide an icon name.")
             return
         }
 
-        let suppressNotification = call.getBool("suppressNotification") ?? true
-
-        setIcon(iconName: iconName, suppressNotification: suppressNotification, call)
+        let _ = call.getBool("suppressNotification") // Deprecated: parameter is ignored
+        setIcon(iconName: iconName, call)
     }
 
     func setIcon(iconName: String?, suppressNotification: Bool, _ call: CAPPluginCall) {

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@capacitor-community/app-icon",
-  "version": "6.0.0",
+  "version": "6.1.0",
   "description": "Capacitor community plugin for changing an iOS app icon.",
   "main": "dist/plugin.cjs.js",
   "module": "dist/esm/index.js",

src/definitions.ts

@@ -10,15 +10,19 @@ export interface IconOptions {
   disable?: string[];
   /**
    * Flag controlling the in app notification which shows after icon is changed. (iOS)
+   * @deprecated This parameter is ignored as it no longer works reliably on iOS 17+ and risks App Store rejection. The system notification will always be shown.
+   * @since 6.1.0
    */
-  suppressNotification: boolean;
+  suppressNotification?: boolean;
 }
 
 export interface ResetOptions {
   /**
    * Flag controlling the in app notification which shows after icon is changed (iOS).
+   * @deprecated This parameter is ignored as it no longer works reliably on iOS 17+ and risks App Store rejection. The system notification will always be shown.
+   * @since 6.1.0
    */
-  suppressNotification: boolean;
+  suppressNotification?: boolean;
 
   /**
    * Name of icons to disable. This is not used for iOS, but required for Android.