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