Calendar

Author: Kang Lin kl222@126.com

🇨🇳 中文

Tables of contents

• Features
• ScreentShot
• Donation
• Download
• Depend
• Compile
• Use
• Contribution
• License Agreement

Project location:

• Project repository:
• Main repository: https://github.com/KangLin/Calendar
• Mirror repository:
  • https://gitlab.com/kl222/Calendar
  • https://gitee.com/kl222/Calendar
  • https://sourceforge.net/projects/rabbitcalendar/
  • https://invent.kde.org/kanglin/Calendar
• Project home

Features

• [x] calendar
  • Birthady(Year cycle), include lunar and solar
  • Month cycle
  • Week cycle
  • Custom cycle
• Custom task
• Eye Nurse： Vision protection
• Sticky

• [x] Cross-platform, support multiple operating systems

  • Windows
  • Linux、Unix
  • Android
  • Mac os
  • IOS

  Mac os and IOS, I don't have the corresponding equipment,
  please compile and test the students with the corresponding equipment.

See: Qt5, Qt6

ScreentShot

• Unix screent shot
• 
• 
• 
• Android screent shot
• 
• 
• 
• 

Donation

Download

Depend

• Qt (LGPL v2.1)

• Qt (official release): https://download.qt.io/official_releases/qt/

  • Set environment variable or cmake parameters:
  • QT_ROOT
  • Qt6: Qt6_ROOT or Qt6_DIR .
    See: https://doc.qt.io/qt-6/cmake-get-started.html
  • Qt5: Qt5_ROOT or Qt5_DIR .
    See: https://doc.qt.io/qt-5/cmake-get-started.html

  • Environment variable

    export QT_ROOT=Qt install root
    # Needed by complied AppImage
    export QMAKE=$QT_ROOT/bin/qmake
    
    # When Qt6
    export Qt6_ROOT=$QT_ROOT
    # When Qt5
    export Qt5_ROOT=$QT_ROOT
    
    # Or
    
    # When Qt6
    export Qt6_DIR=$QT_ROOT/lib/cmake/Qt6
    # When Qt5
    export Qt5_DIR=$QT_ROOT/lib/cmake/Qt5
    

  • CMAKE parameters

    # Qt6
    cmake -DQT_ROOT=[Qt install root] -DQt6_DIR=[Qt install root]/lib/cmake/Qt6 ......
    # Qt5 
    cmake -DQT_ROOT=[Qt install root] -DQt5_DIR=[Qt install root]/lib/cmake/Qt5 ......
    # Needed by complied AppImage
    export QMAKE=$QT_ROOT/bin/qmake
    

• System built-in:

  • Qt5:

    ~$ sudo apt install qttools5-dev qttools5-dev-tools qtbase5-dev qtbase5-dev-tools qtmultimedia5-dev qtlocation5-dev libqt5svg5-dev

  • Qt6: See: Script/build_depend.sh

    ~$ sudo apt install qmake6 qt6-tools-dev qt6-tools-dev-tools qt6-base-dev qt6-base-dev-tools qt6-qpa-plugins libqt6svg6-dev qt6-l10n-tools qt6-translations-l10n qt6-scxml-dev qt6-multimedia-dev

  • When multiple distributions of Qt are installed on the system.
    For example: Install Qt5 and Qt6 at the same time.
    The system uses the qtchooser tool to select the current Qt version.

    l@l:/home/RabbitRemoteControl$ qtchooser
    Usage:
    qtchooser { -l | -list-versions | -print-env }
    qtchooser -install [-f] [-local] <name> <path-to-qmake>
    qtchooser -run-tool=<tool name=""> [-qt=<qt version="">]</qt> [program arguments]
    <executable name=""> [-qt=<qt version="">]</qt> [program arguments]</executable></tool></path-to-qmake></name>

    Environment variables accepted:
    QTCHOOSER_RUNTOOL name of the tool to be run (same as the -run-tool argument)
    QT_SELECT version of Qt to be run (same as the -qt argument)

  • List which version of Qt is currently installed on your system

    l@l:/home/RabbitRemoteControl$ qtchooser -l
    4
    5
    default
    qt4-x86_64-linux-gnu
    qt4
    qt5-x86_64-linux-gnu
    qt5
    qt6
    
    # View the Qt version of your current environment
    l@l:/home/RabbitRemoteControl$ qtchooser --print-env
    QT_SELECT="default"
    QTTOOLDIR="[Paths]"
    QTLIBDIR="Prefix=/usr"
    

  • Set the Qt version of your current environment

    export QT_SELECT=qt6  # Set the Qt6 version of your current environment
    
    # View the Qt version of your current environment
    l@l:/home/RabbitRemoteControl$ qtchooser --print-env
    QT_SELECT="qt6"
    QTTOOLDIR="/usr/lib/qt6/bin"
    QTLIBDIR="/usr/lib/aarch64-linux-gnu"
    

