本页内容

共享项目设置

Qt Creator 将用户特定的项目设置存储在项目目录下的.qtcreator/目录中的.user 文件中。您可以将这些设置作为.shared 文件(例如CMakeLists.txt.sharedqtcreator.pro.sharedqtcreator.qbs.shared )在多个项目之间共享。该文件的 XML 结构与.user 文件相同,但仅包含待共享的设置。

要共享 CMake 项目设置,请使用CMake 预设CMakeLists.txt.shared 文件。

创建共享设置文件

创建.shared 文件最简单的方法是从.user 文件中复制设置。通常,您会共享ProjectExplorer.Project.EditorSettings 部分中的某些值。

注意:必须 始终指定ProjectExplorer.Project.Updater.FileVersion 变量,并为其使用与.user 文件中相同的值。

然后,您可以将.shared 文件分发给其他开发人员,或将其复制到其他开发电脑上。

以下是一个.shared 文件的示例:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE QtCreatorProject>
<qtcreator>
    <data>
        <variable>ProjectExplorer.Project.EditorSettings</variable>
        <valuemap type="QVariantMap">
            <value type="bool" key="EditorConfiguration.SpacesForTabs">true</value>
            <value type="bool" key="EditorConfiguration.AutoSpacesForTabs">false</value>
            <value type="int" key="EditorConfiguration.TabSize">14</value>
            <value type="int" key="EditorConfiguration.IndentSize">4</value>
        </valuemap>
    </data>
    <data>
        <variable>ProjectExplorer.Project.Updater.FileVersion</variable>
        <value type="int">10</value>
    </data>
</qtcreator>

更新共享设置

在您添加共享设置后,Qt Creator 首次加载该项目时,会用这些设置覆盖用户设置。如果您首次打开该项目,且Qt Creator 尚未创建.user 文件,则.shared 文件中的设置将立即生效。

如果您收到一个.shared 文件,但不希望使用其中的某项特定设置,可以对其进行修改。Qt Creator 会将其标记为“固定设置”。 下次打开该项目时,该设置将不会被更新。Qt Creator 会跟踪.user 文件中的“粘性”设置,如果用户文件和共享文件中的值最终变得完全一致,则会移除该标记。这是为了避免仅仅因为您想尝试一下而创建了永久性的“粘性”设置。

共享 CMake 项目设置

以下是一个CMakeLists.txt.shared 文件的示例:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE QtCreatorProject>
<qtcreator>
 <data>
  <variable>ProjectExplorer.Project.PluginSettings</variable>
   <valuemap type="QVariantMap">
    <valuemap type="QVariantMap" key="CMakeSpecificSettings">
      <value type="bool" key="AskBeforePresetsReload">false</value>
      <value type="bool" key="AskReConfigureInitialParams">false</value>
      <value type="bool" key="AutorunCMake">false</value>
      <value type="bool" key="PackageManagerAutoSetup">false</value>
      <value type="bool" key="ShowAdvancedOptionsByDefault">true</value>
      <value type="bool" key="ShowSourceSubFolders">false</value>
      <value type="bool" key="UseGlobalSettings">false</value>
      <value type="bool" key="UseJunctionsForSourceAndBuildDirectories">true</value>
    </valuemap>
  </valuemap>
 </data>
 <data>
  <variable>Version</variable>
  <value type="int">22</value>
 </data>
</qtcreator>

有关这些设置的更多信息,请参阅《覆盖项目的 CMake 设置》。

另请参阅 “构建和运行项目”以及“CMake 预设”。

Copyright © The Qt Company Ltd. and other contributors. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.