Document new buildProfile config option (#498)

* Document new `buildProfile` config option

Relates to game-ci/unity-builder#674
Relates to game-ci/unity-builder#685

* Update BuildScript.cs with BuildProfile example

* Update example/BuildScript.cs

---------

Co-authored-by: David Finol <[email protected]>

Author: MichaelBuhler

docs/03-github/04-builder.mdx

@@ -162,9 +162,24 @@ _**required:** `false`_ _**default:** `""`_
 #### projectPath
 
 Specify the path to your Unity project to be built. The path should be relative to the root of your
-project.
+repository.
 
-_**required:** `false`_ _**default:** `<your project root>`_
+_**required:** `false`_ _**default:** `<your repository root>`_
+
+#### buildProfile
+
+Provide a path to a build profile. The path should be relative to the root of your Unity project
+(i.e. relative to `projectPath`). See the
+[Unity documentation](https://docs.unity3d.com/Manual/build-profiles.html) for more information on
+using build profiles.
+
+```yaml
+- uses: game-ci/unity-builder@v4
+  with:
+    buildProfile: 'Assets/Settings/Build Profiles/WindowsDemo.asset'
+```
+
+_**required:** `false`_ _**default:** Unity will do a platform build for the `targetPlatform`._
 
 #### buildName
 

example/BuildScript.cs

@@ -4,6 +4,9 @@
 using System.Linq;
 using UnityEditor;
 using UnityEditor.Build.Reporting;
+#if UNITY_6000_0_OR_NEWER
+using UnityEditor.Build.Profile;
+#endif
 
 namespace UnityBuilderAction
 {
@@ -89,6 +92,38 @@ public static void Build()
             Build(buildTarget, buildSubtarget, options["customBuildPath"]);
         }
 
+#if UNITY_6000_0_OR_NEWER
+        public static void BuildWithProfile()
+        {
+            // Gather values from args
+            Dictionary<string, string> options = GetValidatedOptions();
+
+            // Load build profile from Assets folder
+            BuildProfile buildProfile = AssetDatabase.LoadAssetAtPath<BuildProfile>(options["customBuildProfile"]);
+
+            // Set it as active
+            BuildProfile.SetActiveBuildProfile(buildProfile);
+// Get all buildOptions from options
+      BuildOptions buildOptions = BuildOptions.None;
+      foreach (string buildOptionString in Enum.GetNames(typeof(BuildOptions))) {
+        if (options.ContainsKey(buildOptionString)) {
+          BuildOptions buildOptionEnum = (BuildOptions) Enum.Parse(typeof(BuildOptions), buildOptionString);
+          buildOptions |= buildOptionEnum;
+        }
+      }
+            // Define BuildPlayerWithProfileOptions
+            var buildPlayerWithProfileOptions = new BuildPlayerWithProfileOptions {
+                buildProfile = buildProfile,
+                locationPathName = options["customBuildPath"],
+                options = buildOptions,
+            };
+
+            BuildSummary buildSummary = BuildPipeline.BuildPlayer(buildPlayerWithProfileOptions).summary;
+            ReportSummary(buildSummary);
+            ExitWithResult(buildSummary.result);
+        }
+#endif
+
         private static Dictionary<string, string> GetValidatedOptions()
         {
             ParseCommandLineArguments(out Dictionary<string, string> validatedOptions);