XCFolder is a powerful command-line tool that converts Xcode virtual groups into actual directories(associated folder), reorganizing your project structure to align with Xcode groups and enabling seamless integration with modern Xcode project generation tools like Tuist and XcodeGen.
- Smart Group Conversion: Intelligently transforms Xcode virtual groups into physical directories while preserving project structure
- Perfect Synchronization: Maintains 1:1 mapping between Xcode project navigator and filesystem directories
- Automated Organization: Eliminates manual folder management with automated synchronization
- Migration Ready: Prepares your project structure for modern build systems like Tuist and XcodeGen
git clone https://github.com/ZhgChgLi/XCFolder.git
./Configuration.yaml:
# Paths to ignore when scanning for source files
ignorePaths:
- "Pods"
- "Frameworks"
- "Products"
# File types to ignore when scanning for source files
ignoreFileTypes:
- "wrapper.framework" # Frameworks
- "wrapper.pb-project" # Xcode project files
#- "wrapper.application" # Applications
#- "wrapper.cfbundle" # Bundles
#- "wrapper.plug-in" # Plug-ins
#- "wrapper.xpc-service" # XPC services
#- "wrapper.xctest" # XCTest bundles
#- "wrapper.app-extension" # App extensions
# Whether to move files only, without changing .xcodeproj settings
moveFileOnly: false
# Use git mv by default instead of filesystem move
gitMove: truecd ./XCFolder
swift run XCFolder YOUR_XCODEPROJ_FILE.xcodeproj ./Configuration.yaml
swift run XCFolder YOUR_XCODEPROJ_FILE.xcodeproj ./Configuration.yaml --is-non-interactive-mode
swift run XCFolder ./TestProject/DCDeviceTest.xcodeproj ./Configuration.yaml
- Ensure your project is backed up, and if you’re using source control,make sure there are no uncommitted changes in Git, as the script may modify your project directory.
- (The script will check for uncommitted changes and will throw an error
❌ Error: There are uncommitted changes in the repository)
- (The script will check for uncommitted changes and will throw an error
- By default, the
git mvcommand will be used to move files to ensure the git file log is fully recorded.- If the move fails or if it's not a Git project, the FileSystem Move will be used instead.
- Check if there are any missing (red) files in the project directory.
- If there are few, you can manually fix them.
- If there are many, verify whether the settings for ignorePaths and ignoreFileTypes in Configuration.yaml are correct, or create an Issue to let me know.
- Check the relevant paths in Build Settings, e.g.,
LIBRARY_SEARCH_PATHS, to see if manual adjustments are needed. - It's recommended to perform a Clean & Build again.
- If you don't want to bother with the current
.xcodeprojXCode project file, you can directly use XCodeGen or Tuist to regenerate the project files.
The entire project is written in Swift and runs as an SPM command-line tool.
You can modify the source code by opening Package.swift if needed.
- ZMarkupParser is a pure-Swift library that helps you to convert HTML strings to NSAttributedString with customized style and tags.
- ZPlayerCacher is a lightweight implementation of the AVAssetResourceLoaderDelegate protocol that enables AVPlayerItem to support caching streaming files.
- ZReviewTender is a tool for fetching app reviews from the App Store and Google Play Console and integrating them into your workflow.
- ZMediumToMarkdown is a powerful tool that allows you to effortlessly download and convert your Medium posts to Markdown format.
- linkyee is a fully customized, open-source LinkTree alternative deployed directly on GitHub Pages.
If you find this library helpful, please consider starring the repo or recommending it to your friends.
Feel free to open an issue or submit a fix/contribution via pull request. :)
