GiantCroissant.Lunar.Build 0.1.1-ci.90

GiantCroissant Lunar Build System

A powerful, configuration-driven build infrastructure for Unity projects with .NET solutions, designed to streamline development workflows and CI/CD pipelines.

Features

• Unified Build System: Single build configuration for all project types
• Cross-Platform: Windows, Linux, and macOS
• Extensible Architecture: Modular components for custom scenarios
• CI/CD Ready: Seamless integration with GitHub Actions
• Mobile Support: Android and iOS components and validation

Supported Project Types

• .NET Libraries: Create and publish NuGet packages
• .NET Executables: Build and package CLI tools
• Unity Packages: Manage and deploy Unity packages
• Unity Player Builds: Multi-platform builds (Android, iOS, Windows)

Quick Start

Prerequisites

• .NET 6.0+ SDK
• Unity 2020.3+ (for Unity projects)
• Git

Installation

1. Clone the repository:

   git clone https://github.com/your-org/giantcroissant-lunar-build.git
   cd giantcroissant-lunar-build
   

2. Restore dependencies:

   dotnet restore build/nuke/Lunar.Build.sln
   

3. Run the build:

   cd build/nuke
   ./build.ps1
   

Documentation

• Docs Index – Overview and navigation
• Quick Start Guide – How to use the build system
• Getting Started – Onboarding and platform setup
• Reference – CLI/targets, performance, inventory
• NuGet Local Feed & Meta Pinning – Local feed, packageSourceMapping, and meta dependency pinning best practices
• Workspace Artifacts and Feed Policy – SSOT, artifacts location, and workspace feed rules

Project Discovery

• Source of truth: projects.discovery in build/nuke/build-config.json.
• Precedence: parameter overrides → config values → defaults.
• Resolution: entries are resolved against both EffectiveRootDirectory and the config file directory; supports files, directories (expanded to **/*.csproj), and wildcard patterns.
• Example:

{
  "projects": {
    "discovery": {
      "sourceDirectory": "build/nuke",
      "entries": [
        "components/Configuration/Lunar.Build.Configuration.csproj",
        "components/NuGet/Lunar.Build.NuGet.csproj",
        "components/CodeQuality/Lunar.Build.CodeQuality.csproj",
        "components/CoreAbstractions/Lunar.Build.CoreAbstractions.csproj",
        "components/Mobile/Lunar.Build.Mobile.csproj",
        "components/Mobile/iOS/Lunar.Build.Mobile.iOS.csproj",
        "components/Mobile/Android/Lunar.Build.Mobile.Android.csproj"
      ],
      "excludePatterns": ["Tests.csproj", ".Tests.csproj"]
    }
  }
}

• Schema: build/nuke/components/Configuration/schemas/project-discovery.schema.json (referenced by the root schema).
• Note: legacy projectGroups[*].explicitProjects are no longer used for discovery; the build now consumes projects.discovery via IProjectDiscoveryComponent.

Project Structure

giantcroissant-lunar-build/
├─ build/                 # Build system components and configurations
├─ docs/                  # Documentation
├─ projects/              # Example and test projects
├─ scripts/               # Utility scripts
└─ .github/               # GitHub workflows and templates

Contributing

We welcome contributions! Contributing guidelines will be added soon.

License

This project is licensed under the MIT License. A LICENSE file will be added to the repository.

Support

For support, please open an issue in the repository issue tracker.

Changelog

Changelog will be provided once releases are stabilized.

<div align="center"> Made with care by the GiantCroissant Team </div>