Creating and working with x86 cpp project

Creating x86 cpp project

To create Hello world x86 cpp project we will use pwrforge new command:

Open the command line and run:

pwrforge new --target x86 --bin hello_world hello_world_project

This will create a new dockerized x86 cpp project inside hello_world_project directory. If you want to create a native project you can add –no-docker argument.

This is how the project directory will look like:

└── hello_world_project
    ├── CMakeLists.txt
    ├── conanfile.py
    ├── LICENSE
    ├── README.md
    ├── pwrforge.lock
    ├── pwrforge.toml
    ├── src
    │   ├── CMakeLists.txt
    │   └── hello_world.cpp
    └── tests
        ├── CMakeLists.txt
        ├── it
        │   └── CMakeLists.txt
        ├── mocks
        │   ├── CMakeLists.txt
        │   └── static_mock
        │       ├── CMakeLists.txt
        │       └── static_mock.h
        └── ut
            └── CMakeLists.txt

For pwrforge the most important file is pwrforge.toml. This is the file in which you write your project configuration. If you want to update some settings in pwrforge.toml make sure you run pwrforge update command to update the project with the newly modified configuration.

More on this can be read in pwrforge.toml file basis

Building the project

To build the project we can change into project directory and run pwrforge build command. Let’s run the build command and build our project in Release

cd hello_world_project
pwrforge build --profile Release

By default, pwrforge builds in Debug, but you can switch it by running it with –profile argument (e.g. –profile=Release). pwrforge will use conan to download all necessary dependencies and build the project. After the build is finished we should see that build/Release directory was created and the build files are inside.

Running the binary

To run the binary we can simply use pwrforge run command:

pwrforge run --profile Release

After running the command we will see Hello world! text in the terminal. If the project wasn’t built for the profile that we want to run yet, run it with --build. By default, run environment follows build-env from pwrforge.toml. Use --docker or --native to override it.

Debugging

pwrforge also supports debugging through gdb cli. We will first build our project in Debug and then we can run pwrforge debug command:

pwrforge build --profile Debug
pwrforge debug