User:RMN/How to compile Miranda plugins on one's own - Revision history

RMN: outdated info removed: such problems never occur with Miranda NG repository

2015-03-31T13:45:41Z

outdated info removed: such problems never occur with Miranda NG repository

@@ Line 60: / Line 60: @@
 [[File:VS - batch build.jpg|600px|center]]
 == Внимание ==
@@ Line 97: / Line 75: @@
 Рекомендуется использовать с осторожностью и только опытным пользователям.
 Авторы данного руководства:
 : Креол, mozzila (дополнения, сборка материала и скриншоты)

RMN: screenshot width

2015-03-29T14:52:22Z

screenshot width

← Older revision		Revision as of 17:52, 29 March 2015
Line 39:		Line 39:
	Мы собираем в 2010 студии, следовательно нам нужна папка '''<tt>bin10</tt>''', именно там находится проектный файл под эту версию — <tt>miranda32.sln</tt>. Откроем его.		Мы собираем в 2010 студии, следовательно нам нужна папка '''<tt>bin10</tt>''', именно там находится проектный файл под эту версию — <tt>miranda32.sln</tt>. Откроем его.

	[[File:VS - solution screen.jpg\|center]]		[[File:VS - solution screen.jpg\|600px\|center]]

	Слева мы видим решения проектов для модулей и ядра Miranda. Прежде чем собрать решение, нам необходимо установить режим компилирования: '''Release Unicode''' для Unicode версии плагина или '''Release''' для ANSI. В настройках решения (ПКМ по решению проекта) ''Properties → C/С++ → Code generations → Runtime Library'' — необходимо установить для создания статического билда значение '''MT''' или, для динамического, '''MD'''.		Слева мы видим решения проектов для модулей и ядра Miranda. Прежде чем собрать решение, нам необходимо установить режим компилирования: '''Release Unicode''' для Unicode версии плагина или '''Release''' для ANSI. В настройках решения (ПКМ по решению проекта) ''Properties → C/С++ → Code generations → Runtime Library'' — необходимо установить для создания статического билда значение '''MT''' или, для динамического, '''MD'''.

	[[File:VS - runtime library.jpg\|center]]		[[File:VS - runtime library.jpg\|600px\|center]]

	В случае с портабельностью надо четко понимать, что существует определенная проблематика. Возьмем, к примеру, ядро и плагины Миранды, собранные динамически в 2003 студии. Чтобы обеспечить портабельность такой сборки, необходимо всего лишь закинуть рантаймы 2003 студии в корень папки Миранды, и все (<tt>msvcr71</tt> и т.п.). В случае если плагины собираются динамически в более поздних версиях студий, то просто кинуть рантаймы в папку с Мирандой не получится. К сожалению, более поздние версии рантаймов требуют в системе наличие файла манифеста для установленных рантаймов.		В случае с портабельностью надо четко понимать, что существует определенная проблематика. Возьмем, к примеру, ядро и плагины Миранды, собранные динамически в 2003 студии. Чтобы обеспечить портабельность такой сборки, необходимо всего лишь закинуть рантаймы 2003 студии в корень папки Миранды, и все (<tt>msvcr71</tt> и т.п.). В случае если плагины собираются динамически в более поздних версиях студий, то просто кинуть рантаймы в папку с Мирандой не получится. К сожалению, более поздние версии рантаймов требуют в системе наличие файла манифеста для установленных рантаймов.
Line 55:		Line 55:
	Далее жмем правой кнопкой по интересующему нас проекту и нажимаем '''Rebuild Solution'''.		Далее жмем правой кнопкой по интересующему нас проекту и нажимаем '''Rebuild Solution'''.

	[[File:VS - rebuild.jpg\|center]]		[[File:VS - rebuild.jpg\|600px\|center]]

	Также существует возможность компиляции сразу для нескольких режимов, для этого нажмите кнопку '''Batch Build…''' (ПКМ по проекту).		Также существует возможность компиляции сразу для нескольких режимов, для этого нажмите кнопку '''Batch Build…''' (ПКМ по проекту).

	[[File:VS - batch build.jpg\|center]]		[[File:VS - batch build.jpg\|600px\|center]]

	== Примечания ==		== Примечания ==

RMN: User:RMN/How to compile Miranda plugins

2015-03-29T14:37:14Z

User:RMN/How to compile Miranda plugins

New page

{{PageLang|ru}}{{DISPLAYTITLE:Самостоятельная компиляция плагинов Miranda IM}}
{{Todo|lang=ru|This guide is a copy of the one from tutorials of <tt>miranda-planet.com</tt> forums. It needs revision and adaptation to Miranda NG project.}}
Инструкция по самостоятельной компиляции плагинов '''Miranda IM''' из SVN.

