summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorAlexandru Croitor <alexandru.croitor@qt.io>2022-08-12 16:05:02 +0200
committerQt Cherry-pick Bot <cherrypick_bot@qt-project.org>2022-08-31 08:07:30 +0000
commitec733f6afc765fb8fc027c9f3610d3fc4ebbc78a (patch)
tree206a781442f12ff184a2e0471b5d1554ee4282d3
parent0ec5393b55689ae3b262e9b37e2474933141abd4 (diff)
CMake: Document CMake iOS archive known issue and work around
Fixes: QTBUG-105006 Change-Id: If90b3c937b9cb982c79867ab0753beeb03144b9e Reviewed-by: Paul Wicking <paul.wicking@qt.io> (cherry picked from commit 8bdc39ed365a7fb74b64575fd96302bdfe77b569) Reviewed-by: Qt Cherry-pick Bot <cherrypick_bot@qt-project.org>
-rw-r--r--doc/src/external-resources.qdoc5
-rw-r--r--doc/src/platforms/ios.qdoc13
2 files changed, 18 insertions, 0 deletions
diff --git a/doc/src/external-resources.qdoc b/doc/src/external-resources.qdoc
index 1ed9f8d20..2b22a60ea 100644
--- a/doc/src/external-resources.qdoc
+++ b/doc/src/external-resources.qdoc
@@ -684,6 +684,11 @@
*/
/*!
+ \externalpage https://gitlab.kitware.com/cmake/cmake/-/issues/23734
+ \title CMake iOS archiving failure issue
+*/
+
+/*!
\externalpage https://doc.qt.io/QtAndroidAutomotive/
\title Qt for Android Automotive
*/
diff --git a/doc/src/platforms/ios.qdoc b/doc/src/platforms/ios.qdoc
index a0aaf54c1..50519bc57 100644
--- a/doc/src/platforms/ios.qdoc
+++ b/doc/src/platforms/ios.qdoc
@@ -719,4 +719,17 @@
\section1 Symbol visibility warnings
\include apple-hidden-symbols.qdocinc
+
+ \section1 Product archiving issue with CMake
+
+ Due to an issue in \l{CMake iOS archiving failure issue}{CMake}, trying to create a product
+ archive with an iOS application may fail.
+
+ This can happen both when trying to create the archive in Xcode using the
+ Product -> Archive menu item, or from the command line using \c {xcodebuild -archivePath}.
+
+ The error message might reference undefined symbols or non-existent file paths.
+
+ To work around the issue, make sure to manually rebuild the project before trying
+ to create an archive.
*/