#mopsicus: заметки с тегом git

FSM для C#

Игорь Лопатин — Thu, 05 Dec 2024 12:18:04 +0300

Доделал пакет для Shardy: реализацию машины состояний (finite state machine). Все стейты и триггеры добавляются через билдер, цепочкой.

Для перехода на стейт надо активировать триггер(ы):

fsm.Trigger(Action.Down);
fsm.Trigger(Action.Down);

В таком случае получится такой результат:

initial is standing
on exit standing
on enter sitting
on exit sitting
on enter lying

Ещё подсмотрел, как сгенерить описание для UML диаграммы и отрендерить её на сайте или на этом, по-моему у них один движок:

Чтобы сделать диаграмму более «интуитивной», вместо слова state используется ключевое слово agent, этом случае можно рисовать разные линии.

@startuml
skin rose
title TestFSM
left to right direction
agent Standing
agent Sitting
agent Lying
agent Jumping
note left of Jumping
some help message here
end note
Start --> Standing
Standing --> Sitting : Down
Standing ~~> Jumping : Space
Sitting --> Lying : Down
Sitting --> Standing : Up
Lying --> Sitting : Up
Jumping --> Standing : Down
@enduml

Ещё к каждому переходу можно добавлять условия, (на картинке выше их нет) об этом подробнее в документации.

Если у перехода между состояниями есть условие(я), то линия будет рисоваться пунктирной, а если нет триггера — то с крестиком на конце. Актуально когда состояний и переходов много, можно сгенерить диаграмму и посмотреть нет ли косяков.

Github

Как использовать Git Submodules в Unity

Игорь Лопатин — Fri, 10 Sep 2021 09:58:32 +0300

И тут сразу возникает вопрос: почему не использовать пакеты и UPM? Это удобно, да и весь механизм уже встроен в Unity?

Но как оказалось, не всегда удаётся выделить какую-то часть приложения в отдельный пакет, чтобы у него было минимум зависимостей и он представлял из себя какую-то самостоятельную единицу. Проекты бывают разные, с различной архитектурой и набором дополнительных ассетов и прочего. А выделить какую-то общую часть (ядро) хочется, чтобы использовать её в других проектах... В общем, если по какой-то причине пакеты вам не подходят — попробуйте Git Submodules.

В чём отличие при работе с сабмодулями гита?
Unity использует скрипты и ассеты которые расположены в папке Assets. Если вы попробуйте подключить сабмодуль и указать путь, например Assets/Core, то ничего не получится, потому что папка Assets уже существует. Поэтому надо провернуть такой финт:

Подключаете сабмодуль к проекту (как это сделать, тут описывать не буду, потому что есть разные клиенты SourceTree, Fork, GitKraken, просто консоль)
В качестве директории можно указать Modules/your_module
Переходите в папку Assets
Устанавливаете симлинк (symlink) на новый сабмодуль. Всё! Он у вас в проекте, можно пользоваться.

cd Assets
ln -s ../Modules/Core Core

Выглядеть это будет примерно так:

Теперь если в подключаемых сабмодулях, что-то меняется, надо просто спуллить обновления. В общем, кто привык работать с Git, то всё достаточно привычно и понятно.

200 звёзд на Github

Игорь Лопатин — Tue, 12 Jan 2021 11:27:07 +0300

Achievement unlocked!

Моё новое скромное достижение. Скрипт с data-driven прокруткой для Unity, получил 200 звёзд на Github. Спасибо S1ROZHA :)

Мне как-то писали, что используют его в MTG Arena и ещё какой-то популярной игре. Приятно что этим пользуюсь не только я.

Установка сразу на несколько Android устройств

Игорь Лопатин — Wed, 26 Feb 2020 12:22:04 +0300

При тестировании приложений часто приходится переустанавливать приложение, это очевидно. Когда я делал для себя мини CI\CD, то там уведомление с ссылкой на APK или IPA, приходило в телеграм. Это удобно, когда на девайсах уже всё настроено и есть доступ к телеге. Скачал и установил.

Но есть у меня и много девайсов на Android, которые периодически сбрасываются до заводских настроек. Каждый раз устанавливать и настраивать телеграм на каждом — как-то утомительно. Поэтому, я написал небольшой баш-скрипт который устанавливает/удаляет приложение сразу со всех подключенных андроид устройств. Было б нужное количество портов и проводов :)

