Creating a new project

In this tutorial, we will simply create a new project

Navigate to your worktree and type:


           
            $ qisrc create foo

           
          

Remember, for this to work on windows, you should have:

  • Run install-qibuild.bat
  • Put C:\Python27 and c:\Python27\Scripts in your %PATH% .

This will create a new project in QI_WORK_TREE/foo

Let us have a look at what has been generated:


           
            foo
|__  qiproject.xml
|__  CMakeLists.txt
|__  main.cpp
|__  test.cpp

           
          
  • main.cpp is just a standard “Hello World”
  • test.cpp is a simple test: you use automatic testing, don’t you?
  • CMakeLists.txt : this is a script file that will be read by CMake to generate makefiles, or Visual Studio solutions.
  • qproject.xml : this file MUST be present for qiBuild to know how to build the foo project.

If you already have source code somewhere, all you have to do is to:

  • create a qiproject.xml looking like

    
                 
                  <project name="foo" />
    
                 
                
  • (optional, if you want to use qi_ functions...): include find_package(qibuild) somewhere after the call to project()

You can do this by running


           
            $ qibuild convert

           
          

Note

‘qibuild convert’ will check that your root CMakeLists.txt is correct, please read the messages carefully

In any case, the root CMakeLists.txt should look like:


           
            cmake_minimum_required(VERSION 2.8)
project(my_project)
find_package(qibuild)

           
          

The project() call is mandatory for qibuild to work when using Visual Studio, the find_package(qibuild) call must be right after project() , otherwise you can have trouble when using a toolchain file.