Framework7 CLI 2.3.0 Released!

Framework7 CLI 2.3.0 update with all new UI released. It has a lot more options to configure and choose from.

2.3.0 Changelog:

  • All new UI :tada:
    • Now it is possible to change cwd (project destination)
    • Advanced webpack configuration
    • Advanced pre-installed Cordova plugins configuration
    • More theming options with instant theming preview - dark mode, fill-style navigation bars
    • New custom build section (for webpack + Less only)
  • Fixed electron settings file reference
  • Minor fixes


Super excited about this @vlad. Thanks a lot

Hi Vlad, awesome work with the CLI! (and everything else you do in general)

I don’t know if you take requests, but it would be very nice if the CLI could also support creating Typescript projects?


Would be awesome to have a .gitignore file added. The CLI creates a big structure, and I am not sure what should be in git or not, particularly after I built a bunch of stuff.

1 Like

I made this simple .gitignore according to my needs

# dependencies

# cordova stuff

# production

# Misc
1 Like

Yeah, will add default .gitignore

This is really awesome! especially for us Designer there need to go into dev :stuck_out_tongue:
I quick question, that the CLI doesnt answer for me:

Is it right that if you wanna work with FW7 + Cordova, you need to install them in two different folder and then merge your FW7 www into the cordova project?

Really dont get the logic of the workflow. I thought the CLI would merge them together but no luck, they overwrite. And when i follow the docs i get:
“Looks like cordova project is not set up”

Otherwise! so great!

/Best Jacob R.

What is your CLI config (what did you select) on creation?

wow… sorry buddy, I used the CMD and was selecting cordova with RETURN instead of selecting with space and then enter. MY BAD, it works!

once again, thanks for everything!

Yeah, also check readme file in created project folder, it should explain some things. But in overall, you shouldn’t touch Cordova/www folder and work only with src folder (if you have bundler) or root www folder (if you haven’t). And when you run Cordova related scripts it should automatically put correct content into Cordova/www

1 Like

Почему при выборе необходимых плагинов для Cordova, они не попадают в config.xml? Это баг или так задумано?

Видимо так задумано. Последние версии cordov’ы добавляют их в package.json

Цитата отсюда:
из раздела “Use with Cordova”:

Just put the contents of www folder in your cordova’s project root www folder

Как все же верно?:slight_smile:

Мы говорим о CLI, в том шаблоне по другому

Подскажите, правильно ли я понимаю оптимальный режим работы с CLI при использовании Cordova (возможно еще кому-то понадобиться):

  1. Весь исходный код мы кладем в src
  2. Для запуска локального сервера нужно выполнить npm start, раньше было npm run dev. Система следит за изменениями файлов и автоматически обновляет страницу. Это очень удобный способ разработки.
  3. Кода нам нужно сделать сборку в один файл мы выполняем npm run build-prod или npm run build-dev Данные команды делают один app.js, который содержит в себе все страницы. Собирать в один файл нужно для веб (так будет гораздо быстрее и удобнее) и для Cordova. Если мы используем современный WKWebView, то стандартный плагин Cordova не умеет загружать локальные файлы, нужно использовать плагин от Ionic или компилировать все в один файл. Разница между двумя командами в том, что последняя не минифицирует и не оптимизирует код, т.е. запуск происходит быстрее.
  4. Для создание приложений на ios и android используются две команды npm run build-cordova-dev и npm run build-cordova-prod Разница между ними такая же, как и написано выше. Есть также еще четыре команды, которые могут делать сборку конкретно для ios или android.
  5. Даже если у нас стоит Android Studio, нам нужно все равно установить отдельно Grandle.
  6. При создании приложения на ios, создается проект для Xcode, которые можно открыть из самого Xcode и сделать сборку. Также создается файл *.app Как здесь поступить оптимальнее для тестирования в симуляторе и создание подписанных приложений?
  7. При создании приложения для Android, создается *.apk, которые можно запустить на эмуляторе. Также вопрос, как оптимальнее запустить в эмуляторе и как удобнее делать подписанные сборки?

I’ll answer in English as it maybe useful for others.

Actually CLI installs other WKWebView plugin if Webpack is NOT selected - cordova-plugin-wkwebview-file-xhr assuming you don’t need local requests in this case. Probably it should be installed anyway, will revise it. And i personally prefer this plugin over Ionic’s one as this cordova-plugin-wkwebview-file-xhr plugin doesn’t use so many hacks and virtual server like in Ionic’s plugin.

I am not sure (don’t remember) here. I thing when we install Android studio, it also installs Gradle, no?

I believe you can launch simulator and run app on it with just a single command cordova run ios --emulator command.

For iOS apps signing, i always use XCode directly, it manages all code signing automatically.

I am using build.json + --buildConfig flag

Hey, I tried to install this tool, but with a bug, I tried always wrong!
λ npm install -g framework7-cli
npm ERR! path C:\Users\Administrator\AppData\Roaming\npm\node_modules\framework7-cli\node_modules\expand-brackets npm ERR! code EEXIST
npm ERR! errno -4075
npm ERR! syscall mkdir
npm ERR! EEXIST: file already exists, mkdir ‘C:\Users\Administrator\AppData\Roaming\npm\node_modules\framework7-cli\node_modules\expand-brackets’
npm ERR! File exists: C:\Users\Administrator\AppData\Roaming\npm\node_modules\framework7-cli\node_modules\expand-brackets
npm ERR! Move it away, and try again.

npm ERR! A complete log of this run can be found in:
npm ERR! C:\Users\Administrator\AppData\Roaming\npm-cache_logs\2019-05-08T16_09_19_664Z-debug.log


npm install -g framework7-cli --unsafe-perm=true --allow-root

I have tried this method, but still can’t

Есть проблема с установкой такого плагина (точнее с тем, чтобы передать переменную):

Если выполнить так:
framework7 cordova plugin add --variable VK_APP_ID=6972823

То будет ошибка:
error: unknown option–variable’`

Чтобы установить плагин, нужно перейти в папку cordova и выполнить то, что и указано в инструкции:
cordova plugin add --variable VK_APP_ID=1234567

1 Like