Archive:Development/CMake FAQ (zh TW): Difference between revisions

Revision as of 10:36, 30 November 2009

Development/CMake FAQ

常見問題

These are KDE's FAQ for CMake, there is also a CMake FAQ in the main CMake wiki.

如何讓我最喜歡的編輯器支援 CMake 語法和縮排？

請閱讀CMake Wiki 的 CMake 編輯器支援章節。這裡說明如何設定 Emacs（XEmacs works too）、VIM、Kate、KWrite 和 KDevelop。

我需要在建構過程中產生一些檔案，我該怎麼做？

使用 ADD_CUSTOM_COMMAND()。在 CMake wiki 的如何在建構過程中生成原始碼檔案有解釋

我想在建構過程中建立一個稍後使用的可執行檔。我該怎麼做？

Let's say the executable is called genembed. Then use KDE4_ADD_EXECUTABLE(foo RUN_UNINSTALLED ${fooSources})to create the executable. The RUN_UNINSTALLED option is important, because the executable has to run from the build dir and has to link to the libraries in the builddir. To achieve this, the executable is compiled with RPATH set accordingly and a wrapper shell script, named just like the executable but with the suffix ".sh" is created. This shell scripts sets up LD_LIBRARY_PATH and the calls the actual executable. Use this wrapper shell script in the ADD_CUSTOM_COMMAND() as described above. You can find out the name and exact location by querying the property WRAPPER_SCRIPT. Here's a full example taken from kdelibs/kstyles/keramik/ :

build the executable

kde4_add_executable(genembed RUN_UNINSTALLED ${genembed_SRCS})

get the name of the generated wrapper script (which sets up LD_LIBRARY_PATH)

get_target_property(GENEMBED_EXECUTABLE genembed WRAPPER_SCRIPT)

and the custom command

add_custom_command(OUTPUT ${CMAKE_CURRENT_BINARY_DIR}/keramikrc.h

 COMMAND ${GENEMBED_EXECUTABLE} --file ${CMAKE_CURRENT_BINARY_DIR}/keramikPics.txt > \
 ${CMAKE_CURRENT_BINARY_DIR}/pixmaps.keramik
 DEPENDS genembed ${keramikPics}

)

As you can see genembed is also listed as a dependency, this means cmake knows that it has to build the executable genembed before executing this rule.

我不想設定 -DCMAKE_INSTALL_PREFIX 命令列參數。CMake 是否支援 KDEDIR 環境變數？

No. $KDEDIR is deprecated in KDE 4.

