Установка и Отладка Исходного Кода

В этой статье рассматриваются основные шаги по установке и отладке исходного кода.

Шаг За Шагом

Запуск мастера 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. Подождите завершение работы Mod Wizard.

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

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

более конкретно:

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

В настоящее время, код лучше собирается под VS2005. Вы можете скачать его здесь.

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

Отладка

Настройка параметров отладки

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.

{{note:ru|Если вы используете OB код-базу, и у вас возникают проблемы с Visual Studio, посмотрите в вашем [[gameinfo.txt:ru|gameinfo.txt]. Если AppID стоит в значении 440, вам необходимо изменить "Command" и "Working Directory" для указания на директорию "team fortress 2". (так же известную, как C:\Steam\SteamApps\Username\team fortress 2\hl2.exe и C:\Steam\SteamApps\Username\team fortress 2)}}

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

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

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

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

Ссылки

Хороший шаг после выполнения этого документа, взглянуть на статью Ваша Первая Энтити, в котором вы будите вносить изменения в исходный код.

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