support examples autorun

Co-authored-by: Copilot <copilot@github.com>

Author: riccardobl

README.md

@@ -125,6 +125,18 @@ You can optionally use the `-Pexample` property to specify an example to start w
 ./gradlew runExamples -Pexample=jme3test.light.pbr.TestPBRSimple
 ```
 
+### Android examples
+
+You can run the Android examples on a local android emulator with:
+
+```bash
+./gradlew -PbuildAndroidExamples=true -PbuildNativeProjects=true runAndroidExamples 
+# or for a specific example:
+# ./gradlew -PbuildAndroidExamples=true -PbuildNativeProjects=true runAndroidExamples -Pexample=jme3test.post.TestBloom
+```
+
+*Make sure to have the SDK and NDK installed and configured properly, and the emulator running before executing the command.*
+
 
 ## Running Tests 
 

jme3-android-examples/build.gradle

@@ -110,7 +110,7 @@ tasks.register('installAndroidExamples', Exec) {
 
 tasks.register('runAndroidExamples', Exec) {
     group = 'application'
-    description = 'Install and launch the Android examples selector on a connected emulator or device.'
+    description = 'Install and launch Android examples on a connected emulator or device. Use -Pexample=<class> to run a specific test directly.'
 
     dependsOn tasks.named('installAndroidExamples')
 
@@ -120,10 +120,21 @@ tasks.register('runAndroidExamples', Exec) {
             throw new GradleException("ADB not found. Set -Pandroid.sdk.path, ANDROID_HOME, or ANDROID_SDK_ROOT.")
         }
         executable adbExecutable.absolutePath
-    }
 
-    args 'shell', 'am', 'start',
-            '-n', 'org.jmonkeyengine.jme3androidexamples/.MainActivity'
+        def exampleClass = project.findProperty('example')?.toString()?.trim()
+        if (exampleClass) {
+            args 'shell', 'am', 'start',
+                    '-n', 'org.jmonkeyengine.jme3androidexamples/.TestActivity',
+                    '--es', 'Selected_App_Class', exampleClass,
+                    '--ez', 'Enable_Mouse_Events', 'true',
+                    '--ez', 'Enable_Joystick_Events', 'false',
+                    '--ez', 'Enable_Key_Events', 'true',
+                    '--ez', 'Verbose_Logging', 'false'
+        } else {
+            args 'shell', 'am', 'start',
+                    '-n', 'org.jmonkeyengine.jme3androidexamples/.MainActivity'
+        }
+    }
 }
 
 def findAdbExecutable() {

jme3-android-examples/src/main/AndroidManifest.xml

@@ -20,6 +20,7 @@
         </activity>
         <activity
                 android:name=".TestActivity"
+                android:exported="true"
                 android:label="@string/app_name"
                 android:launchMode="singleTask"
                 android:screenOrientation="landscape">