Hero background image

Руководство по эффективному бета-тестированию

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

Добро пожаловать!

Почему бета-тестирование важно

Наши сотрудники отдела контроля качества усердно работают над тем, чтобы наши релизы были стабильными, но мы никак не могли бы сделать это без членов нашего сообщества разработчиков, предоставляющих отзывы о предстоящих сборках. Мы очень рады, что вы хотите помочь!

Чтобы помочь вам помочь нам (помочь вам), мы создали это руководство, чтобы стать лучшим бета-тестером, каким вы только можете быть - как загрузить свой проект, как написать отчет об ошибке и многое другое. Следуя этим шагам, вы сможете предоставить нам самую важную информацию, чтобы мы могли устранить проблемы, которые влияют на вас и развитие ваших проектов.

Ваши отзывы о бета-версии бесценны. Мы анализируем каждое сообщение об ошибке бета-версии с оценкой 4 и 5 и делаем все возможное, чтобы рассмотреть те, которые имеют более низкую оценку (если вы не знаете, что это значит, посмотрите этот пост в блоге). Когда мы подтвердим наличие ошибки и найдем ее исправление, мы включим ее в ближайший бета-релиз. В настоящее время мы не можем предоставить подробную информацию о том, какие именно исправления появятся в бета-версии, но знайте, что это произойдет как можно скорее!

Ниже вы найдете подробную информацию о рабочем процессе отправки важных сообщений об ошибках и отзывов. Здесь же вы найдете краткое описание самых важных шагов.

Если у вас есть дополнительные вопросы о бета-версии, посетите форум бета-версии.

СОДЕРЖАНИЕ

01 Установка и начало работы

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

Запустите программу установки или концентратор. Если вы используете программу установки, не забудьте установить бета-версию в новый каталог. Можно иметь несколько версий Unity рядом друг с другом, если они расположены в отдельных каталогах.

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

Обязательно создайте резервную копию, если решите запустить существующий проект в бета-версии. Обратная совместимость не гарантируется, поэтому после обновления проекта может оказаться невозможным вернуть его к предыдущей версии. Обратите внимание, что когда Unity открывает проект, он автоматически переносится в ту версию Unity, которую вы используете. Работа с копией проекта также экономит ваше время, поскольку вам не придется заново импортировать проект при возвращении к текущей стабильной версии.

Разрабатывайте, как обычно, и/или тестируйте новые функции и обновления. Если вы считаете, что нашли ошибку, выполните следующие шаги, описанные во второй, третьей и четвертой частях этого руководства.

02 Работа с ошибками в Unity

Итак... вы нашли ошибку. Так вы сможете оказать наиболее эффективную помощь.

Оцените ситуацию Первичные действия Вторичные действия Проверьте трекер проблем на наличие существующих сообщений об ошибках.

Задайте этот вопрос в Google и найдите соответствующие темы на форуме.

Это известная нерешенная проблема?

Проголосуйте за соответствующую запись на трекере проблем.

Это неизвестная проблема?

Отправьте отчет об ошибке с минимальным воспроизведением проекта и ответьте на запросы персонала Unity.

О проблеме уже сообщалось, но вы хотите убедиться, что ваш случай будет исправлен?

Отправьте отчет об ошибке с минимальным воспроизведением проекта и ответьте на запросы персонала Unity.

Существует ли на форуме тема, посвященная этому вопросу?

Ответить Если нет, заведите одну, ссылающуюся на ваш идентификатор выпуска.

Если вы столкнулись с проблемой в Unity, первым делом выясните, является ли она известной или вы первый, кто с ней столкнулся. Первый адрес, по которому можно получить такую информацию, - наш публичный Issue Tracker. Она позволяет искать ошибки, о которых сообщили другие пользователи, и голосовать или комментировать их. Голосование по вопросам помогает нашей команде определить приоритеты, над какими ошибками нужно работать в первую очередь.

Форум бета-версии Unity - еще один замечательный ресурс сообщества. Вы можете посмотреть, что сообщили другие люди, найти обходные пути решения проблем или предоставить информацию самостоятельно. Это также хороший способ связаться с кем-нибудь из сотрудников Unity. Просто убедитесь, что поднимаемые вами темы относятся к текущей бете, и не объединяйте несколько разных вопросов в одной теме.

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

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

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

03 Документирование и сообщение об ошибке

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

Не бойтесь совершать ошибки. Если мы не сможем воспроизвести проблему с информацией, представленной в вашем отчете, мы свяжемся с вами, чтобы выяснить, не упущено ли что-то.

Откройте отчет об ошибках

Запустив Unity, перейдите в меню Help → Report a Bug. Кроме того, вы можете найти инструмент сообщения об ошибках, который установлен рядом с редактором, в папке приложений. Он также автоматически запустится, если произойдет сбой.

Предоставьте основную информацию

В поле "С чем связана проблема" выберите вариант, который лучше всего соответствует ошибке, о которой вы сообщаете. Поскольку вы сообщаете об ошибке в бета-версии, обычно это будет "Проблема с редактором" или "Краш-баг".

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

Укажите свой адрес электронной почты на случай, если нашей команде понадобится связаться с вами для получения дополнительной информации. Если вы вошли в систему под своей учетной записью Unity, это поле будет заполнено автоматически.

Если ваш отчет будет проверен, текст, написанный в полях "Название" и "Опишите проблему", станет доступен в открытом доступе в Issue Tracker. Это помогает обществу. Другие пользователи смогут оставлять комментарии, голосовать (что поможет определить приоритет исправлений) и узнавать, когда исправление будет доступно. Ни одна из ваших личных данных не будет опубликована. Ваши проекты и другие вложения доступны только сотрудникам Unity.

