QaterialGallery - GitLite

KO | EN

gitlite — search

#hacktoberfest #ai #typescript #llm #go #android #rust #linux #docker #macos #nodejs #pytorch #security #ios

QaterialGallery

(★ 109)

🖼️ Qaterial Library Showcase.

파일 탐색기

최종 버전 다운로드 (.zip)

- - android-apk.yml
  - clang-format.yml
  - ios-ipa.yml
  - linux-appimage.yml
  - macos-dmg.yml
  - remove-old-artifacts.yml
  - wasm.yml
  - windows-installer.yml
- Dependencies.cmake
- FetchQaterial.cmake
- FetchQtAndroidCMake.cmake
- FetchQtIosCMake.cmake
- FetchQtLinuxCMake.cmake
- FetchQtMacCMake.cmake
- FetchQtStaticCMake.cmake
- FetchQtWasmCMake.cmake
- FetchQtWindowsCMake.cmake
- FetchSpdlog.cmake
- screen1.png
- screen10.png
- screen11.png
- screen12.png
- screen13.png
- screen14.png
- screen15.png
- screen16.png
- screen2.png
- screen3.png
- screen4.png
- screen5.png
- screen6.png
- screen7.png
- screen8.png
- screen9.png
- - QaterialGallery.hpp
- - AndroidManifest.xml.in
- - icon.png
  - index.html
- - appstore.png
  - appstore.svg
  - LaunchScreen.storyboard
- - appstore.png
- - icon.ico
  - icon.rc
- Deploy.cmake
- - AppBarBottomPage.qml
  - AppBarContent.qml
  - AppBarTopPage.qml
  - BannerPage.qml
  - ButtonPage.qml
  - CardLayout1.qml
  - CardLayout2.qml
  - CardLayout3.qml
  - CardLayout4.qml
  - CardPage.qml
  - ClusteredTabBarPage.qml
  - ControlButtonPage.qml
  - DateTimePickersPage.qml
  - DelegatePage.qml
  - DialogDelegatePage.qml
  - DialogPage.qml
  - FABPage.qml
  - FaderPage.qml
  - FixedTabBarPage.qml
  - FooterTabBarPage.qml
  - FramePage.qml
  - GroupBoxLayout.qml
  - GroupBoxPage.qml
  - IconButtonPage.qml
  - LatoTabBarPage.qml
  - Main.qml
  - MaterialPage.qml
  - MenuBarPage.qml
  - qmldir
  - ScrollableTabBarPage.qml
  - SlidersPage.qml
  - SnackbarPage.qml
  - StepperPage.qml
  - TabBarPage.qml
  - TextFieldPage.qml
  - ToolTipPage.qml
  - TypoPage.qml
  - TypoPageEntry.qml
- Import.qml
- Main.cpp
.clang-format
.editorconfig
.gitignore
.jsbeautifyrc
CMakeLists.txt
LICENSE
PrivacyPolicy.md
README.md

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Qaterial Gallery

