AutoVersioning plugin

From Code::Blocks
Revision as of 20:12, 15 September 2007 by Jgm (talk | contribs)
AutoVersioning
AutoVersioningLogo.png
Developer(s): JGM
Maintainer(s): JGM
Version: 0.7

Introduction

The idea of the Auto Versioning plugin was made during the development of a pre-alpha software that required the version info and status. Been to busy coding, without time to maintain the version number, just decided to develop a plugin that could do all this with little intervention as possible.

The plugin helps you keep track of the actual project version that you are working with. It creates a c++ header with variable declarations that you can use on your source files to give your users the version info of your piece of art (software).

Features

Here is the list of features the plugin covers summarized:

  • Generates and auto increment version variables
  • Software status editor
  • Integrated scheme editor for changing the behavior of the auto incrementation of version values
  • Date declarations as month, date and year
  • Ubuntu style version
  • Svn revision check
  • Change log generator.

Sources

Usually source and news about new releases are posted on the Code::Blocks forums on the plugins development section. You can access this plugin topic over [/index.php/topic,6294.msg48225.html#msg48225 here], recent sources are attached on the first post (you have to be logged in to download attachments on the forum.

The plugin also have a project page at www.berlios.de. The link is http://developer.berlios.de/projects/autoversioning/. Submit all features request and bugs on the project page.

Svn check out: svn://svn.berlios.de/autoversioning/trunk

Using it

After downloading the sources, compiling them and installing the plugin to Code::Blocks just go to the Project->Auto Versioning menu. A pop up window like this will appear:

AvAskConfigure.png

When hitting yes on the ask to configure message box the main autoversioning configuration dialog will open. To let you configure the version info of your project. Each editable control has a tool tip with information that explains you its features, so if you put the mouse on the control the tool tip will pop up. Below is a screenshot showing all the tabs:

AvDialog.png

Version Values:
Here you just enter the corresponding version values or let the autoversioning plugin increment them by himself.

  • Major - Increments by 1 when the minor version reaches its maximun
  • Minor - Increments by one when the build number pass the barrier of build times, the the value is reset to 0 when it reach its maximun value.
  • Build Number (also equivalent to Release) - Increments by one every time that the revision number is incremented.
  • Revision - Increment randomly when the project has been modified and then compiled.

Status:
Some fields to keep track of your software status with predefined values for convenience.

  • Software Status - The typical example should be v1.0 Alpha
  • Abbreviation - Same as software status but like this v1.0a

Scheme:
Let you edit how the plugin will increment the version values.

Settings:
In this tab you can check Commit Changes to increment the changes manually when you feel that is the right moment, just using the menu Project->Commit Changes.