Merge branch 'master' into codex/create-building.md-for-codename-one-o1r15v

Author: shai-almog

CodenameOne/src/com/codename1/impl/CodenameOneImplementation.java

@@ -42,6 +42,7 @@
 import com.codename1.io.tar.TarEntry;
 import com.codename1.io.tar.TarInputStream;
 import com.codename1.l10n.L10NManager;
+import com.codename1.ui.Component;
 import com.codename1.location.LocationManager;
 import com.codename1.media.Media;
 import com.codename1.media.MediaManager;
@@ -8549,4 +8550,18 @@ public void postMessage(MessageEvent message) {
     public Boolean isDarkMode() {
         return null;
     }
+
+    /**
+     * Manually announces text to native accessibility services, associating the announcement with
+     * a specific component when possible. Components are typically announced automatically when
+     * focused; this hook allows platforms to expose announcements triggered outside the normal
+     * focus lifecycle. The default implementation is a no-op.
+     *
+     * @param cmp the component related to this announcement or {@code null} for the root context
+     * @param text the message to announce
+     */
+    public void announceForAccessibility(Component cmp, String text) {
+        // No-op by default. Platforms that support accessibility announcements
+        // should override this method.
+    }
 }

CodenameOne/src/com/codename1/ui/CN.java

@@ -327,6 +327,27 @@ public static void vibrate(int duration) {
         Display.impl.vibrate(duration);
     }
 
+    /**
+     * Manually announces text to native accessibility services, optionally associating the
+     * announcement with a specific component. Normally, components are announced automatically
+     * when they receive focus; this method is for cases where an announcement is needed outside
+     * the normal focus lifecycle.
+     *
+     * @param cmp the component related to this announcement or {@code null} for the root view
+     * @param text the message to announce
+     */
+    public static void announceForAccessibility(Component cmp, String text) {
+        Display.impl.announceForAccessibility(cmp, text);
+    }
+
+    /**
+     * Convenience overload to announce text without specifying a component.
+     *
+     * @param text the message to announce
+     */
+    public static void announceForAccessibility(String text) {
+        Display.impl.announceForAccessibility(null, text);
+    }
 
     /**
      * Returns true if we are currently in the event dispatch thread.

CodenameOne/src/com/codename1/ui/Component.java

@@ -481,8 +481,9 @@ public class Component implements Animation, StyleListener, Editable {
     EventDispatcher longPressListeners;
     private EventDispatcher stateChangeListeners;
     boolean isUnselectedStyle;
-    
+
     private String tooltip;
+    private String accessibilityText;
 
     boolean isDragAndDropInitialized() {
         return dragAndDropInitialized;
@@ -2138,6 +2139,10 @@ public Label getLabelForComponent() {
      */
     void focusGainedInternal() {
         startComponentLableTicker();
+        String text = getAccessibilityText();
+        if (text != null && text.length() > 0) {
+            announceForAccessibility(text);
+        }
     }
 
 
@@ -2156,7 +2161,7 @@ void stopComponentLableTicker() {
     }
 
     /**
-     * Callback allowing a developer to track wheh the component gains focus
+     * Callback allowing a developer to track when the component gains focus
      */
     protected void focusGained() {
     }
@@ -8158,6 +8163,55 @@ public void paint(Graphics g) {
         }
     }
 
+    /**
+     * Manually announces text to native accessibility services, associating the announcement
+     * with this component when possible. Screen readers normally announce a component
+     * automatically when it gains focus; this helper is for additional announcements that
+     * should occur outside of focus changes.
+     *
+     * @param text the message to announce
+     */
+    public void announceForAccessibility(String text) {
+        Display.getInstance().announceForAccessibility(this, text);
+    }
+
+    /**
+     * Sets the text that describes this component to assistive technologies.
+     * When the component gains focus, this text will be announced
+     * automatically.
+     *
+     * @param text accessibility description
+     */
+    public void setAccessibilityText(String text) {
+        this.accessibilityText = text;
+    }
+
+    /**
+     * Returns the text that describes this component to assistive technologies.
+     * If no text was set explicitly, this method attempts to derive a
+     * description from the component's label or content.
+     *
+     * @return accessibility description or {@code null} if none
+     */
+    public String getAccessibilityText() {
+        if (accessibilityText != null) {
+            return accessibilityText;
+        }
+        if (componentLabel != null) {
+            String t = componentLabel.getText();
+            if (t != null && t.length() > 0) {
+                return t;
+            }
+        }
+        if (this instanceof TextHolder) {
+            String t = ((TextHolder) this).getText();
+            if (t != null && t.length() > 0) {
+                return t;
+            }
+        }
+        return null;
+    }
+
     /**
      * @return the tooltip
      */

