Documentation

Unity Engine

User Manual

Script Reference

Unity Engine

AddCopyFilesBuildPhaseBeforeTargetPostprocess(string, string, string, string)

Creates a new Copy Files build phase for a given target.
Read time 1 minuteLast updated 13 days ago

Definition

public string AddCopyFilesBuildPhaseBeforeTargetPostprocess(string targetGuid, string name, string dstPath, string subfolderSpec)

Parameters

targetGuid

string
The GUID of the target, such as the one returned by PBXProject.GetUnityFrameworkTargetGuid.

name

string
The name of the phase.

dstPath

string
The destination path.

subfolderSpec

string
The subfolder spec. The following usages are known:
  • 10
    for embedding frameworks.
  • 13
    for embedding app extension content.
  • 16
    for embedding watch content.

Returns

Type

Description

stringReturns the GUID of the new phase.

Remarks

If a Copy Files build phase with the same name, 
dstPath
, and 
subfolderSpec
is already configured for the target, the function returns the existing phase. The new phase is placed right before Unity's post-process placeholder target (if it exists).

Examples

using UnityEngine;using UnityEditor;using UnityEditor.iOS.Xcode;using UnityEditor.Callbacks;using System.IO;public class Sample_AddCopyFilesBuildPhaseBeforeTargetPostprocess  {    [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 main target GUID          string mainTargetGuid = pbxProject.GetUnityMainTargetGuid();        // Add a Copy Files Build Phase before Unity Postprocess phase to the main target        pbxProject.AddCopyFilesBuildPhaseBeforeTargetPostprocess(mainTargetGuid, "ExamplePhase", "path/to/file", "10");        // Apply changes to the pbxproj file        pbxProject.WriteToFile(projectPath);    }}