index cf0146fe3da96a3e9a5c9dc0090795f060536071..46b93157021ac2cf51ae3c1d63a667008a1fda4f 100644 (file)
--- a/README
+++ b/README
-**** ENGLISH ****
+BlackBox Component Builder for Windows, GNU/Linux, OpenBSD, FreeBSD
-To develop applications for Linux Ubuntu (12.04, 12.10)
- - sudo apt-get install wine libgnomeui-0
- - put this folder in any place
- - run the script "setup_script.py"
- - run new script from popup menu "Scripts" > "BlackBox LinDev"
-(if you move the folder, repeat run of "setup_script.py")
+Tested on:
+* Windows XP,7,10
+* OpenBSD 6.0
+* Fedora Core 17
+* Ubuntu 14.04, 16.04 LTS
+* Ubuntu GNOME 17.04
+* Arch Linux 4.9.6
+* Debian Mate
+* Red Hat Enterprise Linux Server 6.3
+* FreeBSD 11.0
+Directories structure:
-BlackBox.exe will open with Wine (Wine is necessary to be installed in OS) in folder with BBLin folder. Part of folders hide for a second for BB can correctly run. If an error dialog appears first time try to run script again.
+ BlackBox/
+ universal development environment based on BlackBox 1.7
-Lin version is concentrated in Host, Lin, Gtk2, System.
-All over are from standart BB 1.6 rc6 without any changes.
+ examples/
+ encoder/ - encoding subsystems by StdCoder from the command line
+ server/ - static single-thread web-server
-Ready to answer questions
-Ivan Denisov, d.ivan.krsk@gmail.com
+Installation of required packages in Ubuntu (should work also with other Debian-based OS):
+ 32-bit version:
-**** RUSSIAN *****
+ sudo apt-get install libgtk2.0-0 gtk2-engines gtk2-engines-murrine libcanberra-gtk-module
+ sudo apt-get install libgnomeui-0 gnome-icon-theme-full
-Для разработки приложений для Linux Ubuntu:
- - sudo apt-get install wine libgnomeui-0
- - поместите папку в удобное место на компьютере,
- - запустите скрипт "setup_script.py" (скрипт создаст другой скрипт для запуска BB)
- - в контекстном меню папки, в разделе "Cценарии" нажмите "BlackBox LinDev"
+ 64-bit version:
-Eсли вы переместили папку со средой, то заново запустите скрипт "setup_script.py".
+ sudo dpkg --add-architecture i386
+ sudo apt-get update
+ sudo apt-get install libgtk2.0-0:i386 gtk2-engines:i386 gtk2-engines-murrine:i386 libcanberra-gtk-module:i386
+ sudo apt-get install libgnomeui-0:i386 gnome-icon-theme-full
-Откроется BlackBox.exe через wine в папке с проектом новой среды для Linux, при этом часть файлов на время прячется, чтобы среда корректно запустилась, потом возвращается на место. Если среда не зупустилась с первого раза, то попробуйте еще раз (первый раз происходит запуск долго, а через 2 секунды папки везвращаются на место).
+To build BlackBox:
-Для работы требуется Wine.
+ cd BlackBox
+ ./switch-target `uname -s` GUI
+ ./build
-Чтобы изменить поведение среды при запуске, правьте файл "System/Mod/Init.odc"
+To run BlackBox (after build):
-Lin версия сейчас заключена в подсистемах: Host, Lin, Gtk2, System.
-Все остальное от bb1.6rc6.7z с сайта оберонкора без изменений абсолютно.
+ ./run-BlackBox
-Изменения отмечены в секции DONE в начале модуля и сами правки выделены синим цветом.
+for Linux version also you can run
+ ./blackbox
-Буду рад ответить на вопросы по предложенному методу работы:
-Иван Денисов, d.ivan.krsk@gmail.com
+To create BlackBox assembly (after build):
+ ./export <outputDirectory>
-Авторы:
-Денисов Иван Андреевич: HostPorts, HostFonts, LinLinker, сопровождение
-Ширяев Александр Владимирович: Kernel, LinLibc
-Оборотов Сергей Алексеевич: TCP
-Ткачев Фёдор Васильевич: исходники
-OpenBUGS322: исходники
-Оберон Микросисемы: исходники
+To clean the BlackBox folder:
-Прошу прощения, если что-то упустили, список пополняется.
+ ./switch-target none
+ ./clean
+
+Example: build, create assembly and run BlackBox from assembly:
+
+ cd BlackBox
+ ./switch-target `uname -s` GUI
+ ./build
+ ./export ../`uname -s`_GUI
+ ./switch-target none
+ ./clean
+ cd ../`uname -s`_GUI
+ ./run-BlackBox
+
+Authors:
+* Oberon microsystems AG
+* BlackBox Framework Center
+* Alexander V. Shiryaev
+* Igor A. Dehtyarenko
+* Ivan A. Denisov