Исходные плагины Java и Kotlin

Unity может интерпретировать отдельные исходные файлы Java и Kotlin как отдельные плагины.

Unity поддерживает код Java и Kotlin, написанный в исходных файлах с расширениями .java и .kt. Для этого Unity интерпретирует каждый исходный файл как отдельный плагин и компилирует его при сборке Проигрывателя. Этот тип плагина полезен, если вам нужно написать небольшое количество кода для одного проекта. Если вы планируете повторно использовать код в нескольких проектах или распространять его среди других людей, то плагин Android Library или Android Archive может быть более подходящим.

Создание исходного плагина Java или Kotlin

Чтобы указать Unity создать плагин из исходного файла Java (.java) или Kotlin (.kt), выполните следующие действия:

1. В течение Активы папку, поместите свой Java (.javaили Kotlin (.kt) исходный файл.
   Тип: Рекомендуется создать подпапку, содержащую исходные файлы Java и Kotlin.
2. Выберите исходный файл и просмотрите его в окне Inspector.
3. В окне Inspector в разделе Выберите платформы для плагина включите Android.
4. Выберите Применить.

Примечание: Вы можете поместить исходные файлы в любую папку в вашем проекте, за исключением специальных папок, таких как StreamingAssets. Если вы поместите файлы в эти папки, Unity Editor не отобразит Плагин Inspector.

Пример: Создание и использование исходного плагина Kotlin

В следующем примере показано, как создать исходный плагин Kotlin и получить доступ к его коду из скрипта C#. Это позволяет использовать функциональные возможности Android в вашем проекте Unity.

1. В папке Ассеты вашего проекта создайте подпапку с именем AndroidPluginsи добавьте в неё файл Kotlin (.kt) со следующим кодом.

     object KotlinStringHelper {
     @JvmStatic
     fun getString(): String {
        return "Hello from Kotlin"
     }
     }
   

2. Выберите файл Kotlin. В окне Inspector в разделе Выберите платформы для плагина включите платформу Android.

3. Выберите Применить.

4. В Unity создайте скрипт C# и добавьте следующий код. Этот код использует AndroidJavaClass чтобы обратиться к статическому методу Kotlin getString.

   
     using UnityEngine;
   
     public class KotlinExamples : MonoBehaviour
     {
        void Start()
        {
           using (AndroidJavaClass cls = new AndroidJavaClass("KotlinStringHelper"))
           {
              string value = cls.CallStatic<string>("getString");
              Debug.Log($"KotlinStringHelper.getString returns {value}");
           }
        }
     }
   

5. Присоедините Скрипт C# к GameObject. Более подробную информацию см. в документации по Управление GameObject.

Редактирование файлов Java или Kotlin в экспортированном проекте Android Studio

По умолчанию, когда вы экспортируете проект Unity для Android, Unity копирует любые файлы Java/Kotlin в проект Android Studio. Если вы редактируете эти файлы в Android Studio, изменения не отражаются в исходных файлах проекта Unity. Если вы снова экспортируете проект Unity, процесс экспорта перезапишет ваши изменения в Android Studio.

Чтобы решить эту проблему, Unity обеспечивает Источники символических ссылок настройка сборки. Если вы выберете этот параметр сборки, Unity создает символическая ссылка в 2000 году Android Студия проекта в Java/Kotlin файлы в Unity проекта, а не копирует файлы на него. Это означает, что если вы редактируете файлы Android Студия, изменения будут отражены в оригинале Unity файлы проекта.

Дополнительные ресурсы

• Android типы подключения
• Вызов Java и Kotlin плагин код из C# сценариев