Ru/Installing and Debugging the Source Code

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

Шаг за шагом

Запуск мастера 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. Подождите пока мастер создания модификаций закончит свою работу.

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

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

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

• Compiling under VS2003
• Compiling under VS2005
• Компиляция под VS2008

Примечание:По умолчанию включена компиляция в режиме отладки. Чтобы запустить модификацию с отладочным 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 этого делать не нужно.

Отладка

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

Примечание:Данный пример будет работать только если вы установили, и хотя бы один раз запустили 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.

Примечание:Если вы используете 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)

Примечание:Если ваши пути содержат пробелы, то разумно поместить их в кавычки. Например, "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 с заголовком вашей модификации.

Совет:Вы можете запускать приложение в оконном режиме для большего комфорта: для этого добавьте параметр "-window" в ваш файл run_mod.bat

Ссылки

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

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