Искать

Руководство: как стать эффективным бета-тестером

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

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

Важность бета-тестирования

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

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

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

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

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

01

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

  1. Загрузите самую последнюю сборку бета-версии непосредственно в качестве самостоятельного установочного файла или нового приложения Unity Hub. Эта страница также содержит массу информации о бета-версии и ресурсы. Вы также можете узнать о новых функциях, найти полезные документы и инструменты и оставаться в курсе последних конкурсов.
  2. Запустите установочный файл или приложение Hub. Если вы используете установочный файл, установите бета-версию в новый каталог. Можно иметь несколько версий Unity рядом, если они располагаются в разных каталогах.
  3. Начните новый проект или сделайте копию проекта, который вы планируете использовать для тестирования бета-версии, затем откройте его в самой последней бета-версии.
    • Не забудьте сделать резервную копию проекта, если вы решили запустить существующий проект в бета-версии. Обратная совместимость не гарантируется, так что после повышения версии проекта может оказаться невозможным возврат к предыдущей версии.
    • Учтите, что когда Unity открывает проект, он автоматически переносит его на версию Unity, используемую вами. Так что работа над копией проекта также экономит время, поскольку вам не нужно повторно импортировать проект, когда вы возвращаетесь к текущей стабильной версии.
  4. Ведите разработку как обычно и/или тестируйте новые функции и обновления. Если вы считаете, что обнаружили баг, следуйте шагам, описанным в частях два, три или четыре данного руководства.

02

Обращение с багами в Unity

Итак… вы нашли баг. Вот как вы можете помочь наиболее эффективно справиться с ним.

Оценка ситуации

Первичные действия

Вторичные действия

1. Оценка ситуации

Проверьте баг-трекер на наличие сообщений о найденном вами баге.

Поищите упоминание проблемы в Google и загляните в соответствующие форумные ветки.

2. Первичные действия

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

Проголосуйте а приоритет решения проблемы, перейдя в баг-трекер.

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

Сообщите о баге, подав минимальный воспроизводимый проект и отвечайте на запросы со стороны персонала Unity.

3. Вторичные действия

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

Сообщите о баге, подав минимальный воспроизводимый проект и отвечайте на запросы со стороны персонала Unity.

Уже есть форумная ветка, посвященная вашей проблеме?

Напишите в ней. Если таковой еще нет, начните новую, указав ID своей проблемы.

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

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

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

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

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

03

Документирование и сообщение о багах

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

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

Откройте инструмент сообщения об ошибках

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

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

В поле “What is the problem related to” (С чем связана проблема) выберите вариант, наиболее подходящий для обнаруженного вами бага. Поскольку это баг из бета-версии, обычно это бывает “A problem with the Editor” (Проблема с редактором) или “Crash Bug” (Баг, приводящий к сбою).

В поле “How often does it happen” (Как часто это случается) вам нужно указать, возникла ли эта проблема только однажды или она возникает иногда или всякий раз, когда вы предпринимаете шаги, приведшие к обнаружению этого бага.

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

Если ваш отчет будет подтвержден, текст из полей “Title” (Заголовок) и “Describe the problem” (Опишите проблему) будет доступен всем в баг-трекере (Issue Tracker). Это помогает сообществу. Другие пользователи смогут оставлять комментарии, голосовать (что помогает расставлять приоритеты исправлений) и видеть, когда исправление доступно. Никакая ваша личная информация опубликована не будет. Ваши проекты и другие вложения доступны только сотрудникам Unity.

Идентифицируйте баг

Как бы вы описали баг, используя самые точные термины? Пишите кратко и конкретно, наподобие этого:

Errors appear in the console after cleaning GI Cache and reloading project

Классифицируйте баг и напишите заголовок

Если вам нужно классифицировать баг, что бы вы выбрали? UI (Пользовательский интерфейс)? Asset import (Импорт ассетов)? Specific platform (Специфическая платформа)? Crash (Сбой)? В данном случае баг был связан с освещением и, конкретнее, с лайтмаппером Enlighten.

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

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

В данном случае заголовок бага выглядел бы вот так:

[Enlighten] Errors appear in the console after cleaning GI Cache and reloading project

Укажите шаги для воспроизведения бага

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

Close and reopen the project

Итак, это было непосредственно перед обнаружением бага. А что вы сделали непосредственно перед этим?

Clean the GI cache: Edit > Preferences > GI Cache > Clean Cache

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

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

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

Что вы ожидали получить вместо бага?

Expected: no errors in the console

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

Actual: errors appear in the console

Учтите, что если появилось сообщение о непредвиденной ошибки, то стоит добавить и его к описанию бага.

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

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

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

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

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

Вы можете найти дополнительную информацию об их использовании, нажав сюда.

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

Окончательный отчет должен выглядеть подобным образом:

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

Отправьте свой отчет о баге

Нажмите кнопку “Send” (Отправить), чтобы подать нам свой отчет о баге.

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

Ради удобства мы предлагаем вам следить за своими отчетами о багах и соответствующими проектами. Рекомендуем вам проделывать следующее:

  1. Всякий раз, когда вы пишите отчет о баге, создавайте .zip-файл прилагаемого к отчету проекта.
  2. Сохраните .txt-файл самого отчета и храните его в каталоге ассетов (Assets), чтобы всегда знать, какая ошибка появляется в проекте и как ее можно воспроизвести.
  3. Отправив отчет о баге и получив подтверждающее письмо с номером вашего случая, запишите этот номер в начало имени .zip-файла.

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

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

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

04

Последующее взаимодействие

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

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

Вот и всё!

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

Согласен

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