From 1e8c842444260fc844a5e47049e29135135baeac Mon Sep 17 00:00:00 2001 From: Bartosz Taudul Date: Mon, 8 Jun 2020 18:27:41 +0200 Subject: [PATCH] Update manual. --- manual/tracy.tex | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/manual/tracy.tex b/manual/tracy.tex index a7a23299..e44f376b 100644 --- a/manual/tracy.tex +++ b/manual/tracy.tex @@ -1279,6 +1279,15 @@ To have proper call stack information, the profiled application must be compiled \item On MSVC open the project properties and go to \emph{Linker\textrightarrow Debugging\textrightarrow Generate Debug Info}, where the \emph{Generate Debug Information} option should be selected. \item On gcc or clang remember to specify the debugging information \texttt{-g} parameter during compilation and omit the strip symbols \texttt{-s} parameter. Link the executable with an additional option \texttt{-rdynamic} (or \texttt{-{}-export-dynamic}, if you are passing parameters directly to the linker). \item On OSX you may need to run \texttt{dsymutil} to extract the debugging data out of the executable binary. +\item On iOS you will have to add a \emph{New Run Script Phase} to your XCode project, which will execute the following shell script: + +\begin{lstlisting}[language=sh] +cp -rf ${TARGET_BUILD_DIR}/${WRAPPER_NAME}.dSYM/* ${TARGET_BUILD_DIR}/${UNLOCALIZED_RESOURCES_FOLDER_PATH}/${PRODUCT_NAME}.dSYM +\end{lstlisting} + +You will also need to setup proper dependencies, by setting the following input file:\\ +\texttt{\$\{TARGET\_BUILD\_DIR\}/\$\{WRAPPER\_NAME\}.dSYM}, and the following output file:\\ +\texttt{\$\{TARGET\_BUILD\_DIR\}/\$\{UNLOCALIZED\_RESOURCES\_FOLDER\_PATH\}/\$\{PRODUCT\_NAME\}.dSYM}. \end{itemize} You may also be interested in symbols from external libraries, especially if you have sampling profiling enabled (section~\ref{sampling}). In MSVC you can retrieve such symbols by going to \emph{Tools\textrightarrow Options\textrightarrow Debugging\textrightarrow Symbols} and selecting appropriate \emph{Symbol file (.pdb) location} servers. Note that additional symbols may significantly increase application startup times.