Если необходимо, то эти функции можно добавить и в прошлый скрипт для CI\CD, если не нужно закачивать APK на сервер и отправлять уведомление.

Исходник на Github

TabsView для Unity

Игорь Лопатин — Wed, 19 Feb 2020 13:57:46 +0300

Сегодня у нас раздел «Велосипедостроение» :)

Если DOTween в проекте не используется, можно его выпилить и сделать вручную, чтобы не тащить библиотеку.

Когда-то давно понадобилось сделать в UI горизонтальную прокрутку табами. В iOS есть такой стандартный элемент. В Android по-моему тоже. Для Unity как известно стандартные UI компоненты довольно скудны. Поэтому каждый придумывает себе, по мере надобности. Вот и получилось когда-то такое, довольно простое решение.

Управляется свайпами
Есть индикаторы состояния табов
Анимации можно делать любые, с помощью DOTween
На переключение таба можно повесить хук

Исходники на Github

Свой CI/CD для Unity

Игорь Лопатин — Thu, 12 Dec 2019 14:44:40 +0300

Написал небольшую статью на Хабр про скрипт который получился в результате автоматизации сборки Unity проектов под Android и iOS. Раньше большинство операций делалось вручную, теперь всё сведено к минимуму.

Один запуск скрипта и:

скачиваются последние изменения с GIT
запускаются тесты
собирается APK для Android, в develop или release
собирается для iOS Xcode проект, в develop или release
компилируется
архивируется и экспортируется в IPA
генерируется манифест для него
генерируются HTML страницы для установки
всё это загружается на сервер с помощью sshpass
все логи записываются в отдельную папку
отсылается уведомление в Телеграмм, что всё готово

Вот такая интеграция и доставка :)

Исходники на Github

100 звёзд на Github

Игорь Лопатин — Mon, 08 Jul 2019 10:34:58 +0300

Скрипт с бесконечным скроллом для Unity получил 100 звёзд на Github. Вроде мелочь, а приятно :)

Кстати, если решили что-то делать в open source, но не знаете как начать, прочтите этот перевод небольшой статьи на Hexlet.

Обновление UnityMobileInput

Игорь Лопатин — Fri, 16 Nov 2018 12:53:48 +0300

Теперь высота клавиатуры считается правильно везде и экран не сдвигается вверх при появлении клавиатуры. Это на Android такая история была.

Зарефакторил много старого кода, убрал не нужное, добавил кастомный инспектор, все настройки поля теперь берутся из Unity UI компонента InputField, клавиатура не пропадает если переключаться между полями и другие мелочи.

Напомню, что в Unity есть один нюанс при работе с пользовательским вводом на андроидах — появляется дополнительное поле ввода над клавиатурой. Оно, в общем-то работает, но с ограничениями (нельзя выделять текст и другие нативные штуки) и занимает место.

Было

Стало

Вроде работает :)
UnityMobileInput

GitHub для Unity

Игорь Лопатин — Thu, 21 Jun 2018 10:37:14 +0300

Юнитеки озадачились и выпустили из беты Github for Unity. Как понятно из названия, это расширение для работы с Github. Теперь все операции можно делать прямо из редактора. Кроме того, есть ряд приятных мелочей:

большие файлы загружаются в отдельное хранилище LFS (Large Files Storage)
отображение различий в файлах с использованием различных предустановок
строка с быстрыми действиями в Git
уведомления с обновлениями

Исходный код расширения доступен на Github (где же ещё :).

Armory3D

Игорь Лопатин — Wed, 13 Jun 2018 22:20:39 +0300

Это игровой движок для Blender. Все модели, материалы, свет и прочее, идут из 3D редактора — полная интеграция.

Достаточно интересный инструмент. Он ещё в разработке, но уже много что сделано:

не нужно ничего никуда экспортировать/импортировать — всё уже в блендере
неплохая система рендера
физика
звуки
сеть
глобальное освещение на вокселях
поддержка нод: шейдеры, логика и т. п.

В основе всего этого, кроссплатфоменные Haxe и Kha

Естественно, в 2018 году, можно (и нужно) билдить под все основные платформы:

Android, iOS
Windows, Linux, Mac
PS4, Xbox One, Switch
HTML5
Ещё куча

