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

From Valve Developer Community
< Ru
Jump to navigation Jump to search
No edit summary
No edit summary
Line 5: Line 5:
=== Запуск мастера 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''' и исходный код будет установлен на ваш жесткий диск.
# Подождите пока мастер создания модификаций закончит свою работу.
# Подождите пока мастер создания модификаций закончит свою работу.


=== Компиляция исходного кода ===
=== Компиляция исходного кода ===
Общая информация о компиляции исходного кода находится здесь : [[Compiler Choices:ru|Выбор компилятора]]
Общая информация о компиляции исходного кода находится здесь : [[Compiler Choices:ru|Выбор компилятора.]]


Более детальная информация находится здесь:
Более детальная информация находится здесь:
Line 20: Line 20:
* [[Compiling under VS2008:ru|Компиляция под VS2008]]
* [[Compiling under VS2008:ru|Компиляция под VS2008]]


{{note|По умолчанию включена компиляция в режиме отладки. Чтобы запустить модификацию с отладочным dll-файлом вам необходимо щелкнуть правой кнопкой мыши на вашей модификации в списке игр Steam, затем щелкнуть '''Properties''', потом '''Set Launch Options...''' и добавить ''-allowdebug'' в конец списка любых параметров, которые могут там находится (параметры разделяются пробелами). Вы можете переключится на release-версию (для распространения модификации) в менеджере конфигураций.}}
{{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: [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|Данный пример сработает только если вы установили и запускали Source SDK Base.}}
{{note|Данный пример будет работать только если вы установили, и хотя бы один раз запустили Source SDK Base.}}
# В окне '''Solution Explorer (Обозреватель решений)''' щелкните правой кнопкой на запускаемом проекте (он отмечен жирным шрифтом) и выберите '''Properties (Свойства)'''.
# В окне '''Solution Explorer (Обозреватель решений)''' щелкните правой кнопкой на запускаемом проекте (он отмечен жирным шрифтом) и выберите '''Properties (Свойства)'''.
# Слева в открывшемся окне выберите пункт Debugging (Отладка).
# Слева в открывшемся окне выберите пункт Debugging (Отладка).
# Теперь справа в текстовом окне '''Command (Команда)''' введите <code>C:\Steam\SteamApps\'''Имя_пользователя'''\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\'''Имя_пользователя'''\source sdk base 2007</code> (измените путь в соответствие с вашим путем установки Steam).
# Далее в '''Working Directory (Рабочий каталог)''' введите <code>C:\Steam\SteamApps\'''Имя_пользователя'''\source sdk base 2007</code> (измените путь в соответствие с вашим путем установки Steam).
Line 42: Line 42:
{{note|Если ваши пути содержат пробелы, то разумно поместить их в кавычки. Например,  <code>"C:\Steam\SteamApps\'''Имя_пользователя'''\team fortress 2\hl2.exe"</code> и т.д. С ними всё должно работать как надо, однако, если у вас есть проблемы с отладкой, придется попробовать что-нибудь другое.}}
{{note|Если ваши пути содержат пробелы, то разумно поместить их в кавычки. Например,  <code>"C:\Steam\SteamApps\'''Имя_пользователя'''\team fortress 2\hl2.exe"</code> и т.д. С ними всё должно работать как надо, однако, если у вас есть проблемы с отладкой, придется попробовать что-нибудь другое.}}


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


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


==== Alternative : run-time attachment ====
==== Альтернативный способ: интеграция во время выполнения ====


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


== Links ==
{{tip|Вы можете запускать приложение в оконном режиме для большего комфорта: для этого добавьте параметр "-window" в ваш файл run_mod.bat}}


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|Ваш первый игровой объект]], в котором вносятся некоторые изменения в исходный код модификации.
 
Если вы планируете интегрировать обновления исходного кода от Valve, и если вы хотите иметь поддержку отката исходного кода и учета его изменений, взгляните на статью [[Using Source Control with the Source SDK]].


{{otherlang:en}}  
{{otherlang:en}}  

Revision as of 00:51, 24 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.pngПримечание:По умолчанию включена компиляция в режиме отладки. Чтобы запустить модификацию с отладочным 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.pngПримечание:Данный пример будет работать только если вы установили, и хотя бы один раз запустили 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.pngПримечание:Если вы используете 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.pngПримечание:Если ваши пути содержат пробелы, то разумно поместить их в кавычки. Например, "C:\Steam\SteamApps\Имя_пользователя\team fortress 2\hl2.exe" и т.д. С ними всё должно работать как надо, однако, если у вас есть проблемы с отладкой, придется попробовать что-нибудь другое.

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

  1. Важно: после обновления Source SDK необходимо один раз запустить игру, которую вы модифицируете через Steam . Если этого не сделать то возможно вы получите сообщения об ошибках Steam при запуске игры через отладчик.
  2. Щелкните правой кнопкой по тому проекту, свойства которого вы изменяли, и выберите Debug->Start New Instance (Отладка->Запустить новый экземпляр).
  3. Если вы получаете предупреждение о том, что hl2.exe не имеет отладочной информации, игнорируйте его.
  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, и если вы хотите иметь поддержку отката исходного кода и учета его изменений, взгляните на статью Using Source Control with the Source SDK.

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

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