• RabbitCommon

  git clone https://github.com/KangLin/RabbitCommon.git

• LunarCalendar

Compile

• Create and enter the build directory

  git clone --recursive https://github.com/KangLin/Calendar.git cd Calendar mkdir build

• Compile

• CMAKE parameter：
  • Qt
  • QT_ROOT: Qt install root
  • Qt6: See: https://doc.qt.io/qt-6/cmake-get-started.html
    • Qt6_ROOT: Is same QT_ROOT
    • Qt6_DIR: $QT_ROOT/lib/cmake/Qt6
  • Qt5: See: https://doc.qt.io/qt-5/cmake-get-started.html
    • Qt5_ROOT: Is same QT_ROOT
    • Qt5_DIR: $QT_ROOT/lib/cmake/Qt5
  • [MUST] RabbitCommon_ROOT: RabbitCommon source directory
  • [Optional] CMAKE_INSTALL_PREFIX: install prefix

• windows or linux

  cd build
  cmake .. -DCMAKE_INSTALL_PREFIX=`pwd`/install \
       -DCMAKE_BUILD_TYPE=Release \
       -DQt6_DIR=${QT_ROOT}/lib/cmake/Qt6 \
       -DRabbitCommon_ROOT=
  cmake --build . --config Release --target install
  

• android: version greater than 6

  • The host is linux

  • Compile

    cd build
    cmake .. -DCMAKE_BUILD_TYPE=Release \
        -DCMAKE_INSTALL_PREFIX=`pwd`/android-build \
        -DCMAKE_TOOLCHAIN_FILE=${ANDROID_NDK}/build/cmake/android.toolchain.cmake \
        -DANDROID_ABI="armeabi-v7a with NEON" \
        -DANDROID_PLATFORM=android-18 \
        -DQT_ROOT=... -DQt6_DIR=... \
        -DRabbitCommon_ROOT= 
    cmake --build . --config Release --target install
    

  • The host is windows

  • Compile

    cd build
    cmake .. -G"Unix Makefiles" ^
        -DCMAKE_BUILD_TYPE=Release ^
        -DCMAKE_INSTALL_PREFIX=`pwd`/android-build ^
        -DCMAKE_TOOLCHAIN_FILE=${ANDROID_NDK}/build/cmake/android.toolchain.cmake ^
        -DCMAKE_MAKE_PROGRAM=${ANDROID_NDK}/prebuilt/windows-x86_64/bin/make.exe ^
        -DANDROID_PLATFORM=android-18 ^
        -DANDROID_ABI=arm64-v8a ^
        -DANDROID_ARM_NEON=ON ^
        -DQT_ROOT=... -DQt6_DIR=... ^
        -DRabbitCommon_ROOT= 
    cmake --build . --config Release --target install
    

  • Parameter Description: https://developer.android.google.cn/ndk/guides/cmake

  • ANDROID_ABI: The following values can be taken:
    Goal ABI. If the target ABI is not specified, CMake uses armeabi-v7a by default.
    Valid ABI are:
    • armeabi：CPU with software floating point arithmetic based on ARMv5TE
    • armeabi-v7a：ARMv7-based device with hardware FPU instructions (VFP v3 D16)
    • armeabi-v7a with NEON：Same as armeabi-v7a, but with NEON floating point instructions enabled. This is equivalent to setting -DANDROID_ABI=armeabi-v7a and -DANDROID_ARM_NEON=ON.
    • arm64-v8a：ARMv8 AArch64 Instruction Set
    • x86：IA-32 Instruction Set
    • x86_64 - x86-64 Instruction Set
  • ANDROID_NDK <path> The path of installed ndk in host</path>
  • ANDROID_PLATFORM: For a full list of platform names and corresponding Android system images, see the [Android NDK Native API] (https://developer.android.google.com/ndk/guides/stable_apis.html)
  • ANDROID_ARM_MODE
  • ANDROID_ARM_NEON
  • ANDROID_STL: Specifies the STL that CMake should use.
    • c++_shared: The shared library variant of libc++.
    • c++_static: The static library variant of libc++.
    • none: No C++ standard library support.
    • system: The system STL

  • Install apk to devices

    adb install android-build-debug.apk

• Note

  • windows
    If you build app. Qt does not provide openssl dynamic library for copyright reasons, so you must copy the dynamic library of openssl to the installation directory.

    • If it is 32, you can find the dynamic library of openssl (libeay32.dll, ssleay32.dll) in the Qt installer Tools\QtCreator\bin directory.
    • If it is 64-bit, you will need to download the binary installation package for openssl yourself.

  • linux

    sudo apt-get install libssl1.1

Use

• pro

  • Library mode:
    Add the following code to the project file:

    isEmpty(Calendar_DIR): Calendar_DIR=$ENV{Calendar_DIR} isEmpty(Calendar_DIR){ message("1. Please download Calendar source code from https://github.com/KangLin/Calendar") message(" ag:") message(" git clone https://github.com/KangLin/Calendar.git") message("2. Build the project, get library") error("2. Then set value Calendar_DIR to library root directory") } INCLUDEPATH *= $${Calendar_DIR}/include $${Calendar_DIR}/include/export LIBS *= -L$${Calendar_DIR}/lib -lLunarCalendar -lCalendar

• cmake

  • Source code

    • Submodule mode

      add_subdirectory(3th_libs/Calendar/Src)

    • Non-submodule mode

      ```

      Need include ${RabbitCommon_ROOT}/cmake/Translations.cmake

      if( "${RabbitCommon_ROOT}" STREQUAL "" )
      set(RabbitCommon_ROOT $ENV{RabbitCommon_ROOT})
      if( "${RabbitCommon_ROOT}" STREQUAL "" )
      set(RabbitCommon_ROOT ${CMAKE_SOURCE_DIR}/../RabbitCommon)
      endif()
      endif()

      if(DEFINED RabbitCommon_ROOT AND EXISTS ${RabbitCommon_ROOT}/Src)
      add_subdirectory(${RabbitCommon_ROOT}/Src ${CMAKE_BINARY_DIR}/RabbitCommon)
      include(${RabbitCommon_ROOT}/cmake/Translations.cmake)
      else()
      message("1. Please download RabbitCommon source code from https://github.com/KangLin/RabbitCommon")
      message(" ag:")
      message(" git clone https://github.com/KangLin/RabbitCommon.git")
      message("2. Then set cmake value or environment variable RabbitCommon_ROOT to download root directory.")
      message(" ag:")
      message(FATAL_ERROR " cmake -DRabbitCommon_ROOT= ")
      endif()

      set(Calendar_DIR $ENV{Calendar_DIR} CACHE PATH "Set Calendar source code root directory.")
      if(EXISTS ${Calendar_DIR}/Src)
      add_subdirectory(${Calendar_DIR}/Src ${CMAKE_BINARY_DIR}/Calendar)
      else()
      message("1. Please download Calendar source code from https://github.com/KangLin/Calendar")
      message(" ag:")
      message(" git clone https://github.com/KangLin/Calendar.git")
      message("2. Then set cmake value or environment variable Calendar_DIR to download root directory.")
      message(" ag:")
      message(FATAL_ERROR " cmake -DCalendar_DIR= ")
      endif()
      ```

  • Library mode:

    • Cmake parameter Calendar_DIR specifies the installation root directory

      FIND_PACKAGE(Calendar)

    • Add libraries and include in CMakeLists.txt

      SET(APP_LIBS ${PROJECT_NAME} ${QT_LIBRARIES}) if(Calendar_FOUND) target_compile_definitions(${PROJECT_NAME} PRIVATE -DCalendar) target_include_directories(${PROJECT_NAME} PRIVATE "${Calendar_INCLUDE_DIRS}/Src" "${Calendar_INCLUDE_DIRS}/Src/export") set(APP_LIBS ${APP_LIBS} ${Calendar_LIBRARIES}) endif() target_link_libraries(${PROJECT_NAME} ${APP_LIBS})

Contribution

• Question
• Contributors

License Agreement