Skip to content

Latest commit

 

History

History
82 lines (70 loc) · 2.98 KB

README.md

File metadata and controls

82 lines (70 loc) · 2.98 KB

Sound MonoGame Sample

This project demonstrates a cross-platform MonoGame 3.8.* sample for playing sound and using pre-built .xnb content. It supports Windows, DesktopGL, Android, and iOS using .NET 8.0 platform-specific SDK-style projects.

Project Modernization (2025):

  • All projects are now SDK-style and use .NET 8.0 TFMs.
  • Platform-specific code and entry points are separated into Platforms/ subdirectories.
  • All MonoGame references are via NuGet (3.8.*).
  • No Content.mgcb file is used; .xnb files are loaded directly.
  • Only Windows, DesktopGL, Android, and iOS are supported (Linux, MacOS, and PSMobile are not).
  • VSCode tasks/launch configurations are provided for Windows and DesktopGL.

Project Structure

README.md
Sound.sln
Core/
    SoundSample.cs
    Content/
        Content.mgcb
        Explosion1.mp3
        Font.spritefont
Platforms/
    Android/
        AndroidManifest.xml
        MainActivity.cs
        Sound.Android.csproj
        Resources/
            Resource.Designer.cs
            Drawable/
                icon.png
                splash.png
            Values/
                Styles.xml
    DesktopGL/
        Program.cs
        Sound.DesktopGL.csproj
    iOS/
        Info.plist
        Program.cs
        Sound.iOS.csproj
    Windows/
        Program.cs
        Sound.Windows.csproj
  • Core/Content/: Pre-built .xnb and audio files, plus the content project file (Content.mgcb).
  • Platforms/Windows, Platforms/DesktopGL, Platforms/Android, Platforms/iOS: Platform-specific projects and entry points.
  • Shared game logic is in Core/SoundSample.cs.

Building and Running

Prerequisites

  • .NET 8.0 SDK
  • Visual Studio 2022+ or VSCode
  • MonoGame 3.8.* NuGet packages (restored automatically)

Windows & DesktopGL (VSCode)

  1. Open the folder in VSCode.
  2. Use the built-in tasks (Ctrl+Shift+B) to build:
    • build-windows or build-desktopgl
  3. Use the Run/Debug menu to launch:
    • Windows or DesktopGL configuration
  4. Ensure all required .xnb files are present in the Core/Content/ directory. If you see a runtime error about missing content, you must add or rebuild the missing .xnb files.

Windows & DesktopGL (Visual Studio)

  1. Open Sound.sln in Visual Studio.
  2. Select the desired platform project and build/run as usual.

Android & iOS

  • Open the respective project in Visual Studio 2022+ (with Xamarin/MAUI workloads installed) and deploy to device/emulator.
  • For Android, ensure all referenced resources (including styles and icons) are present and named in lowercase under Platforms/Android/Resources/.

Notes

  • No Content.mgcb file is used at runtime; .xnb files are loaded directly from Core/Content/.
  • Platform-specific code is separated into subdirectories to minimize #if blocks.
  • Only Windows, DesktopGL, Android, and iOS are supported (Linux, MacOS, and PSMobile are not).
  • If you encounter missing content errors at runtime, check the Core/Content/ directory for the required .xnb files.

License

Copyright © 2011