__TOC__

== Введение ==
Последнее время меня часто спрашивают как самостоятельно собрать тот или иной плагин для Миранды, или само ядро. Данный гайд пишется именно чтобы предотвратить в дальнейшем подобные вопросы. Начнем с главного: я не программист. Следовательно, людям искушенным в искусстве написания программ, просьба не ругаться и не бить сильно за те неточности, которые будут допущены ниже (а они будут, исходя из постулата что я не владею языками программирования).

== Section1 ==
Ядро и плагины Миранды, находящиеся в ее основном репозитории, написаны на языке C и C++. Следовательно для того, чтобы собрать конечный продукт, нам будет необходим компилятор языка '''C/C++'''. Исходные коды Миранды и плагинов (большинства) содержат файлы проектов под '''MS Visual Studio'''. Правда тут небольшой нюанс: разные программисты пользуются разными версиями MS VS. В основном репозитории Миранды есть файл проектов к 2003, 2005 и 2008 студиям. В сторонних плагинах часто такой упорядоченности не бывает, и там выкладываются проекты только под конкретную студию, зачастую старую. Например, встречаются проекты под 6-ю версию (справка: MS VS 2003 — 7-я версия, 2005 — 8-я, 2008 — 9-я, 2010 — 10-я). Альтернативой компилятору, входящему в состав '''MS VS''', является '''MinGW''', в некоторых плагинах встречаются проекты и под него, но только в некоторых, поэтому уделять ему внимание не будем.

