Core

The Core application framework owns the process lifecycle, command-line integration, event dispatch, shared services, and orderly shutdown. Start with Core Application Framework for a guided tour of the available application designs and supporting topics.

• Core Application Framework
  • Choosing an Application Design
  • Writing Small Applications with Functions
  • Building Event-Driven Applications
  • Building Procedural Applications
  • Organizing Command-Style Tools
  • Composing Applications from Services
  • Running as a Service or Foreground Daemon
  • Adding Build Version Information
  • Creating Release Packages
• Choosing an Application Design
  • Comparing the Designs
  • Understanding Main Dispatch
  • Shared Application Startup and Error Handling
• Writing Small Applications with Functions
  • Configuring the Complete Lifecycle
  • Capturing the Application Safely
  • Knowing When to Introduce a Class
• Building Event-Driven Applications
  • Entering the Main Event Loop
  • Starting Asynchronous Work after Option Parsing
  • Finishing and Reporting Failures
• Building Procedural Applications
  • Separating Setup, Options, and Work
  • Using Parsed Values
  • Overriding Application Main Dispatch
  • Cleanup and Errors
• Building Command-Style Applications
  • Defining Commands with Option Modules
  • Preserving Callback Lifetimes
  • Leaving Main Dispatch to Application
  • Help, Errors, and Exit Codes
• Building an Application from Parts
  • Registering the Service Graph
  • Keeping Application and Service Responsibilities Separate
  • Accessing Prepared Services
  • Combining Parts with Custom Main Behavior
• Designing Application Parts
  • Publishing a Stable Service Interface
  • Implementing and Constructing a Part
  • Declaring Dependencies
  • Following the Part Lifecycle
  • Sharing Command-Line Configuration
  • Calling Services Across Threads
  • Handling Failures and Shutdown
• Running Application Parts Independently
  • Manual Application-Part Lifecycle Management
  • Preparing Before Startup
  • Waiting for Part Startup and Shutdown from an External Thread
  • Starting and Stopping One Branch
  • Supplying an Existing Event Target
• Creating Services and Foreground Daemons
  • What Makes a Service Different?
  • Preparing One Executable for Every Mode
  • Installing the Compiled Application
  • Reporting a Slow Windows Startup
  • Windows Controls and Console Events
  • Linux and macOS Signal Conventions
  • Service Startup and Shutdown Responsibilities
• Adding Git Version Information to Your App
  • Version Tags
  • Subclass Pattern
  • Direct Application Pattern
  • CMake Setup
  • Git Reference Tracking
• Creating Release Packages
  • What a Release Package Contains
  • Register Your First Package
  • Add Your Own Files
• Registering Packages in CMake
  • What a Package Call Registers
  • Choose the Executables: TARGET or TARGETS
  • Choose the Package Name: NAME
  • Select a Configuration File: CONFIG
  • Choose Where ZIPs Go: OUTPUT_DIRECTORY
  • What Happens During Install
• Configuring Release Package Contents
  • Begin with a Shared Configuration
  • Choose a Version Source
  • Archive Root Directory, Filename, and Runtime Contents
  • Add Files and Directories
  • Adapt Settings to a Platform or Package
  • Signing Credentials from Environment Placeholders
• Signing and Notarizing Release Packages
  • Code Signing and macOS Notarization
  • Sign a Windows Release
  • Sign and Notarize a macOS App