Программирование на С/C++
Здесь описывается, как использовать разные компиляторы C/C++, чтобы скомпилировать программу под KolibriOS
Visual C++ 6/.NET/2005
- Лицензия: команднострочная версия (Visual C++ Toolkit, компилятор/линковщик, стандартные включаемые файлы и RTL-библиотеки) бесплатна (http://microsoft.com, поиск по сайту), полная версия (IDE, исходники RTL) коммерческая
- Доступные библиотеки для Колибри: библиотека LZMA-упаковки lzmapack.lib; можно использовать любой код, не использующий вызовов ОС и компилирующийся в объектные файлы, которые понимает линковщик от Microsoft (в частности, огромное количество Сишных библиотек). К сожалению, к стандартной RTL (Run-Time Library) это не относится, так что все недостающие функции придётся реализовывать "ручками". Реализация некоторых, впрочем, уже есть.
- Примеры программирования для Колибри: ac97snd, fara, xonix
- Генерируемые форматы: 32-bit PE и 64-bit PE64
- Средства разработки: командная строка в Windows; IDE для Windows
Visual C++ - один из лучших оптимизирующих компиляторов C++. Команднострочный компилятор распространяется Microsoft бесплатно, за IDE нужно платить, поэтому здесь рассматриваются оба варианта. Версия VC6, хоть и довольно давно выпущенная, всё ещё популярна, версии VS.NET и VS2005 имеют свойство тормозить.
Пакет VC (точнее, линковщик link.exe) генерирует исключительно PE-файлы, так что с 32-битностью проблем нет, а вот с генерацией двоичного файла придётся повозиться.
При работе в IDE сначала создадим проект: (для VC6) File->New->Projects->Win32 Application, Project name: hello, (для VS) File->New->Project->Visual C++,General->Empty Project, Name: hello, для VC6 появится мастер, ему указываем "An empty project", подтвердим серьёзность намерений нажатием OK в последнем диалоговом окне и получим в полном соответствии с пожеланиями пустой проект с двумя конфигурациями. Конфигурацию Debug рекомендуется сразу удалить (для VC6 Build->Configurations->кнопка Remove, для VS Build->Configuration Manager->(в выпадающем списке)Edit->кнопка Remove), поскольку отладчик VC в данном контексте заведомо бесполезен. Теперь добавляем в проект (для VC6 Project->Add to Project->Files, для VS Project->Add Existing Item) включаемые файлы kosSyst.h, KosFile.h, mcsmemm.h и файлы с исходным кодом kosSyst.cpp, KosFile.cpp, mcsmemm.cpp (входят в прилагаемые к статье примеры - немного модифицированный вариант из исходников дистрибутива для возможности компиляции с VC6). Кстати, возникающий диалог поддерживает выбор нескольких файлов (если удерживать Ctrl). Далее, создаём основной файл hello.cpp (можно и main.cpp, можно взять любое другое имя) (для VC6 File->New->Files->C++ Source File, File name: hello, для VS File->New->File->Visual C++,C++ File, потом File->Save source1.cpp As, потом File->Move hello.cpp into->hello) и далее начинаем писать сам код. Рекомендуется изучить kosSyst.h, там указаны прототипы функций-обёрток системных вызовов.
#include "kosSyst.h" #include "kosFile.h" const char header[] = "HelloWorld test"; const char string[] = "Hello, World!"; void draw_window(void) { // start redraw kos_WindowRedrawStatus(1); // define&draw window kos_DefineAndDrawWindow(10,40,150,50, 0x33,0xFFFFFF,0,0,(Dword)header); // display string kos_WriteTextToWindow(30,10,8,0,(char*)string,0); // end redraw kos_WindowRedrawStatus(2); } void kos_Main() { draw_window(); for (;;) { switch (kos_WaitForEvent()) { case 1: draw_window(); break; case 2: // key pressed, read it and ignore Byte keyCode; kos_GetKey(keyCode); break; case 3: // button pressed; we have only one button, close kos_ExitApp(); } } }
Теперь настраиваем компиляцию. RTL-библиотеку использовать нельзя, она потянет за собой линковку к Windows-библиотекам, так что для VC6 на вкладке Project->Settings->Link в Category: Input очищаем поле Object/library modules и устанавливаем флажок Ignore all default libraries. Выполнение начинается с функции crtStartUp, так что устанавливаем в Category: Output устанавливаем Entry-point symbol:crtStartUp. Кроме того, в поле Project Options рекомендуется добавить опцию /align:16 (это необязательно, но сильно уменьшает размер бинарника). Для VS соответствующий диалог вызывается по Project->hello Properties и вместо вкладок там treeview, те же действия выполняются так: Configuration Properties->Linker->Input-> Ignore All Default Libraries: Yes, Linker->Advanced->Entry Point: crtStartUp, Linker->Command Line->Additional options: /align:16. Кроме того, для VS нужно явно установить подсистему: Linker->System->SubSystem (возьмите любую, она ни на что не влияет) и отключить при компиляции проверки переполнения стековых буферов и RTTI (они ссылаются на RTL): C/C++ ->Code Generation->Buffer Security Check: No, C/C++ ->Language->Enable Run-Time Type Info: No. Также манифест, вставляемый VS, нам ни к чему, так что Linker->Manifest File->Generate Manifest: No. Теперь компилятор уже способен сгенерировать код, но он окажется в формате PE. Основная идея заключается в том, чтобы получаемый PE-файл пропустить через программу pe2kos.exe, которая сменит его формат на используемый в Колибри. pe2kos.exe включена с исходниками в исходники дистрибутива (папка develop\pe2kos), а также без исходников в прилагаемые к статье примеры. (Есть и альтернативный подход, про который можно прочитать в разделе по MASM, описание линковки.) Колибри-бинарники требуется загружать по нулевому адресу, Колибри-заголовок окажется в начале файла вместо PE-заголовка, так что требуется установить базовый адрес (на той же самой вкладке - Output для VC6, Linker->Advanced для VS - поле Base address) в 0, для VS нужно ещё установить Fixed Base Address в "Image must be loaded at a fixed address (/FIXED)" (VC6 по умолчанию и так не генерирует релокейшенов).
Осталось настроить вызов pe2kos. Для VC6: Project->Settings->Custom Build, для VS: Project->hello Properties->Custom Build Step. В поле Commands/Command Line пишем
pe2kos Release\hello.exe hello
(предполагается, что pe2kos либо лежит в одном из PATH-каталогов, либо в каталоге проекта), в поле Outputs записываем имя бинарника - hello, он сгенерируется в каталоге проекта. Ах да, собственно компиляция теперь как обычно - либо F7, либо Build->Build hello.exe(VC)/Build->Build Solution(VS), либо соответствующая кнопка на панели инструментов. Теперь поработаем с командной строкой. Для начала установим необходимые переменные окружения. При установке VC Toolkit, VC6 или VS в соответствующем разделе главного меню появляется пункт "... Command Prompt", который вызывает консоль, устанавливает нужное окружение и ждёт действий пользователя. Можно самостоятельно запустить консоль и выполнить файл vcvars32.bat. После этого требуется перейти в рабочую папку (диск меняется командой X:, папка на диске - командой cd \folder1\folder2). Предполагается, что в эту папку уже скопированы kosFile.cpp,kosSyst.cpp,mcsmemm.cpp,kosFile.h,kosSyst.h,mcsmemm.h и набран hello.cpp. Необходимые опции компиляции точно такие же, как и в IDE, только теперь они задаются не через GUI, а в командной строке. Компиляция до VS2005:
cl /c /O2 /nologo hello.cpp kosFile.cpp kosSyst.cpp mcsmemm.cpp link /nologo /entry:crtStartUp /subsystem:native /base:0 /fixed /align:16 /nodefaultlib hello.obj kosFile.obj kosSyst.obj mcsmemm.obj pe2kos hello.exe hello
В VS2005 добавляются новые ключи:
cl /c /O2 /nologo /GS- /GR- hello.cpp kosFile.cpp kosSyst.cpp mcsmemm.cpp link /nologo /manifest:no /entry:crtStartUp /subsystem:native /base:0 /fixed /align:16 /nodefaultlib hello.obj kosFile.obj kosSyst.obj mcsmemm.obj pe2kos hello.exe hello
GCC/G++
- Лицензия: бесплатные, OpenSource
- Доступные библиотеки для Колибри: портированные RTL (Run-Time Library, стандартная Си-библиотека), SDL (Simple DirectMedia Layer, на ней основаны куча программ); можно использовать любой код, не использующий вызовов ОС и компилирующийся в объектные файлы, которые понимает ld (GNU линковщик).
- Примеры программирования для Колибри: dosbox, sdlfire, sdlquake, pig
- Генерируемые форматы: 32-bit, probably, 16-bit
- Средства разработки: MinGW - командная строка в Windows (http://www.mingw.org); GCC/G++ - стандартные компиляторы, входящие во все пакеты Linux и cygwin (http://www.cygwin.com)
GCC/G++ - один из лучших оптимизирующих компиляторов C/C++. Двоичные файлы как специальный формат не поддерживает, однако, линковщик понимает специальные скрипты, с помощью которых можно ему сказать довольно много.
Для кросс-компиляции программ на C и C++ для KolibriOS был создан специальный тулчейн.
Ниже приведены руководства по установке данного тулчейна на Linux и Windows.
Установка на Linux
Подробное руководство по установке тулчейна http://board.kolibrios.org/viewtopic.php?f=33&t=3540 Чтобы сделать установку более удобной, turbocat'ом был написан специальный скрипт, которые сделает все за вас). Скачать скрипт-установщик можно на этой странице http://board.kolibrios.org/viewtopic.php?f=33&t=3540&p=76381#p76381
Пример с компиляцией Hello world здесь https://habr.com/ru/post/527144/
ВАЖНО: замечание от автора скрипта:
Вот написал небольшой скрипт на BASH. Выполняет все действия по установке kos32-gcc и библиотек для Линукса автоматически. Не рекомендую запускать от рута(предоставляйте рут только когда скрипт сам потребует). Иначе тулчейн будет установлен в папку /root а не ваш домашний каталог!
Установка на Windows
Инструкция по установке тулчейна под Windows: https://habr.com/ru/post/229231/
Для удобства Boppan собрал тулчейн в один архив, скачать его можно тут:
http://board.kolibrios.org/viewtopic.php?f=33&t=1218&p=74401&hilit=kossdk#p74401
Borland C++
- Лицензия: утилиты командной строки бесплатны ( www.borland.com/bcppbuilder/freecompiler или поиск "Command-Line tools" по сайту), IDE коммерческая
- Доступные библиотеки для Колибри: базовая, необходимая для работы (включает работу с многопоточностью, обёртки системных вызовов, работу с кучей, работу с файлами, но RTL нет).
- Примеры программирования для Колибри: life2 (programs\demos\life2)
- Генерируемые форматы: 32-bit PE
- Средства разработки: командная строка в Windows; IDE для Windows
Компилятор не позволяет генерировать двоичные файлы. Здесь используется интересный подход: раз создавать Колибри-бинарники с помощью компилятора не получается, не будем его использовать! Будем использовать FASM, он позволяет генерировать всё, что нужно. Вопрос: а причём же здесь тогда C++? Ответ: будем писать на C++, но компилировать в ассемблерный текст! "Мелкие" проблемы с несоответствием TASM-синтаксиса выходных файлов от Borland C++ FASM-синтаксису решаются несложной программой t2fasm.exe. Для компиляции потребуется библиотека базовых функций, она входит в вышеупомянутые исходники life2. Собственно код (window.cpp) bcc32:
#include <kolibri.h> #include <kos_heap.h> #include <kos_file.h> using namespace Kolibri; const char header[] = "Colors"; bool KolibriOnStart(TStartData &kos_start, TThreadData th) { kos_start.Left = 10; kos_start.Top = 40; kos_start.Width = 135; kos_start.Height = 80; kos_start.WinData.WindowColor = 0xFFFFFF; kos_start.WinData.WindowType = 0x34; // 0x34 - fixed, 0x33 - not fixed kos_start.WinData.Title = header; return true; } void KolibriOnPaint(void) { // If button have ID 1, this is close button DrawButton(2,0xff0000, 10,40,50,20); DrawButton(3,0x00ff00, 70,10,50,20); DrawButton(4,0x0000ff, 70,40,50,20); DrawButton(5,0xFFFE00, 10,10,50,20); } void KolibriOnButton(long id, TThreadData th) { switch(id){ case 2: SetWindowCaption("Red"); break; case 3: SetWindowCaption("Green"); break; case 4: SetWindowCaption("Blue"); break; case 5: SetWindowCaption("Yellow"); //break; }; } /* int KolibriOnIdle(TThreadData th) { return -1; } void KolibriOnSize(int window_rect[], TThreadData th) {} void KolibriOnKeyPress(TThreadData th) { GetKey(); } void KolibriOnMouse(TThreadData th) {} */
Что-бы компилировать FASM версией выше 1.64 нужно пропатчить компилятор. Пример файла window_cpp.bat:
Set NAME=window Set BCC_DIR=..\..\..\bcc32 kos32-bcc -S -v- -R- -6 -a4 -O2 -Og -Oi -Ov -OS -k- -D__KOLIBRI__ -I..\..\..\bcc32\include %NAME%.cpp echo STACKSIZE equ 102400> kos_make.inc echo HEAPSIZE equ 102400>> kos_make.inc echo include "%BCC_DIR%\include\kos_start.inc">> kos_make.inc echo include "%BCC_DIR%\include\kos_func.inc">> kos_make.inc echo include "%BCC_DIR%\include\kos_heap.inc">> kos_make.inc echo include "kos_make.inc" > f_%NAME%.asm t2fasm < %NAME%.asm >> f_%NAME%.asm fasm f_%NAME%.asm %NAME%.kex if exist %NAME%.kex kpack %NAME%.kex if exist %NAME%.kex del kos_make.inc pause
Tiny C Compiler
- Лицензия: бесплатный, OpenSource
- Доступные библиотеки для Колибри: солидная часть RTL (Run-Time Library, стандартная Си-библиотека)
- Программы: TinyTextEditor, TinyHashView, PasswordGen, Whois, UnIMG, Weather, SHELL
- Генерируемые форматы: 32-bit COFF, ELF, PE, Kolibri
- Средства разработки: командная строка в Windows/Linux , консоль Kolibri OS
Компилятор TCC был доработан для генерации Колибри-бинарников. Также написана некоторая часть C RTL на базе функций Колибри. Исходники как самого компилятора, так и RTL доступны на svn-сервере Колибри: svn://kolibrios.org/programs/develop/ktcc/trunk. В отличии от остальных представленных выше компиляторов языка С, он портирован для Kolibri OS.
Примеры программ находятся в дистрибутиве по адресу "/kolibrios/develop/tcc/samples". Так же они доступны на SVN[1]
Пример базовой оконной программы (hello.c):
#include <sys/ksys.h> enum BUTTONS { BTN_QUIT = 1, BTN_CLICK = 2, }; int count = 0; ksys_colors_table_t sys_colors; void redraw_window(void) { _ksys_start_draw(); _ksys_create_window(10, 40, 400, 200, "My window", sys_colors.work_area, 0x14); _ksys_draw_text("TCC example", 15, 34, 0, 0x91000000 | sys_colors.work_text); _ksys_define_button(150, 100 , 100, 50, BTN_CLICK, sys_colors.work_button); _ksys_draw_text("Click!", 155, 115, 0, 0x91000000 | sys_colors.work_button_text); _ksys_draw_number(count, 15, 100, 0, 0x92000000 | sys_colors.work_text); _ksys_end_draw(); } int main() { _ksys_get_system_colors(&sys_colors); while (1) { switch (_ksys_get_event()) { case KSYS_EVENT_REDRAW: redraw_window(); break; case KSYS_EVENT_BUTTON: switch (_ksys_get_button()) { case BTN_CLICK: count++; redraw_window(); break; case BTN_QUIT: return 0; } break; } } }
Компиляция:
tcc hello.c -o hello