Difference between revisions of "Installing and Debugging the Source Code:ru"

From Valve Developer Community
Jump to: navigation, search
(Alternative : run-time attachment)
 
(13 intermediate revisions by 8 users not shown)
Line 1: Line 1:
Статья разъясняет основные действия по установке и debug'у исходного кода
+
{{otherlang2
 +
|title=Установка и Отладка Исходного Кода
 +
|jp=Installing_and_Debugging_the_Source_Code:jp
 +
|en=Installing_and_Debugging_the_Source_Code
 +
|pl=Installing and Debugging the Source Code:pl
 +
|es=Installing_and_Debugging_the_Source_Code:es
 +
|fr=Installing_and_Debugging_the_Source_Code:fr
 +
|zh-cn=Installing_and_Debugging_the_Source_Code:zh-cn
 +
}}
 +
В этой статье рассматриваются основные шаги по установке и отладке исходного кода.
  
== Шаг за шагом ==
+
== Шаг За Шагом ==
 +
=== Запуск мастера Create a Mod ===
  
=== Запуск 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.
  
# Из Steam'а запустите Source SDK и выберите '''Create a Mod'''.
+
=== Компиляция Исходного Кода ===
# Здесь в принципе можно выбрать любой тип мода, но для примера выберите опцию '''Modify Half-Life 2 Single Player''' и нажмите '''Next'''.
+
Общая информация о компиляции находится здесь: [[Compiler Choices:ru|Выбор Компилятора]]
# В верхнем текстовом окне введите путь к директории, в которой вы будете создавать мод. В этом туториале предполагается, что вы ввели '''C:\MyMod''' - просто для примера.
 
# В нижнем текстовом окне наберите имя вашего мода. Так будет называться папка внутри директории '''''SteamInstallPath'''\SteamApps\SourceMods''. В этом примере, для определенности, пусть имя будет '''MyMod'''.
 
# Нажмите кнопку '''Next'''. Create a Mod начнет переписывать файлы с исходным кодом на жесткий диск в указанную папку.
 
# Дождитесь, пока копирование не закончится.
 
  
=== Компиляция кода ===
+
более конкретно:
Для общих сведений о компиляции обратитесь к статье [[Compiler Choices|Выбор компилятора]]
+
* [[Compiling under VS2003:ru|Компиляция под VS2003]]
 +
* [[Compiling under VS2005:ru|Компиляция под VS2005]]
 +
* [[Compiling under VS2008:ru|Компиляция под VS2008]]
 +
* [[Compiling under VS2010:ru|Компиляция под VS2010]]
  
Более конкретная информация:
+
{{note:ru|По умолчанию включен режим отладки. Для запуска мода с отладочным DLL, вы должны правой кнопкой нажать на мод в Steam, выбрать '''Properties''', затем '''Set Launch Options...''' и добавить ''-allowdebug'' в конец того, что возможно, уже там введено (разделяя параметры пробелами). Вы можете перейти в режим Релиза (для распространения мода) в менеджере конфигурации.}}
* [[Compiling under VS2003|Компиляция в VS2003]]
 
* [[Compiling under VS2005|Компиляция в VS2005]]
 
