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.04 GNOME, 17.10, 18.04 LTS
   8 * Debian 9.3, 9.4 Xfce/Mate/GNOME/Cinnamon
   9 * Arch Linux 4.9.6
  10 * Red Hat Enterprise Linux Server 6.3
  11 * FreeBSD 11.0
  12
  13 Download: http://blackbox.obertone.ru/download
  14
  15 Directories structure:
  16
  17         BlackBox/
  18                 universal development environment for Component Pascal programming language
  19         BlackBox/_*
  20                 platform-specific files
  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 Prepare BlackBox from repository on Windows:
  31
  32         copy _Windows_, _Windows_GUI and __GUI content to the BlackBox directory
  33         remove other directories starting with "_"
  34         run build.bat
  35
  36
  37 Installation of required packages in Debian-based systems:
  38
  39         32-bit version:
  40
  41                 sudo apt-get install libgtk2.0-0 gtk2-engines gtk2-engines-murrine libcanberra-gtk-module gnome-icon-theme-full
  42
  43         64-bit version:
  44
  45                 sudo dpkg --add-architecture i386
  46                 sudo apt-get update
  47                 sudo apt-get install libgtk2.0-0:i386 gtk2-engines:i386 gtk2-engines-murrine:i386 libcanberra-gtk-module:i386 gnome-icon-theme-full
  48
  49         Ubuntu 18.04 Bionic Beaver:
  50
  51                 sudo dpkg --add-architecture i386
  52                 sudo apt-get update
  53                 sudo apt-get install libgtk2.0-0:i386 gtk2-engines:i386 gtk2-engines-murrine:i386 libcanberra-gtk-module:i386 gnome-themes-extra:i386
  54
  55
  56 To build BlackBox:
  57
  58         cd BlackBox
  59         ./switch-target `uname -s` GUI
  60         ./build
  61
  62 To run BlackBox (after build):
  63
  64         ./run-BlackBox
  65
  66 for Linux version also you can run
  67
  68         ./blackbox
  69
  70 To create BlackBox assembly (after build):
  71
  72         ./export <outputDirectory>
  73
  74 To clean the BlackBox folder:
  75
  76         ./switch-target none
  77         ./clean
  78
  79 Example: build, create assembly and run BlackBox from assembly:
  80
  81         cd BlackBox
  82         ./switch-target `uname -s` GUI
  83         ./build
  84         ./export ../`uname -s`_GUI
  85         ./switch-target none
  86         ./clean
  87         cd ../`uname -s`_GUI
  88         ./run-BlackBox
  89
  90 Authors:
  91 * Oberon microsystems AG
  92 * BlackBox Framework Center
  93 * Alexander V. Shiryaev
  94 * Igor A. Dehtyarenko
  95 * Ivan A. Denisov