Больше видео на канале в Youtube.
Начиная с последней версии, движок стал бесплатным! Все исходники лежат на Github.

Unity Mobile Input

Игорь Лопатин — Tue, 10 Apr 2018 11:31:43 +0300

Выложил на Github плагин нативного ввода для мобильных устройств. Это небольшая надстройка над стандартным Unity InputField UI. Работает на iOS и Android.

Зачем он нужен:

Нативное поле ввода и клавиатура
Отсутствует раздражающее дополнительное поле над клавиатурой в Android
Для iOS можно добавить кнопку «Готово»
Настройка кнопки Return для клавиатуры: стандартная, далее, готово, поиск
Для работы нужно просто повестить скрипт MobileInput на родной InputField UI

До этого, было временное решение, которое не обладало необходимыми опциями, да и ошибки были. Собственно, на то оно и временное :) Но в Unity до сих пор нет таких возможностей для ввода, поэтому пришлось сделать такой плагин.

В моей версии исправлены ошибки и отрефакторен почти весь код от старого и неподдерживаемого плагина UnityNativeEdit.

Исходники на Github

Unity blur effect и 2 камеры

Игорь Лопатин — Mon, 29 Jan 2018 10:26:23 +0300

В этом примере, я собрал сразу два интересных момента:

как сделать размытый фон
как использовать сразу 2 камеры

Для чего это может понадобиться? Например, чтобы одна камера была для игры, с настроенными пост эффектами, другая для интерфейса. Или чтобы сделать вот такой эффект размытия. В общем-то, можно и 3 камеры использовать. Зависит от потребностей и фантазии...

Фокус в том, чтобы настроить камеру на рендер только нужного слоя.
Как было сделано в этом примере:

Объекты или контейнер которые должны быть размыты, находятся в слое Blur
Blur camera рендерит только слой Blur (Culling Mask)
Для Main camera этот слой отключён, стоит флаг Depth only и глубина больше, чем у Blur camera
Ну и на Blur camera висит собственно скрипт размытия

По такому же принципу можно одновременно и 3 камеры сделать. Если потребуется.

Исходник на Github

Отправка письма из Unity

Игорь Лопатин — Thu, 07 Sep 2017 16:51:54 +0300

Ничего особенного конечно, ничем не отличается от самого обычного плагина для iOS или Android, но кто-то у меня спрашивал про это.
Весь код умещается на одном экране, дольше демку делал :)

Исходники на Github

Вообще, надо бы собрать все плагины, мелочуху и выложить на гитхаб: синхронизация с iCloud, in-app покупки (не доверяю я Unity IAP :), буфер обмена, получение изображения с камеры и галереи, сохранение в галерею, push уведомления, запись в keychain, авторизация через Google Sign-in, встроенный браузер и прочее.
Если что-то заинтересовало — пишите в комменты или mail@mopsicus.ru.

Работа в фоне в iOS и Unity

Игорь Лопатин — Tue, 25 Jul 2017 10:22:15 +0300

Маленький плагин который позволяет поработать приложению в свернутом виде на iOS, некоторое время. Зачем это нужно? Например, чтобы дождаться команды с сервера и показать пользователю уведомление, что пришло время его хода.
Весь плагин состоит из двух функций, которые запускают и останавливают задачу при потере фокуса.

-(void) startTask {
    [self endTask];
    if (bgTask == UIBackgroundTaskInvalid) {
        bgTask = [[UIApplication sharedApplication] beginBackgroundTaskWithExpirationHandler:^{
            [[UIApplication sharedApplication] endBackgroundTask:bgTask];
            bgTask = UIBackgroundTaskInvalid;
        }];
    }
}

- (void) endTask {
    if (bgTask != UIBackgroundTaskInvalid) {
        [[UIApplication sharedApplication] endBackgroundTask:bgTask];
        bgTask = UIBackgroundTaskInvalid;
    }
    [UIApplication sharedApplication].idleTimerDisabled = NO;
}

А в Unity это вызывается на OnApplicationFocus:

void OnApplicationFocus (bool focusStatus) {								
    if (focusStatus) 
        Background.StopTask();
    else 
        Background.StartTask();
}

Ссылка на Github

Unity, iOS и IPv6

Игорь Лопатин — Tue, 30 May 2017 10:32:29 +0300

