Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

macOS setup documentation #67

Merged
merged 1 commit into from
Jan 22, 2024
Merged

Conversation

mrhelmut
Copy link
Contributor

This is an attempt to address issues such as this one: MonoGame/MonoGame#7982


## macOS considerations

For the time being, MonoGame requires that you install the x64 version of the .NET SDK even if you are running on an Apple Silicon mac. It is also required that [Rosetta](https://support.apple.com/en-us/HT211861) is enabled.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Even with Rosetta emulation, the mgcb will fail to build Textures and SpriteFonts due to the freeimage and freetype libs needing to be built for the M1/M2 architecture.

There are workarounds that some have used such as doing a brew install of both libs and creating a symnlink for them

Copy link
Contributor

@AristurtleDev AristurtleDev left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Include considerations about freeimage and freetype?

@mrhelmut
Copy link
Contributor Author

Include considerations about freeimage and freetype?

We should rebuild those libraries with Apple Silicon support, the setup on macOS and Linux is already convoluted enough. I'll try to setup that in the way @harry-cpp initiated with Github Actions for other libs.

@harry-cpp
Copy link
Member

@AristurtleDev and I already set them up ^^

@harry-cpp
Copy link
Member

@mrhelmut
Copy link
Contributor Author

You're always a step ahead (or I'm lagging).

So all we need is updating the references? (and make sure that SharpFont can load FreeType properly)

@AristurtleDev
Copy link
Contributor

Yea, the references packed with the mgcb NuGet need to be updated to include the the apple silicon built libs. That still won't resolve current user issue though until a new MonoGame release is done, so the information about it should probably still be included in the macOS consideration section written for the page until then.

@tomspilman tomspilman merged commit 20c6261 into MonoGame:main Jan 22, 2024
@mrhelmut mrhelmut deleted the documentation branch January 29, 2024 19:18
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.

None yet

4 participants