wx_cmake_template - GitLite

KO | EN

gitlite — search

#ai #llm #go #golang #rust #deep-learning #nodejs #macos #windows #cli #awesome-list #vue #openai #open-source

wx_cmake_template

(★ 159)

A template for multiplatform WxWidgets projects using CMake

File Explorer

Download Latest Version (.zip)

- c_cpp_properties.json
- launch.json
- settings.json
- tasks.json
- CMakeLists.txt
- Info.plist
- main.cpp
- main.exe.manifest
- - CMakeLists.txt
- CMakeLists.txt
.gitignore
CMakeLists.txt
copy_to_project.sh
LICENSE
README.md

# Installation Guide

1. Get the code

git clone https://github.com/lszl84/wx_cmake_template

Downloads the entire project code from GitHub to your computer.

cd wx_cmake_template

Moves into the project folder you just downloaded.

2. CMake

Medium Recommended

Prerequisites

Git Needed to download the project code from GitHub.
CMake The tool used to generate build configuration.
C/C++ 컴파일러 Windows needs Visual Studio (Community edition, free), macOS needs Xcode Command Line Tools, Linux needs the gcc/g++ package.

cmake -S. -Bbuild

Type this command into your terminal and run it.

cmake --build build

Type this command into your terminal and run it.

✅ Check that an executable was created inside the build folder, then run it directly (e.g. ./build/app_name).

Pulled directly from this repo's README.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# 🚨 STOP! 🚨

You might want to try much simpler version of this setup, with `FetchContent`: https://github.com/lszl84/wx_cmake_fetchcontent_template

Tutorial here: https://www.youtube.com/watch?v=zjNg5HdgNO0

Or use the more complex approach described below.

# wx_cmake_template

A template for multiplatform wxWidgets projects using CMake

## How this works

This template searches for the wxWidgets library using `FindPackage`. If not found, it downloads the library source from GitHub, compiles it, and links it with the main project.

The super build pattern with `ExternalProject_Add` is used to achieve this.

## Requirements

This works on Windows, Mac, and Linux. You'll need `cmake` and a C++ compiler (tested on `clang`, `gcc`, and MSVC).

Linux builds require the GTK3 library and headers installed in the system.

## Building

To build the project, use:

```bash
cmake -S. -Bbuild
cmake --build build
```

This will create a directory named `build` and create all build artifacts there. The main executable can be found in the `build/subprojects/Build/wx_cmake_template_core` folder.

## Using as a Template (Linux/Mac)

Use the provided `copy_to_project.sh` script to create another project from the template.

```bash
./copy_to_project.sh directory project_name
```

This will create a copy of the template's directory structure in `directory`, renaming `wx_cmake_template` to the provided `project_name`.

## Notes

For details, see the [blog post](https://devmindscape.com/post/wxwidgets-cmake/) and the [video](https://www.youtube.com/watch?v=MfuBS9n5_aY) tutorial showcasing the installation on Linux, Windows, and Mac OS X.

---
Check out the blog for more! [devmindscape.com](https://devmindscape.com)
---