Skip to content

Update Project Generator guides for openFrameworks 0.12.1 - #848

Merged
danoli3 merged 1 commit into
openframeworks:masterfrom
danoli3:project-generator-docs-0.12.1
Nov 14, 2026
Merged

danoli3 merged 1 commit into
openframeworks:masterfrom
danoli3:project-generator-docs-0.12.1

Conversation

@danoli3

@danoli3 danoli3 commented Nov 12, 2026

Copy link
Copy Markdown
Member

Document the Project Generator create/update workflow for openFrameworks 0.12.1 and correct the linked English setup guides. Builds on the merged setup-guide update in #840, with newer nightly features identified separately.

Area Changes
Project Generator Rewrite the create/update walkthrough, addon guide and introductory tutorial. Explain OF path, parent project path, platform choices, templates, generated files and addons.make. Remove the fixed three-folder-depth requirement.
Release versions Check the 0.12.1 workflow against its pinned Project Generator source and the released 0.95 executable. Label newer CMake and Visual Studio templates as nightly features.
Linux and Raspberry Pi Correct command locations and platform IDs. Explain that compilePG.sh builds the CLI, with optional installation as projectGenerator, rather than the Electron GUI. Distinguish old dependency-script workarounds from current master.
Visual Studio, Xcode and Android Link to the shared generator guide and clarify importing/updating projects and selecting the matching OF installation.
VS Code and MSYS2 Match UCRT64, MINGW64 and CLANG64 terminal/compiler settings to the downloaded package. Clarify makefile versus nightly CMake projects.
Emscripten Keep the nightly requirement, refer to the SDK version pinned by the checkout, and correct Release output/run paths to bin/em/<project>/.
Rendering Fix metadata so the edited how-to titles render correctly, publish the existing Xcode/VS Code screenshots through Nikola, and add spacing to guide tables.
Checked locally Result
Released Project Generator 0.95 executable with 0.12.1 templates, on Apple Silicon Linux project creation and update, addon preservation, deeper-folder creation, ARM64 and Visual Studio project generation pass
Nikola 7.8.15 13 related published pages render; the legacy introductory tutorial also parses as Markdown
Local links, anchors and images 56 checks pass
Stable download filenames 9 rendered links match assets published on the 0.12.1 release
Headless Chrome Correct titles and readable tables; both Project Generator guide images and all 23 Xcode screenshots load; no failed local asset requests
git diff --check Pass

The command-line checks generate project files; they do not compile Windows/Linux applications or exercise the OS installers. Translations are unchanged. Based on current site master e73d122, including merged #840 and the newer site-build changes.

@danoli3
danoli3 merged commit 54ac0e8 into openframeworks:master Nov 14, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant