Installing and Debugging the Source Code:ru

From Valve Developer Community
Revision as of 18:34, 18 June 2009 by JeffLane (talk | contribs) (f)
Jump to: navigation, search

В этой статье рассказывается об основах установки и отладки исходного кода.

Шаг за шагом

Запуск мастера Create a Mod

  1. Запустите Source SDK через Steam и щелкните на пункте Create a Mod.
  2. Здесь вы можете выбрать любой пункт для модификации, но для нужд этой статьи выберите пункт Modify Half-Life 2 Single Player и нажмите Next.
  3. В следующем диалоговом окне, в верхнем поле ввода, введите название директории, в которой вы хотите хранить файлы модификации. В данной статье предполагается что вы ввели C:\MyMod.
  4. В нижнем поле ввода введите имя вашей модификации. Директория с таким именем будет создана в каталоге SteamInstallPath\SteamApps\SourceMods. В данной статье предполагается что вы ввели имя MyMod.
  5. Нажмите кнопку Next и исходный код будет установлен на ваш жесткий диск.
  6. Подождите пока мастер создания модификаций закончит свою работу.

Компиляция исходного кода

Общая информация о компиляции исходного кода находится здесь : Выбор компилятора.

Более детальная информация находится здесь:

Note.png Note: По умолчанию включена компиляция в режиме отладки. Чтобы запустить модификацию с отладочным dll-файлом вам необходимо щелкнуть правой кнопкой мыши на вашей модификации в списке игр Steam, затем щелкнуть Properties, потом Set Launch Options... и добавить -allowdebug в конец списка любых параметров, которые могут там находится (параметры разделяются пробелами). Вы можете переключится на release-версию (для распространения модификации) в менеджере конфигураций.

В настоящее время код лучше всего компилируется под VS2005. Вы можете скачать его по ссылке: http://www.microsoft.com/express/2005/

Пользователи VCE2005 должны загрузить Windows SDK (Пользователям Windows 2000: Platform SDK). Пользователям Visual Studio и VCE2008 этого делать не нужно.

Отладка

Установка параметров отладки

Note.png Note: Данный пример будет работать только если вы установили, и хотя бы один раз запустили Source SDK Base.
  1. В окне Solution Explorer (Обозреватель решений) щелкните правой кнопкой на запускаемом проекте (он отмечен жирным шрифтом) и выберите Properties (Свойства).
  2. Слева в открывшемся окне выберите пункт Debugging (Отладка).
  3. Справа в текстовом окне Command (Команда) введите C:\Steam\SteamApps\Имя_пользователя\source sdk base 2007\hl2.exe (измените путь в соответствие с вашим путем установки Steam).
  4. Далее в поле Command Arguments (Командные аргументы) введите -dev -sw -game "C:\Steam\SteamApps\SourceMods\MyMod" (где MyMod это имя вашей модификации, которое вы указывали в диалоговом окне Create a Mod мастера создания модификаций).
  5. Далее в Working Directory (Рабочий каталог) введите C:\Steam\SteamApps\Имя_пользователя\source sdk base 2007 (измените путь в соответствие с вашим путем установки Steam).
  6. Нажмите кнопку OK.
Note.png Note: Если вы используете Orange Box code-base и у вас проблемы с отладкой напрямую из Visual Studio, то просмотрите файл gameinfo.txt вашего мода. Если значение AppID равно 440, вам необходимо поменять пути в параметрах "Command (Команда)" и "Working Directory (Рабочий каталог)" так, чтобы они указывали на рабочий каталог "team fortress 2" (т.е. C:\Steam\SteamApps\Имя_пользователя\team fortress 2\hl2.exe и C:\Steam\SteamApps\Имя_пользователя\team fortress 2)
Note.png Note: Если ваши пути содержат пробелы, то разумно поместить их в кавычки. Например, "C:\Steam\SteamApps\Имя_пользователя\team fortress 2\hl2.exe" и т.д. С ними всё должно работать как надо, однако, если у вас есть проблемы с отладкой, придется попробовать что-нибудь другое.

Запуск в отладчике

  1. Важно: после обновления Source SDK необходимо один раз запустить игру, которую вы модифицируете через Steam . Если этого не сделать то возможно вы получите сообщения об ошибках Steam при запуске игры через отладчик.
  2. Щелкните правой кнопкой по тому проекту, свойства которого вы изменяли, и выберите Debug->Start New Instance (Отладка->Запустить новый экземпляр).
  3. Если вы получаете предупреждение о том, что hl2.exe не имеет отладочной информации, игнорируйте его.
  4. Теперь при отладке должна запускаться Half-life 2 с вашим исходным кодом. Вы можете вносить модификации в код, перекомпилировать его, и перезапускать игру с внесенными изменениями!

Альтернативный способ: интеграция во время выполнения

  1. Запустите вашу модификацию через Steam.
  2. В Visual Studio выберите Main Menu > Debug > Attach to Process... (Главное меню > Отладка > Присоединиться к процессу...).
  3. Выберите процесс hl2.exe с заголовком вашей модификации.
Tip.png Tip: Вы можете запускать приложение в оконном режиме для большего комфорта: для этого добавьте параметр "-window" в ваш файл run_mod.bat

Ссылки

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

Если вы планируете интегрировать обновления исходного кода от Valve, и если вы хотите иметь поддержку отката исходного кода и учета его изменений, взгляните на статью Using Source Control with the Source SDK.

Template:Otherlang:en Template:Otherlang:en:jp Template:Otherlang:en:es Template:Otherlang:en:fr