How to create folder reference in Xcode?

Question

I tried to add files to Xcode 16 for loading a react build into webview by following this tutorial https://ditto.live/blog/run-react-locally-in-ios-app:

Right click on the Project(In project navigation at left)
Add files to "<project_name>"
Selected the folder(named 'build') from navigator and clicked "Add"
I get the following dialog:

The expected image should have been this:

enter image description here

And when I try to list the build folder with:

let docsPath = Bundle.main.resourcePath!.appending("/build")
let fileManager = FileManager.default

do {
    let docsArray = try fileManager.contentsOfDirectory(atPath: docsPath)
    print(docsArray)
} catch {
    print(error)
}

I get "No such file or directory" error in the console.

polo li · Accepted Answer · 2024-12-03 02:58:59Z

4

You can try the method below; it works for me.

Show Inspector: Choose Folder -> View -> Inspector -> Show Inspector enter image description here
Choose Apply Once to Folder and add your target enter image description here

answered Dec 3, 2024 at 2:58

polo li

412 bronze badges

Sign up to request clarification or add additional context in comments.

2 Comments

Community Dec 3, 2024 at 10:51

Your answer could be improved with additional supporting information. Please edit to add further details, such as citations or documentation, so that others can confirm that your answer is correct. You can find more information on how to write good answers in the help center.

kelin Sep 22 at 15:48

As i understand you are telling us how to add folder as a whole to the project, not how to reference a folder.

Jon Hess · Accepted Answer · 2024-11-14 18:42:19Z

3

After you create the folder reference as described by yo1995's answer, also use the file inspector on the folder to change the value of "Build Rules" to "Apply Once To Folder".

This will result in the folder being copied as an opaque single resource, rather than passing all of the files in the folder through to the build system for individual processing.

answered Nov 14, 2024 at 18:42

Jon Hess

14.3k1 gold badge49 silver badges51 bronze badges

Comments

yo1995 · Accepted Answer · 2024-11-14 18:39:53Z

Xcode 16 has slightly changed the UI for adding files/folders.

The first checkbox in older versions, "Destination: Copy items if needed" is changed into a drop down list. Copy = checked; reference in place = unchecked; move is a newly added action that equals to copy then delete in the older version.

The "Add folders" radio buttons group is changed into a drop down list as well. It only appears when you are adding a folder from disk. The options remain the same.

To debug file path related issues, one way is to use Xcode > Product > Show Build Folder In Finder, and reveal the content in the app bundle to see how the folders are actually structured in the bundle.

In short, "groups" are logic groupings for the project files only, and all the files are laid flat in the root level of the bundle; "folder references" are actual folders created in the bundle so the files are hierarchical.

Related Apple doc: https://developer.apple.com/documentation/xcode/managing-files-and-folders-in-your-xcode-project

Collectives™ on Stack Overflow

How to create folder reference in Xcode?

3 Answers 3

2 Comments

Comments

Comments

Your Answer

Hot Network Questions

Collectives™ on Stack Overflow

3 Answers 3

2 Comments

Comments

Comments

Your Answer

Sign up or log in

Post as a guest

Related