BuildPipeline.BuildPlayer

Создает игрока.

Используйте эту функцию для программного создания сборки проекта.

Вызов этого метода приведет к отмене всех переменных в скрипте редактора, которые ссылаются на GameObjects, так что их нужно будет вновь приобрести после вызова.

Сценарии могут запускаться в стратегических точках во время сборки, реализуя один из поддерживаемых интерфейсов обратного вызова, например BuildPlayerProcessor, IPreprocessBuildWithContext, IProcessSceneWithReport и IPostprocessBuildWithContext.

Примечание: Обратите внимание, что изменения в скриптовые символы вступают в силу только при следующей перезагрузке домена, когда скрипты перекомпилируют.

Это означает, что если вы измените определенные скриптовые символы с помощью кода, используя PlayerSettings.SetDefineSymbolsForGroup без перезагрузки домена перед вызовом этой функции, эти изменения не вступят в силу.

Это также означает, что встроенные символы скриптов, определенные для текущей активной целевой платформы (например, UNITY_STANDALONE_WIN, или UNITY_ANDROID) остаются на месте, даже если вы пытаетесь компилировать для другой целевой платформы, что может привести к компиляции неправильного кода в вашей сборке.

Дополнительные ресурсы: BuildPlayerWindow.DefaultBuildMethods.BuildPlayer.

using UnityEditor;
using UnityEngine;
using UnityEditor.Build.Reporting;

// Output the build size or a failure depending on BuildPlayer.

public class BuildPlayerExample
{
    [MenuItem("Build/Build iOS")]
    public static void MyBuild()
    {
        BuildPlayerOptions buildPlayerOptions = new BuildPlayerOptions();
        buildPlayerOptions.scenes = new[] { "Assets/Scene1.unity", "Assets/Scene2.unity" };
        buildPlayerOptions.locationPathName = "iOSBuild";
        buildPlayerOptions.target = BuildTarget.iOS;
        buildPlayerOptions.options = BuildOptions.None;

        BuildReport report = BuildPipeline.BuildPlayer(buildPlayerOptions);
        BuildSummary summary = report.summary;

        if (summary.result == BuildResult.Succeeded)
        {
            Debug.Log("Build succeeded: " + summary.totalSize + " bytes");
        }

        if (summary.result == BuildResult.Failed)
        {
            Debug.Log("Build failed");
        }
    }
}

Создает игрока из определенного профиля создания.

using UnityEditor;
using UnityEditor.Build.Reporting;
using UnityEditor.Build.Profile;
using UnityEngine;

public class BuildPlayerWithBuildProfileExample
{
    [MenuItem("Build/Build iOS Demo")]
    public static void MyBuild()
    {
        BuildProfile buildProfile = AssetDatabase.LoadAssetAtPath<BuildProfile>("Assets/Settings/Build Profiles/iOSDemo.asset");
        BuildPlayerWithProfileOptions options = new BuildPlayerWithProfileOptions()
        {
            buildProfile = buildProfile,
            locationPathName = "iOSDemoBuild",
            options = BuildOptions.None,
        };

        BuildReport report = BuildPipeline.BuildPlayer(options);
        BuildSummary summary = report.summary;

        // Output the build size or a failure depending on BuildPlayer.
        if (summary.result == BuildResult.Succeeded)
        {
            Debug.Log("Build succeeded: " + summary.totalSize + " bytes");
        }

        if (summary.result == BuildResult.Failed)
        {
            Debug.Log("Build failed");
        }
    }
}

Создает игрока. Эти перегрузки по-прежнему поддерживаются, но будут заменены. Пожалуйста, используйте BuildPlayer(BuildPlayerOptions buildPlayerOptions) и BuildPlayer(BuildPlayerWithProfileOptions buildPlayerWithProfileOptions) вместо этого.