CQtDeployer/README.md

157 lines
11 KiB
Markdown
Raw Normal View History

2019-06-20 09:34:23 +03:00
# CQtDeployer [![CQtDeployer](https://snapcraft.io/cqtdeployer/badge.svg)](https://snapcraft.io/cqtdeployer)
2019-06-20 15:27:51 +03:00
# ![Logo](https://i.ibb.co/phDBvfr/qt.png)
2018-08-19 13:15:32 +03:00
2019-06-06 17:47:50 +03:00
****************************
2019-06-20 09:34:23 +03:00
## What is CQtDeployer
2019-06-06 09:21:13 +03:00
The CQtDeployer is application for extract all depends library of executable and create launch script for your application.
2018-08-19 13:15:32 +03:00
Key differences of this program:
2019-04-12 13:56:50 +03:00
* Performance: this program deploys the application several times faster (up to 10 seconds)
* Flexibility: this application's got flags that help you to configure the deployment for your or your project's needs
2019-05-21 18:06:10 +03:00
* Crossdeploy: this application's support windows and linux distrebutives, This means that you can use it not only to deploy a project for your platform, but also to deploy a project on Linux for Windows and vice versa.
2019-04-12 13:56:50 +03:00
2018-08-19 13:15:32 +03:00
### How to use
2019-04-12 18:36:47 +03:00
#### Example: cqtdeployer <-bin [params]> [options]
2018-08-19 13:15:32 +03:00
2019-06-24 18:00:13 +03:00
#### cqtdeployer -bin myApp -qmlDir ~/MyAppProject/qml -qmake ~/Qt/5.12.4/gcc_64/bin/qmake clear
2018-08-19 13:15:32 +03:00
#### Options:
2018-12-15 11:33:40 +03:00
| Option | Descriptiion |
|-----------------------------|-----------------------------------------------------------------|
2019-04-13 09:02:07 +03:00
| help / h | Shows help. |
2019-05-14 11:31:13 +03:00
| always-overwrite | Copies files and replaces the existing ones. |
2019-04-12 18:36:47 +03:00
| -bin [list, params] | Deployable file or folder. For example -bin ~/my/project/bin/,~/my/project/bin.exe|
| -binDir [params] | A folder which includes deployable files (recursive search). WARNING: this flag supports 'so', 'dll' and 'exe' files only. Use '-bin' flag if you want to deploy linux binary files |
2019-05-14 11:31:13 +03:00
| -qmlDir [params] | Qml data dir. For example -qmlDir ~/my/project/qml |
| deploySystem | Deploys all libraries |
| noLibc | Skip Deploys libc and ld-linux libs |
2019-04-12 18:36:47 +03:00
| -qmake [params] | Qmake path. For example |
2018-12-15 11:33:40 +03:00
| | -qmake ~/Qt/5.11.1/gcc_64/bin/qmake |
| -ignore [list,params] | The list of libs to ignore. |
2019-04-12 18:36:47 +03:00
| | For example -ignore libicudata.so.56,libicudata2.so.56 |
2019-05-14 11:31:13 +03:00
| -ignoreEnv [list,params] | The list of the environment to ignore. |
| | For example -ignoreEnv /bad/dir,/my/bad/Dir |
| clear | Deletes deployable files of the previous session. |
2019-04-12 18:36:47 +03:00
| | For example -runScript myApp.sh |
2019-05-14 11:31:13 +03:00
| allQmlDependes | Extracts all the qml libraries. |
| | (not recommended, as it takes great amount of computer memory) |
| -libDir [list,params] | Sets additional paths for extra libs of an app. |
2019-04-12 18:36:47 +03:00
| | For example -libDir ~/myLib,~/newLibs |
2019-05-14 11:31:13 +03:00
| -extraPlugin [list,params] | Sets an additional path to extraPlugin of an app |
2019-05-22 09:43:52 +03:00
| -recursiveDepth [params] | Sets the Depth of recursive search of libs (default 0) |
2019-05-14 11:31:13 +03:00
| -targetDir [params] | Sets target directory(by default it is the path to the first deployable file)|
| noStrip | Skips strip step |
| noTranslations | Skips the translations files. |
2019-04-12 18:36:47 +03:00
| qmlExtern | Use qml external scanner (qmlimportscaner) |
2019-05-14 11:31:13 +03:00
| | It doesn't work without qmake and inside a snap package |
| -verbose [0-3] | Shows debug log |
2018-09-18 16:36:05 +03:00
2018-08-24 16:26:54 +03:00
2018-08-19 13:15:32 +03:00
2019-06-10 14:58:06 +03:00
#### Example: cqtdeployer -bin myApp -qmlDir ~/MyAppProject/qml -qmake ~/Qt/5.12.4/gcc_64/bin/qmake clear
2018-08-19 13:15:32 +03:00
## Build for Linux
2019-05-21 18:06:10 +03:00
- install qt and qt QtInstallFrameWork from [qtInstaller](https://www.qt.io/download-qt-installer?hsCtaTracking=9f6a2170-a938-42df-a8e2-a9f0b1d6cdce%7C6cb0de4f-9bb5-4778-ab02-bfb62735f3e5)
- qmake -r
- make -j$(nproc)
- make deploy
- ./Distro/CQtDeployerInstaller
2018-08-19 13:15:32 +03:00
2018-12-16 21:00:24 +03:00
## Build for Windows
2019-05-21 18:06:10 +03:00
- install qt and qt QtInstallFrameWork from [qtInstaller](https://www.qt.io/download-qt-installer?hsCtaTracking=9f6a2170-a938-42df-a8e2-a9f0b1d6cdce%7C6cb0de4f-9bb5-4778-ab02-bfb62735f3e5)
- qmake -r
- make -j$(nproc)
- make deploy
- ./Distro/CQtDeployerInstaller.exe
2018-08-19 13:15:32 +03:00
## Install
You can download the latest version of the application [here](https://github.com/QuasarApp/Console-QtDeployer/releases).
2018-12-08 14:02:32 +03:00
### Snap
[![Get it from the Snap Store](https://snapcraft.io/static/images/badges/en/snap-store-black.svg)](https://snapcraft.io/cqtdeployer)
2018-08-19 13:15:32 +03:00
## Donate
2019-04-12 18:36:47 +03:00
If you want to support the project,you can donate into our bitcoin wallet.
2018-08-19 13:15:32 +03:00
### Bitcoin address - 1NJNbDKmezcUcHRfzpBeq2fHeG21oEKX8Q
***************************
***************************
***************************
2019-06-06 09:21:13 +03:00
Qt CQtDeployer - это приложением для извлечения всех зависимых библиотек исполняемого файла и создает сценарий запуска для вашего приложения.
2018-08-19 13:15:32 +03:00
Основные отличия этой программы:
* Производительность - эта программа развертывает приложение в несколько раз быстрее (до 10 секунд)
* Гибкость - это приложение имеет флаги, которые помогут вам настроить деплоинг под ваши нужды и нужды вашего проекта
2019-05-21 18:06:10 +03:00
* Crossdeploy: приложение поддерживает Windows и дистрибутивы Linux, это означает, что вы можете использовать его не только для развертывания проекта для вашей платформы, но и для развертывания проекта в Linux для Windows и наоборот.
2018-08-19 13:15:32 +03:00
### Как использовать
2018-09-22 16:54:52 +03:00
#### пример : cqtdeployer <-bin [params]> [options]
2018-08-19 13:15:32 +03:00
#### Options:
| Option | Descriptiion |
|-----------------------------|-----------------------------------------------------------|
2019-04-12 18:36:47 +03:00
| help / h | Показывает справку |
2018-12-15 11:33:40 +03:00
| always-overwrite | Копирует файлы с заменой уже существующих |
2018-12-15 20:51:25 +03:00
| -bin [list, params] | Развертываемый файл или папка. пример -bin ~/my/project/bin/,~/my/project/bin.exe|
| -binDir [params] | Папка с развертываемыми файлами (с рекурсивным поиском). ВНИМАНИЕ! Этот флаг поддерживает только файлы 'so', 'dll' и 'exe'. Если вы хотите развернуть бинарный файл Linux, используйте флаг '-bin' |
2018-12-15 11:33:40 +03:00
| -qmlDir [params] | Папка qml. пример -qmlDir ~/my/project/qml |
| deploySystem | Копирует все библиотеки кроме libc |
| deployLibc | Копирует libc и все остальные библиотеки |
2018-12-15 20:51:25 +03:00
| -qmake [params] | Путь к qmake. пример |
2019-06-20 09:59:51 +03:00
| | -qmake ~/Qt/5.12.4/gcc_64/bin/qmake |
2018-12-15 20:51:25 +03:00
| -ignore [list,params] | Список библиотек для игнорирования |
| | Пример -ignore libicudata.so.56,libicudata2.so.56 |
2019-05-14 11:31:13 +03:00
| -ignoreEnv [list,params] | Список путей для игнорирования. |
| | Пример -ignoreEnv /bad/dir,/my/bad/Dir |
2019-04-12 18:36:47 +03:00
| clear | Удаляет все старые файлы (с прошлого запуска) |
2018-12-15 20:51:25 +03:00
| | пример -runScript myApp.sh |
2019-04-12 18:36:47 +03:00
| allQmlDependes | Извлекает все библиотеки qml. |
2018-08-24 16:26:54 +03:00
| | (не рекомендуется, так как занимает много памяти) |
2019-04-12 18:36:47 +03:00
| -libDir [list,params] | Устанавливает дополнительные пути к библиотекам |
2018-12-15 20:51:25 +03:00
| | Пример -libDir ~/myLib,~/newLibs |
2019-04-12 18:36:47 +03:00
| -extraPlugin [list,params] | Устанавливает дополнительный путь для extraPlugin приложения |
| -recursiveDepth [params] | Устанавливает глубину поиска библиотек (по умолчанию 0) |
| -targetDir [params] | Устанавливает целевой каталог (по умолчанию это путь к первому развертываемому файлу)|
| noStrip | Пропускает шаг strip |
| noTranslations | Пропускает файлы переводов |
| qmlExtern | Использует внешний сканер qml (qmlimportscaner) |
2019-03-28 19:23:22 +03:00
| | не работает без qmake и в snap |
2019-04-12 18:36:47 +03:00
| -verbose [0-3] | Показывает дебаг лога |
2018-09-18 16:36:05 +03:00
2019-06-10 14:58:06 +03:00
#### Пример: cqtdeployer -bin myApp -qmlDir ~/MyAppProject/qml -qmake ~/Qt/5.12.4/gcc_64/bin/qmake clear
2018-08-19 13:15:32 +03:00
## Build для Linux
2019-05-21 18:06:10 +03:00
- установите qt и qt QtInstallFrameWork из [Установщик qt](https://www.qt.io/download-qt-installer?hsCtaTracking=9f6a2170-a938-42df-a8e2-a9f0b1d6cdce%7C6cb0de4f-9bb5-4778-ab02-bfb62735f3e5)
- qmake -r
- make -j$(nproc)
- make deploy
- ./Distro/CQtDeployerInstaller
2018-12-16 21:00:24 +03:00
## Build для Windows
2019-05-21 18:06:10 +03:00
- установите qt и qt QtInstallFrameWork из [Установщик qt](https://www.qt.io/download-qt-installer?hsCtaTracking=9f6a2170-a938-42df-a8e2-a9f0b1d6cdce%7C6cb0de4f-9bb5-4778-ab02-bfb62735f3e5)
- qmake -r
- make -j$(nproc)
- make deploy
- ./Distro/CQtDeployerInstaller.exe
2018-12-08 14:02:32 +03:00
### Snap
[![Загрузите из Snap Store](https://snapcraft.io/static/images/badges/ru/snap-store-black.svg)](https://snapcraft.io/cqtdeployer)
2018-08-19 13:15:32 +03:00
## Установить
Вы можете загрузить последнюю версию приложения [здесь](https://github.com/QuasarApp/Console-QtDeployer/releases).
## Пожертвовать
Если вы хотите помочь проекту, то вы можете пожертвовать небольшую сумму на наш биткойн-кошелек.
### Биткойн-адрес - 1NJNbDKmezcUcHRfzpBeq2fHeG21oEKX8Q