С 1 июня 2016 года, все отсылаемые приложения в AppStore должны уметь работать по IPv6.

Unity вроде как решили все эти вопросы еще в прошлом году. Но если погуглить, то оказывается, что некоторые получают отказы до сих пор, по тем или иным причинам связанным с IPv6. Чтобы проверить работает ли ваше приложение в сетях IPv6, Apple написали специальную статью с мануалом. Я ей воспользовался и обнаружил, что приложение не коннектится к серверу :(

Для соединения используются сокеты, поэтому код был очень простой:

...
private Socket _socket;
 
public static void Connect () {
    _socket = new Socket(AddressFamily.InterNetwork, SocketType.Stream, ProtocolType.Tcp);
    _socket.BeginConnect("134.253.17.11", 10001, new AsyncCallback(OnEndConnect), null);
}
 
void OnEndConnect (IAsyncResult iar) {
    Debug.Log ("connected");
}
...

Собственно, сразу стало понятно в чем проблема — AddressFamily должен быть InterNetworkV6 если работаем по IPv6 или InterNetwork для IPv4.

Если подключаться к серверу по домену, то можно воспользоваться таким решением — передаем хост, указываем тип, в ответ получает IPv6 или «обычный» IP адрес.

Если же подключение осуществляется по IP адресу, то преобразование с помощью различных конвертеров в IPv6 (раз, два), не дало работающего результата — сокет просто не подключался.

Ответ был найден в том самом мануале от Apple (смотрим на подраздел Use System APIs to Synthesize IPv6 Addresses) и на одном китайском сайте :) Если все это объединить, то получится более-менее универсальное решение которое будет работать и по IPv6, и по IPv4, в iOS и Android.

Исходник на Github

SSL/TLS в Unity

Игорь Лопатин — Mon, 13 Mar 2017 14:20:55 +0300

А сегодня мы будем шифровать весь трафик. А зачем? А чтобы усложнить жизнь читерам.

Если у вас мультиплеер на авторитарном сервере, естественно все действия должны контролироваться на нем. Но зная, какие команды отправлять, можно легко написать бота, который автоматизирует некоторые процессы, нарушая баланс и игру «правильных» игроков. Конечно, если сильно захотеть, можно сломать все что угодно, но усложнить жизнь взломщикам и читерам тоже можно. Будем использовать SSL.

Ничего изобретать не буду, потому что «все уже придумано до нас» :)
Для теста серверной части (на node.js) и генерации ключей используем эти скрипты. Единственное, чего там нет — это как из сертификата и ключа сделать PFX файл:

openssl pkcs12 -export -in client.crt -inkey client.key -out mycert.pfx

Этот файл понадобится для клиента. Для проверки SSL соединения берем пример с сокетами с MSDN и немного переделываем его. Получаем поток и прокидываем его через SSL.

IEnumerator UseSSL () {
	NetworkStream stream = new NetworkStream (socket);
	SslStream sslStream = new SslStream (stream, false, new RemoteCertificateValidationCallback (CertificateValidationCallback), new LocalCertificateSelectionCallback (CertificateSelectionCallback));
	bool authenticationPassed = true;		
	#if UNITY_EDITOR
		X509Certificate2 cert = new X509Certificate2(certPath, certPassword);
	#elif UNITY_ANDROID || UNITY_IOS
		WWW reader = new WWW (certPath);
		while (!reader.isDone) 
			yield return null;
		X509Certificate2 cert = new X509Certificate2 (reader.bytes, certPassword);
	#endif
	X509Certificate2Collection certs = new X509Certificate2Collection();
	certs.Add (cert);
	sslStream.AuthenticateAsClient (server, certs, SslProtocols.Tls, true);
	authenticationPassed = sslStream.IsAuthenticated;
	if (authenticationPassed) {
              ///
	}
	yield break;
}

Вот и весь квест. Теперь трафик между игровым сервером и клиентом зашифрован.

Ccылка на Github

Добавление Google Play Services в Unity проект

Игорь Лопатин — Mon, 30 Jan 2017 11:18:03 +0300

Прошло время ручного копирования JAR файлов и ресурсов в папку с проектом. Все плагины для Android теперь надо компилить в AAR модули. Кроме того, если в плагине реализуются какие-то функции для работы с Google сервисами, например, пуш-уведомления, сохранение в облако, или авторизация, то нужно подключать к модулю зависимости.

