🔖История о магическом багеПохоже, пора вводить новую рубрику на канале, т.к. магические баги в игровых движках - не редкость.
Под магическими багами подразумевается незадокументированное неочевидное поведение движка, которое либо вообще не генерирует ошибки, либо генерирует неинформативные.
Сегодня будет история про Cocos и TypeScript.
В Cocos, у ноды (аналог GameObject) есть свойство node.active, что в Unity gameObject.activeInHierarchy. В Unity можно установить через метод gameObject.SetActive(value), а в Cocos только через node.active = value.
Так вот, решили мы добавить расширение для класса ноды, чтобы можно было node.setActive(value) пользоваться. Это хотелось сократить записи вида:
if (myNode !== null){
myNode.active = true;
}до записи вида:
myNode.setActive(true);
ну и внутри всякие проверочки. Сделали, все работает, огонь, удобно.
А спустя почти неделю билд на мобилки надо собирать. А билд на мобилках не работает. Ни андрюха, ни яблос не хочет грузить игру. Она запускается, но видна бесконечная загрузка. Ошибка есть, но говорит, что-то про Promises (аналог async в C#). Полез смотреть, где был добавлен код с асинхронщиной за последнюю неделю. Тогда я еще не знал, что проблема крылась в простом расширении. Но открылось, что подобного кода никто не добавлял в проект, а значит ошибка дает 0 полезной информации. Видимо она случается косвенно, из-за чего-то другого.
Здесь начинается квест
сдохни или умри найди поломанный коммит. Напомню, что проблема в мобильных билдах. То есть надо собрать билд, чтобы понять, есть ли ошибка или нет. В Unity попроще, билд андроид собирается прямо из редактора. А в Cocos собирается проект для Android Studio. Потом переходишь в Android Studio и запускаешь билд на андроид.Таким образом, методом двоичного поиска я сидел, собирал билды, проверял работоспособность почти весь день. Раз 25 собрал. Нашел поломанный коммит. А там ничего интересного. Обычная логика, обычное расширение, про которое я написал выше, мы такие уже делали для класса Node.
Наступила стадия кропотливого поиска проблем. Когда инвертируешь коммит и убираешь изменения по одному файлику внутри коммита. И точно также собираешь билд, ведь тебе нужно понять в каком файлике проблема! В общем, выяснилось, что в расширении проблема. Вот в этом простом расширений. Другие расширения работают, а вот это нет, ломает проект.
Мы глубоко в причины не зарывались, но думается, что расширение с возможностью включать и отключать ноду становится доступным в многопотоке, а кокос (как и юнити) на мобилках работает в монопотоке, и видимо там при каких-то проверках выпадало исключение внутри движка, а до лога добиралась какая-то левая инфа.
Так что вот, и такое в геймдеве случается. Если у вас тоже появились магические баги за последнее время, делитесь!
