CMP0128

在 3.22 版本中新增。

當此策略設定為 NEW 時

• <LANG>_EXTENSIONS 會初始化為 CMAKE_<LANG>_EXTENSIONS，如果已設定，否則會回退到 CMAKE_<LANG>_EXTENSIONS_DEFAULT。

• 如果 <LANG>_STANDARD 未設定或符合預設值，則會正確啟用/停用擴展。

• 除非需要達到指定的模式，否則不會新增影響標準模式的旗標。

OLD 行為

• 將 <LANG>_EXTENSIONS 初始化為 CMAKE_<LANG>_EXTENSIONS，如果已設定，否則會回退到 ON。

• 如果設定了 <LANG>_STANDARD 且 <LANG>_STANDARD_REQUIRED 為 OFF，則始終會新增旗標。

• 如果 <LANG>_STANDARD 未設定

  • 即使 <LANG>_EXTENSIONS 為 OFF，也不會停用擴展。

  • 除了 IAR 編譯器外，如果 <LANG>_EXTENSIONS 為 ON，則無法啟用擴展。

在以下情況下，程式碼可能需要針對 NEW 行為進行更新

• 如果先前被 CMake 覆寫且在編譯器偵測期間未使用的標準模式旗標，現在由於 CMake 不再新增旗標，因為偵測到的預設值是適當的，因此現在生效。

  此類程式碼應轉換為以下任一種

  • 使用 <LANG>_STANDARD 和 <LANG>_EXTENSIONS，而不是手動新增旗標。

  • 或確保在編譯器偵測期間使用手動指定的旗標。

• 如果在未設定 <LANG>_STANDARD 的情況下停用了擴展，則 CMake 實際上不會停用擴展。

  此類程式碼應更新為在需要時不停用擴展。

• 如果當 <LANG>_STANDARD 符合編譯器的預設值時啟用/停用擴展，則 CMake 實際上不會啟用/停用擴展。

  此類程式碼應更新為設定正確的擴展模式。

如果在編譯器偵測期間使用影響標準模式的編譯器旗標（例如，在 工具鏈檔案 中使用 CMAKE_<LANG>_FLAGS_INIT），那麼它們將會影響偵測到的預設 標準 和 擴展。

此策略在 CMake 3.22 版本中引入。可以透過 cmake_policy() 或 cmake_minimum_required() 設定。如果未設定，CMake 預設情況下不會發出警告，並且使用 OLD 行為。

請參閱 CMAKE_POLICY_WARNING_CMP0128 變數的文件以控制警告。

注意

策略的 OLD 行為 依定義已棄用，並可能在 CMake 的未來版本中移除。