qmlcore

PUREQML :: QMLCORE: QML TO JAVASCRIPT

QMLCore adalah satu set alat sederhana yang kami (tim kecil advokat QML) sejak bertahun -tahun untuk menyederhanakan pengembangan HTML5 UI untuk perangkat seluler dan desktop. Itu dirancang dengan mempertimbangkan QML asli, sementara itu tidak 100% kompatibel dan ditingkatkan dalam beberapa aspek. Konsep utamanya sama, jadi jika Anda terbiasa dengan QML asli, Anda bisa segera mulai.

Penggunaan

QMLCore menyediakan toolchain yang ditulis dalam python menggunakan python-future, memungkinkannya dijalankan di atas kedua versi Python. Biasanya Anda tidak perlu menggunakannya secara langsung. build menyediakan pembungkus yang nyaman di sekitar mereka semua.

Prasyarat

Python modern apa pun (2 atau 3) akan berjalan dengan baik. Jinja2 adalah opsi yang berbeda untuk templating jika Anda menginginkan lebih dari QML Loader dalam file HTML Anda, sementara itu tidak diperlukan untuk aplikasi kecil.

Untuk menginstal persyaratan yang dijalankan:

$ pip install - r requirements . txt 

How-to yang sederhana

• Buat Direktori Proyek, cd <project-dir>
• Clone Qmlcore untuk itu: git clone [email protected]:pureqml/qmlcore.git
• Jalankan ./qmlcore/build --boilerplate
• Lihatlah ./src/app.qml
• Jalankan ./qmlcore/Build Harap temukan file yang dihasilkan di build.web/*

Cara kerjanya

Kompiler QML memindai direktori sumber untuk file QML dan parse masing -masing. Nama file dimulai dengan huruf besar dianggap sebagai komponen, huruf kecil dipakai. Opsi di seluruh proyek disimpan dalam file .manifest . Hasil kompilasi adalah file javascript tunggal dengan dependensi minimum (hanya modernizr), siap digunakan dalam lingkungan seluler dan desktop dan disertai dengan sampel .html peluncur.

Opsi manifes

Manifest adalah kumpulan peretasan di seluruh proyek yang kami gunakan untuk merusak berbagai proyek. Beberapa dari mereka mungkin atau mungkin tidak berguna.

• templater - Mesin templat untuk digunakan, hanya 'sederhana' dan 'jinja2' yang didukung saat ini
• web-prefix -lihat -P opsi di bawah ini, tentukan awalan aturan CSS
• minify - False/True atau Compiler Name sebagai String, hanya 'GCC' dan 'Uglify -Js' yang didukung. Google Closure Compiler mengharuskan Java untuk dijalankan.
• platforms menggunakan platform tambahan/*/ file, default dan satu -satunya platform yang 'web' untuk saat ini
• path - Direktori Tambahan untuk mencari sumber

Bangun Opsi Baris Perintah Alat

• -m, --minify Minify dengan opsi default ('Uglify-js')
• -k, --keep sumber asli setelah minifikasi, berguna untuk peringatan minifikasi debugging
• -d, --devel , terus berjalan dan tunggu perubahan, memerlukan modul inotify
• -p, --web-prefix prefix Web awalan, aturan CSS default yang dihapus, menambahkan awalan 'qml-' untuk mereka, memungkinkan Anda untuk pertukaran html/qml.
• -u, --update-translation pembaruan file terjemahan, yang ditentukan dalam manifest.banguages
• -j, --jobs menjalankan pekerjaan paralel
• --boilerplate menginisialisasi minimum untuk kick-off lebih cepat di direktori saat ini.

Platform yang didukung

Kami mendukung banyak platform dan varian integrasi video yang berbeda.

Platform yang paling terkenal adalah:

• Browser Web HTML5 (jelas) dengan addons yang berbeda:
  • Shaka
  • Dash.js
  • Ekstensi Web Video.js
• Electronjs
• Android (Mesin Asli dan Cordova)
• IOS (Cordova)
• SmartTV Platorms:
  • TV Android apa pun melalui dukungan Android asli.
  • LG (Netcast dan WebOS)
  • Samsung SmartTV (Orsay dan Tizen)
  • Operatv
• Banyak platform STB (secara pribadi)
• Mesin C ++ asli dengan persyaratan minimal (EGL atau LinuxFB) (secara pribadi)

Untuk daftar lengkap platform yang didukung, lihat di sini dan di sini. Atau alternatifnya tanyakan saja kepada kami.

Dukungan Android asli

Repo utama untuk implementasi Android asli murni adalah https://github.com/pureqml/qmlcore-android.

Untuk membangun aplikasi Android asli, Anda perlu:

• Instal Android SDK dan atur variabel lingkungan ANDROID_HOME
• Jalankan ./qmlcore/platform/pure.femto/build-android-native.sh Script.

Lokalisasi

QMLCore menggunakan qt-approach untuk lokalisasi. Anda menulis kode dalam bahasa default Anda, kemudian menghasilkan/memperbarui (build -u) .ts file terjemahan, menerjemahkannya dengan ahli bahasa QT dan mengkompilasi proyek Anda. QmlCore Mengenali fungsi TR, QSTR, QStranslate, serta macros qt_tr_noop/qt_translate_noop.

Kontrol Perpustakaan

QMLCore berisi minimal kontrol platform: gambar, teks, persegi panjang dan kelas model-view-delegate. Berbagai kontrol yang mungkin berguna berada di repositori terpisah. Cukup klon melalui git clone [email protected]:pureqml/controls.git dalam proyek Anda dan hanya itu!

Perbedaan QML

Tata bahasa

Kami membutuhkan titik koma setelah setiap pernyataan. Ini dapat diubah di masa depan.

Fokus

Perbedaan terbesar dengan QML asli adalah bagaimana fokus diterapkan. Kami bertujuan untuk memiliki fokus "selalu konsisten" di mana-mana. Anda harus menandai setiap komponen yang dapat fokus dengan focus: true; properti, dan sisanya harus bekerja tanpa mengutak -atik. Kami menyediakan beberapa properti yang nyaman untuk menangani fokus dengan mudah:

• ActiveFocus - Item ini memiliki fokus saat ini dan mendapatkan input pengguna terlebih dahulu
• Fokus - Item ini memiliki fokus saat ini pada induknya, tetapi tidak harus fokus secara global

Catatan kustomisasi acak

Menambahkan fitur Modernizr

Silakan gunakan perintah berikut untuk mendapatkan halaman build modernizr khusus: head -n2 dist/modernizr-custom.js | tail -n1 atau hanya baris kedua file modernizr -custom.js

Terima kasih

Proyek Modernizr

Modernizr memberi tahu Anda apa yang ditawarkan HTML, CSS, dan JavaScript yang ditawarkan browser pengguna. https://modernizr.com/

SDL Game Controller Database

Database Sumber Komunitas Pemetaan Pengontrol Game https://github.com/gabomdq/sdl_gamecontrollerdb

Proyek Apache Cordova

Apache Cordova adalah kerangka pengembangan seluler open-source. Ini memungkinkan Anda untuk menggunakan teknologi web standar - HTML5, CSS3, dan JavaScript untuk pengembangan lintas platform. https://cordova.apache.org