Evaluate Changelogic without registration!
  

Configuring Your Project to Use Changelogic

What is a project?
For Changelogic, a project is a directory tree or collection of directory trees of source files that are built into a release unit – a package or set of packages that are released together.

Creating new project from web interface


You can find the project adding form from user menu->new project. This is how the new project creation form looks:



The main parameters you need to enter are:

  • Project's name – this will show up in the dropdown in menu, where you choose project, free text
  • CVS server – default CVS server is created with database, you can configure it or enter new ones from user menu->CVS servers
  • CVS repository – the name of project in your CVS repository, the name by which you do checkout (cvs checkout my-project)
  • Initial version – the first version, must consist of four digits separated by dots, for example 1.1.1.0

This is project roles' section:



You can see what the privileges of any role are from roles page.


Adding new project (no code yet)

  1. Create a project repository in cvs (for example: mkdir <project repository name>; cvs import <project repository name> mycompany initial)
  2. Add project from Changelogic web interface (user menu->new project)
  3. cvs checkout <project repository name>
  4. cd <project repository name>
  5. Download devweb-build.xml (you can get it from Changelogic web interface under user menu->supporting files)
  6. Dowload and modify according to your needs: build.xml, devweb-project.properties, devweb-personal.properties
  7. Test: ant -f devweb-build.xml init
  8. cvs add build.xml devweb-project.properties devweb-build.xml Be careful not to add devweb-personal.properties, it should be local in every developers' working directory
  9. cvs commit
  10. cd ..
  11. cvs tag -b latest <project repository name>
  12. cvs rtag -r latest <version tag> <project repository name>
  13. Test: cd <project repository name>; ant edit

Version tag is in format ver-x_x_x_x (for example if the version is 1.2.3.4 then the tag is ver-1_2_3_4). You select the first version number when adding a project from web interface. “latest” is Changelogic's special branch.


You can add your project specific build targets to build.xml.


Adding existing project (some code already written)

Steps are described in previous instruction, but now the sequence is: 2–3, 11, 4–9, 12–13.


In case of existing project you probably already have a build script too. Here are some guidelines, how to integrate Changelogic's targets into your build script.


Adding project with modules

  1. Add project from Changelogic web interface (user menu->new project)
  2. Import the project's code into cvs
  3. cvs tag -b latest <project modules>
  4. cvs rtag -r latest ver-1_1_1_0 <project modules>
  5. Add modules to project (from project's detail form)
  6. Import module's code: cvs import -m \"\" module module_name initial
  7. Check “Is imported” box at the module's details page
  8. From your working directory run ant -f devweb-build.xml setup_project