Installing and Debugging the Source Code:ru

Статья разъясняет основные действия по установке и debug'у исходного кода

Шаг за шагом

Запуск Create a Mod

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

Компиляция кода

Для общих сведений о компиляции обратитесь к статье Выбор компилятора

Более конкретная информация:

• Компиляция в VS2003
• Компиляция в VS2005
• Компиляция в VS2008

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

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

Пользователям VCE2005 понадобится предварительно скачать Windows SDK (Windows 2000 users: Platform SDK). Тем, кто работает в Visual Studio и VCE2008, это не нужно.

Debugging

Настройка параметров debugging'а

 Note: Будет работать только если вы уже установили и запустили Source SDK Base.

1. В окне Solution Explorer щелкните правой кнопкой мыши на текущем проекте (строчка жирным шрифтом) и выберите Properties.
2. В появляющемся окне Property Pages зайдите в раздел Debugging (список слева).
3. Справа, в строчке сразу за Command, введите C:\Steam\SteamApps\Username\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\Username\source sdk base 2007 (это тоже пример - вы же должны ввести путь, который отвечает директории, в которую вы установили Steam на своем компьютере).
6. Нажмите кнопку OK.

Запуск в debugger'е

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

Другой вариант: attachment к запущенной игре

1. Запустите свой мод в Steam
2. В Visual Studio в главном меню нажмите Debug > Attach to Process...
3. Выберите процесс hl2.exe с названием вашего мода

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

Ссылки

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

Если вы собираетесь интегрировать обновления кода от Valve, и хотели бы иметь backup'ы кода и историю версий, ознакомьтесь со статьей Использование систем контроля версий с Source SDK.