為什麼我會得到/usr/lib/qt4/include/QtCore/qstring.h:536: undefined reference to `QString::fromLatin1_helper(char const*, int)'之類的編譯錯誤？

如果你有舊版的 Qt 4 在 qt/lib 目錄，你必須刪除這些舊版（4.0.1）檔案。

我要怎麼讓 CMake 創建 noisy makefiles？我希望看到 make 過程執行的指令。

Pass the VERBOSE variable to make, i.e. % make VERBOSE=1 or % VERBOSE=1 make

For more details see the CMake wiki: Is there an option to produce more 'verbose' compiling?

產生的 Makefiles 中沒有 'make distclean' 標籤。我該如何才能清理包括 cache 檔案在內的所有檔案？

Simply remove the build directory, or just the contents of the build directory.

I've got fatal error LNK1104: cannot open file 'optimized.lib' under Windows/msvc (release with debug info build)

This is a problem with KDE's CMakeLists.txt and CMake 2.6.0 and 2.6.1, it will be fixed soon.

QT_*_LIBRARIES must not be used in your target_link_libraries() line of CMakeLists.txt. Use QT_*_LIBRARY instead. Otherwise the variable will look like this (example for QT_QTNETWORK_LIBRARY):

optimized;C:/kde4/lib/QtNetwork4.lib;debug;C:/kde4/lib/QtNetworkd4.lib ^^^^^^^^^

The first optimized part is translated by cmake to optimized.lib so we have got the cannot open file 'optimized.lib' error.

@@ Line 5: / Line 5: @@
 === 如何讓我最喜歡的編輯器支援 CMake 語法和縮排？===
-Read the CMake Wiki section [http://www.cmake.org/Wiki/CMake_Editors_Support CMake Editors Support].  It describes how to setup Emacs (XEmacs works too), VIM, Kate, KWrite, and KDevelop.
+請閱讀CMake Wiki 的 [http://www.cmake.org/Wiki/CMake_Editors_Support CMake 編輯器支援]章節。這裡說明如何設定 Emacs（XEmacs works too）、VIM、Kate、KWrite 和 KDevelop。
 === 我需要在建構過程中產生一些檔案，我該怎麼做？ ===
-Use ADD_CUSTOM_COMMAND(). It's explained here in the CMake wiki: [http://www.cmake.org/Wiki/CMake_FAQ#How_can_I_generate_a_source_file_during_the_build.3F  How can I generate a source file during the build]
+使用 ADD_CUSTOM_COMMAND()。在 CMake wiki 的[http://www.cmake.org/Wiki/CMake_FAQ#How_can_I_generate_a_source_file_during_the_build.3F  如何在建構過程中生成原始碼檔案]有解釋
-=== I need to build an executable which is used later on during the build to generate files. How do I do this ? ===
+=== 我想在建構過程中建立一個稍後使用的可執行檔。我該怎麼做？===
 Let's say the executable is called genembed. Then use KDE4_ADD_EXECUTABLE(foo RUN_UNINSTALLED ${fooSources})to create the executable. The RUN_UNINSTALLED option is important, because the executable has to run from the build dir and has to link to the libraries in the builddir. To achieve this, the executable is compiled with RPATH set accordingly and a wrapper shell script, named just like the executable but with the suffix ".sh" is created. This shell scripts sets up LD_LIBRARY_PATH and the calls the actual executable.
 Use this wrapper shell script in the ADD_CUSTOM_COMMAND() as described above.
@@ Line 31: / Line 31: @@
 As you can see genembed is also listed as a dependency, this means cmake knows that it has to build the executable genembed before executing this rule.
-=== I don't want to set the -DCMAKE_INSTALL_PREFIX command line option.  Does cmake support the KDEDIR environment variable? ===
+=== 我不想設定 -DCMAKE_INSTALL_PREFIX 命令列參數。CMake 是否支援 KDEDIR 環境變數？ ===
 No.  $KDEDIR is deprecated in KDE 4.
-=== Why do I get compile errors like /usr/lib/qt4/include/QtCore/qstring.h:536: undefined reference to `QString::fromLatin1_helper(char const*, int)'? ===
+=== 為什麼我會得到/usr/lib/qt4/include/QtCore/qstring.h:536: undefined reference to `QString::fromLatin1_helper(char const*, int)'之類的編譯錯誤？===
-A: If you have an old Qt4 version in your qt/lib directory you must delete the old (4.0.1) files.
+如果你有舊版的 Qt 4 在 qt/lib 目錄，你必須刪除這些舊版（4.0.1）檔案。
-=== How do I tell cmake to create noisy makefiles?  I want to see the exact commands that are run during the make process. ===
+=== 我要怎麼讓 CMake 創建 noisy makefiles？我希望看到 make 過程執行的指令。===
 Pass the VERBOSE variable to make, i.e.
 <code>
@@ Line 49: / Line 49: @@
 For more details see the CMake wiki: [http://www.cmake.org/Wiki/CMake_FAQ#Is_there_an_option_to_produce_more_.27verbose.27_compiling.3F Is there an option to produce more 'verbose' compiling?]
-=== There is no 'make distclean' target in the generated Makefiles.  How do I clean up everything, including the cache files? ===
+=== 產生的 Makefiles 中沒有 'make distclean' 標籤。我該如何才能清理包括 cache 檔案在內的所有檔案？ ===
 Simply remove the build directory, or just the contents of the build directory.