README.md

   1 BlackBox Component Builder for Windows, GNU/Linux, OpenBSD, FreeBSD
   2
   3 Tested on:
   4 * Windows XP, 7, 10
   5 * OpenBSD 6.2
   6 * Fedora Core 17
   7 * Ubuntu 14.04, 16.04 LTS
   8 * Ubuntu GNOME 17.04
   9 * Arch Linux 4.9.6
  10 * Debian Mate
  11 * Debian 9.3 Xfce
  12 * Red Hat Enterprise Linux Server 6.3
  13 * FreeBSD 11.0
  14
  15 Download: http://blackbox.obertone.ru/download
  16
  17 Directories structure:
  18
  19         BlackBox/
  20                 universal development environment for Component Pascal programing language
  21
  22         dev/
  23                 files for continuous integration system & technical notes for framework developers
  24
  25         examples/
  26                 append/  - append string to .odc file
  27                 encoder/ - encoding subsystems by StdCoder from the command line
  28                 server/  - static web-server
  29
  30 Installation of required packages in Ubuntu (should work also with other Debian-based OS):
  31
  32         32-bit version:
  33
  34                 sudo apt-get install libgtk2.0-0 gtk2-engines gtk2-engines-murrine libcanberra-gtk-module
  35                 sudo apt-get install libgnomeui-0 gnome-icon-theme-full
  36
  37         64-bit version:
  38
  39                 sudo dpkg --add-architecture i386
  40                 sudo apt-get update
  41                 sudo apt-get install libgtk2.0-0:i386 gtk2-engines:i386 gtk2-engines-murrine:i386 libcanberra-gtk-module:i386
  42                 sudo apt-get install libgnomeui-0:i386 gnome-icon-theme-full
  43
  44 To build BlackBox:
  45
  46         cd BlackBox
  47         ./switch-target `uname -s` GUI
  48         ./build
  49
  50 To run BlackBox (after build):
  51
  52         ./run-BlackBox
  53
  54 for Linux version also you can run
  55
  56         ./blackbox
  57
  58 To create BlackBox assembly (after build):
  59
  60         ./export <outputDirectory>
  61
  62 To clean the BlackBox folder:
  63
  64         ./switch-target none
  65         ./clean
  66
  67 Example: build, create assembly and run BlackBox from assembly:
  68
  69         cd BlackBox
  70         ./switch-target `uname -s` GUI
  71         ./build
  72         ./export ../`uname -s`_GUI
  73         ./switch-target none
  74         ./clean
  75         cd ../`uname -s`_GUI
  76         ./run-BlackBox
  77
  78 Authors:
  79 * Oberon microsystems AG
  80 * BlackBox Framework Center
  81 * Alexander V. Shiryaev
  82 * Igor A. Dehtyarenko
  83 * Ivan A. Denisov