CodenameOne/src/com/codename1/ui/Display.java

@@ -682,6 +682,28 @@ public void flashBacklight(int duration) {
         impl.flashBacklight(duration);
     }
 
+    /**
+     * Manually announces text to native accessibility services, optionally associating the
+     * announcement with a specific component. Most assistive technologies will announce a
+     * component automatically when it gains focus; this method is intended for situations
+     * where an announcement should occur independently of focus changes.
+     *
+     * @param cmp the component related to this announcement or {@code null} for the root view
+     * @param text the message to announce
+     */
+    public void announceForAccessibility(Component cmp, String text) {
+        impl.announceForAccessibility(cmp, text);
+    }
+
+    /**
+     * Convenience overload to announce text without specifying a component.
+     *
+     * @param text the message to announce
+     */
+    public void announceForAccessibility(String text) {
+        announceForAccessibility(null, text);
+    }
+
     /**
      * Invoking the show() method of a form/dialog while the user is editing
      * text in the native text box can have several behaviors: SHOW_DURING_EDIT_IGNORE,

Ports/Android/src/com/codename1/impl/android/AndroidImplementation.java

@@ -57,9 +57,9 @@
 import android.util.Log;
 import android.util.TypedValue;
 import android.view.KeyEvent;
-import android.view.View;
-import android.view.ViewGroup;
-import android.view.Window;
+import android.view.View;
+import android.view.ViewGroup;
+import android.view.Window;
 import android.webkit.WebSettings;
 import android.webkit.WebView;
 import android.webkit.WebViewClient;
@@ -114,8 +114,10 @@
 import android.telephony.SmsManager;
 import android.telephony.gsm.GsmCellLocation;
 import android.text.Html;
-import android.view.*;
-import android.view.View.MeasureSpec;
+import android.view.*;
+import android.view.View.MeasureSpec;
+import android.view.accessibility.AccessibilityEvent;
+import android.view.accessibility.AccessibilityManager;
 import android.webkit.*;
 import android.widget.*;
 import com.codename1.background.BackgroundFetch;
@@ -10794,13 +10796,50 @@ public void run() {
         return true;
     }
 
-    public boolean isJailbrokenDevice() {
-        try {
-            Runtime.getRuntime().exec("su");
-            return true;
-        } catch(Throwable t) {
-            com.codename1.io.Log.e(t);
-        }
-        return false;
-    }
-}
+    public boolean isJailbrokenDevice() {
+        try {
+            Runtime.getRuntime().exec("su");
+            return true;
+        } catch(Throwable t) {
+            com.codename1.io.Log.e(t);
+        }
+        return false;
+    }
+
+    @Override
+    public void announceForAccessibility(final Component cmp, final String text) {
+        final Activity act = getActivity();
+        if (act == null) {
+            return;
+        }
+        act.runOnUiThread(new Runnable() {
+            @Override
+            public void run() {
+                View view = null;
+                if (cmp instanceof PeerComponent) {
+                    Object peer = ((PeerComponent) cmp).getNativePeer();
+                    if (peer instanceof View) {
+                        view = (View) peer;
+                    }
+                }
+                if (view == null) {
+                    view = act.getWindow().getDecorView();
+                }
+                if (view == null) {
+                    return;
+                }
+                if (Build.VERSION.SDK_INT >= 16) {
+                    view.announceForAccessibility(text);
+                } else {
+                    AccessibilityManager manager = (AccessibilityManager) act.getSystemService(Context.ACCESSIBILITY_SERVICE);
+                    if (manager != null && manager.isEnabled()) {
+                        AccessibilityEvent event = AccessibilityEvent.obtain(AccessibilityEvent.TYPE_NOTIFICATION_STATE_CHANGED);
+                        event.getText().add(text);
+                        event.setSource(view);
+                        manager.sendAccessibilityEvent(event);
+                    }
+                }
+            }
+        });
+    }
+}

maven/CodeNameOneBuildClient.jar

@@ -332,6 +332,7 @@
                         <source>1.8</source>
                         <show>protected</show>
                         <failOnError>false</failOnError>
+                        <doclint>none</doclint>
                     </configuration>
                 </plugin>
                 <plugin>
@@ -398,7 +399,11 @@
                 <artifactId>maven-javadoc-plugin</artifactId>
                 <version>3.2.0</version>
                 <configuration>
-                    <additionalOptions>--allow-script-in-comments</additionalOptions>
+                    <doclint>none</doclint>
+                    <failOnError>false</failOnError>
+                    <additionalOptions>
+                        <additionalOption>--allow-script-in-comments</additionalOption>
+                    </additionalOptions>
                 </configuration>
             </plugin>
             <plugin>