docs: added section on e load-xcode and how to fix security error #444
Conversation
mccare
requested review from
ckerr,
MarshallOfSound,
codebytere and
jkleinsc
as code owners
| @@ -434,3 +440,5 @@ Regardless of whether automatic updates are enabled, you can manually call the f | |||
| ``` | |||
| e auto-update check | |||
| ``` | |||
|
|
|||
There was a problem hiding this comment.
Let's not add this extra space here please!
| @@ -386,6 +386,12 @@ $ e sanitize-config --help | |||
|
|
|||
| Sometimes `build-tools` will make updates to its config requirements. In these events warnings will be output to console to inform you that `build-tools` has temporarily handled the issues. You can make these warnings go away either by manually updating your config files or by running this command to automatically overwrite the existing configs to update formatting. | |||
|
|
|||
| ### `e load-xcode` | |||
| `e load-xcode` downloads and unpacks Xcode and required macOS SDK into the electron buildtools (`.electron_build_tools`) directory | |||
There was a problem hiding this comment.
Space between header and top description please!
| `e load-xcode` downloads and unpacks Xcode and required macOS SDK into the electron buildtools (`.electron_build_tools`) directory | ||
| and symlinks them. This is automatically run by `e init`. | ||
|
|
||
| In case you get a pop up saying that "Xcode is damaged", you need to acknowledge the dialog with cancel and open it through system preferences. Go to System Preferences/Security & Privacy. There will be a section stating that "Xcode is from an unidentified developer". Press "Open Anyway" to acknowledge that you want to open Xcode.app. You might want to run `e load-xcode` again. |
There was a problem hiding this comment.
Let's tweak the wording of this:
As of some more recent Xcode releases, you may see a popup dialog saying "Xcode is damaged". If this occurs, you will need to acknowledge the dialog with cancel and open it through macOS System Preferences. Go to the
Security & Privacysection within System Preferences. There will be a section stating "Xcode is from an unidentified developer". Press "Open Anyway" to acknowledge that you want to openXcode.app. Following this, run thee load-xcodecommand again to verify it works as expected.
|
Good point, I'm using Kitty.app and it is not listed in my developer tools. So this is pretty specific to my setup and doesn't warrant more documentation. Feel free to close it. |
I was running into error when
e initwas downloading and installing Xcode.app. The error was pretty confusing, so I tried to document it in the Readme.