I'm curious when using Xcode.
I always need to choose an option when copying the open source class files I need for my project.
The options are "Create groups" and "Create folder references".
I've read the difference between the two already.
But it is not understood at all.
When I chose one of the two options, I deleted the file from my project and the open source class file was deleted at the same time.
I do not want it.
I want to always exist as an independent file. What should I choose?
There are two types of any Xcode project structure organization:
- filesystem project structure (inspectable with Finder.app)
- IDE project structure (inspectable with Project Navigator in Xcode's navigator area.)
Xcode relies on filesystem organization by keeping a reference to a "physical" file or folder. That is why you may have all the classes, images, plists, and other parts of your projects stored in the same folder, while the references to these parts are being kept organized into respective groups within Xcode project.
When you create a group, it affects the organization of your project in Xcode. When you create a group with a reference folder, it creates both, a group in Xcode project and a folder in your filesystem.
However, since Xcode 9 it seems like, Apple enforces filesystem project structure to correspond to Xcode project structure. It means, that you explicitly has to choose "New Group without Folder"
It took me a while to understand the difference between those two options so I thought I'd share:
I'm writing this when Xcode 10 is the current version
The biggest difference is how the imported folder / file will be accessible from the finder. Let's say you want to import a new folder to your Xcode project. When you choose Create groups
Xcode will import your new folder and create a group (the yellow icon). When you go to your project's directory (using Finder) you should see a folder named like the one you've just imported, but any additional files you put to this folder trough Finder won't be visible in your Xcode project.
When you choose Create folder references
the imported folder will have a classic blue folder icon. This new folder will also be visible when you go to your projects directory, but now every new file you put there will also appear in your Xcode project.
If you want to know more just read this explanation http://www.thomashanning.com/xcode-groups-folder-references/
It's pretty straightforward and easy to understand.
Added files and folders from Finder
into the Xcode
group. Xcode 10.2.1. Just take a look at the examples without Copy items if needed
Files
Common behaviour for create groups
and create folder references
- Rename a file from
Finder
does not rename the file in Xcode
, as a result Xcode doesn't handle it and it will mark them by red color.
- Rename a file from
Xcode
rename the file in Finder
- Change a file from
Finder
change the file in Xcode
and vice versa
- Remove to trash a file from
Xcode
change the file in Finder
and vice versa
- Add a file from folder in
Finder
does not add the file to group in Xcode
Folders
Common behaviour for create groups
and create folder references
:
- Rename a folder/group from
Xcode
rename the folder in Finder
create groups
If you choose create groups
, then the corresponding folder appears with a yellow icon in the project navigator.
It is just a virtual folder. It useful during development when you copy a file and it is not compiled and you do not have a time to make changes in it and want only to check if a project works. So you can just remove a reference from a file. It will not be removed from a folder as a result you will be able to add this file again.
- Rename a folder in
Finder
does not rename a name of group in Xcode
. You steal can work with group but previous content inside although visible but unavailable
- Add a file to a folder in
Finder
does not add the file to group in Xcode
- Add a file to a group in
Xcode
does not add the file to folder in Finder
- Remove a folder in
Finder
does not remove the group in Xcode
. You steal can work with group but previous content inside although visible but unavailable
create folder references
If you are choosing create folder references
, then the folder appears with a blue icon in the project navigator.
It is a real folder and any changes will be reflected
- Rename a folder in
Finder
does not rename a name of folder in Xcode. The previous content is gone and you can not work with this folder
- Add a file to a folder in
Finder
adds the file to folder in Xcode
- Add a file to a folder in
Xcode
adds the file to folder in Finder
- Remove a folder in
Finder
removes the folder in Xcode
.
Copy items if needed