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. Важно: после обновления SDK вам понадобится запустить игру, которую вы модифицируете через Steam единожды перед запуском в отладчике. Если этого не сделать то вы можете получить сообщения об ошибках Steam при запуске игры через отладчик.
2. Right-click on the same project you were editing the properties for, and choose Debug->Start New Instance.
3. If you get a warning that hl2.exe has no debugging information, ignore it.
4. It should now launch Half-Life 2 and run your code. You can make modifications to the code now, rebuild, and rerun the game with your changes!

Alternative : run-time attachment

1. Start the mod using Steam
2. Inside Visual Studio, Main Menu > Debug > Attach to Process...
3. Select the hl2.exe process with the title of your mod

Совет:you can start the app in windowed mode for better comfort : add a "-window" option in your run_mod.bat

Links

A good next step after mastering this document is to look at the Your First Entity document, in which you will make changes to some of the source code.

If you plan to integrate code updates from Valve, and if you want code backups and revision history, take a look at the Using Source Control with the Source SDK document.