Установка



Интеграция с Visual Studio


Начиная с выпуска 9.0.0 фреймверк Nitisa можно устанавливать как обычное расширение Visual Studio и использовать Конструктор Форм непосредственно как интегрированный редактор Visual Studio. Для установки расширения Nitisa следуйте следующим простым шагам.

  • Откройте Visual Studio.
  • Перейдите в меню Tools->Extensions and updates.
  • Кликните на пункте Online слева в окне Extensions and Updates чтобы просматривать расширения доступные в сети.
  • Наберите Nitisa в поле поиска в правой части окна Extensions and Updates.
  • Отыщите Nitisa for Visual Studio в результатах поиска в середине окна Extensions and Updates.
  • Кликните на нем и проверьте информацию в Created by справа в окне Extensions and Updates чтобы убедиться, что Вы выбрали верное расширение. Там должно быть Nitisa.
  • Кникните по кнопке Download для установки.

Расширение Nitisa доступно для Visual Studio 2017 и более новых версий.

После установки Вы увидете несколько доступных проектов(для разных платформ) в диалоговом окне New Project Visual Studio в опции Visual C++.

Вам не нужно собирать Nitisa, как в случае скачивания исходного кода. Это произойдет автоматически, когда Вы будете собирать любой проект Nitisa, созданный с помощью установленных шаблонов, первый раз(и только первый раз).

Использование скачаного исходного кода


Если Вы не хотите использовать Visual Studio в качестве среды разработки или хотите избежать использования расширения Nitisa интегрированного в Visual Studio по другим причинам, Вы можете продолжить делать следующие простые шаги, чтобы начать работать с фреймверком.

  • В начале нужно скачать фреймверк Nitisa. Это можно сделать на странице Скачать.
  • Распакуйте все файлы в любую папку. Назовем эту папку путем установки. Пожалуйста обратите внимание на то, что эта папка должна быть доступна компилятору.
  • [НЕ ОБЯЗАТЕЛЬНО] Откройте файл решения, выберите нужную конфигурацию и платформу, соберите все решение для получения статических библиотек и исполняемых файлов Конструктора Форм. Во всех статьях мы преполагаем что используется конфиурация "Debug"("ReleaseRT" для Конструктора Форм) и платформа "x86". Так же можно использовать Пакетную сборку в соответствущем меню Visual Studio и собрать все доступные конфигурации. Если Вы собираетесь создавать только приложения под Windows, собирайте только папку Windows решения.
  • [НЕ ОБЯЗАТКЛЬНО] Если Вы, по какой-либо причине, хотите использовать только Конструктор Форм на отдельной машине на которой не установлена Visual Studio 2017(или более поздняя), Вам на ней так же понадобится Visual C++ 2017 x86/x64 redistributable.

Если Вы работаете в Visual Studio 2019, то при открытии файл решения Nitisa.sln она скорее всего спросит Вас о необходимости ретаргетинга на более новый набор средств сборки. Просто согласитесь.

Скачанный исходный код и расширение для Visual Studio. Сравнение


Вас может заинтересовать разница между использованием фреймверка в виде скачанного исходного кода и расширения для Visual Studio и какой из вариантов лучше Вам подойдет. Хорошо, мы собираемся объяснить отличия прямо сейчас.

Использование расширения Nitisa для Visual Studio упрощает подготовку фреймверка, создание проекта и обновление Nitisa. Оно так же позволяет работать с Nitisa как частью Visual Studio, так что Вам не придется волноваться ни очем, кроме установки расширения. Однако в этом случае Конструктор Форм собирается где-то в другом месте и находится где-то, не понятно где, о чем Вам обычно не следует волноваться. В результате этого всплывают некоторые ограничения. Конструктор Форм как часть Visual Studio не может загружать внешние пакеты, он использует только интегрированные. Вы так же не сможете его модифицировать так как в этом случае его исходный код недоступен.

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

Так что, если Вы просто создаете приложения используя мощный набор средств фреймверка Nitisa, расширение для Visual Studio является наиболее разумным для Вас выбором. Однако, если Вы разрабатываете Ваши собственные виджеты и пакеты виджетов, которые должны быть доступны в Конструкторе Форм, лучшим выбором будет использование скачанного исходного кода.

Можно ли использовать оба варианта и скачанный исходный код и расширение для Visual Studio? Да, можно. Даже можно использовать несколько скачанных версий исходного кода. Просто будьте осторожны при указании путей к заголовочным файлам и файлам со скомпилированными статическими библиотеками в Ваших проектах.

Разработка только на Linux


