Установка Mxx_ru

Mxx_ru распространяется в виде RubyGem-а и Gem Mxx_ru доступен в центральном репозитории RubyGems на сайте RubyForge. Для установки Mxx_ru необходимо иметь Ruby и установленную в Ruby систему управления RubyGems. После этого необходимо проинсталлировать Gem Mxx_ru и выставить в правильное значение переменную среды MXX_RU_CPP_TOOLSET.

ruby setup.rb

export RUBYOPT="rubygems"

gem install -v '>= 1.3.1' -r Mxx_ru

export MXX_RU_CPP_TOOLSET=gcc_linux

set MXX_RU_CPP_TOOLSET=gcc_mingw

export MXX_RU_CPP_TOOLSET=gcc_cygwin

set MXX_RU_CPP_TOOLSET=vc7

set MXX_RU_CPP_TOOLSET=vc8

set MXX_RU_CPP_TOOLSET=vc9

Распаковка

Выбирается каталог, который будет содержать SObjectizer, после чего в этот каталог распаковывается архив с соответствующей версией SObjectizer. Например:

cd d:/usr/src
tar jxf d:/download/so-4.4.0-b6.tar.bz2

После чего в d:/usr/src будет создан каталог so4.4. Далее этот каталог будет именоваться как SO4_ROOT.

Патчинг дистрибутива

Если к дистрибутиву на SourceForge есть diff-файлы (патчи), то их нужно загрузить и использовать затем для обновления (патчинга) дистрибутива. Например, пусть SO4_ROOT это d:/usr/src/so4.4, а патчи находятся в d:/download/so4.4. Тогда следует выполнить команды, аналогичные приведенным ниже:

cd d:/usr/src/so4.4
gunzip < d:/download/so4.4/so.4.4.b6.0-so.4.4.b6.1.diff.gz | patch -p2
gunzip < d:/download/so4.4/so.4.4.b6.1-so.4.4.b6.2.diff.gz | patch -p2
...

Примечание. Кроме параметра -p2 на платформе Win32 утилите patch может потребоваться передавать еще и параметр --binary.

Примечание. Портированные под Win32 утилиты tar, gunzip, bzip2, patch можно взять из проекта UnxUtils. Так же они входят в состав Cygwin и MinGW.

Автоматизированная распаковка и патчинг дистрибутива

Загруженные с SourceForge архив дистрибутива и diff-файлы можно разместить в одном каталоге (например, d:/usr/src) после чего запустить приведенный ниже Ruby-скрипт:

ruby unpack.rb

в результате будет создан подкаталог so4.4 в котором будет находиться пропатченный дистрибутив SObjectizer.

Исходный код скрипта unpack.rb:

DIFF_VER_REGEX = /.*\.(\d)*\.diff\.gz$/
SO4_ROOT = 'so4.4'

def verbose_run( desc, &blk )
  puts desc + "..."
  blk.call
  fail "'#{desc}' failed!" unless 0 == $?.exitstatus
end

verbose_run( 'Unpacking tar.bz2' ) { `tar jxf so-4.4.0-b6.tar.bz2` }

Dir[ '*.diff.gz' ].sort { |a,b|
  ((DIFF_VER_REGEX.match(a))[1].to_i) <=> ((DIFF_VER_REGEX.match(b))[1].to_i)
}.each { |n|
  verbose_run( "Patching #{n}" ) {
    Dir.chdir( SO4_ROOT ) { `gzip -d -c < ../#{n} | patch -lup2 --binary` }
  }
}

Распаковка ACE

Исходные тексты библиотеки ACE должны располагаться в каталоге SO4_ROOT/dev/ace/ACE_wrappers. В этом каталоге должны быть подкаталоги ace, include, lib и другие из состава ACE. Существует два способа распаковки ACE: автоматический, когда распаковкой занимаются Ruby скрипты, входящие в состав SObjectizer, и ручной, когда за распаковку ACE отвечает пользователь SObjectizer.

Примечание. Для SObjectizer достаточен дистрибутив ACE [1], в который входит только сам ACE без TAO и CIAO. Обычно этот дистрибутив имеет имя ACE-X.Y.Z-lib.tar.bz2 или ACE-X.Y.Z.tar.bz2 (так же есть архивы tar.gz и zip). Например, ACE-5.5.10.tar.bz2, ACE-5.6.5.tar.bz2. Архивы ACE, в которые входят TAO и CIAO называются, например, так: ACE-5.5.1+TAO-1.5.1.tar.bz2 и ACE-5.5.1+TAO-1.5.1+CIAO-0.5.1.tar.bz2. Они имеют гораздо больший объем, но использовать их для SObjectizer не имеет смысла, т.к. SObjectizer не нуждается в TAO и CIAO.

Для получения ACE можно обратиться к странице Obtaining ACE.

Примечание. Последней стабильной версией ACE ветки 5.6.* на данный момент является версия 5.6.8. Версия 5.6.6 содержит серьезную ошибку [2], поэтому ее использование не желательно.

Автоматическая распаковка ACE

Для автоматической распаковки ACE необходимо разместить архив ACE [1] (в виде ACE-*-lib.tar.bz2 или ACE-*.tar.bz2) файла в каталог SO4_ROOT/dev/ace_lib_distrib после чего подключить в какой-либо из проектных файлов (например, build.rb) проект ace/ace_lib_unpacker.rb:

require 'mxx_ru/cpp'

MxxRu::Cpp::composite_target( MxxRu::BUILD_ROOT ) {

  global_include_path( "." )

  required_prj( "ace/ace_lib_unpacker.rb" )
  ...

Подробнее см. соответствующий раздел в API Reference Manual.

cd d:/usr/src/so4.4/dev/ace
tar jxf d:/download/ACE-5.6.8.tar.bz2

Компиляция

ruby build.rb --mxx-cpp-release

ruby build.rb --mxx-cpp-debug

ruby sample/build_samples.rb --mxx-cpp-release

ruby test/build_tests.rb --mxx-cpp-release

ruby build_all.rb --mxx-cpp-release