Программа RQ Debugger IDE предназначена для для разработки программ на языках Rapid-Q Basic и FreeBasic.

Внешний вид главного окна программы




Основные возможности

Текущая версия находится в  Beta стадии. Некоторые функции не реализованы.
Работа возможна только с разрешением экрана 1024х768 !!

 

Настройки (Options)

Editor.  Можно установить другой шрифт и выключить подсветку синтаксиса.
Directories. Необходимо установить пути компилятора и других необходимых файлов для Rapid-Q и
FreeBasic.

Другие вкладки пока не работают.

Проекты (Projects)

Проекты представляют собой списки файлов, используемых при работе над  какой-нибудь отдельной темой. В эти списки могут входить как  программные модули, так и любые другие файлы.  
Чтобы создать новый проект откройте пункт меню File и там - New Project.
Будет предложено сохранить существующий проект. После этого, в появившемся окне введите имя проекта, под которым он будет числиться в списке проектов и введите или выберите имя файла.
Откроется пустое окно или окно с выбранным файлом. Данный файл появится в списке окон
(пункт меню Windows).
В списке проектов (пункт меню Projects) появится имя данного проекта.
Когда открывается новый файл через пункт меню File-Open, он добавляется в список окон (пункт меню Windows). При завершении работы будет предложено сохранить измененные файлы и настройки текущего проекта. В настройки входят:

Аналогичным образом можно создать несколько проектов и в дальнейшем выбирать один из них, используя  пункт меню Projects.
Удалить проект можно используя Projects-Delete Project.

Окна
Когда открывается новый файл через пункт меню File-Open, он добавляется в список окон (пункт меню Windows). Всего может быть открыто 32 файла для каждого проекта. Переключение к последнему просмотренному  окну осуществляется при помощи пункта Меню LastW. Таким образом можно быстро переключаться между двумя окнами.
Чтобы закрыть окно используйте Windows-Close Window.

Закладки
Для каждого окна можно создать 32 закладки. (пункт меню BookMarks). Для создания используйте BookMarks-Add BookMark. Строка в которой находится курсор будет добавлена в список закладок.
Для быстрого переключения между двумя закладками используйте пункт меню LastB.
Другие пункты меню

Навигация по тексту
Одной из основных задач при написании данного редактора было создание развитых средств навигации по тексту. Одно из таких средств - закладки было описано выше.
Другие средства

    SubsList  составляется каждый раз при загрузке файла. После изменения файла для обновления SubList надо нажать соответсвующую кнопку на тулбаре или в меню View-Subroutine list. SubList может после этого находиться в свернутом виде в Task Bar'e Windows.
    Панель поиска-замены  всегда видна в верхнем левом углу экрана. При поиске работает только поиск вперед.
 

Компиляция
В настоящей версии для Rapid-Q реализована только компиляция в exe файл и компиляция со вставкой отладочной информации для пошаговой отладки. Для компиляции и запуска программы необходимо использовать меню Run-RQ Compile and run (F5) или кнопку тулбара.  После этого компилятор сохранит исходник (предыдущий будет затерт), попытается создать exe -файл в директории исходника и запустить его на выполнение. Существующий exe-шник с таким же именем будет затерт. Если при компиляции возникнут ошибки, то первая из них будет отображаться в логе (самое нижнее окно редактора) и компиляция будет прервана. Ошибка также будет отображаться в строке состояния и курсор будет установлен на строку с ошибкой. В данной версии до конца не отлажено и иногда не срабатывает.  Если ошибка будет во включаемом ($include) файле то эта ситуация также корректно не обрабатывается. Надо в редакторе лога
найти имя включаемого файла, открыть его и кликнуть на строке статуса с ошибкой. Курсор установится на строку с ошибкой.
Если при компиляции exe-файл с таким именем уже запущен, то компиляция не будет выполнена, но никакого предупреждения в данной версии выдано не будет. Эта ситуация будет исправлена в следующих версиях.

Пошаговый отладчик
Для отладки отдельных процедур и функций Rapid-Q в данной IDE имеется пошаговый отладчик.
Пошаговый отладчик в Beta версии не всегда работает корректно!
Если отлаживаемая процедура входит в состав сложной программы, то лучше для отладки процедуры создать отдельный модуль.

=== Как работает отладчик. ==================================
См.  StepByStepDebug.bas demo.

Создается четыре дополнительных файла
$DbgDisplay.bas - исходник с добавленной отладочной информацией (процедурами RQDebug("~$#SubName.varname",varname,0))
$SrcDisplay.bas - текст отлаживаемой процедуры для показа и подсветки текущего оператора.
$~OpLen.dat - Длина операторов для подсветки в $SrcDisplay.bas
$~OpPos.dat - Позиция операторов для подсветки в $SrcDisplay.bas

Всталяемые в исходник отладочные процедуры (Debugger subs) имеют вид

RQDebug("~$#SubName.varname",varname,0)
                                ^^sub name              ^^ var name
В выходном окне печатается список наблюдаемых переменных вида
SubName.varname=varname

=== Как использовать пошаговый отладчик ===
1. Выделить  (в окне редактора исходника)  переменную, которую вы хотите наблюдать .
2. Нажать кнопку "AddWatch" в панели дебаггераl (или в  popup menu по правой кнопке мыши)
Откроется Watch Window и туда будет добавлена переменная
3. Сделать то же самое для остальных переменных
4. Нажать кнопку "Compile and run with debug" в debug panel или в меню Run.
5. Программа будет скомпилирована с отладочной информацией и запущена. Когда произойдет вызов отлаживаемой процедуры, выполнение будет прервано и откроется окно пошаговой отладки.
6. Используте кнопку "Trace"  для пошаговой отладки и "Continue" для продолжения выполнения.
Малополезная кнопка Timer служит для выполнения шагов по таймеру, а не вручную.

Конечно данный отладчик не является полноценным средством, но во многих случаях может быть полезен.
 

FreeBasic
В связи с появлением языка FreeBasic была добавлена его частичная поддержка.
Можно компилировать exe-файлы и dll.  Созданные с помощью FreeBasic DLL могут вызываться из программ Rapid-Q в тех случаях, когда требуется высокое быстродействие. Для данной среды на FreeBasic была написана DLL для подсветки синтаксиса.

 


Замечания и предложения   просьба направлять по адресу diakin@narod.ru
Шелковенко Андрею Васильевичу.