AndroidProjectFilesModifier

Абстрактный класс с методами для изменения пользовательских файлов проекта Android Gradle в процессе сборки.

Примечание: с помощью этого класса можно изменять файлы проекта Gradle, настроенные в модулях, отличных от стандартного unityLibrary и launcher модулей Android Gradle. Если вы измените этим классом содержимое файлов проекта Android Gradle в стандартных модулях, сборка завершится ошибкой.

This abstract class contains two callback methods: Setup и OnModifyAndroidProjectFiles. Unity звонки Setup перед началом сборки, и этот метод устанавливает предварительные условия для системы сборки. Unity вызовы OnModifyAndroidProjectFiles после создания проекта Gradle, что означает, что все изменения, внесенные в этом методе, применяются непосредственно к этому проекту.

В генерируемых файлах используется синтаксис Groovy, и все свойства строкового типа используют двойные кавычки.

Если ваш OnModifyAndroidProjectFiles callback зависит от других файлов в проекте (или на локальной машине), или если вы хотите, чтобы callback производил новые файлы, вы должны заранее предоставить эту информацию системе сборки, используя Setup. Конвейер построения требует эту информацию, чтобы знать, какие файлы создает обратный вызов и от каких файлов зависит обратный вызов. Это необходимо для того, чтобы конвейер построения мог определить, когда этот шаг должен быть выполнен и когда его можно пропустить. Setup метод возвращает AndroidProjectFilesModifierContext. Для получения дополнительной информации см. AndroidProjectFilesModifierContext.

О том, когда Unity вызывает методы этого класса, см. Как Unity создает Android приложения.

В течение Setup метода, можно указать пути к файлам Gradle, которые нужно создать в настраиваемом модуле Gradle. В следующем примере показано, как можно указать эти пути для настраиваемого модуля mycustommodule и изменить значения в build.gradle и AndroidManifest.xml файлы.

using System.IO;
using UnityEditor.Android;
using Unity.Android.Gradle;
using Unity.Android.Gradle.Manifest;

public class ModifyProjectScript : AndroidProjectFilesModifier
{
    public override AndroidProjectFilesModifierContext Setup()
    {
        var ctx = new AndroidProjectFilesModifierContext();
        ctx.Outputs.AddBuildGradleFile("mycustommodule/build.gradle");
        ctx.Outputs.AddManifestFile("mycustommodule/src/main/AndroidManifest.xml");
        return ctx;
    }

    public override void OnModifyAndroidProjectFiles(AndroidProjectFiles projectFiles)
    {
        var customGradleFile = new ModuleBuildGradleFile();
        customGradleFile.Android.DefaultConfig.MinSdk.Set(28);
        projectFiles.SetBuildGradleFile("mycustommodule/build.gradle", customGradleFile);

        var customManifestFile = new AndroidManifestFile();
        customManifestFile.Manifest.Application.AddActivity("MyCustomActivity"); ;
        projectFiles.SetManifestFile("mycustommodule/src/main/AndroidManifest.xml", customManifestFile);
    }
}