Installing and Debugging the Source Code
< Ru
В этой статье рассматриваются основные шаги по установке и отладке исходного кода.
Contents
Шаг За Шагом
Запуск мастера Create a Mod
- Запустите Source SDK через Steam и выберите пункт Create a Mod.
- Обычно вы можете выбрать любой тип мода, но в целях данного руководства, выберите вариант Modify Half-Life 2 Single Player и нажмите Next.
- В верхнем поле следующего диалога, введите директорию, куда вы хотите распаковать мод. Это руководство предполагает, что введено C:\MyMod.
- В нижнем поле, введите любое название вашего мода. Это станет подкаталогом в вашей SteamInstallPath\SteamApps\SourceMods директории. В этом примере предполагается, что вы ввели MyMod.
- Нажмите на кнопку Next и исходный код будет распакован на ваш жёсткий диск.
- Подождите завершение работы Mod Wizard.
Компиляция Исходного Кода
Общая информация о компиляции находится здесь: Выбор Компилятора
более конкретно:
![Note.png](/w/images/thumb/c/cc/Note.png/10px-Note.png)
В настоящее время, код лучше собирается под VS2005. Хотя Visual Studio 2010 это лучший выбор для Source.
VCE2005 пользователям необходимо скачать Windows SDK (Windows 2000 пользователи: Platform SDK). Для Visual Studio и VCE2008 этого не требуется.
Отладка
Настройка параметров отладки
![Note.png](/w/images/thumb/c/cc/Note.png/10px-Note.png)
- В окне Solution Explorer, правый клик на текущем проекте (он отмечен жирным) и выберите Properties.
- В появившимся диалоге Property Pages, с левой стороны выберите пункт Debugging.
- По правую сторону, в текстовом поле Command, введите
C:\Steam\SteamApps\Username\source sdk base 2007\hl2.exe
(корректировка пути, к вашему собственному Steam). - Далее, в Command Arguments, введите
-dev -sw -game "C:\Steam\SteamApps\SourceMods\MyMod"
(где MyMod это название вашего мода, введённое в диалоге Create a Mod). - Далее, в Working Directory, введите
C:\Steam\SteamApps\Username\source sdk base 2007
(корректировка пути, к вашему собственному Steam). - Нажмите на кнопку OK.
![Note.png](/w/images/thumb/c/cc/Note.png/10px-Note.png)
C:\Steam\SteamApps\Username\team fortress 2\hl2.exe
и C:\Steam\SteamApps\Username\team fortress 2
)![Note.png](/w/images/thumb/c/cc/Note.png/10px-Note.png)
"C:\Steam\SteamApps\Username\team fortress 2\hl2.exe"
и т.п. Всё может работать и без них, но так же, это один из источников возникающих проблем.![Note.png](/w/images/thumb/c/cc/Note.png/10px-Note.png)
fatal error LNK1169: one or more multiply defined symbols found
или error LNK2005: __malloc_dbg already defined in memoverride.obj
, это может быть исправлено добавлением "/FORCE:MULTIPLE" (без кавычек) в свойства проекта/configuration properties/linker/command line/additional options. Это будет работать более хорошо, если вы добавите это в server и client проекты.Запуск в отладчике
- Важно: в случае обновления SDK, перед запуском в отладчике, вы должны один раз запустить игру, которую вы редактируете (это требуется только один раз). Если этого не сделать, будут возникать Steam ошибки, при запуске в режиме отладки.
- Правый клик на проекте, над которым вы работаете, перейдите в его свойства, и выберите Debug->Start New Instance.
- Если вы получаете предупреждение, что
hl2.exe
не имеет отладочной информации (hl2.exe has no debugging information), игнорируйте это. - Теперь запустите Half-Life 2 и ваш код. Вы можете сейчас внести изменение в код, пересобрать его, и вернуться в игру с вашими изменениями!
Альтернатива: интеграция во время выполнения
- Запустите мод через Steam
- В Visual Studio, Main Menu > Debug > Attach to Process...
- Выберите процесс hl2.exe с названием вашего мода
![Tip.png](/w/images/thumb/4/45/Tip.png/9px-Tip.png)
Ссылки
Хороший шаг после выполнения этой статьи, взглянуть на статью Ваша Первая Энтити , в котором вы будете вносить изменения в исходный код.
Если вы планируете интегрировать обновления кода от Valve, и если вы хотите иметь резервную копию кода и историю ревизий, взгляните на статью Использование Source Control с Source SDK .