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

From Valve Developer Community
Jump to: navigation, search
m (f)
(update/correcting)
Line 1: Line 1:
В этой статье рассказывается об основах установки и отладки исходного кода.
+
{{DISPLAYTITLE:Установка и Отладка Исходного Кода}}{{otherlang2|
 +
| jp = Installing and Debugging the Source Code:jp
 +
| es = Installing and Debugging the Source Code:es
 +
| fr = Installing and Debugging the Source Code:fr
 +
| en = Installing and Debugging the Source Code}}
  
== Шаг за шагом ==
+
В этой статье рассматриваются основные шаги по установке и отладке исходного кода.
  
 +
== Шаг За Шагом ==
 
=== Запуск мастера Create a Mod ===
 
=== Запуск мастера Create a Mod ===
  
# Запустите Source SDK через Steam и щелкните на пункте '''Create a Mod'''.
+
# Запустите Source SDK из Steam и выберите пункт '''Create a Mod'''.
# Здесь вы можете выбрать любой пункт для модификации, но для нужд этой статьи выберите пункт '''Modify Half-Life 2 Single Player''' и нажмите '''Next'''.
+
# Обычно вы можете выбрать любой тип мода, но в целях данного руководства, выберите вариант '''Modify Half-Life 2 Single Player''' и нажмите '''Next'''.
# В следующем диалоговом окне, в верхнем поле ввода, введите название директории, в которой вы хотите хранить файлы модификации. В данной статье предполагается что вы ввели '''C:\MyMod'''.
+
# В верхнем поле следующего диалога, введите директорию, куда вы хотите распаковать мод. Это руководство предполагает, что введено '''C:\MyMod'''.
# В нижнем поле ввода введите имя вашей модификации. Директория с таким именем будет создана в каталоге '''''SteamInstallPath'''\SteamApps\SourceMods''. В данной статье предполагается что вы ввели имя '''MyMod'''.
+
# В нижнем поле, введите любое название вашего мода. Это станет подкаталогом в вашей '''''SteamInstallPath'''\SteamApps\SourceMods'' директории. В этом примере предполагается, что вы ввели '''MyMod'''.
# Нажмите кнопку '''Next''' и исходный код будет установлен на ваш жесткий диск.
+
# Нажмите на кнопку '''Next''' и исходный код будет распакован на ваш жесткий диск.
# Подождите пока мастер создания модификаций закончит свою работу.
+
# Подождите, пока Mod Wizard не закончит.
  
=== Компиляция исходного кода ===
+
=== Компиляция Исходного Кода ===
Общая информация о компиляции исходного кода находится здесь : [[Compiler Choices:ru|Выбор компилятора.]]
+
Общая информация о компиляции находится здесь: [[Compiler Choices:ru|Выбор Компилятора]]
  
Более детальная информация находится здесь:
+
более конкретно:
* [[Compiling under VS2003]]
+
* [[Compiling under VS2003:ru|Компиляция под VS2003]]
* [[Compiling under VS2005]]
+
* [[Compiling under VS2005:ru|Компиляция под VS2005]]
 
* [[Compiling under VS2008:ru|Компиляция под VS2008]]
 
* [[Compiling under VS2008:ru|Компиляция под VS2008]]
  
{{Note|По умолчанию включена компиляция в режиме отладки. Чтобы запустить модификацию с отладочным dll-файлом вам необходимо щелкнуть правой кнопкой мыши на вашей модификации в списке игр Steam, затем щелкнуть '''Properties''', потом '''Set Launch Options...''' и добавить ''-allowdebug'' в конец списка любых параметров, которые могут там находится (параметры разделяются пробелами). Вы можете переключится на release-версию (для распространения модификации) в менеджере конфигураций.}}
+
{{note:ru|По умолчанию включена отладочная компиляция. Для запуска мода с отладочным DLL, вы должны правой кнопкой нажать на мод в Steam, выбрать '''Properties''', затем '''Set Launch Options...''' и добавить ''-allowdebug'' в конец того, что возможно, уже там введено (заключая в кавычки). Вы можете перейти в режим Релиза (для распространения мода) в менеджере конфигурации.}}
  
