Add option to allow compiling WebEngine as Mac App Store compliant.

When the option is enabled, a GYP variable is set that will result in
removing private API calls in Chromium.

Task-number: QTBUG-51072
Change-Id: If8835ce74bf5db94c17b68ebeb396cae9cc10553
Reviewed-by: Michael Brüning <michael.bruning@theqtcompany.com>

1 files changed, 19 insertions, 0 deletions

diff --git a/src/webengine/doc/src/qtwebengine-platform-notes.qdoc b/src/webengine/doc/src/qtwebengine-platform-notes.qdoc
index 673215dd7..559615b3b 100644
--- a/src/webengine/doc/src/qtwebengine-platform-notes.qdoc
+++ b/src/webengine/doc/src/qtwebengine-platform-notes.qdoc
@@ -120,6 +120,25 @@
     with the codec libraries. For some codecs, open source implementations, such as \l {OpenH264},
     are available.
 
+    \section1 Mac App Store Compatibility
+
+    By default, Qt WebEngine uses private OS X API, which might cause an application to be
+    rejected when submitted to the Mac App Store. To configure Qt WebEngine not to use these API
+    calls, Qt WebEngine has to be recompiled:
+
+    \code
+    qmake WEBENGINE_CONFIG += use_appstore_compliant_code
+    \endcode
+
+    However, this will cause some behavioral changes, such as:
+
+    \list
+        \li The OS X Kill Ring functionality will no longer work (emacs-like copy pasting).
+        \li Certain Chromium sandboxing cleanup is not done.
+        \li Text areas will be painted with a different style.
+        \li Text fields might be painted with a different style on Mountain Lion (OS X 10.8).
+    \endlist
+
     \section1 Default QSurfaceFormat OpenGL Profile Support
 
     If a new default QSurfaceFormat with a modified OpenGL profile has to be set, it should be set