-
-
Notifications
You must be signed in to change notification settings - Fork 1.4k
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
WIP : Improving macos build step docs #3873
Open
PicoCreator
wants to merge
5
commits into
utmapp:main
Choose a base branch
from
PicoCreator:macos-build-step-docs
base: main
Could not load branches
Branch not found: {{ refName }}
Loading
Could not load tags
Nothing to show
Loading
Are you sure you want to change the base?
Some commits from the old base branch may be removed from the timeline,
and old review comments may become outdated.
Open
Changes from all commits
Commits
Show all changes
5 commits
Select commit
Hold shift + click to select a range
ce89cf1
Adding additional notes when trying to get the build working on Monte…
PicoCreator c7019b9
Additional iteration of build steps
PicoCreator acad7e3
Further iterating (and fixing of mac docs)
PicoCreator e9d1c6b
Reverting advance build steps, making the prebuilt folder structure c…
PicoCreator d167f21
remove duplicate copy and paste
PicoCreator File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change | ||||
---|---|---|---|---|---|---|
|
@@ -11,11 +11,19 @@ git clone --recursive https://github.com/utmapp/UTM.git | |||||
|
||||||
Alternatively, run `git submodule update --init --recursive` after cloning if you did not do a recursive clone. | ||||||
|
||||||
## Dependencies | ||||||
## Downloading PreBuilt SysRoot Dependencies | ||||||
|
||||||
The easy way is to get the prebuilt dependences from [GitHub Actions][1]. Pick the latest release and download all of the `Sysroot-macos-*` artifacts. You need to be logged in to GitHub to download artifacts. If you only intend to run locally, it is alright to just download the sysroot for your architecture. | ||||||
The easiest way is to get the prebuilt dependences from Github. | ||||||
|
||||||
### Building Dependencies (Advanced) | ||||||
- Find the list of [release builds here][1]. | ||||||
- Pick the latest release and download all of the `Sysroot-macos-*` artifacts for the architecture you will need (you will need to be signed in to a github account). If you only intend to run locally, it is alright to just download the sysroot for your traget architecture. | ||||||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more.
Suggested change
|
||||||
- Unpack them into the UTM project folder. You should have a "folder" configured per architecture (see screenshot for an example) | ||||||
|
||||||
![Example of prebuilt sysroot](./imgs/prebuilt-sysroot.png) | ||||||
|
||||||
### Building SysRoot Dependencies (Advanced) | ||||||
|
||||||
| This is optional, and is only necessary if you changed stuff with Qemu or the patches. | ||||||
|
||||||
If you want to build the dependencies yourself, it is highly recommended that you start with a fresh macOS VM. This is because some of the dependencies attempt to use `/usr/local/lib` even though the architecture does not match. Certain installed packages like `libusb`, `gawk`, and `cmake` will break the build. | ||||||
|
||||||
|
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Typo says "traget"