В настоящее время код лучше всего компилируется под VS2005. Вы можете скачать его по ссылке: http://www.microsoft.com/express/2005/
+
В настоящее время, код лучше собирается под 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 пользователи: [http://www.microsoft.com/downloads/details.aspx?familyid=A55B6B43-E24F-4EA3-A93E-40C0EC4F68E5&displaylang=en Platform SDK]). Visual Studio и VCE2008 этого не требуется.
  
 
===Отладка===
 
===Отладка===
 +
==== Настройка параметров отладки ====
  
==== Установка параметров отладки ====
+
{{note:ru|Это будет работать, только если у вас установлен и единожды запущен Source SDK Base.}}
+
# В '''Solution Explorer window,''' правый клик на текущем проекте (он отмечен жирным) и выберите '''Properties'''.
{{note|Данный пример будет работать только если вы установили, и хотя бы один раз запустили Source SDK Base.}}
+
# В появившимся диалоге Property Pages, с левой стороны выберите пункт Debugging.
# В окне '''Solution Explorer (Обозреватель решений)''' щелкните правой кнопкой на запускаемом проекте (он отмечен жирным шрифтом) и выберите '''Properties (Свойства)'''.
+
# По правую сторону, в текстовом поле '''Command''', введите <code>C:\Steam\SteamApps\'''Username'''\source sdk base 2007\hl2.exe</code> (корректировка пути, к вашему собственному Steam).
# Слева в открывшемся окне выберите пункт Debugging (Отладка).
+
# Далее, в '''Command Arguments''', введите <code>-dev -sw -game "C:\Steam\SteamApps\SourceMods\MyMod"</code> (где '''MyMod''' это название вашего мода, введенное в диалоге ''Create a Mod'').
# Справа в текстовом окне '''Command (Команда)''' введите <code>C:\Steam\SteamApps\'''Имя_пользователя'''\source sdk base 2007\hl2.exe</code> (измените путь в соответствие с вашим путем установки Steam).
+
# Далее, в '''Working Directory''', введите <code>C:\Steam\SteamApps\'''Username'''\source sdk base 2007</code> (корректировка пути, к вашему собственному Steam).
# Далее в поле '''Command Arguments (Командные аргументы)''' введите <code>-dev -sw -game "C:\Steam\SteamApps\SourceMods\MyMod"</code> (где '''MyMod''' это имя вашей модификации, которое вы указывали в диалоговом окне ''Create a Mod'' мастера создания модификаций).
+
# Нажмите на кнопку '''OK'''.
# Далее в '''Working Directory (Рабочий каталог)''' введите <code>C:\Steam\SteamApps\'''Имя_пользователя'''\source sdk base 2007</code> (измените путь в соответствие с вашим путем установки Steam).
 
# Нажмите кнопку '''OK'''.
 
  
{{note|Если вы используете Orange Box code-base и у вас проблемы с отладкой напрямую из Visual Studio, то просмотрите файл gameinfo.txt вашего мода. Если значение AppID равно 440, вам необходимо поменять пути в параметрах "Command (Команда)" и "Working Directory (Рабочий каталог)" так, чтобы они указывали на рабочий каталог "team fortress 2" (т.е. <code>C:\Steam\SteamApps\'''Имя_пользователя'''\team fortress 2\hl2.exe</code> и <code>C:\Steam\SteamApps\'''Имя_пользователя'''\team fortress 2</code>)}}
+
{{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|Если ваши пути содержат пробелы, то разумно поместить их в кавычки. Например,  <code>"C:\Steam\SteamApps\'''Имя_пользователя'''\team fortress 2\hl2.exe"</code> и т.д. С ними всё должно работать как надо, однако, если у вас есть проблемы с отладкой, придется попробовать что-нибудь другое.}}
+
{{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 проекты.}}
  
# ''Важно: после обновления Source SDK необходимо один раз запустить игру, которую вы модифицируете'' '''через Steam''' ''. Если этого не сделать то возможно вы получите сообщения об ошибках Steam при запуске игры через отладчик.''
+
==== Запуск в отладчике ====
# Щелкните правой кнопкой по тому проекту, свойства которого вы изменяли, и выберите Debug->Start New Instance (Отладка->Запустить новый экземпляр).
+
# Если вы получаете предупреждение о том, что hl2.exe не имеет отладочной информации, игнорируйте его.
+
# ''Важно: в случае обновления SDK, перед запуском в отладчике, вы должны один раз запустить игру, которую вы редактируете (это требуется только один раз). Если этого не сделать, будут возникать Steam ошибки, при запуске в режиме отладкиI.''
# Теперь при отладке должна запускаться Half-life 2 с вашим исходным кодом. Вы можете вносить модификации в код, перекомпилировать его, и перезапускать игру с внесенными изменениями!
+
# Правый клик на проекте, над которым вы работаете, перейдите в его свойства, и выберите Debug->Start New Instance.
 +
# Если вы получаете предупреждение, что <code>hl2.exe</code> не имеет отладочной информации (hl2.exe has no debugging information), игнорируйте это.
 +
# Теперь запустите Half-Life 2 и ваш код. Вы можете сейчас внести изменение в код, пересобрать его, и вернутся в игру с вашими изменениями!
  
==== Альтернативный способ: интеграция во время выполнения ====
+
==== Альтернатива: интеграция во время выполнения ====
  
# Запустите вашу модификацию через Steam.
+
# Запустите мод через Steam
# В Visual Studio выберите Main Menu > Debug > Attach to Process... (Главное меню > Отладка > Присоединиться к процессу...).
+
# В Visual Studio, Main Menu > Debug > Attach to Process...
# Выберите процесс hl2.exe с заголовком вашей модификации.
+
# Выберите процесс hl2.exe с названием вашего мода
 
+
{{tip:ru|вы можете запустить приложение в оконном режиме, для большего конфорта: добавьте опцию "-window" в ваш run_mod.bat}}
{{tip|Вы можете запускать приложение в оконном режиме для большего комфорта: для этого добавьте параметр "-window" в ваш файл run_mod.bat}}
 
  
 
== Ссылки ==
 
== Ссылки ==
  
Следующим шагом после просмотра этой статьи может быть статья [[My First Entity:ru|Ваш первый игровой объект]], в котором вносятся некоторые изменения в исходный код модификации.
+
Хороший шаг для после выполнения этого документа, взглянуть на статью [[Your First Entity:ru|Ваша Первая Энтити]], в котором вы будите вносить изменения в исходный код.
 
 
Если вы планируете интегрировать обновления исходного кода от Valve, и если вы хотите иметь поддержку отката исходного кода и учета его изменений, взгляните на статью [[Using Source Control with the Source SDK]].
 
  
{{otherlang:en}}
+
Если вы планируете интегрировать обновления кода от Valve, и если вы хотите иметь резервную копию кода и историю ревизий, Взгляните на статью [[Using Source Control with the Source SDK:ru|Использование Source Control с Source SDK]].
{{otherlang:en:jp|Installing and Debugging the Source Code:jp}}
 
{{otherlang:en:es|Installing and Debugging the Source Code:es}}
 
{{otherlang:en:fr|Installing and Debugging the Source Code:fr}}
 
  
 
[[Category:Programming:ru]]
 
[[Category:Programming:ru]]
 
[[Category:Modding:ru]]
 
[[Category:Modding:ru]]
 +
[[Category:Russian]]

Revision as of 23:11, 18 January 2010

English Español Français 日本語

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

Шаг За Шагом

Запуск мастера 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 не закончит.

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

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

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

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

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

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

Отладка

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

Note.png Примечание: Это будет работать, только если у вас установлен и единожды запущен Source SDK Base.
  1. В Solution Explorer window, правый клик на текущем проекте (он отмечен жирным) и выберите 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}}

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 ошибки, при запуске в режиме отладкиI.
  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

Ссылки

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

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