Процесс установки очень прост:

  • Вам, возможно, понадобиться установить некоторые библиотеки, которые перечислены в предидущей статье.
  • Скачайте фреймверк Nitisa. Вы можете сделать это на странице Скачать.
  • Распакуйте все файлы в любую папку. Например, Вы можете распаковать их в Вашу домашнюю папку.
  • Для получения статических библиотек, Вам нужно собрать исходный код фреймверка. В папке с фреймверком есть несколько *.sh скриптов, которые могут Вам помочь сделать это. Сначала откройте терминал в папке с этими скриптами. Если Вы скачали выпуск 9.0.0 и распаковали его в Вашу домашнюю папку, Вам нужно открыть терминал в папке ~/Nitisa-9.0.0.
  • Файл build-all.sh можно использовать для сборки Отладочных(Debug) и Финальных(Release) статических библиотек. Скрипты build-all-debug.sh и build-all-release.sh можно использовать для сборки только отладочных и только финальных библиотек. Чтобы собрать все, наберите в терминале ./build-all.sh. На это уйдет некоторое время, однако не волнуйтесь - это нужно сделать только один раз.

Конфигурации сборки


Решение скачанного фреймверка содержит четыре поддерживаемые платформы: ARM и x86 для 32-битных сборок, ARM64 и x64 для 64-битных сборок. Платформы ARM и ARM64 используются только в Android проектах. Так же есть несколько конфигураций. Это Debug, DebugRT, Release, ReleaseRT. Конфигурации без RT производят статические библиотеки со статическим связываением с библиотекой времени выполнения. Конфигурации с RT производят статические библиотеки со связыванием с библиотекой времени выполнения в форме DLL. Мы рекомендуем использовать конфигурации RT для сборки Конструктора Форм и сборки Ваших собственных пакетов. При разработке приложений обычно используются не RT конфигурации.

Для проектов под Linux, Вам так же нужно настроить соединение с машиной с операционной системой Linux для удаленной сборки.

В любом случае Вы можете добавлять Ваши собственные конфигурации для нужд Ваших приложений. Только не забывайте что ядро фреймверка и пакеты должны иметь совместимые конфигурации иначе Вы получите проблемы с линковкой(обратите внимание в первую очередь на использование библиотеки времени выполнения, настройки платформы и версии SDK).

Есть несколько простых рекомендаций, которые мы можем Вам дать, чтобы помочь выбрать какую платформу и конфигурацию лучше использовать. Если вы планируете запускать Ваше приложение только на 32-разрядной архитектуре, у Вас нет выбора кроме как использовать платформу x86. Если Вы планируете запускать Ваше приложение только на 64-разрядной архитектуре, Вы можете использовать либо платформу x86(которая создает 32-разрядные приложения) либо x64. До тех пор пока Ваше приложение не работает с огромными объемами данных(>2Гб), лучшим выбором будет платформа x86, так как в этом случае получится меньшее и немного более быстрое приложение. В противном случае используйте x64.

Что касается конфигурации, то можно использовать Debug и DebugRT во время разработки, а Release и ReleaseRT для финальной сборки. Используйте *RT, если Вы разрабатываете виджеты и пакеты виджетов, которые должны управлятся Конструктором Форм. В остальных случаях используйте конфигурации без *RT.

Конструктор Форм


Этот параграф применим только к использованию скачанного исходного кода фреймверка.

Соберите решение в конфигурации DebugRT или ReleaseRT для получения исполняемых файлов Конструктора Форм, который динамически загружает пакеты. Это рекомендуемый вариант.

Соберите решение в конфигурации Debug или Release для получения исполняемых файлов Конструктора Форм, который не загружает пакеты, а линкуется с ними на этапе сборки. В этом случае только пакеты доступные по умолчанию интегрируются в Конструктор Форм и, чтобы добавить другие пакеты, нужно менять исходный код Конструктора Форм и пересобирать его снова.

Удаление фреймверка


Если Вы установили Nitisa из Visual Studio, Вы можете удалить фреймверк стандартным способом - как обычное расширение: перейдите в меню Tools->Extensions and updates, найдите Nitisa среди установленных расширений и кликните по кнопке Uninstall.

Дополнительно нужно удалить скомпилированные файлы, которые находятся в папке данных всех пользователей(обычно это C:\ProgramData). Подпапка там, которую нужно удалить, называется Nitisa.

Если Вы скачали и распаковали Nitisa в какую-либо папку, Вы можете просто удалить эту папку.

Если Вы работаете только на Linux, все что нужно - это удалить папку, в которую Вы ранее распаковали фреймверк Nitisa.