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

From Valve Developer Community
Jump to: navigation, search
(Links)
Line 1: Line 1:
Статья разъясняет основные действия по установке и debug'у исходного кода
+
В этой статье рассказывается об основах установки и отладки исходного кода.
  
 
== Шаг за шагом ==
 
== Шаг за шагом ==
  
=== Запуск Create a Mod ===
+
=== Запуск мастера Create a Mod ===
  
# Из Steam'а запустите Source SDK и выберите '''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'''. Create a Mod начнет переписывать файлы с исходным кодом на жесткий диск в указанную папку.
+
# Нажмите кнопку '''Next''' и исходный код будет установлен на ваш жесткий диск.
# Дождитесь, пока копирование не закончится.
+
# Подождите пока мастер создания модификаций закончит свою работу.
  
=== Компиляция кода ===
+
=== Компиляция исходного кода ===
Для общих сведений о компиляции обратитесь к статье [[Compiler Choices|Выбор компилятора]]
+
Общая информация о компиляции исходного кода находится здесь : [[Compiler Choices:ru|Выбор компилятора]]
  
Более конкретная информация:
+
Более детальная информация находится здесь:
* [[Compiling under VS2003|Компиляция в VS2003]]
+
* [[Compiling under VS2003]]
* [[Compiling under VS2005|Компиляция в VS2005]]
+
* [[Compiling under VS2005]]
* [[Compiling under VS2008|Компиляция в VS2008]]
+
* [[Compiling under VS2008:ru|Компиляция под VS2008]]
  
{{note|По умолчанию компиляция кода идет в режиме Debug. Чтобы запустить мод с отладочным dll, нажмите на имени мода в списке игр Steam правой кнопкой мыши, выберите  '''Properties''', и в '''Set Launch Options...''' добавьте параметр ''-allowdebug'' в конец (если там уже что-то есть; параметры разделяются пробелами). Вы можете переключиться на билд в режиме release (для распространения мода) в Configuration Manager. <!-- Надеюсь, что имеется в виду именно переключение  в Visual Studio - все разумно и вполне сходится -->}}
+
{{note|По умолчанию включена компиляция в режиме отладки. Чтобы запустить модификацию с отладочным dll-файлом вам необходимо щелкнуть правой кнопкой мыши на вашей модификации в списке игр Steam, затем щелкнуть '''Properties''', потом '''Set Launch Options...''' и добавить ''-allowdebug'' в конец списка любых параметров, которые могут там находится (параметры разделяются пробелами). Вы можете переключится на release-версию (для распространения модификации) в менеджере конфигураций.}}
  
На данный момент код лучше компилировать в 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 users: [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 этого делать не надо.
  
===Debugging===
+
===Отладка===
  
==== Настройка параметров debugging'а ====
+
==== Установка параметров отладки ====
 
   
 
   
{{note|Будет работать только если вы уже установили и запустили Source SDK Base.}}
+
{{note|Данный пример сработает только если вы установили и запускали Source SDK Base.}}
# В окне '''Solution Explorer''' щелкните правой кнопкой мыши на текущем проекте (строчка жирным шрифтом) и выберите '''Properties'''.
+
# В окне '''Solution Explorer (Обозреватель решений)''' щелкните правой кнопкой на запускаемом проекте (он отмечен жирным шрифтом) и выберите '''Properties (Свойства)'''.
# В появляющемся окне Property Pages зайдите в раздел Debugging (список слева).
+
# Слева в открывшемся окне выберите пункт Debugging (Отладка).
# Справа, в строчке сразу за '''Command''', введите <code>C:\Steam\SteamApps\'''Username'''\source sdk base 2007\hl2.exe</code> (у вас путь может отличаться - введите тот, который отвечает вашей директории установки Steam).
+
# Теперь справа в текстовом окне '''Command (Команда)''' введите <code>C:\Steam\SteamApps\'''Имя_пользователя'''\source sdk base 2007\hl2.exe</code> (измените путь в соответствие с вашим путем установки Steam).
# Справа от '''Command Arguments''' введите <code>-dev -sw -game "C:\Steam\SteamApps\SourceMods\MyMod"</code> (здесь '''MyMod''' это имя вашего мода, которое вы ввели ранее, в диалоге ''Create a Mod'').
+
# Далее в поле '''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 на своем компьютере).
+
# Далее в '''Working Directory (Рабочий каталог)''' введите <code>C:\Steam\SteamApps\'''Имя_пользователя'''\source sdk base 2007</code> (измените путь в соответствие с вашим путем установки Steam).
 
# Нажмите кнопку '''OK'''.
 
# Нажмите кнопку '''OK'''.
  
==== Запуск в debugger'е ====
+
{{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>)}}
 
# ''Важно: после апдейта SDK нужно перед запуском в отладчике обязательно запустить '' '''через Steam''' '' игру, которую вы редактируете - хотя бы раз (достаточно одного). В противном случае при запуске через дебаггер у вас могут возникнуть ошибки, связанные со Steam.''
 
# Щелкните правой кнопкой мыши на проекте (том же, для которого редактировали Properties) и выберите Debug->Start New Instance.
 
# В случае, если вылезет warning о том, что у <code>hl2.exe</code> нет отладочной информации, игнорируйте его.
 
