f321b2350c
- Updated the Visual Studio setup guide to recommend using a project generation script for easier configuration. - Added detailed instructions for the new script, including features and usage examples. - Improved the script to check for vcpkg installation and automatically install dependencies if missing. - Introduced a test script to verify the project generation process with different configurations. - Enhanced error handling and output messages in the project generation script for better user experience.
YAZE Build Scripts
This directory contains build and setup scripts for YAZE development on different platforms.
Windows Scripts
Setup Scripts
setup-windows-dev.ps1- Complete Windows development environment setup (PowerShell)setup-vcpkg-windows.ps1- vcpkg setup only (PowerShell)setup-vcpkg-windows.bat- vcpkg setup only (Batch)
Build Scripts
build-windows.ps1- Build YAZE on Windows (PowerShell)build-windows.bat- Build YAZE on Windows (Batch)
Validation Scripts
validate-windows-build.ps1- Validate Windows build environment
Project Generation
generate-vs-projects.py- Generate Visual Studio project files (Cross-platform Python)generate-vs-projects.ps1- Generate Visual Studio project files (PowerShell)generate-vs-projects.bat- Generate Visual Studio project files (Batch)
Quick Start (Windows)
Option 1: Automated Setup (Recommended)
.\scripts\setup-windows-dev.ps1
Option 2: Manual Setup
# 1. Setup vcpkg
.\scripts\setup-vcpkg-windows.ps1
# 2. Generate project files
python scripts/generate-vs-projects.py
# 3. Build
.\scripts\build-windows.ps1
Option 3: Using Batch Scripts
REM Setup vcpkg
.\scripts\setup-vcpkg-windows.bat
REM Generate project files
python scripts/generate-vs-projects.py
REM Build
.\scripts\build-windows.bat
Script Options
setup-windows-dev.ps1
-SkipVcpkg- Skip vcpkg setup-SkipVS- Skip Visual Studio check-SkipBuild- Skip test build
build-windows.ps1
-Configuration- Build configuration (Debug, Release, RelWithDebInfo, MinSizeRel)-Platform- Target platform (x64, x86, ARM64)-Clean- Clean build directories before building-Verbose- Verbose build output
build-windows.bat
- First argument: Configuration (Debug, Release, RelWithDebInfo, MinSizeRel)
- Second argument: Platform (x64, x86, ARM64)
clean- Clean build directoriesverbose- Verbose build output
Examples
# Build Release x64 (default)
.\scripts\build-windows.ps1
# Build Debug x64
.\scripts\build-windows.ps1 -Configuration Debug -Platform x64
# Build Release x86
.\scripts\build-windows.ps1 -Configuration Release -Platform x86
# Clean build
.\scripts\build-windows.ps1 -Clean
# Verbose build
.\scripts\build-windows.ps1 -Verbose
# Validate environment
.\scripts\validate-windows-build.ps1
REM Build Release x64 (default)
.\scripts\build-windows.bat
REM Build Debug x64
.\scripts\build-windows.bat Debug x64
REM Build Release x86
.\scripts\build-windows.bat Release x86
REM Clean build
.\scripts\build-windows.bat clean
Troubleshooting
Common Issues
-
PowerShell Execution Policy
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser -
MSBuild Not Found
- Install Visual Studio 2022 with C++ workload
- Or add MSBuild to PATH
-
vcpkg Issues
- Run
.\scripts\setup-vcpkg-windows.ps1to reinstall - Check internet connection for dependency downloads
- Run
-
Python Not Found
- Install Python 3.8+ from python.org
- Make sure Python is in PATH
Getting Help
- Run validation script:
.\scripts\validate-windows-build.ps1 - Check the Windows Development Guide
- Review build output for specific error messages
Other Scripts
create_release.sh- Create GitHub releases (Linux/macOS)extract_changelog.py- Extract changelog for releasesquality_check.sh- Code quality checks (Linux/macOS)test_asar_integration.py- Test Asar integrationagent.sh- AI agent helper script (Linux/macOS)