Documentation

Unity Engine

User Manual

Script Reference

Unity Engine

ReplaceFile(string, string, PBXSourceTree)

Replaces a specified file with a new file.
Read time 1 minuteLast updated 6 days ago

Definition

public void ReplaceFile(string fileGuid, string path, PBXSourceTree source = PBXSourceTree.Absolute)

Parameters

fileGuid

string
The GUID of the file reference.

path

string
The physical path to the new file on the filesystem.

source

PBXSourceTree
The source tree the path is relative to. By default it's PBXSourceTree.Source. The PBXSourceTree.Group tree is not supported.

Remarks

The path to the specified file is replaced and the GUID of the old file is preserved.

Examples

using UnityEditor;using System.IO;using UnityEditor.Callbacks;using UnityEditor.iOS.Xcode;public class Sample_ReplaceFile  {    [PostProcessBuild]    public static void OnPostprocessBuild(BuildTarget buildTarget, string pathToBuiltProject)    {        // Stop processing if build target is not iOS        if (buildTarget != BuildTarget.iOS)            return;        // Initialize PBXProject        string projectPath = PBXProject.GetPBXProjectPath(pathToBuiltProject);        PBXProject pbxProject = new PBXProject();        pbxProject.ReadFromFile(projectPath);        // Get the target GUID        string targetGuid = pbxProject.GetUnityMainTargetGuid();        // Get the GUID of the existing file you want to replace        string existingFilePath = "Resources/oldExampleFile.txt";        string existingFileGuid = pbxProject.FindFileGuidByProjectPath(existingFilePath);        // Add the new file and get the GUID        string newFilePath = "path/to/your/newExampleFile.txt";        string newFileGuid = pbxProject.AddFile(newFilePath, "Resources/newExampleFile.txt", PBXSourceTree.Source);        // Replace the existing file with the new file        pbxProject.ReplaceFile(existingFileGuid, newFileGuid);        // Apply changes to the pbxproj file        pbxProject.WriteToFile(projectPath);    }}