PROJECT_VERSION_MINORを使ったバージョン管理のベストプラクティス

CMakeにおけるPROJECT_VERSION_MINOR変数：詳細解説

PROJECT_VERSION_MINORは、CMakeプロジェクトのバージョン管理において重要な役割を果たす変数です。これは、プロジェクトのマイナーバージョン番号を表し、バグ修正や機能追加などのマイナーな変更を反映するために更新されます。

設定方法

PROJECT_VERSION_MINORは、CMakeLists.txtファイル内で以下の2つの方法で設定できます。

直接設定

set(PROJECT_VERSION_MAJOR 1)
set(PROJECT_VERSION_MINOR 2)
set(PROJECT_VERSION_PATCH 3)

PROJECT_VERSION変数から自動生成

project(MyProject VERSION 1.2.3)

この場合、PROJECT_VERSION_MINORは自動的に2に設定されます。

使用方法

PROJECT_VERSION_MINORは、以下の用途で使用できます。

• ビルドファイルの生成
• バージョン情報の表示
• 条件付きの処理

ビルドファイルの生成

PROJECT_VERSION_MINORを使用して、ビルドファイルの名前やパスを生成することができます。

set(output_file "${PROJECT_NAME}-${PROJECT_VERSION_MAJOR}.${PROJECT_VERSION_MINOR}.exe")

バージョン情報の表示

PROJECT_VERSION_MINORを使用して、アプリケーションのバージョン情報を表示することができます。

message(STATUS "MyProject version ${PROJECT_VERSION_MAJOR}.${PROJECT_VERSION_MINOR}.${PROJECT_VERSION_PATCH}")

条件付きの処理

PROJECT_VERSION_MINORを使用して、条件付きの処理を実行することができます。

if(PROJECT_VERSION_MINOR GREATER 1)
  # 新しい機能を有効にする
endif()

ベストプラクティス

• PROJECT_VERSION_MINORは、プロジェクトのマイナーバージョン番号を表すためにのみ使用してください。
• バグ修正や機能追加などの変更を行うたびに、PROJECT_VERSION_MINORを更新してください。
• セマンティックバージョニングを採用することを検討してください。

補足

• PROJECT_VERSION_MINORは、CMake 2.6以降で利用可能です。
• PROJECT_VERSION_MINORは、整数値のみ設定できます。
• PROJECT_VERSION_MINORは、CMake GUIツールでも設定可能です。

この解説が、PROJECT_VERSION_MINOR変数の理解と活用に役立つことを願っています。

• ご不明な点があれば、お気軽にご質問ください。
• より詳細な情報は、CMake公式ドキュメントを参照してください。

PROJECT_VERSION_MINORを使用したサンプルコード

project(MyProject VERSION 1.2.3)

message(STATUS "MyProject version ${PROJECT_VERSION_MAJOR}.${PROJECT_VERSION_MINOR}.${PROJECT_VERSION_PATCH}")

出力例:

MyProject version 1.2.3

条件付きの処理

project(MyProject VERSION 1.2.3)

if(PROJECT_VERSION_MINOR GREATER 1)
  message(STATUS "New feature enabled")
else()
  message(STATUS "Old feature enabled")
endif()

出力例 (PROJECT_VERSION_MINORが2の場合):

New feature enabled

出力例 (PROJECT_VERSION_MINORが1以下の場合):

Old feature enabled

ビルドファイルの生成

project(MyProject VERSION 1.2.3)

set(output_file "${PROJECT_NAME}-${PROJECT_VERSION_MAJOR}.${PROJECT_VERSION_MINOR}.exe")

add_executable(${output_file} main.cpp)

生成されるファイル:

• MyProject-1.2.exe

セマンティックバージョニングの例

project(MyProject VERSION 1.2.3-alpha)

# バグ修正
set(PROJECT_VERSION 1.2.4)

# 機能追加
set(PROJECT_VERSION 1.3.0)

# メジャーバージョンアップ
set(PROJECT_VERSION 2.0.0)

バージョン情報の例:

• 1.2.3-alpha
• 1.2.4
• 1.3.0
• 2.0.0

CMake GUIツールを使用する場合は、プロジェクトのプロパティウィンドウでPROJECT_VERSION_MAJOR、PROJECT_VERSION_MINOR、PROJECT_VERSION_PATCHを設定できます。

PROJECT_VERSION_MINORを設定するその他の方法

環境変数

• CMAKE_PROJECT_VERSION_MAJOR

これらの環境変数は、CMakeLists.txtファイルが実行される前に設定する必要があります。

例:

export CMAKE_PROJECT_VERSION_MAJOR=1
export CMAKE_PROJECT_VERSION_MINOR=2
export CMAKE_PROJECT_VERSION_PATCH=3

cmake ..

コマンドライン

PROJECT_VERSION_MINORは、以下のコマンドラインオプションを使用して設定することもできます。

• -DPROJECT_VERSION_MAJOR=

例:

cmake -DPROJECT_VERSION_MAJOR=1 -DPROJECT_VERSION_MINOR=2 -DPROJECT_VERSION_PATCH=3 ..

外部ツール

PROJECT_VERSION_MINORは、外部ツールを使用して設定することもできます。

例:

• Git: Gitリポジトリを使用している場合は、git describeコマンドを使用してバージョン情報を取得することができます。

set(PROJECT_VERSION $(git describe --tags --abbrev=4))

• Subversion: Subversionリポジトリを使用している場合は、svn infoコマンドを使用してバージョン情報を取得することができます。

set(PROJECT_VERSION $(svn info --revision))

注意事項

• 環境変数やコマンドラインオプションを使用してPROJECT_VERSION_MINORを設定する場合は、CMakeLists.txtファイル内で設定するよりも優先されます。
• 外部ツールを使用してPROJECT_VERSION_MINORを設定する場合は、ツールの出力形式を考慮する必要があります。