feat(android): softwareRendering property for WebView

android/modules/ui/src/java/ti/modules/titanium/ui/WebViewProxy.java

@@ -244,6 +244,25 @@ public HashMap getRequestHeaders()
 		return new HashMap<String, String>();
 	}
 
+	@Kroll.setProperty
+	public void setSoftwareMode(Boolean value)
+	{
+		TiUIWebView currWebView = getWebView();
+		if (currWebView != null) {
+			currWebView.setSoftwareMode(value);
+		}
+	}
+
+	@Kroll.getProperty
+	public boolean getSoftwareMode()
+	{
+		TiUIWebView currWebView = getWebView();
+		if (currWebView != null) {
+			return currWebView.softwareMode;
+		}
+		return false;
+	}
+
 	@Kroll.setProperty
 	public void setRequestHeaders(HashMap params)
 	{

android/modules/ui/src/java/ti/modules/titanium/ui/widget/webview/TiUIWebView.java

@@ -64,6 +64,8 @@ public class TiUIWebView extends TiUIView
 	private float zoomLevel = TiApplication.getInstance().getResources().getDisplayMetrics().density;
 	private float initScale = zoomLevel;
 
+	public boolean softwareMode = false;
+
 	public static final int PLUGIN_STATE_OFF = 0;
 	public static final int PLUGIN_STATE_ON = 1;
 	public static final int PLUGIN_STATE_ON_DEMAND = 2;
@@ -466,6 +468,10 @@ public void processProperties(KrollDict d)
 			webView.setHorizontalScrollBarEnabled(scrollbarValue == AndroidModule.WEBVIEW_SCROLLBARS_DEFAULT
 				|| scrollbarValue == AndroidModule.WEBVIEW_SCROLLBARS_HIDE_VERTICAL);
 		}
+
+		if (d.containsKeyAndNotNull(TiC.PROPERTY_SOFTWARE_MODE)) {
+			setSoftwareMode(TiConvert.toBoolean(d, TiC.PROPERTY_SOFTWARE_MODE));
+		}
 	}
 
 	@Override
@@ -1070,4 +1076,18 @@ protected void disableHWAcceleration()
 	{
 		Log.d(TAG, "Do not disable HW acceleration for WebView.", Log.DEBUG_MODE);
 	}
+
+	public void setSoftwareMode(Boolean value)
+	{
+		WebView webView = getWebView();
+		if (webView != null) {
+			softwareMode = value;
+			if (value) {
+				webView.setLayerType(View.LAYER_TYPE_SOFTWARE, null);
+			} else {
+				webView.setLayerType(View.LAYER_TYPE_HARDWARE, null);
+			}
+		}
+	}
+
 }

android/titanium/src/java/org/appcelerator/titanium/TiC.java

@@ -863,6 +863,7 @@ public class TiC
 	public static final String PROPERTY_DEPARTMENT = "department";
 	public static final String PROPERTY_FIXED_SIZE = "fixedSize";
 	public static final String PROPERTY_UI_FLAGS = "uiFlags";
+	public static final String PROPERTY_SOFTWARE_MODE = "softwareMode";
 
 	public static final String SIZE_AUTO = "auto";
 	public static final String URL_APP_PREFIX = "app://";

apidoc/Titanium/UI/WebView.yml

@@ -1020,6 +1020,16 @@ properties:
     platforms: [iphone, ipad, macos]
     since: {iphone: "2.0.0", ipad: "2.0.0", macos: "9.2.0"}
 
+  - name: softwareMode
+    summary: A Boolean value indicating the render mode of the WebView
+    description: |
+        Set to `true` (software rendering) if you use `Ti.Media.takeScreensho()` or `toImage()` and the WebView contains local HTML files.
+        Otherwise the WebView might be empty in the screenshot/image. If you change the setting you will have to assing the HTML content again.
+    type: Boolean
+    default: false
+    platforms: [android]
+    since: {android: "12.7.0"}
+
   - name: enableZoomControls
     summary: If `true`, zoom controls are enabled.
     type: Boolean