Раньше (до 5 версии Unity, по-моему), в папку с проектом добавляли JAR файл со всеми Google сервисами, размером 5-6 мб, что конечно «не очень» оптимально. Теперь все сервисы разделены на отдельные AAR модули, которые хранятся в папке с SDK.

Google сделал специальное расширение для Unity, которое само подгружает нужные модули и зависимости в проект. Достаточно указать, что вы собираетесь использовать. Это очень удобно.

Google.VersionHandler.InvokeInstanceMethod(
      svcSupport, "DependOn",
      new object[] {
      "com.google.android.gms",
      "play-services-games",
      "10.0.1" },
      namedArgs: new Dictionary<string, object>() {
          {"packageIds", new string[] { "extra-google-m2repository" } }
      });

https://github.com/googlesamples/unity-jar-resolver

Утилиты от Leopotam

Игорь Лопатин — Fri, 02 Dec 2016 11:23:25 +0300

Набор хороших утилит для Unity, от Leopotam. Тут и оптимизация, и анимации, и хелперы для редактора, и еще куча всего. В общем, есть что посмотреть на выходных.

https://github.com/Leopotam/LeopotamGroupLibraryUnity

Поиск по Unity репозиториям

Игорь Лопатин — Tue, 09 Aug 2016 10:45:10 +0300

Отличный сайт, позволяет искать в Unity репозиториях Github. Разбивка по категориям, новинки, фильтры, понятное визуальное представление. Рекомендую.

http://unitylist.com

Unity и Git

Игорь Лопатин — Mon, 21 Mar 2016 00:41:05 +0300

Как настроить Unity для работы с Git? Как настроить Git, чтобы в репозиторий не попадали ненужные файлы?

Из всех файлов и папок в Unity проекте, нас интересует всего две папки: Assets и ProjectSettings. В первой папке хранятся все скрипты, спрайты, анимации и прочее. Во второй — настройки проекта. Все остальные файлы можно исключить из репозитория, их сгенерирует Unity, MonoDevelop или VisualStudio.

Добавим исключения в файл .gitignore

/[Ll]ibrary/
/[Tt]emp/
/[Oo]bj/
/[Bb]uild/
/[Bb]uilds/
/Assets/AssetStoreTools*

# Autogenerated VS/MD solution and project files
ExportedObj/
*.csproj
*.unityproj
*.sln
*.suo
*.tmp
*.user
*.userprefs
*.pidb
*.booproj
*.svd

# Unity3D generated meta files
*.pidb.meta

# Unity3D Generated File On Crash Reports
sysinfo.txt

# Builds
*.apk
*.unitypackage

# OS generated
.DS_Store
.DS_Store?
._*
.Spotlight-V100
.Trashes
ehthumbs.db
Thumbs.db

Кстати, на GitHub есть коллекция полезных .gitignore файлов, вроде, постоянно обновляется и пополняется.

Осталось настроить Unity:

Устанавливаем Hidden Meta Files:
Editor → Project Settings → Editor → Version Control → Mode
Устанавливаем Force Text:
Editor → Project Settings → Editor → Asset Serialization → Mode
Сохраняем проект

Теперь можно запушить свой Unity проект. Также, можно поставить расширение Git LFS, оно позволяет работать с большими файлам, даже по несколько гигабайт.

#mopsicus: заметки с тегом git

FSM для C#

Finite state machine

Finite state machine

FSM UML diagram

FSM UML diagram

Как использовать Git Submodules в Unity

Unity Git submodules

Unity Git submodules

200 звёзд на Github

Infinite scroll unity 200 stars

Infinite scroll unity 200 stars

Установка сразу на несколько Android устройств

Console APK install tool

Console APK install tool

TabsView для Unity

Свой CI/CD для Unity

Mopsicus CI/CD bash script

Mopsicus CI/CD bash script

100 звёзд на Github

Обновление UnityMobileInput

GitHub для Unity

Armory3D

Unity Mobile Input

Unity blur effect и 2 камеры

Отправка письма из Unity

Работа в фоне в iOS и Unity

Unity, iOS и IPv6

SSL/TLS в Unity

Добавление Google Play Services в Unity проект

Утилиты от Leopotam

Поиск по Unity репозиториям

Unity и Git