Определите ошибку

Как бы вы описали жука в самых кратких выражениях? Будьте краткими и конкретными, например:

Ошибки появляются в консоли после очистки GI Cache и перезагрузки проекта

Определите категорию ошибки и напишите ее название

Если бы вам нужно было классифицировать жука, что бы вы выбрали? ПОЛЬЗОВАТЕЛЬСКИЙ ИНТЕРФЕЙС Импорт активов? Скрипты Конкретная платформа? Авария? В данном случае ошибка была связана с освещением, а точнее с лайтмаппером Enlighten.

Теперь добавьте это и описание ошибки, чтобы создать заголовок в следующем формате:

Описание [Категория]

В этом сценарии название вашей ошибки будет выглядеть следующим образом:

[Enlighten] Ошибки появляются в консоли после очистки GI Cache и перезагрузки проекта

Предоставьте шаги для воспроизведения

Командам специалистов по контролю качества и разработке Unity нужна любая помощь, которую вы можете предложить для диагностики и устранения проблем. В зависимости от полученной информации они могут не выявить основную проблему, или же их могут ввести в заблуждение и исправить что-то другое, не относящееся к вашей ошибке. Поэтому в ваших интересах предоставить как можно больше информации, чтобы убедиться, что ваша проблема будет окончательно решена. Самый простой способ сделать это - проследить все шаги, которые вы предприняли до появления ошибки. Итак, что вы сделали первым делом, прежде чем увидели жука?

Закройте и снова откройте проект

Итак, это последний шаг в "Шагах к воспроизведению". Что вы делали прямо перед этим?

Очистите кэш GI: Редактировать > Параметры > GI Cache > Очистить кэш

Продолжайте делать это как можно дольше, в идеале до того момента, когда вы впервые открыли Unity. Чем больше информации вы сможете предоставить, тем проще будет воспроизвести и устранить проблему. Если вы не можете вспомнить все, попробуйте воспроизвести ошибку и обратите внимание на то, какие действия вы выполняете.

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

Сопоставьте ожидаемые и фактические результаты

Что, по вашему мнению, должно было произойти до того, как вы столкнулись с ошибкой?

Ожидается: отсутствие ошибок в консоли

Что произошло вместо этого?

Фактически: в консоли появляются ошибки

Обратите внимание, что если вы столкнулись с неожиданными сообщениями об ошибках, их также полезно добавить в описание.

После заполнения всей этой информации ваш отчет должен выглядеть следующим образом:

Прикрепите папку с проектом

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

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

На ​помощь ​вы ​уменьшить ​сайт ​размер ​из ​Ваш ​проекты ​и ​на ​создать ​минимальный ​проекты по воспроизводству, ​мы ​разработано ​несколько ​инструменты ​что ​очень ​уменьшить ​сайт ​требуется ​усилия.

Вы ​можно ​найти ​дополнительно ​информация ​на ​как ​на ​используйте ​эти ​инструменты здесь.

Идеальным вариантом будет самый маленький проект, воссоздающий проблему, но большие проекты - это лучше, чем ничего, поэтому, пожалуйста, выкладывайте весь проект, если вы не можете его сузить. Наш сайт ​отчетность ​система ​поддерживает ​огромный ​вложения Пожалуйста, ​сделать ​не ​загрузить ​индивидуально ​активы ​потому что ​сайт ​проект ​содержит ​соответствующий ​данные и ​файлы ​что ​сайт ​активы ​в одиночку ​сделать ​Нет

Итоговый отчет должен выглядеть следующим образом:

Идеально Вы составили информативный и лаконичный отчет об ошибке, который наша команда сможет использовать для поиска и устранения проблемы. Остался последний шаг:

Отправьте сообщение об ошибке

Нажмите "Отправить", чтобы отправить сообщение об ошибке.

Когда ваша ошибка будет подана, вам будет отправлено письмо с подтверждением, содержащее номер дела, который вам нужно будет сохранить. В письме будет ссылка на веб-страницу с текущим статусом ошибки. Вы можете в любое время заглянуть на эту страницу, чтобы узнать о новых новостях. Не публикуйте эту ссылку на форуме или в других публичных местах, так как она раскрывает ваш контактный адрес и историю сообщений об ошибках. Номер дела достаточен для того, чтобы другие могли найти проблему в Issue Tracker.

Для вашего личного удобства мы предлагаем вам отслеживать сообщения об ошибках и связанные с ними папки проекта. Мы рекомендуем следующий подход:

Каждый раз, когда вы отправляете отчет об ошибке, создавайте .zip-файл с прикрепленным проектом.

Сохраните .txt файл самого сообщения об ошибке и храните его в директории Assets, чтобы знать, какую ошибку выдает проект и как ее воспроизвести.

После отправки сообщения об ошибке возьмите номер дела, указанный в письме с подтверждением, и прикрепите к нему свой .zip-файл.

Таким образом, вы сможете быстро найти проект, который вы прикрепили к отчету, как только Unity отправит вам письмо с уведомлением о том, что отчет об ошибке был закрыт.

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

Хотя это и требует от вас некоторой работы, это означает, что а) вы с большей вероятностью получите качественный отчет об ошибке, а значит, ваша ошибка с большей вероятностью будет воспроизведена и исправлена, и б) вы сможете легко убедиться, что ошибка была исправлена в будущей бета-версии.

04 Последующие действия

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

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

И все.

Спасибо, что нашли время, чтобы узнать, как стать эффективным бета-тестером. Если у вас есть вопросы по любому из вышеперечисленных пунктов, а выбранная вами поисковая система не дает ответов, пожалуйста, загляните на форумы и спросите.