* [[Compiling under VS2008|Компиляция в VS2008]]
 
  
{{note|По умолчанию компиляция кода идет в режиме Debug. Чтобы запустить мод с отладочным dll, нажмите на имени мода в списке игр Steam правой кнопкой мыши, выберите  '''Properties''', и в '''Set Launch Options...''' добавьте параметр ''-allowdebug'' в конец (если там уже что-то есть; параметры разделяются пробелами). Вы можете переключиться на билд в режиме release (для распространения мода) в Configuration Manager. <!-- Надеюсь, что имеется в виду именно переключение  в Visual Studio - все разумно и вполне сходится -->}}
+
В настоящее время, код лучше собирается под VS2005. Вы можете скачать его [http://www.microsoft.com/express/2005/ здесь]. Хотя Visual Studio 2010 это лучший выбор для Source.
  
На данный момент код лучше компилировать в VS2005. Скачать его можно здесь: http://www.microsoft.com/express/2005/
+
VCE2005 пользователям необходимо скачать [http://www.microsoft.com/downloads/details.aspx?FamilyID=e6e1c3df-a74f-4207-8586-711ebe331cdc&DisplayLang=en Windows SDK] (Windows 2000 пользователи: [http://www.microsoft.com/downloads/details.aspx?familyid=A55B6B43-E24F-4EA3-A93E-40C0EC4F68E5&displaylang=en Platform SDK]). Visual Studio и VCE2008 этого не требуется.
  
Пользователям VCE2005 понадобится предварительно скачать [http://www.microsoft.com/downloads/details.aspx?FamilyID=e6e1c3df-a74f-4207-8586-711ebe331cdc&DisplayLang=en Windows SDK] (Windows 2000 users: [http://www.microsoft.com/downloads/details.aspx?familyid=A55B6B43-E24F-4EA3-A93E-40C0EC4F68E5&displaylang=en Platform SDK]). Тем, кто работает в Visual Studio и VCE2008, это не нужно.
+
===Отладка===
 +
==== Настройка параметров отладки ====
  
===Debugging===
+
{{note:ru|Это будет работать, только если у вас установлен и единожды запущен Source SDK Base.}}
 +
# В '''окне Solution Explorer,''' правый клик на текущем проекте (он отмечен жирным) и выберите '''Properties'''.
 +
# В появившимся диалоге Property Pages, с левой стороны выберите пункт Debugging.
 +
# По правую сторону, в текстовом поле '''Command''', введите <code>C:\Steam\SteamApps\'''Username'''\source sdk base 2007\hl2.exe</code> (корректировка пути, к вашему собственному Steam).
 +
# Далее, в '''Command Arguments''', введите <code>-dev -sw -game "C:\Steam\SteamApps\SourceMods\MyMod"</code> (где '''MyMod''' это название вашего мода, введенное в диалоге ''Create a Mod'').
 +
# Далее, в '''Working Directory''', введите <code>C:\Steam\SteamApps\'''Username'''\source sdk base 2007</code> (корректировка пути, к вашему собственному Steam).
 +
# Нажмите на кнопку '''OK'''.
  
==== Настройка параметров debugging'а ====
+
{{note:ru|Если вы используете OB код-базу, и у вас возникают проблемы с Visual Studio, посмотрите в вашем [[gameinfo.txt:ru|gameinfo.txt]]. Если AppID стоит в значении 440, вам необходимо изменить "Command" и "Working Directory" для указания на директорию "team fortress 2". (так же известную, как <code>C:\Steam\SteamApps\'''Username'''\team fortress 2\hl2.exe</code> и <code>C:\Steam\SteamApps\'''Username'''\team fortress 2</code>)}}
 
{{note|Будет работать только если вы уже установили и запустили Source SDK Base.}}
 
# В окне '''Solution Explorer''' щелкните правой кнопкой мыши на текущем проекте (строчка жирным шрифтом) и выберите '''Properties'''.
 
# В появляющемся окне Property Pages зайдите в раздел Debugging (список слева).
 
# Справа, в строчке сразу за '''Command''', введите <code>C:\Steam\SteamApps\'''Username'''\source sdk base 2007\hl2.exe</code> (у вас путь может отличаться - введите тот, который отвечает вашей директории установки Steam).
 
# Справа от '''Command Arguments''' введите <code>-dev -sw -game "C:\Steam\SteamApps\SourceMods\MyMod"</code> (здесь '''MyMod''' это имя вашего мода, которое вы ввели ранее, в диалоге ''Create a Mod'').
 
# Справа от '''Working Directory''', наберите <code>C:\Steam\SteamApps\'''Username'''\source sdk base 2007</code> (это тоже пример - вы же должны ввести путь, который отвечает директории, в которую вы установили Steam на своем компьютере).
 
# Нажмите кнопку '''OK'''.
 
  
==== Запуск в debugger'е ====  
+
{{note:ru|Если в ваших путях есть пробелы, не забудьте заключить их в кавычки. Для примера: <code>"C:\Steam\SteamApps\'''Username'''\team fortress 2\hl2.exe"</code> и т.п. Это МОЖЕТ работать без них, но так же, это один из источников возникающих проблем.}}
 +
 
 +
{{note:ru|Если у вас возникают ошибки, наподобие <code>fatal error LNK1169: one or more multiply defined symbols found</code> или <code>error LNK2005: __malloc_dbg already defined in memoverride.obj</code>, это может быть исправлено добавлением "/FORCE:MULTIPLE" (без кавычек) в свойства проекта/configuration properties/linker/command line/additional options. Это будет работать более хорошо, если вы добавите это в server и client проекты.}}
 +
 
 +
==== Запуск в отладчике ====  
 
 
 
 
# ''Важно: после апдейта SDK нужно перед запуском в отладчике обязательно запустить '' '''через Steam''' '' игру, которую вы редактируете - хотя бы раз (достаточно одного). В противном случае при запуске через дебаггер у вас могут возникнуть ошибки, связанные со Steam.''
+
# ''Важно: в случае обновления SDK, перед запуском в отладчике, вы должны один раз запустить игру, которую вы редактируете (это требуется только один раз). Если этого не сделать, будут возникать Steam ошибки, при запуске в режиме отладки.''
# Щелкните правой кнопкой мыши на проекте (том же, для которого редактировали Properties) и выберите Debug->Start New Instance.
+
# Правый клик на проекте, над которым вы работаете, перейдите в его свойства, и выберите Debug->Start New Instance.
# В случае, если вылезет warning о том, что у <code>hl2.exe</code> нет отладочной информации, игнорируйте его.
+
# Если вы получаете предупреждение, что <code>hl2.exe</code> не имеет отладочной информации (hl2.exe has no debugging information), игнорируйте это.
# После этого можно будет запускать Half-Life 2 и свой код. Вы сможете производить изменения в коде, пересобирать и снова запускать игру с внесенными изменениями!
+
# Теперь запустите Half-Life 2 и ваш код. Вы можете сейчас внести изменение в код, пересобрать его, и вернутся в игру с вашими изменениями!
  
==== Другой вариант: attachment к запущенной игре====
+
==== Альтернатива: интеграция во время выполнения  ====
  
# Запустите свой мод в Steam  
+
# Запустите мод через Steam
# В Visual Studio в главном меню нажмите Debug > Attach to Process...
+
# В Visual Studio, Main Menu > Debug > Attach to Process...
 
# Выберите процесс hl2.exe с названием вашего мода
 
# Выберите процесс hl2.exe с названием вашего мода
{{tip| для удобства можно запускать игру в оконном режиме: добавьте опцию "-window" в ваш файл run_mod.bat}}
+
{{tip:ru|вы можете запустить приложение в оконном режиме, для большего конфорта: добавьте опцию "-window" в ваш 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.
+
Хороший шаг после выполнения этого документа, взглянуть на статью [[Your First Entity:ru|Ваша Первая Энтити]], в котором вы будите вносить изменения в исходный код.
  
{{otherlang:ru}}
+
Если вы планируете интегрировать обновления кода от Valve, и если вы хотите иметь резервную копию кода и историю ревизий, взгляните на статью [[Using Source Control with the Source SDK:ru|Использование Source Control с Source SDK]].
{{otherlang:ru:en|Installing and Debugging the Source Code}}
 
{{otherlang:ru:jp|Installing and Debugging the Source Code:jp}}
 
{{otherlang:ru:es|Installing and Debugging the Source Code:es}}
 
{{otherlang:ru:fr|Installing and Debugging the Source Code:fr}}
 
  
 
[[Category:Programming:ru]]
 
[[Category:Programming:ru]]
 
[[Category:Modding:ru]]
 
[[Category:Modding:ru]]
 +
[[Category:Russian]]

Latest revision as of 13:13, 26 November 2016

English Español Français Polski 日本語 简体中文

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

Шаг За Шагом

Запуск мастера 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.

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

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

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

Примечание:По умолчанию включен режим отладки. Для запуска мода с отладочным DLL, вы должны правой кнопкой нажать на мод в Steam, выбрать Properties, затем Set Launch Options... и добавить -allowdebug в конец того, что возможно, уже там введено (разделяя параметры пробелами). Вы можете перейти в режим Релиза (для распространения мода) в менеджере конфигурации.

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

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

Отладка

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

Примечание:Это будет работать, только если у вас установлен и единожды запущен 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.
Примечание:Если вы используете OB код-базу, и у вас возникают проблемы с Visual Studio, посмотрите в вашем 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)
Примечание:Если в ваших путях есть пробелы, не забудьте заключить их в кавычки. Для примера: "C:\Steam\SteamApps\Username\team fortress 2\hl2.exe" и т.п. Это МОЖЕТ работать без них, но так же, это один из источников возникающих проблем.
Примечание:Если у вас возникают ошибки, наподобие 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 проекты.

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

  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 с названием вашего мода
Совет:
вы можете запустить приложение в оконном режиме, для большего конфорта: добавьте опцию "-window" в ваш run_mod.bat


Ссылки

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

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