QtQuick plugins to build user interfaces based on the KDE UX guidelines
Kirigami is a set of QtQuick components at the moment targeted for mobile use (in the future desktop as well) targeting both Plasma Mobile and Android. It’s not a whole set of components, all the “Primitive” ones like buttons and textboxes are a job for QtQuickControls (soon QtQuickControls2) but it’s a set of high level components to make the creation of applications that look and feel great on mobile as well as desktop devices and follow the Kirigami Human Interface Guidelines.
Build all examples available
mkdir build
cd build
cmake .. -DBUILD_EXAMPLES=ON
make
Than, you can run:
./examples/applicationitemapp/applicationitemapp
# or
./examples/galleryapp/kirigami2gallery
Make sure to install android-sdk, android-ndk and android-qt5-arch, where arch should be the same architecture that you aim to deploy.
mkdir build
cd build
cmake .. \
-DQTANDROID_EXPORTED_TARGET=kirigami2gallery \
-DBUILD_EXAMPLES=on \
-DANDROID_APK_DIR=../examples/galleryapp \
-DECM_DIR=/path/to/share/ECM/cmake \
-DCMAKE_TOOLCHAIN_FILE=/usr/share/ECM/toolchain/Android.cmake \
-DECM_ADDITIONAL_FIND_ROOT_PATH=/path/to/Qt5.7.0/5.7/{arch} \
-DCMAKE_PREFIX_PATH=/path/to/Qt5.7.0/5.7/{arch}/path/to/Qt5Core \
-DANDROID_NDK=/path/to/Android/Sdk/ndk-bundle \
-DANDROID_SDK_ROOT=/path/to/Android/Sdk/ \
-DANDROID_SDK_BUILD_TOOLS_REVISION=26.0.2 \
-DCMAKE_INSTALL_PREFIX=/path/to/dummy/install/prefix
You need a -DCMAKE_INSTALL_PREFIX
to somewhere in your home, but using an absolute path.
If you have a local checkout of the breeze-icons repo, you can avoid the cloning of the build dir
by passing also -DBREEZEICONS_DIR=/path/to/existing/sources/of/breeze-icons
make create-apk-kirigami2gallery
Apk will be generated at ./kirigami2gallery_build_apk/build/outputs/apk/kirigami2gallery_build_apk-debug.apk
.
To directly install on a phone:
adb install -r ./kirigami2gallery_build_apk/build/outputs/apk/kirigami2gallery_build_apk-debug.apk
To perform this, your device need to be configureted with USB debugging
and install via USB
in Developer options
.
Some ambient variables must be set before the process:
ANDROID_NDK
,ANDROID_SDK_ROOT
,Qt5_android
andJAVA_HOME
export ANDROID_NDK=/path/to/android-ndk
export ANDROID_SDK_ROOT=/path/to/android-sdk
export Qt5_android=/path/to/android-qt5/5.7.0/{arch}
export PATH=$ANDROID_SDK_ROOT/platform-tools/:$PATH
# adapt the following path to your ant installation
export ANT=/usr/bin/ant
export JAVA_HOME=/path/to/lib/jvm/java-8-openjdk/
Build kirigami
Use the same procedure mentioned above (but without BUILD_EXAMPLES
switch):
cd
into kirigami sources directory;mkdir build
cd build
cmake .. \
-DCMAKE_TOOLCHAIN_FILE=/path/to/share/ECM/toolchain/Android.cmake\
-DCMAKE_PREFIX_PATH=/path/to/Qt5.7.0/5.7/android_armv7/\
-DCMAKE_INSTALL_PREFIX=/path/to/dummy/install/prefix\
-DECM_DIR=/path/to/share/ECM/cmake
make
make install
make create-apk-kirigami2gallery
step.Build your application
This guide assumes that you build your application with CMake and use Extra CMake Modules (ECM) from KDE frameworks.
cd
into your application sources directory;$yourapp
with the actual name of your application;mkdir build
cd build
cmake .. \
-DCMAKE_TOOLCHAIN_FILE=/path/to/share/ECM/toolchain/Android.cmake \
-DQTANDROID_EXPORTED_TARGET=$yourapp \
-DANDROID_APK_DIR=../examples/galleryapp/ \
-DCMAKE_PREFIX_PATH=/path/to/Qt5.7.0/5.7/android_armv7/ \
-DCMAKE_INSTALL_PREFIX=/path/to/dummy/install/prefix
make
make install
make create-apk-$yourapp
-DCMAKE_INSTALL_PREFIX
directory will be the same as where Kirigami was installed,
since you need to create an apk package that contains both the kirigami build and the
build of your application.examples/minimalqmake
example as a template.kirigami
and breeze-icons
git repositories under the 3rdparty folder.main()
call KirigamiPlugin::getInstance().registerTypes();
to register QML types.此处可能存在不合适展示的内容,页面不予展示。您可通过相关编辑功能自查并修改。
如您确认内容无涉及 不当用语 / 纯广告导流 / 暴力 / 低俗色情 / 侵权 / 盗版 / 虚假 / 无价值内容或违法国家有关法律法规的内容,可点击提交进行申诉,我们将尽快为您处理。