Ru/Installing and Debugging the Source Code: Difference between revisions

From Valve Developer Community
< Ru
Jump to navigation Jump to search
(Just a stub for renderin' it into Russian...)
 
m (obsolete language category)
 
(30 intermediate revisions by 14 users not shown)
Line 1: Line 1:
Статья разъясняет основные действия по установке и debug'у исходного кода
{{LanguageBar}}


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


=== Запустите Create a Mod wizard ===
==Шаг За Шагом==
===Запуск мастера 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'''.
Общая информация о компиляции находится здесь: {{L|Compiler Choices|Выбор Компилятора}}
# In the top edit control of the next dialog, enter a directory where you would like to create a mod. This tutorial will assume you entered '''C:\MyMod'''.
# In the bottom edit control, enter any name for your mod. This will become a subdirectory under your '''''SteamInstallPath'''\SteamApps\SourceMods'' folder. This example will assume you entered '''MyMod''' here.
# Click the '''Next''' button and the source code will be installed on your hard drive.
# Wait for the mod wizard to finish.


=== Compile the Source Code ===
более конкретно:
For general considerations about compilation go here : [[Compiler Choices]]
* {{L|Compiling under VS2003|Компиляция под VS2003}}
* {{L|Compiling under VS2005|Компиляция под VS2005}}
* {{L|Compiling under VS2008|Компиляция под VS2008}}
* {{L|Compiling under VS2010|Компиляция под VS2010}}


For more specific :
{{Note|По умолчанию включен режим отладки. Для запуска мода с отладочным DLL, вы должны правой кнопкой нажать на мод в Steam, выбрать '''Properties''', затем '''Set Launch Options...''' и добавить ''-allowdebug'' в конец того, что возможно, уже там введено (разделяя параметры пробелами). Вы можете перейти в режим Релиза (для распространения мода) в менеджере конфигурации.}}
* [[Compiling under VS2003]]
* [[Compiling under VS2005]]
* [[Compiling under VS2008]]


{{note|It is on debug compile by default. In order to run the mod with a debug dll you must right click the mod in the Steam game browser, click '''Properties''' then '''Set Launch Options...''' and add ''-allowdebug'' to the end of anything that may already be there (separated by spaces). You can change to a release build (for distributing the mod) in the configuration manager.}}
В настоящее время, код лучше собирается под VS2005. Хотя Visual Studio 2010 это лучший выбор для Source.


Currently the code is better compiling on VS2005. You can download it at 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 users need to download the [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 and VCE2008 users do not.
===Отладка===
====Настройка параметров отладки====
{{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'''.


===Debugging===
{{Note|Если вы используете OB код-базу, и у вас возникают проблемы с Visual Studio, посмотрите в вашем {{L|Gameinfo.txt|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>)}}


==== Setup debugging parameters ====
{{Note|Если в ваших путях есть пробелы, не забудьте заключить их в кавычки. Для примера: <code>"C:\Steam\SteamApps\'''Username'''\team fortress 2\hl2.exe"</code> и т.п. Всё ''может'' работать и без них, но так же, это один из источников возникающих проблем.}}
{{note|This will only work if you have installed and launched the Source SDK Base.}}
# In the '''Solution Explorer window,''' right-click on the current project (the one in bold) and choose '''Properties'''.
# In the Property Pages dialog that appears, choose the Debugging item on the left-hand side.
# On the right-hand side, in the text control next to '''Command''', enter <code>C:\Steam\SteamApps\'''Username'''\source sdk base 2007\hl2.exe</code> (adjusting the folder names given here to reflect your own Steam installation).
# Next to '''Command Arguments''', enter <code>-dev -sw -game "C:\Steam\SteamApps\SourceMods\MyMod"</code> (where '''MyMod''' is the name of your mod you entered in the ''Create a Mod'' dialog).
# Next to '''Working Directory''', enter <code>C:\Steam\SteamApps\'''Username'''\source sdk base 2007</code> (adjusting the folder names given here to reflect your own Steam installation).
# Click the '''OK''' button.


==== Run in the debugger ====
{{Note|Если у вас возникают ошибки, наподобие <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 проекты.}}
# ''Important: after an SDK update, you must make sure to run whatever game you're editing'' '''through Steam''' ''once (only one time is necessary) before running in the debugger. If you don't, you may get Steam errors when running through the debugger.''
# Right-click on the same project you were editing the properties for, and choose Debug->Start New Instance.
# If you get a warning that <code>hl2.exe</code> has no debugging information, ignore it.
# 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 ====
====Запуск в отладчике====
# ''Важно: в случае обновления SDK, перед запуском в отладчике, вы должны один раз запустить игру, которую вы редактируете (это требуется только один раз). Если этого не сделать, будут возникать Steam ошибки, при запуске в режиме отладки.''
# Правый клик на проекте, над которым вы работаете, перейдите в его свойства, и выберите Debug->Start New Instance.
# Если вы получаете предупреждение, что <code>hl2.exe</code> не имеет отладочной информации (hl2.exe has no debugging information), игнорируйте это.
# Теперь запустите Half-Life 2 и ваш код. Вы можете сейчас внести изменение в код, пересобрать его, и вернуться в игру с вашими изменениями!


# Start the mod using Steam  
====Альтернатива: интеграция во время выполнения====
# Inside Visual Studio, Main Menu > Debug > Attach to Process...
# Запустите мод через Steam
# Select the hl2.exe process with the title of your mod
# В Visual Studio, Main Menu > Debug > Attach to Process...
{{tip|you can start the app in windowed mode for better comfort : add a "-window" option in your run_mod.bat}}
# Выберите процесс hl2.exe с названием вашего мода
{{Tip|для большего комфорта, вы можете запустить приложение в оконном режиме: добавьте опцию "-window" в ваш run_mod.bat}}


== Links ==
==Ссылки==
Хороший шаг после выполнения этой статьи, взглянуть на статью {{L|Your First Entity|Ваша Первая Энтити}}, в котором вы будете вносить изменения в исходный код.


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.
Если вы планируете интегрировать обновления кода от Valve, и если вы хотите иметь резервную копию кода и историю ревизий, взгляните на статью {{L|Using Source Control with the Source SDK|Использование Source Control с Source SDK}}.


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.
{{ACategory|Programming}}
 
{{ACategory|Modding}}
{{otherlang:ru}}
{{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:Modding:ru]]

Latest revision as of 03:50, 22 August 2024

English (en)Deutsch (de)Español (es)Français (fr)Italiano (it)日本語 (ja)Polski (pl)Русский (ru)中文 (zh)Translate (Translate)

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

Шаг За Шагом

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

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

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

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

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

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

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

Отладка

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

Note.pngПримечание:Это будет работать, только если у вас установлен и единожды запущен 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.
Note.pngПримечание:Если вы используете OB код-базу, и у вас возникают проблемы с Visual Studio, посмотрите в вашем gameinfo.txt(en). Если AppID стоит в значении 440, вам необходимо изменить "Command" и "Working Directory" для указания на директорию "team fortress 2". (так же известную, как C:\Steam\SteamApps\Username\team fortress 2\hl2.exe и C:\Steam\SteamApps\Username\team fortress 2)
Note.pngПримечание:Если в ваших путях есть пробелы, не забудьте заключить их в кавычки. Для примера: "C:\Steam\SteamApps\Username\team fortress 2\hl2.exe" и т.п. Всё может работать и без них, но так же, это один из источников возникающих проблем.
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 проекты.

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

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

Ссылки

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

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

Retrieved from "https://developer.valvesoftware.com/w/index.php?title=Ru/Installing_and_Debugging_the_Source_Code&oldid=446809"