|   Configuration   |                            Status                            |
| :---------------: | :----------------------------------------------------------: |
| Windows Installer | [![👷 Windows CI](https://github.com/OlivierLDff/QaterialGallery/workflows/%F0%9F%91%B7%20Windows%20CI/badge.svg)](https://github.com/OlivierLDff/QaterialGallery/actions?query=workflow%3A%22%F0%9F%91%B7+Windows+CI%22) |
|  Linux AppImage   | [![👷 AppImage CI](https://github.com/OlivierLDff/QaterialGallery/workflows/%F0%9F%91%B7%20AppImage%20CI/badge.svg)](https://github.com/OlivierLDff/QaterialGallery/actions?query=workflow%3A%22%F0%9F%91%B7+AppImage+CI%22) |
|     MacOs Dmg     | [![👷 MacOs CI](https://github.com/OlivierLDff/QaterialGallery/workflows/%F0%9F%91%B7%20MacOs%20CI/badge.svg)](https://github.com/OlivierLDff/QaterialGallery/actions?query=workflow%3A%22%F0%9F%91%B7+MacOs+CI%22) |
|    Android Apk    | [![👷 Android CI](https://github.com/OlivierLDff/QaterialGallery/workflows/%F0%9F%91%B7%20Android%20CI/badge.svg)](https://github.com/OlivierLDff/QaterialGallery/actions?query=workflow%3A%22%F0%9F%91%B7+Android+CI%22) |
|      iOs Ipa      | [![👷 iOs CI](https://github.com/OlivierLDff/QaterialGallery/workflows/%F0%9F%91%B7%20iOs%20CI/badge.svg)](https://github.com/OlivierLDff/QaterialGallery/actions?query=workflow%3A%22%F0%9F%91%B7+iOs+CI%22) |
|       Wasm        | [![👷 Wasm CI](https://github.com/OlivierLDff/QaterialGallery/workflows/%F0%9F%91%B7%20Wasm%20CI/badge.svg)](https://github.com/OlivierLDff/QaterialGallery/actions?query=workflow%3A%22%F0%9F%91%B7+Wasm+CI%22) |

[![downloadappstore](https://user-images.githubusercontent.com/17255804/98216721-b97d4380-1f49-11eb-9d38-483069cbb4e4.png)](https://apps.apple.com/us/app/qaterial-gallery/id1538406440)

QaterialGallery is a showcase application and contains example for the library Qaterial . It is still under development. This library is hard fork of previous library QQuickMaterialHelper.

This project also showcase multiplatform deployment with Qt.

## Components

### Main Page

<img src="./docs/screen3.png" alt="screen3" style="zoom:50%;" />

### Menu Bar

![screen4](https://raw.githubusercontent.com/OlivierLDff/QaterialGallery/master/docs/screen4.png)

### Buttons

![screen5](https://raw.githubusercontent.com/OlivierLDff/QaterialGallery/master/docs/screen5.png)

### Icons

<img src="./docs/screen6.png" alt="screen6" style="zoom:50%;" />

### Floating Action Button

![screen7](https://raw.githubusercontent.com/OlivierLDff/QaterialGallery/master/docs/screen7.png)

### Controls Buttons

![screen8](https://raw.githubusercontent.com/OlivierLDff/QaterialGallery/master/docs/screen8.png)

### Typography

<img src="./docs/screen9.png" alt="screen9" style="zoom:50%;" />

### Text Field

<img src="./docs/screen10.png" alt="screen10" style="zoom: 50%;" />

### Tab

![screen11](https://raw.githubusercontent.com/OlivierLDff/QaterialGallery/master/docs/screen11.png)

### Cards

![screen12](https://raw.githubusercontent.com/OlivierLDff/QaterialGallery/master/docs/screen12.png)

### Frame

<img src="./docs/screen13.png" alt="screen13" style="zoom: 50%;" />

### Group Box

<img src="./docs/screen14.png" alt="screen14" style="zoom:50%;" />

### Snackbars

<img src="./docs/screen15.png" alt="screen15" style="zoom:50%;" />

### Dialogs

![screen16](https://raw.githubusercontent.com/OlivierLDff/QaterialGallery/master/docs/screen16.png)

DOC TODO

## Build

QaterialGallery is a cross platform application that can be build natively or cross compiled. Qt precompiled binary are required and can be download from the [official website](http://download.qt.io/archive/qt/). Then simply use the qt manager to install the toolchain that you need. Minimum Qt version is `5.12`.

### Windows

To build the application for windows it is required to already be on a windows machine. It is recommended to export the path as global variable.

```bash
export QT_WIN_VERSION=5.12.0
export QT_DIR_MINGW32=C:/Qt/$QT_WIN_VERSION/mingw53_32
export QT_DIR_MINGW64=C:/Qt/$QT_WIN_VERSION/mingw53_64
export QT_DIR_MSVC32=C:/Qt/$QT_WIN_VERSION1/msvc2017_32
export QT_DIR_MSVC64=C:/Qt/$QT_WIN_VERSION/msvc2017_64
```

Then simply clone the repository and create an in source build folder.

```bash
git clone https://github.com/OlivierLdff/QaterialGallery
cd QaterialGallery && mkdir build && cd build
```

**MinGw 32 bits - Make**

```bash
cmake -DCMAKE_PREFIX_PATH=$QT_DIR_MINGW32 \
-G "Unix Makefiles" -DCMAKE_BUILD_TYPE=$QT_BUILD_TYPE path/to/CMakeLists/
```

**MinGw 64 bits - Ninja**

```bash
cmake -DCMAKE_PREFIX_PATH=$QT_DIR_MINGW64 \
-G "Ninja" -DCMAKE_BUILD_TYPE=$QT_BUILD_TYPE path/to/CMakeLists/
```

**Msvc 32 bits *(Default)***

```bash
cmake -DCMAKE_PREFIX_PATH=$QT_DIR_MSVC32 \
-G "Visual Studio 15 2017" path/to/CMakeLists/
```

**Msvc 64 bits**

```bash
cmake -DCMAKE_PREFIX_PATH=$QT_DIR_MSVC64 \
-G "Visual Studio 15 2017 Win64" path/to/CMakeLists/
```

### Linux

*TODO*

### Mac

*TODO*

### Android

#### Requirement

- [Android SDK Tools](https://developer.android.com/studio/index.html)
- [The Android NDK](http://developer.android.com/tools/sdk/ndk/index.html) *If installing Android Studio ndk comes with the SDK in `$SDK_PATH/ndk_bundle/`*.
- [Java SE Development Kit](http://www.oracle.com/technetwork/java/javase/downloads/jdk7-downloads-1880260.html) (JDK) v6 or later. You can also use [OpenJDK](http://openjdk.java.net/) on Linux.

#### Environment variable

You need to the following environment variable to be set.

- `ANDROID_SDK` : Path to the Android Sdk.
- `ANDROID_NDK` : Path to the Android Ndk
- `JAVA_HOME` : Path to the Java (mainly to use the jarsigner utility).

To build the application for windows it is required to already be on a windows machine. It is recommended to export the path as global variable.

```bash
export QT_ANDROID_VERSION=5.12.0
## On Windows
export QT_DIR_ARMV7A=C:/Qt/$QT_ANDROID_VERSION/android_armv7
export QT_DIR_ARM64V8A=C:/Qt/$QT_WIN_VERSION1/android_arm64_v8a
export QT_DIR_X86=C:/Qt/$QT_WIN_VERSION/android_x86
## On UNIX system
export QT_DIR_ARMV7A=Path/To/Qt/$QT_ANDROID_VERSION/android_armv7
export QT_DIR_ARM64V8A=Path/To/Qt/$QT_WIN_VERSION1/android_arm64_v8a
export QT_DIR_X86=Path/To/Qt/$QT_WIN_VERSION/android_x86
## On macOs
export QT_USER_ID=$(id -un)
export QT_DIR_ARMV7A=/Users/$QT_USER_ID/Qt/$QT_ANDROID_VERSION/android_armv7
export QT_DIR_ARM64V8A=/Users/$QT_USER_ID/Qt/$QT_WIN_VERSION1/android_arm64_v8a
export QT_DIR_X86=/Users/$QT_USER_ID/Qt/$QT_WIN_VERSION/android_x86
```

**CMAKE_BUILD_TYPE** can be set to multiple values. *Debug | Release | MinSizeRel | RelWithDebInfo*.

*Tip for windows: If you don't have make installed you can use the one in the ndk:*

```bash
-DCMAKE_MAKE_PROGRAM="$ANDROID_NDK/prebuilt/windows-x86_64/bin/make.exe"
```

#### Arm v7a

```bash
mkdir build-android-armeabi-v7a && cd build-android-armeabi-v7a
cmake -DQT_DIR=$QT_DIR_ARMV7A -G "Unix Makefiles" \
-DCMAKE_TOOLCHAIN_FILE=$ANDROID_NDK/build/cmake/android.toolchain.cmake \
-DCMAKE_BUILD_TYPE=Release \
-DANDROID_ABI=armeabi-v7a \
-DANDROID_NATIVE_API_LEVEL=27 \
-DANDROID_STL=c++_shared \
-DANDROID_TOOLCHAIN=clang \
-DQATERIALGALLERY_BUILD_SHARED=ON \
-DQATERIALGALLERY_ANDROID_KEYSTORE=Path/To/Keystore \
-DQATERIALGALLERY_ANDROID_KEYSTORE_ALIAS=KeystoreAlias \
-DQATERIALGALLERY_ANDROID_KEYSTORE_PASSWORD=xxxx \
..
make -j8
```

The resulted apk will be in `QaterialGallery-armeabi-v7a/build/outputs/apk/release/`.

#### Arm64 v8a

```bash
mkdir build-android-arm64-v8a && cd build-android-arm64-v8a
cmake -DQT_DIR=$QT_DIR_ARM64V8A -G "Unix Makefiles" \
-DCMAKE_TOOLCHAIN_FILE=$ANDROID_NDK/build/cmake/android.toolchain.cmake \
-DCMAKE_BUILD_TYPE=Release \
-DANDROID_ABI=arm64-v8a \
-DANDROID_NATIVE_API_LEVEL=27 \
-DANDROID_STL=c++_shared \
-DANDROID_TOOLCHAIN=clang \
-DQATERIALGALLERY_ANDROID_KEYSTORE=Path/To/Keystore \
-DQATERIALGALLERY_ANDROID_KEYSTORE_ALIAS=KeystoreAlias \
-DQATERIALGALLERY_ANDROID_KEYSTORE_PASSWORD=xxxx \
..
make -j8
```

The resulted apk will be in `QaterialGallery-arm64-v8a/build/outputs/apk/release/`.

#### x86

```bash
mkdir build-android-x86 && cd build-android-x86
cmake -DQT_DIR=$QT_DIR_X86 -G "Unix Makefiles" \
-DCMAKE_TOOLCHAIN_FILE=$ANDROID_NDK/build/cmake/android.toolchain.cmake \
-DCMAKE_BUILD_TYPE=Release \
-DANDROID_ABI=x86 \
-DANDROID_NATIVE_API_LEVEL=27 \
-DANDROID_STL=c++_shared \
-DANDROID_TOOLCHAIN=clang \
-DQATERIALGALLERY_BUILD_SHARED=ON \
-DQATERIALGALLERY_ANDROID_KEYSTORE=Path/To/Keystore \
-DQATERIALGALLERY_ANDROID_KEYSTORE_ALIAS=KeystoreAlias \
-DQATERIALGALLERY_ANDROID_KEYSTORE_PASSWORD=xxxx \
..
make -j8
```

The resulted apk will be in `QaterialGallery-x86/build/outputs/apk/release/`.

### Ios

**Prerequisite:**

- Be on recent version of [macOs](https://www.apple.com/fr/macos/mojave/).
- Latest Version of [XCode](https://developer.apple.com/xcode/).
- [Qt](https://www.qt.io/) compiled for iOs as static library.
- [iOs CMake Toolchain](https://github.com/OlivierLDff/IosCMakeToolchain).
- Generate Qt Import Plugin statement. See [these macros](https://github.com/OlivierLDff/QtStaticCMake).
- An [Apple Developer Licence](https://developer.apple.com/) if you want to deploy on real device.

**Prepare Environment:**

If you installed official Qt binary, Qt Sdk binary is located in:

```bash
export QT_USER_ID=$(id -un)
export QT_IOS_VERSION=5.15.1
export QT_IOS_DIR=/Users/$QT_USER_ID/Qt/$QT_IOS_VERSION/ios
```

**Run CMake:**

Then simply run CMake with [this toolchain](https://github.com/OlivierLDff/IosCMakeToolchain). Read the toolchain README for more information.

```bash
cmake -DCMAKE_PREFIX_PATH=$QT_IOS_DIR \
-DDEPLOYMENT_TARGET=12.0 \
-DCMAKE_TOOLCHAIN_FILE=/path/to/ios.toolchain.cmake \
-DPLATFORM=OS64COMBINED \
-DENABLE_BITCODE=FALSE \
-DTEAM_ID=AAAAAAAA \
-G "XCode" \
path/to/Projet/
```

**Build:**

Then you can simply build your app:

```bash
cmake --build . --config Release
```

or launch the generated XCode project.

Ipa will be located in `QaterialGalleryIpa/Qaterial.ipa`.

## Configuration

### Input

*Note: Exe, Shared and Static can't be ON at the same time.*

* **QATERIALGALLERY_BUILD_SHARED** : Build as a shared library [ON OFF]. *Default: OFF*.
* **QATERIALGALLERY_BUILD_STATIC** : Build as a static library [ON OFF]. *Default: OFF*.
* **QATERIALGALLERY_BUILD_EXE** : Build as an executable [ON OFF]. *Default: ON*.
* **QATERIALGALLERY_PROJECT** : Name of the project. *Default: QaterialGallery*.
* **QATERIALGALLERY_TARGET** : Name of the project. *Default: QaterialGallery*.

### Dependencies

### Output

* **QATERIALGALLERY_TARGET** : Output target to link to. *Default: QaterialGallery*

## Versions

To create a new release:

* Update in `CMakelist.txt` variables **QATERIALGALLERY_VERSION_MAJOR**, **QATERIALGALLERY_VERSION_MINOR**, **QATERIALGALLERY_VERSION_PATCH**.
* Increment in `platform/PostBuildPlatform.cmake` the parameter **VERSION_CODE** in the android apk macro

## Authors

* [Olivier Le Doeuff](https://github.com/OlivierLDff)