如何用Xcodeproj gem在post_install钩子中添加嵌套资源目录到PBXResourcesBuildPhase

Got it, let's break down how to replicate the "Create folder references" drag-and-drop behavior in Xcode using the Xcodeproj gem within a post_install hook. This will add your nested resource directories to both the project tree (PBXProj) and the Copy Bundle Resources build phase exactly as you'd expect from manual setup.

Core Concepts to Match Manual Setup #

When you drag a folder into Xcode and select "Create folder references", Xcode creates a PBXFileReference with:

• lastKnownFileType set to folder.reference
• sourceTree set to <group> (so it's relative to the project structure)
• The reference is added to your target's PBXResourcesBuildPhase to ensure it's bundled with your app

Step-by-Step Implementation #

Here's a complete post_install hook that handles this:

post_install do |installer|
  # Grab your project (adjust this if you're targeting a specific pod project instead)
  project = installer.pods_project
  
  # Replace with your target's exact name
  target_name = "YourMainAppTarget"
  target = project.targets.find { |t| t.name == target_name }

  # Define the path to your nested resource directory (relative to your project root)
  resource_dir_relative_path = "Resources/MyNestedAssets"
  # Convert to absolute path to avoid path resolution issues
  resource_dir_absolute_path = File.expand_path(resource_dir_relative_path, project.path.dirname)

  # 1. Create the folder reference (the true flag tells Xcodeproj to make a reference, not a group)
  folder_reference = project.new_file(resource_dir_absolute_path, true)
  # Ensure the reference matches Xcode's manual setup (sometimes new_file needs a nudge)
  folder_reference.lastKnownFileType = "folder.reference"
  folder_reference.sourceTree = "<group>"

  # 2. Add the reference to your desired project group (e.g., the "Resources" group)
  # If the Resources group doesn't exist, fall back to the main project group
  target_resources_group = project.groups.find { |g| g.name == "Resources" } || project.main_group
  target_resources_group.children << folder_reference

  # 3. Add the folder reference to the Copy Bundle Resources build phase
  resources_build_phase = target.resources_build_phase
  # Skip if it's already added to avoid duplicates
  unless resources_build_phase.files.any? { |phase_file| phase_file.file_ref == folder_reference }
    resources_build_phase.add_file_reference(folder_reference)
  end

  # Save the changes to the project file
  project.save
end

Key Notes for Success #

• Path Accuracy: Double-check the relative path to your resource directory—using File.expand_path ensures the gem resolves the path correctly relative to your project's location.
• Avoid Duplicates: The check for existing references prevents adding the same folder multiple times if the hook runs repeatedly.
• Target Selection: If you're modifying a pod's target instead of your main app, adjust how you fetch the project and target objects (e.g., use installer.pod_targets instead).
• Nested Depth: You don't need to recursively add subfolders—folder references automatically include all nested content, just like the manual Xcode setup.

内容的提问来源于stack exchange，提问作者Neru