# После этого можно будет запускать Half-Life 2 и свой код. Вы сможете производить изменения в коде, пересобирать и снова запускать игру с внесенными изменениями!
 
  
==== Другой вариант: attachment к запущенной игре====
+
{{note|Если ваши пути содержат пробелы, то разумно поместить их в кавычки. Например,  <code>"C:\Steam\SteamApps\'''Имя_пользователя'''\team fortress 2\hl2.exe"</code> и т.д. С ними всё должно работать как надо, однако, если у вас есть проблемы с отладкой, придется попробовать что-нибудь другое.}}
  
# Запустите свой мод в Steam
+
==== Запуск в отладчике ====
# В Visual Studio в главном меню нажмите Debug > Attach to Process...
 
# Выберите процесс hl2.exe с названием вашего мода
 
{{tip| для удобства можно запускать игру в оконном режиме: добавьте опцию "-window" в ваш файл run_mod.bat}}
 
  
== Ссылки ==
+
# ''Важно: после обновления SDK вам понадобится запустить игру, которую вы модифицируете'' '''через Steam''' ''единожды перед запуском в отладчике. Если этого не сделать то вы можете получить сообщения об ошибках Steam при запуске игры через отладчик.''
 +
# 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!
  
Если вы уже разобрались с тем, что описано в статье, будет неплохо посмотреть документ [[Your First Entity|Ваш первый entity]]. Это следующий шаг, и в процессе работы с этим документом вы уже произведете некие изменения в исходном коде.
+
==== Alternative : run-time attachment ====
  
Если вы собираетесь интегрировать обновления кода от Valve, и хотели бы иметь backup'ы кода и историю версий, ознакомьтесь со статьей [[Using Source Control with the Source SDK|Использование систем контроля версий с Source SDK]].
+
# Start the mod using Steam
 +
# Inside Visual Studio, Main Menu > Debug > Attach to Process...
 +
# Select the hl2.exe process with the title of your mod
 +
{{tip|you can start the app in windowed mode for better comfort : add a "-window" option in your run_mod.bat}}
  
{{otherlang:ru}}
+
== Links ==
{{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]]
+
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.
[[Category:Modding:ru]]
+
 
 +
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.
 +
 
 +
{{otherlang:en}}
 +
{{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]]
 +
[[Category:Modding]]

Revision as of 17:41, 23 May 2009

В этой статье рассказывается об основах установки и отладки исходного кода.

Шаг за шагом

Запуск мастера 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. Подождите пока мастер создания модификаций закончит свою работу.

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

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

Более детальная информация находится здесь:

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

В настоящее время код лучше всего компилируется под VS2005. Вы можете скачать его по ссылке: http://www.microsoft.com/express/2005/

Пользователи VCE2005 должны загрузить Windows SDK (Пользователям Windows 2000: Platform SDK). Пользователям Visual Studio и VCE2008 этого делать не надо.

Отладка

Установка параметров отладки

Note:Данный пример сработает только если вы установили и запускали Source SDK Base.
  1. В окне Solution Explorer (Обозреватель решений) щелкните правой кнопкой на запускаемом проекте (он отмечен жирным шрифтом) и выберите Properties (Свойства).
  2. Слева в открывшемся окне выберите пункт Debugging (Отладка).
  3. Теперь справа в текстовом окне Command (Команда) введите C:\Steam\SteamApps\Имя_пользователя\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\Имя_пользователя\source sdk base 2007 (измените путь в соответствие с вашим путем установки Steam).
  6. Нажмите кнопку OK.
Note:Если вы используете Orange Box code-base и у вас проблемы с отладкой напрямую из Visual Studio, то просмотрите файл gameinfo.txt вашего мода. Если значение AppID равно 440, вам необходимо поменять пути в параметрах "Command (Команда)" и "Working Directory (Рабочий каталог)" так, чтобы они указывали на рабочий каталог "team fortress 2" (т.е. C:\Steam\SteamApps\Имя_пользователя\team fortress 2\hl2.exe и C:\Steam\SteamApps\Имя_пользователя\team fortress 2)
Note:Если ваши пути содержат пробелы, то разумно поместить их в кавычки. Например, "C:\Steam\SteamApps\Имя_пользователя\team fortress 2\hl2.exe" и т.д. С ними всё должно работать как надо, однако, если у вас есть проблемы с отладкой, придется попробовать что-нибудь другое.

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

  1. Важно: после обновления SDK вам понадобится запустить игру, которую вы модифицируете через Steam единожды перед запуском в отладчике. Если этого не сделать то вы можете получить сообщения об ошибках Steam при запуске игры через отладчик.
  2. Right-click on the same project you were editing the properties for, and choose Debug->Start New Instance.
  3. If you get a warning that hl2.exe has no debugging information, ignore it.
  4. 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

  1. Start the mod using Steam
  2. Inside Visual Studio, Main Menu > Debug > Attach to Process...
  3. Select the hl2.exe process with the title of your mod
Tip:you can start the app in windowed mode for better comfort : add a "-window" option in your 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.

Template:Otherlang:en Template:Otherlang:en:jp Template:Otherlang:en:es Template:Otherlang:en:fr