feat(examples): add icon generation script

Author: fadi-george

examples/build.md

@@ -37,28 +37,24 @@ bunx cap add android
   "onesignal-capacitor-plugin": "file:../../onesignal-capacitor-plugin.tgz"
   ```
 
-App icon generation uses `@capacitor/assets`. Place the OneSignal logo in `assets/icon-only.png`, then:
+### App icons
 
-```bash
-bunx @capacitor/assets generate --ios --android --iconBackgroundColor '#ffffff' --splashBackgroundColor '#ffffff'
+Each demo's `assets/` directory holds the three 1024x1024 source images that [`@capacitor/assets`](https://capacitorjs.com/docs/guides/splash-screens-and-icons) consumes:
+
+```
+assets/
+├── icon-only.png         # OneSignal logo on white
+├── icon-foreground.png   # OneSignal logo on transparent (Android adaptive foreground)
+└── icon-background.png   # solid white                   (Android adaptive background)
 ```
 
-After generating, remove the adaptive icon files so Android uses the generated PNGs directly (the adaptive icon XMLs reference the default Capacitor foreground and override them):
+To (re)generate all native icon assets, run from inside a demo:
 
 ```bash
-rm -rf android/app/src/main/res/mipmap-anydpi-v26 \
-       android/app/src/main/res/drawable-v24/ic_launcher_foreground.xml \
-       android/app/src/main/res/drawable/ic_launcher_background.xml \
-       android/app/src/main/res/values/ic_launcher_background.xml \
-       android/app/src/main/res/mipmap-*/ic_launcher_foreground.png
+bunx @capacitor/assets generate --ios --android
 ```
 
-Then verify both platforms picked up the OneSignal logo and not a default Capacitor icon:
-
-- iOS: open `ios/App/App/Assets.xcassets/AppIcon.appiconset/AppIcon-512@2x.png`
-- Android: open `android/app/src/main/res/mipmap-xxxhdpi/ic_launcher.png`
-
-If either still shows the default Capacitor blue X, re-run the generator. `@capacitor/assets generate` has been observed to silently skip the iOS output on a first run.
+That produces the full Android adaptive icon set (foreground/background mipmaps + `mipmap-anydpi-v26/ic_launcher{,_round}.xml`) and the iOS `AppIcon.appiconset`. No additional steps.
 
 ### Build & run scripts
 
@@ -224,7 +220,9 @@ examples/
     ├── package.json
     ├── .env.example
     ├── assets/
-    │   └── icon-only.png       # Source for @capacitor/assets generate
+    │   ├── icon-only.png         # OneSignal logo on white
+    │   ├── icon-foreground.png   # Android adaptive icon foreground (transparent)
+    │   └── icon-background.png   # Android adaptive icon background (solid white)
     ├── src/
     │   ├── main.tsx
     │   ├── App.tsx             # IonApp + IonReactRouter, StatusBar config

examples/demo/android/app/src/main/res/mipmap-anydpi-v26/ic_launcher.xml

@@ -0,0 +1,9 @@
+<?xml version="1.0" encoding="utf-8"?>
+<adaptive-icon xmlns:android="http://schemas.android.com/apk/res/android">
+    <background>
+        <inset android:drawable="@mipmap/ic_launcher_background" android:inset="16.7%" />
+    </background>
+    <foreground>
+        <inset android:drawable="@mipmap/ic_launcher_foreground" android:inset="16.7%" />
+    </foreground>
+</adaptive-icon>

examples/demo/android/app/src/main/res/mipmap-anydpi-v26/ic_launcher_round.xml

@@ -0,0 +1,9 @@
+<?xml version="1.0" encoding="utf-8"?>
+<adaptive-icon xmlns:android="http://schemas.android.com/apk/res/android">
+    <background>
+        <inset android:drawable="@mipmap/ic_launcher_background" android:inset="16.7%" />
+    </background>
+    <foreground>
+        <inset android:drawable="@mipmap/ic_launcher_foreground" android:inset="16.7%" />
+    </foreground>
+</adaptive-icon>