📝 Update README with clearer mise usage instructions for Cork compilation

The README now provides more detailed instructions on how to use mise with tuist for compiling Cork. Instead of using `mise use`, which modifies the local environment, the instructions now recommend using `mise exec` to run tuist commands with a specific version without permanently changing settings. This approach gives users more control over their environment and explains the trust prompt that mise displays when encountering a new project configuration.
This commit is contained in:
Dave Williams 2025-06-10 15:25:15 +01:00
parent f42da4e0c9
commit c8f6f799ff
No known key found for this signature in database
1 changed files with 8 additions and 3 deletions

View File

@ -150,7 +150,12 @@ In my case, it was `echo "eval \"\$(/Users/david/.local/bin/mise activate zsh)\"
#### Compiling Cork
0. I recommend you pick a version marked by one of the version tags. Those are released versions. If you decide to compile the current state of any of the branches, you might encounter experience-breaking bugs and unfinished features
1. Use the command `git clone https://github.com/buresdv/Cork.git && cd Cork && mise use tuist@4.25.0 && tuist install && tuist generate --no-binary-cache`. Xcode will open the project.
1. Use the command `git clone https://github.com/buresdv/Cork.git && cd Cork && mise exec tuist@4.25.0 -- tuist install && mise exec tuist@4.25.0 -- tuist generate --no-binary-cache`.
- Mise will ask you to trust the local [`.mise.toml`](.mise.toml).
- You can either:
- Say yes, to always use `tuist` version 4.25.0 in this directory.
- Say no, and the command will use `tuist` 4.25.0 anyway, but future invocations of `tuist` will not be version controlled.
- Xcode will open the project.
<div style= "margin-left: 1rem">
<details>
@ -159,7 +164,7 @@ In my case, it was `echo "eval \"\$(/Users/david/.local/bin/mise activate zsh)\"
<ol>
<li><code>git clone https://github.com/buresdv/Cork.git</code> downloads the source code</li>
<li><code>cd Cork</code> opens the folder you downloaded Cork into</li>
<li><code>mise use</code> tells your system to use version <i>4.25.0</i> of Tuist to build Cork</li>
<li><code>mise exec [...]</code> runs a command using version <i>4.25.0</i> of Tuist, without polluting your local `mise.toml`, to build Cork</li>
<li><code>tuist install</code> downloads all Cork pre-requisites</li>
<li><code>tuist generate</code> creates the Xcode project and opens it</li>
</ol>
@ -187,4 +192,4 @@ Cork is licensed under [Commons Clause](https://commonsclause.com).
This means that Cork's source source is available and you can modify it, contribute to it etc., but you can't sell or distribute Cork or modified versions of it.
Moreover, you cant distribute compiled versions of Cork without consulting me first. Compiling versions for your personal use is fine.
Moreover, you cant distribute compiled versions of Cork without consulting me first. Compiling versions for your personal use is fine.