Итак, рассмотрим в качестве примера компилятора '''MS VS 2010 Express'''. Для скачивания данной версии следует пройти по [http://www.microsoft.com/express/downloads этой ссылке]. Я настоятельно рекомендую воспользоваться именно английской версией, потому что русская среда разработки это, как минимум, странно. Плюс данной редакции в том, что она, по сравнению с другими версиями '''VS''', мала и бесплатна. Также нам понадобится вторая чрезвычайно ценная и нужная программа — [http://tortoisesvn.net TortoiseSVN]. Скачав и установив данную программу (и, при желании, языковый пакет к ней), после перезагрузки системы мы увидим в контекстном меню '''Windows''' новые пункты:

[[File:TortoiseSVN - menu items RU.png|center]]

== Section2 ==
Следующим действием должно стать создание основной, корневой папки, где будут лежат исходные коды Миранды. Да-да, желательно иметь под рукой все исходники ядра и плагинов идущих с ядром. Для людей крайне ограниченных в трафике, необходимо иметь как минимум папку <tt>/include/</tt> из репозитория Миранды (только если вы хотите собирать сторонние плагины). Из личного опыта могу сказать, что путь к локальной копии репозитория лучше сделать без пробелов и без русских символов в названиях папок. Например, путь к моей копии исходных кодов Миранды имеет такой вид: <tt>D:\Sources\miranda\</tt>

Итак, создаем папку и, вызвав контекстное меню, нажимаем пункт «Извлечь». Появится окошко с просьбой ввести адрес репозитория (см. [[#Репозитории Miranda IM|ниже]]), с которого необходимо произвести скачивание исходных кодов.

В папке, куда было указано скачивание исходников, вы найдете две директории: <tt>miranda</tt> и <tt>miranda-tools</tt>. В первую очередь нас интересует папка <tt>miranda</tt>. Структура папок внутри неё должна выглядеть следующим образом:
<pre style="overflow:auto;">
bin
bin7
bin8
bin9
bin10
docs
i18n
include
lib
plugins
protocols
src
</pre>

Мы собираем в 2010 студии, следовательно нам нужна папка '''<tt>bin10</tt>''', именно там находится проектный файл под эту версию — <tt>miranda32.sln</tt>. Откроем его.

[[File:VS - solution screen.jpg|center]]

Слева мы видим решения проектов для модулей и ядра Miranda. Прежде чем собрать решение, нам необходимо установить режим компилирования: '''Release Unicode''' для Unicode версии плагина или '''Release''' для ANSI. В настройках решения (ПКМ по решению проекта) ''Properties → C/С++ → Code generations → Runtime Library'' — необходимо установить для создания статического билда значение '''MT''' или, для динамического, '''MD'''.

[[File:VS - runtime library.jpg|center]]

В случае с портабельностью надо четко понимать, что существует определенная проблематика. Возьмем, к примеру, ядро и плагины Миранды, собранные динамически в 2003 студии. Чтобы обеспечить портабельность такой сборки, необходимо всего лишь закинуть рантаймы 2003 студии в корень папки Миранды, и все (<tt>msvcr71</tt> и т.п.). В случае если плагины собираются динамически в более поздних версиях студий, то просто кинуть рантаймы в папку с Мирандой не получится. К сожалению, более поздние версии рантаймов требуют в системе наличие файла манифеста для установленных рантаймов.

Далее мнения расходятся, лично я считаю, что недостаточно кинуть в корень Миранды еще и файл манифеста к библиотекам, т.к. если оно и будет работать, не факт что корректно. Другие утверждают, что это выход и вроде все как окей пашет. Это что касательно динамической линковки.

Теперь стоит поговорить о статической линковке. Плагины, собранные в условиях статической линковки, имеют как правило существенно больший размер, в отличие от динамической сборки (примерно в 2 раза). Но в то же время они лишены главного недостатка динамической линковки — требования наличия библиотек в системе. То есть, для плагинов собранных со статической линковкой не понадобятся библиотеки даже в корне Миранды. Именно такую вариацию лично я и предпочитаю.

Немного о скорости. По логике понятно, что динамическая линковка оказывается быстрее статической, ненамного но все же. Я бы сказал, что такое утверждение правдиво для систем безантивирусной защиты, или тех антивирусов которые не отслеживают обращения сторонних программ к системным файлам, библиотекам и т.п. Проведя тесты на KIS 7 и 2009 могу сказать, что ощутимой разницы в скорости не заметно, пожалуй статическая линковка в данном случае шуршит даже быстрее. Также, важным моментом в этом деле является вопрос наличия оптимизации при сборке плагина: '''sse''' и '''sse2'''. Плагины, собранные динамически с оптимизациями '''sse2''', по утверждениям пользователей, загружаются существенно быстрее чем без оптимизации, с '''sse''' или статические. Но, к сожалению, '''sse2''' поддерживают далеко не все типы процессоров, и если с '''Intel''' все более-менее окей (примерно последние 4–5 лет у них во всех процессорах есть поддержка этого набора инструкций) то с '''AMD''' все очень неоднозначно.

Далее жмем правой кнопкой по интересующему нас проекту и нажимаем '''Rebuild Solution'''.

[[File:VS - rebuild.jpg|center]]

Также существует возможность компиляции сразу для нескольких режимов, для этого нажмите кнопку '''Batch Build…''' (ПКМ по проекту).

[[File:VS - batch build.jpg|center]]

== Примечания ==
1. Если возникла ошибка с хидером <tt>winres.h</tt>, то поступаем по одному из предложенных вариантов:
* Скачиваем файл <tt>winres.h</tt> (см. [[#Прикрепленные файлы|Прикрепленные файлы]]) и помещаем его в папку <tt>C:/Program Files/Microsoft SDKs/Windowsv7.0A/Include</tt>
* Заменяем в коде все хидеры <tt>winres.h</tt> на <tt>winresrs.h</tt>. После чего ищем файл <tt>winresrs.h</tt> в папке <tt>C:/Program Files/Microsoft SDKs/Windowsv7.0A/Include</tt> и добавляем следующие строки (в начало):
<pre style="overflow:auto;">
#ifdef IDC_STATIC

#undef IDC_STATIC

#endif

#define IDC_STATIC (-1) // all static controls
</pre>

2. Если возникла ошибка с хидером <tt>afxres.h</tt>, то заменяем его на <tt>winres.h</tt>. Или скачиваем файл <tt>afxres.h</tt> (см. [[#Прикрепленные файлы|Прикрепленные файлы]]) и помещаем его в папку <tt>C:/Program Files/Microsoft SDKs/Windowsv7.0A/Include</tt>.

== Внимание ==
* '''SVN''' — это хранилище кода, как правило, на стадии написания и тестирования.
* '''НЕ КОМПИЛИРУЙТЕ''' плагины, если вы не уверены, что их работоспособность гарантирована. (Спасибо Awkward)
* Перед компилированием сделайте резервные копии рабочих плагинов.

== Репозитории Miranda IM ==
* http://miranda.googlecode.com/svn/branches/stable/ — стабильная ветка
* http://miranda.googlecode.com/svn/trunk/ — альфа-версии сборок

Для людей с ограниченным трафиком следует качать по ссылкам:
* http://miranda.googlecode.com/svn/branches/stable/miranda/include и
* http://miranda.googlecode.com/svn/trunk/miranda/include (только если вы хотите собирать сторонние плагины)

Рекомендуется использовать с осторожностью и только опытным пользователям.

== Прикрепленные файлы ==
* afxres.h
* winres.h

Авторы данного руководства:
: Креол, mozzila (дополнения, сборка материала и скриншоты)