Skip to content

Commit 8a1375d

Browse files
authored
Enhance build-errors.md for Xcode and Terminal file permission issue (#1042)
Clarified error message and solution for 'Unable to read included file' issue in Xcode and Terminal. Updated instructions for modifying permissions.
1 parent 61723d2 commit 8a1375d

1 file changed

Lines changed: 7 additions & 4 deletions

File tree

docs/build/build-errors.md

Lines changed: 7 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -150,24 +150,27 @@ For example, if you see "Invalid active developer path (/Library/Developer/Comma
150150

151151
## Specific Error Messages
152152

153-
### Unable to read included file `LoopConfigOverride.xcconfig`
153+
### in Xcode, Unable to read included file `LoopConfigOverride.xcconfig` or in Terminal `LoopConfigOverride.xcconfig`: Operation not permitted
154154

155155
**Error Message:**
156-
This error occurs inside *Xcode* with the build halting at the line that reads the `LoopConfigOverride.xcconfig` file.
156+
This error occurs inside *Xcode* with the build halting at the line that reads the `LoopConfigOverride.xcconfig` file, or in Terminal when trying to customize a prior download of Loop.
157157

158158
![xcode does not have permission to read downloads folder](img/xcode-permission-error.jpg){width="650"}
159159
{align="center"}
160160

161+
161162
**Solution:**
162163

163-
Modify the permissions for *Xcode* in your macOS.
164+
Modify the permissions for *Xcode* and *Terminal* in your macOS.
164165

165166
The graphic below has steps labeled 1 through 4 to guide you to the setting that must be enabled for you to build the app with *Xcode*.
166167

167168
1. Open the macOS settings (*Apple* icon) and navigate to Privacy & Security
168169
1. Select Files and Folders
169170
1. Select *Xcode*
170-
1. Ensure that Downloads Folder is enabled
171+
1. The graphic below shows that the Downloads Folder is enabled, however in newer macOS, your only option may be to grant Full Disk Access.
172+
2. Additionally, if your error has occured while trying to add customizations, select *Terminal*
173+
3. The graphic below shows that the Downloads Folder is enabled for *Xcode*, however it's the same process for *Terminal*.
171174

172175
![check privacy settings for xcode access to downloads folder](img/set-xcode-file-permissions.png){width="750"}
173176
{align="center"}

0 commit comments

Comments
 (0)